fabro/docs/plans
Bryan Helmkamp 7d83f2448c
docs(plans): write Stage 6 handoff for settings TOML redesign
Comprehensive handoff document that the engineer picking up the
settings redesign can use to continue the work. Captures:

- TL;DR of what's landed vs what remains
- Source document references (brainstorm, plan, canonical example)
- Current-state tree map with file-level annotations
- Full dependency chain from TOML -> v2 -> bridge -> consumers
- Commit log for Stages 1-5 (13 commits, 76 files, +6413/-2151)
- Stage 6 broken into six independent subtasks: consumer migration,
  bridge deletion, legacy type deletion, fabro-config shim deletion,
  v2 namespace flattening, OpenAPI + clients + fabro-web rewrite
- Concrete before/after migration patterns with InterpString examples
- Testing gotchas I hit during Stages 1-5: fabro-cli parallel test
  daemon FD limit, insta snapshot pending review, hook shorthand vs
  #[serde(flatten)] duplicate-command collision, fabro-test managed
  marker detection, apply_server_defaults full-shape propagation,
  user layer trust boundary, pre-existing fabro-interview test clippy
  warnings
- Open design questions the next engineer needs to decide: ConfigLayer
  resolve naming, post-layering interpolation pass, fail-closed auth,
  ModelRegistry runtime wiring, run.scm provider depth, serde flatten+
  HashMap+deny_unknown_fields constraint
- Verification recipes (full gate, legacy key sanity grep, bridge
  caller sanity grep)
- Explicit success criteria for Stage 6 completion
2026-04-09 11:54:44 -04:00
..
2026-04-02-001-feat-server-daemon-management-plan.md Add server daemon management with Unix socket support 2026-04-02 10:40:19 -07:00
2026-04-02-002-feat-http-store-client-auto-start-plan.md refactor(cli): route run state through the shared server daemon 2026-04-05 00:15:33 -04:00
2026-04-04-run-event-simplification-plan.md refactor: simplify run event representation 2026-04-04 12:59:42 -04:00
2026-04-04-shared-nextest-test-daemon-plan.md refactor(cli): route run state through the shared server daemon 2026-04-05 00:15:33 -04:00
2026-04-05-cli-deglobalize-server-url-and-storage-dir-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-05-cli-exec-explicit-local-and-mode-removal-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-05-cli-model-server-canonical-and-llm-removal-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-05-cli-run-lifecycle-cleanup-compaction-plan.md plan 2026-04-05 11:03:02 -04:00
2026-04-05-run-adjacent-server-only-cleanup-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-05-run-create-server-target-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-05-run-manifest-and-preflight-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-05-server-canonical-secrets-doctor-repo-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-06-cli-config-socket-storage-separation-plan.md plans 2026-04-06 10:17:30 -04:00
2026-04-06-object-backed-artifact-uploads.md refactor(artifacts): clean up stale artifact wording 2026-04-07 23:13:22 -04:00
2026-04-06-settings-command-server-local-merge-plan.md plan 2026-04-06 10:43:41 -04:00
2026-04-06-subprocess-run-workers-signal-control-plan.md plans 2026-04-07 10:30:40 -04:00
2026-04-07-fix-attach-terminal-authoritative-stream-plan.md plans 2026-04-07 16:05:11 -04:00
2026-04-07-global-cas-blob-refs-plan.md plans 2026-04-07 17:18:42 -04:00
2026-04-07-interview-control-channel-and-server-slack-plan.md feat: embed fabro spa and align interruption semantics 2026-04-08 14:43:44 -04:00
2026-04-07-run-manifest-blobs-and-bundle-removal-plan.md plan 2026-04-07 23:44:44 -04:00
2026-04-07-run-state-projection-consolidation-plan.md plans 2026-04-07 16:05:21 -04:00
2026-04-07-store-dump-server-owned-export-plan.md plans 2026-04-07 17:18:42 -04:00
2026-04-07-worker-http-only-run-store-migration-plan.md plans 2026-04-07 16:05:11 -04:00
2026-04-08-001-feat-fabro-uninstall-command-plan.md feat(cli): add fabro uninstall command 2026-04-08 16:31:32 -04:00
2026-04-08-cli-services-command-context-refactor-plan.md plan 2026-04-08 16:24:11 -04:00
2026-04-08-fabro-spa-asset-crate-plan.md feat: embed fabro spa and align interruption semantics 2026-04-08 14:43:44 -04:00
2026-04-08-optional-web-ui-server-plan.md docs(plan): add optional web ui server plan 2026-04-08 16:09:42 -04:00
2026-04-08-production-web-ui-test-plan.md test: add test plan for production web UI implementation 2026-04-08 04:28:47 -04:00
2026-04-08-production-web-ui.md plan: revise production web UI plan to fix demo get_run_status, files tab, and Playwright config 2026-04-08 04:17:54 -04:00
2026-04-09-settings-toml-redesign-handoff.md docs(plans): write Stage 6 handoff for settings TOML redesign 2026-04-09 11:54:44 -04:00