reshape: move OHM transcripts under ohm/ for org-wide multi-app layout; add org-wide root README
This commit is contained in:
@@ -0,0 +1,238 @@
|
||||
# Session 0052.0 — Transcript
|
||||
|
||||
> Date: 2026-05-31
|
||||
> Goal: Pick up after session 0049 (Patchwatch Phase 1). Fix the known
|
||||
> `flotilla` self-scan bug, then handle whatever it surfaces.
|
||||
>
|
||||
> Outcome: **Shipped TWO flotilla releases. v1.5.1 fixes the `flotilla`
|
||||
> self-scan radar layer (resolved-installed-env scan). Discovered the OHM
|
||||
> Gitea org repos went private (intentional) — which had silently broken
|
||||
> `pin check` / `deploy` / `plan` / `audit` app-layers. v1.6.0 wires
|
||||
> authenticated Gitea reads to restore them. Closed the loop with the
|
||||
> operator: a dedicated read token (NOT ohm-bot) now reads both `ben.stull/*`
|
||||
> repos — `pin check` resolves `0.31.3` and the full `audit` runs with ZERO
|
||||
> scanner_errors across all four layers. Blocker resolved; radar fully live.**
|
||||
|
||||
---
|
||||
|
||||
## Pre-session state
|
||||
|
||||
- flotilla `main` = `512797d` (v1.5.0, untagged — session 0049 merged the
|
||||
Patchwatch Phase 1 radar but never pushed a `v1.5.0` tag; tags stopped at
|
||||
`v1.4.0`).
|
||||
- ohm-rfc `main` = `1bb3f39` (ROADMAP #43 Patchwatch merged). Pin = `0.31.3`.
|
||||
- Local flotilla checkout: clean `main` @ `512797d`; CLI installed editable
|
||||
at v1.5.0; `osv-scanner` 2.3.8 on PATH at `/opt/homebrew/bin`.
|
||||
- Handoff named a "good first task": the `flotilla` self-scan layer feeds the
|
||||
bare `pyproject.toml` to `osv-scanner --lockfile`, which exits 127 → recorded
|
||||
as a `scanner_error`.
|
||||
|
||||
Claimed session ID **0052** via `claim-session-id.sh` (active in-flight at
|
||||
claim time: 0026, 0027, 0045 — all stale, days old).
|
||||
|
||||
---
|
||||
|
||||
## Turn-by-turn arc
|
||||
|
||||
### Arc 1 — Fix the `flotilla` self-scan layer (→ v1.5.1)
|
||||
|
||||
Reproduced the bug: `osv-scanner --lockfile pyproject.toml` → exit 127 "could
|
||||
not determine extractor". flotilla has no lockfile and unpinned deps
|
||||
(`click>=8.1`), so osv has nothing to extract.
|
||||
|
||||
Design intent (PATCHWATCH-PHASE1-RADAR §2.4) is "flotilla's own **installed
|
||||
environment**". Fix: `scan_flotilla` now enumerates the resolved installed set
|
||||
via `importlib.metadata`, renders it as a pinned `requirements.txt`, and scans
|
||||
that. The enumerator is dependency-injected (`run_audit(..., dist_enumerator=)`)
|
||||
so the suite stays offline. Threaded a `dist_enumerator` param through
|
||||
`run_audit`; updated the test stubs (osv stub keys on content, not lockfile
|
||||
name, so the flotilla layer scans a deterministic injected set).
|
||||
|
||||
Validated live: the `flotilla` layer went from a blind `scanner_error` to 4
|
||||
routine `pip` advisories in the operator venv. Doc-sync: SPEC §12.4 table +
|
||||
PATCHWATCH-PHASE1-RADAR §2.4. 6 new tests; suite 276 green.
|
||||
|
||||
Shipped **v1.5.1** (merge `6bda02f`, tag `v1.5.1`); also backfilled the missing
|
||||
`v1.5.0` tag at `512797d`. Pushed main + both tags over HTTPS (osxkeychain
|
||||
credential — push works even though the repo is now private).
|
||||
|
||||
### Arc 2 — Discovery: the OHM Gitea repos went private
|
||||
|
||||
The full live `audit` run surprised me: `py-app` and `node-app` both reported
|
||||
`pin: HTTP 404`. Session 0049 had resolved the pin fine. My change touched only
|
||||
`scan_flotilla`, so this was independent.
|
||||
|
||||
Diagnosis: the pin URL `ben/ohm-rfc` 307-redirects to `ben.stull/ohm-rfc`, which
|
||||
404s. Then **every** repo — including the public-looking
|
||||
`wiggleverse/ohm-rfc-app-flotilla` and `ben.stull/rfc-app` — 404'd via the
|
||||
anonymous API/raw/web, while SSH (operator key) saw them fine. Instance up
|
||||
(web root 200, `/api/v1/version` 200 anon). The web *repo page* returning 404
|
||||
(not a login redirect) is Gitea's signature for **private repos viewed
|
||||
anonymously**. Conclusion: the org repos were made private.
|
||||
|
||||
This is bigger than the radar: `pin.read_gitea_pin` also backs `flotilla
|
||||
deploy`, `pin check`, and `plan`. Confirmed `flotilla pin check` now 404s — so
|
||||
flotilla's **core deploy path was broken**, not just the radar.
|
||||
|
||||
Asked the operator: intentional? → **"Intentional — wire auth."** And: does
|
||||
ohm-bot have read on the repos? → **"Yes, has read."** (The second answer turned
|
||||
out empirically false — see Arc 4.)
|
||||
|
||||
### Arc 3 — Authenticated Gitea reads (→ v1.6.0)
|
||||
|
||||
Built the §19.2 "private-corpus-repo Gitea token" capability:
|
||||
|
||||
- New deployment-record field `gitea_read_secret_ref` (migration 008) — a Secret
|
||||
Manager reference `<project>/<id>[@version]`. Per §3 invariant 1 the record
|
||||
holds the *reference*, not bytes.
|
||||
- `pin.resolve_gitea_token(dep)` resolves it via ADC at read time;
|
||||
`pin.read_gitea_pin` + `audit.read_gitea_file_at_ref` gain `token=` and send
|
||||
`Authorization: token …`.
|
||||
- Threaded the token through `deploy`, `plan`, and `audit`'s default readers
|
||||
(injected readers used verbatim → tests stay offline). Resolution failure →
|
||||
a named `DeployError`/`PlanError`/`scanner_error`, never a silent fallback.
|
||||
- CLI: `deployment add/update --gitea-read-secret-ref` (empty clears it);
|
||||
`deployment show` surfaces it. SPEC §13.11 documents the field.
|
||||
|
||||
17 new tests across pin/audit/deployment/plan/deploy; suite 293 green.
|
||||
|
||||
### Arc 4 — Live validation + the access-gap finding
|
||||
|
||||
Set the deployment record to `wiggleverse-ohm/ohm-rfc-app-gitea-bot-token` (a
|
||||
non-secret reference — within remit) and applied migration 008. `pin check`
|
||||
still 404'd.
|
||||
|
||||
Diagnosed with authed curl (token never printed): the token is valid (whoami =
|
||||
`ohm-bot`), but authed reads of `ben.stull/ohm-rfc` and `ben.stull/rfc-app`
|
||||
**still 404 even on the metadata endpoint**. Listing ohm-bot's accessible repos
|
||||
showed it has read on the `wiggleverse` **org** repos
|
||||
(ohm-content, ohm-rfc-app-flotilla, ohm-session-history, rfc-0001-human, …) but
|
||||
**not** on the two `ben.stull/*` personal-namespace repos.
|
||||
|
||||
Proved flotilla's own client chain works end-to-end: it resolves the real
|
||||
ohm-bot token from Secret Manager and reads `wiggleverse/ohm-rfc-app-flotilla/
|
||||
VERSION` → `1.5.1` (200); the same read anonymously → 404. So the code is
|
||||
correct and complete — the only blocker is the per-repo access grant.
|
||||
|
||||
Shipped **v1.6.0** (merge `70ba3b0`, tag `v1.6.0`), pushed main + tag.
|
||||
|
||||
### Arc 5 — Closing the loop: a dedicated read token (post-publish)
|
||||
|
||||
Worked through the token with the operator. The operator declined to extend
|
||||
the org bot to the personal-namespace repos and instead used a **separate read
|
||||
token**, stored in the secret `ohm-rfc-app-gitea-read-token` (wiggleverse-ohm).
|
||||
I located it (no `wiggleverse-rfc-app` secret exists; the read-token secret was
|
||||
already there) and repointed the deployment record at it:
|
||||
`gitea_read_secret_ref = wiggleverse-ohm/ohm-rfc-app-gitea-read-token`.
|
||||
|
||||
First attempts 401'd: the secret held a stale **188-char** value that isn't a
|
||||
Gitea PAT (40 hex) and was rejected under `token`, `Bearer`, and `?token=`
|
||||
schemes alike — verified without ever printing the bytes. The operator replaced
|
||||
it with a working Gitea PAT whose identity reads both `ben.stull/ohm-rfc` and
|
||||
`ben.stull/rfc-app`.
|
||||
|
||||
Result — fully restored:
|
||||
- `pin check ohm-rfc-app` → resolves `0.31.3` (matches deploys.id=51).
|
||||
- `audit ohm-rfc-app` → **9 findings, scanner_errors=[]** across all four
|
||||
layers. The session-0049 fast-lane finding is confirmed live:
|
||||
`[fast] high py-app/tqdm 4.9.0 → 4.11.2` (GHSA-r7q7-xcjw-qx8q, RCE). Also
|
||||
surfaced: py-app/idna 3.9.0→3.15 (medium), py-app/tqdm CLI-injection + PYSEC
|
||||
(routine), the flotilla/pip set, and os reboot-required. node-app scanned
|
||||
clean.
|
||||
|
||||
So v1.6.0's authenticated reads are proven end-to-end against the real private
|
||||
repos. No code change in this arc — the operator gesture (load a working token)
|
||||
was the last mile.
|
||||
|
||||
---
|
||||
|
||||
## Cut state (end of session)
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| flotilla `main` | `70ba3b0` — v1.6.0 (authenticated Gitea reads) |
|
||||
| flotilla tags | `v1.5.0` (backfilled), `v1.5.1`, `v1.6.0` |
|
||||
| OHM deployment record | `gitea_read_secret_ref` = `wiggleverse-ohm/ohm-rfc-app-gitea-read-token` (dedicated read token, NOT ohm-bot); migration 008 applied to laptop DB |
|
||||
| OHM live | untouched (read-only session; no deploy) |
|
||||
| ohm-rfc pin | `0.31.3` (unchanged) — now readable via token |
|
||||
| OHM radar | `audit` runs clean: 9 findings, **0 scanner_errors**, fast=1 (tqdm RCE) |
|
||||
| Local CLI | editable install @ v1.6.0, suite 293 green |
|
||||
|
||||
| Ledger | Status |
|
||||
| --- | --- |
|
||||
| Fix `flotilla` self-scan layer | ✅ v1.5.1 |
|
||||
| Backfill missing `v1.5.0` tag | ✅ |
|
||||
| Discover + diagnose private-repo breakage | ✅ |
|
||||
| Wire authenticated Gitea reads | ✅ v1.6.0 (code complete + proven live) |
|
||||
| Restore `pin check` / `deploy` / app-layer `audit` live | ✅ dedicated read token loaded; audit clean |
|
||||
|
||||
---
|
||||
|
||||
## §19.2 candidates surfaced / resolved
|
||||
|
||||
- **"private-corpus-repo Gitea token" — RESOLVED in code (v1.6.0).** The field
|
||||
+ token threading exist and are proven. Activation is operator-gated on repo
|
||||
access (below).
|
||||
- **Token identity vs repo ownership** — ohm-bot (org-scoped) can't read the
|
||||
operator's personal-namespace repos. If the OHM content/source repos are meant
|
||||
to be org-owned, moving them to `wiggleverse/*` both unblocks ohm-bot and
|
||||
tidies ownership. Worth a decision.
|
||||
|
||||
---
|
||||
|
||||
## What lands on the operator's plate
|
||||
|
||||
1. ~~Grant ohm-bot read on the two repos~~ — **DONE** (Arc 5): the operator
|
||||
loaded a dedicated read token into `ohm-rfc-app-gitea-read-token` and the
|
||||
record points at it. Radar fully live.
|
||||
2. (Optional) Reconcile [[reference_authoring_lane_token_scope]]: it assumed
|
||||
ohm-bot drives PRs on `ben.stull/ohm-rfc`, but ohm-bot can't currently even
|
||||
*read* it. Verify how PR-driving actually authenticates.
|
||||
3. The tqdm RCE (`GHSA-r7q7-xcjw-qx8q`, fix 4.11.2) is a real fast-lane pin-bump
|
||||
candidate, but needs a fixed **rfc-app** tag to bump to first; the bump rides
|
||||
Track Δ (#37–#42), not this session.
|
||||
|
||||
---
|
||||
|
||||
## Prompt the operator can paste into the next Claude Code session
|
||||
|
||||
```
|
||||
You are picking up after session 0052. Reserve your own session ID via
|
||||
claim-session-id.sh before any work.
|
||||
|
||||
STATE (all pushed):
|
||||
- flotilla main = 70ba3b0 (v1.6.0): authenticated Gitea reads. Tags v1.5.0
|
||||
(backfilled), v1.5.1, v1.6.0 all pushed.
|
||||
- v1.5.1 fixed the `flotilla` audit self-scan layer (now scans the resolved
|
||||
installed env via importlib.metadata — surfaces real pip advisories).
|
||||
- v1.6.0 added the `gitea_read_secret_ref` deployment-record field (migration
|
||||
008) + token-auth on every Gitea raw read (pin/deploy/plan/audit), because
|
||||
the OHM org Gitea repos were made PRIVATE on 2026-05-31 (intentional) and
|
||||
every anonymous read started 404ing.
|
||||
|
||||
BLOCKER: RESOLVED in session 0052.
|
||||
- The deployment record points at wiggleverse-ohm/ohm-rfc-app-gitea-read-token —
|
||||
a DEDICATED read token (NOT ohm-bot, which lacks access to the ben.stull/*
|
||||
personal-namespace repos). Its identity reads both ben.stull/ohm-rfc (pin) and
|
||||
ben.stull/rfc-app (lockfiles). `pin check` resolves 0.31.3; full `audit` runs
|
||||
clean (9 findings, 0 scanner_errors). Nothing to do here — radar is live.
|
||||
|
||||
Run form (osv on PATH + pinned gcloud config):
|
||||
PATH="/opt/homebrew/bin:$PATH" CLOUDSDK_ACTIVE_CONFIG_NAME=wiggleverse \
|
||||
.venv/bin/ohm-rfc-app-flotilla audit ohm-rfc-app
|
||||
|
||||
NEXT MOVES:
|
||||
1. tqdm RCE is live in the pin: py-app/tqdm 4.9.0 has a HIGH RCE
|
||||
(GHSA-r7q7-xcjw-qx8q, fixed 4.11.2) — fast-lane pin-bump candidate, but needs
|
||||
a fixed rfc-app tag to bump to first; the bump rides Track Δ (#37-#42), not
|
||||
the audit verb. (Also live: py-app/idna 3.9.0→3.15, medium.)
|
||||
2. Patchwatch Phase 2: OS unattended-upgrades (security pocket) on the VM +
|
||||
the reboot-required the radar flagged (linux-image-6.1.0-49). Independent
|
||||
of Track Δ.
|
||||
3. Patchwatch cloud runner (proposal §6): Cloud Scheduler → read-only Cloud Run
|
||||
job running `flotilla audit … --json --fail-on`. Now unblocked — the runner's
|
||||
identity will need Secret Manager access to ohm-rfc-app-gitea-read-token (the
|
||||
token approach is proven end-to-end).
|
||||
|
||||
Do NOT build the auto-initiate tier (Phase 5) — depends on Track Δ existing.
|
||||
```
|
||||
Reference in New Issue
Block a user