docs(issue-62): add relay plan for AuthStorage->ModelRuntime migration

2026-07-17 20:29:21 +02:00
parent 9436c308c3
commit 8225cf6fcd
3 changed files with 235 additions and 0 deletions
@@ -0,0 +1,47 @@
+# Relay log — issue-62-authstorage
+
+Append-only. One concise entry per leg. Do not read end-to-end for orientation;
+use `status.md`. Targeted lookups only.
+
+---
+
+## Leg 0 — Planning (assessment + relay packet)
+
+**Did:**
+- Read issue #62 and confirmed the crash: static `import { AuthStorage }` fails
+  at ESM load with Pi 0.80.8+.
+- Investigated all `AuthStorage`/`ModelRegistry` usage in `src/` (3 production
+  files + 5 test/support files under `src/server/sessions/`; other
+  pi-coding-agent imports unaffected).
+- Downloaded and diffed real npm tarballs (pi-coding-agent 0.80.7/0.80.8/0.80.10
+  and pi-ai 0.80.7/0.80.8) into `/srv/dev/pi-inspect` (scratch, outside repo) to
+  establish the exact new export surface: `AuthStorage` and its backends removed
+  from exports; new `ModelRuntime` (async) + `readStoredCredential`; changed
+  `ModelRegistry` (constructed from a runtime, `refresh()` now async, no
+  `authStorage`); pi-ai `CredentialStore`/`InMemoryCredentialStore`/
+  `AuthInteraction` model. Confirmed 0.80.8 and 0.80.10 `.d.ts` are identical
+  for the affected files (stable target).
+- Wrote `ASSESSMENT-issue-62.md` (root).
+
+**Decisions:**
+- **Clean migration to `ModelRuntime`, no dual-version compat shim.** Rationale:
+  sync→async, credential-store contract change, OAuth callback contract change,
+  and session-services option change span both surfaces with no small clean
+  adapter; 0.80.0–0.80.7 is already broken/superseded (`latest` = 0.80.10).
+- **Dep range fix:** peerDeps `>=0.80.0 <1` → `>=0.80.8 <0.81` for all three
+  `@earendil-works/*` packages; upper bound `<0.81` because this line ships
+  breaking changes within `0.80.x`.
+- Relay packet placed under `relays/issue-62-authstorage/` (committed; not in
+  `package.json` `files`, so not published; `.pi-web/` is gitignored so not used).
+
+**Artifacts changed:** `ASSESSMENT-issue-62.md`;
+`relays/issue-62-authstorage/{charter,status,log}.md`.
+
+**Status update:** last completed leg 0, next leg 1 = charter slice 0
+(Bootstrap: install Pi 0.80.8+, correct dep ranges).
+
+**Blockers:** none. Noted `/tmp` disk-quota issue (install in worktree) and the
+pending sessiond restart for later daemon-path slices.
+
+**Handoff:** Planning only — NOT auto-spawning the first implementation leg.
+Assessment + relay plan are laid out ready to be kicked off by the user.