fabro/docs
Bryan Helmkamp 57d0132273 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
..
administration docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
agents docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
api-reference docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
brainstorms feat(artifacts): remove scratch artifact cache staging 2026-04-08 17:42:55 -04:00
changelog docs 2026-04-06 16:57:34 -04:00
core-concepts docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
examples Attractor spec hunks 9-11: edge selection fallback and default_max_retries rename 2026-03-23 14:20:24 -04:00
execution docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
getting-started Remove deprecated fabro init command 2026-03-30 16:17:38 -04:00
human-tools docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
ideation feat(cli): add fabro uninstall command 2026-04-08 16:31:32 -04:00
images Cut over Fabro web app to a server-backed SPA 2026-04-01 21:36:01 -07:00
integrations docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
languages Add fabro language for syntax highlighting in docs 2026-03-17 09:43:14 -04:00
logo Fix logo SVG viewBox clipping the right edge of the O 2026-03-14 14:11:36 -04:00
plans docs(plans): write Stage 6 handoff for settings TOML redesign 2026-04-09 11:54:44 -04:00
reference docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
tutorials Attractor spec hunks 14 & 16: remove error_policy and k_of_n/quorum from parallel handler 2026-03-23 14:59:35 -04:00
workflows docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
.mintignore Fix Mintlify dev server: valid navbar URL and ignore AGENTS.md 2026-03-05 16:29:50 -05:00
docs.json chore: remove workflows and steer endpoints 2026-04-07 08:25:54 -04:00
dot-highlight.js Remove debug markers from dot-highlight script 2026-03-17 10:23:48 -04:00
favicon.svg Rebrand docs site from Arc to Fabro 2026-03-11 21:27:58 -04:00