diff --git a/docs/SESSION-2026-06-17-open-items.md b/docs/SESSION-2026-06-17-open-items.md new file mode 100644 index 0000000..4133877 --- /dev/null +++ b/docs/SESSION-2026-06-17-open-items.md @@ -0,0 +1,52 @@ +# Open items — session 2026-06-17 (handoff notice) + +Everything still open after this session. Done items are in +`docs/audit/DATA-QUALITY-2026-06-15.md` (DQ-1..DQ-5 + roadmap R-A,R-B,R-C,R-D,R-F all +DONE; R-E deferred). This file is only the **loose ends**. + +## 1. BLOCKER — Jetson is offline +- The Jetson (`192.168.178.103`) went **unreachable** mid-session: `ping` 100 % loss, + `ssh:22` timeout. It hosts Postgres (the live corpus) **and** GROBID. +- **Blocks every live-DB action below.** First step next session: confirm it's powered + + on the network, bring the SSH tunnel back up + (`ssh -f -N -L 5433:localhost:5432 alfred@192.168.178.103`). + +## 2. PENDING — R-F accent re-clean (cosmetic, code already merged into the branch) +- R-F is functionally DONE (section signal 34/329 → **314/329 = 95 %**), but a few live + `chunks.section` labels still carry LaTeX accents/ties (e.g. `m\"obius`, `colin~de~…`). +- The `_clean_title` polish that fixes these is committed on `feat/section-labels`; the + **in-place re-clean of existing rows didn't finish** (Jetson went offline, item #1). +- **Action when Jetson is back (short UPDATE, no re-ingest):** apply + `codex.quality._clean_title` to every `chunks.section` containing `\` or `~` and write + it back. Quick + idempotent — exactly the kind of short op that survives a flaky link. + +## 3. Git — feature branches not merged to `main` +This session's work is on 5 branches off `audit/loop-1` (itself **18 commits ahead of +`main`**). No PRs opened. Merge decision + order pending: + +| Branch | Contents | Commits ahead of main | +|---|---|---| +| `audit/loop-1` | base: DQ-1..DQ-5, **R-A** (GROBID backfill + native arm64 GROBID) | 18 | +| `feat/tex-ingest` | **R-C** (.tex section-aware ingest) + DQ-5 arXiv-id fix + gzip fallback | 22 | +| `feat/section-labels` | **R-F** (richer section labels) — **branched off `feat/tex-ingest`** | 25 | +| `feat/crossref-references` | **R-B** (Crossref refs) + a concurrent GROBID-on-demand tweak | 20 | +| `feat/graph-coverage-warning` | **R-D** (citing-coverage warning) | 19 | +| `chore/infra-ssh-stability` | infra TODO doc (#4) | 19 | + +- **Order matters:** `feat/section-labels` contains `feat/tex-ingest`, so merge + `feat/tex-ingest` first (or merge section-labels alone, which brings both). +- All branches share the `audit/loop-1` base, so merging any one brings that whole line + to `main` — decide whether to land `audit/loop-1` → `main` as the trunk first. + +## 4. Infra TODO — tmux-on-Jetson for stable long ops (documented, not implemented) +- `docs/infra/jetson-ssh-stability.md` (branch `chore/infra-ssh-stability`). The + Mac↔Jetson tunnel dropped repeatedly on multi-minute writes all session. Fix: run long + ops **on the Jetson in `tmux`** (DB is localhost there → no tunnel; survives SSH drops); + `autossh` for interactive tunnels. Open. + +## 5. Known limitations (documented, NOT action items) +- `math/0306167` (old AMS-TeX, no `\section{}`) stays `section=body` — inherent. +- The 2 edited-volume books yielded 0 GROBID-parsed DOI/arXiv refs in the R-A sweep — + inherent (per-chapter refs, no clean end-bibliography). +- **DQ-6** (upstream PDF→`.txt` extraction fidelity, done outside codex-py) — flagged + earlier, largely **mooted** by R-A/R-C ingesting from PDF/`.tex` directly.