fabro/docs
Bryan Helmkamp 0a576a5f74
docs(install): address third review pass on web-install spec
Three more fixes:

P0 — Local restart UX. Today's `fabro server start` does not stay
around to supervise the `__serve` child it spawns (`start.rs:318`), so
no auto-restart happens locally after `/install/finish` exits. Spec the
two cases honestly: supervised deployments rely on the supervisor;
local laptops show the operator a "run `fabro server start` to launch
your configured server" message after a 30s polling timeout. A built-in
local supervisor is named as a follow-up. Updated the manual-test
section to cover both cases and the orchestration-docs section to
detect supervised vs. local at boot time.

P1 — Auto-start callers must not enter install mode. `connect_server`
→ `connect_api_client_bundle` → `start::ensure_server_running_for_storage`
is used by `run attach`, `server runs`, etc. Add an explicit *Auto-start
callers* subsection and a new decision: only the explicit `fabro server
start` (or `restart`) command enters install mode. Auto-start callers
fail with a clear "configure first" message pointing the operator at
either `fabro server start` or `fabro install`.

P2 — Process-model rationale corrected. The previous draft claimed the
existing dispatch path "would error on missing settings.toml" but that
is false: `user.rs:77` returns defaults, `serve.rs:820-824` falls back
to a Unix socket, and `tests/it/cmd/server_start.rs:111` is a passing
test of `fabro server start` with no config. Reworded to say what is
actually true — without the fork, `fabro server start` cheerfully boots
a non-functional default server, and install mode displaces that
default. Summary line now mentions the explicit-config caveat too.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-18 19:50:44 -04:00
..
administration docs(digital-ocean): replace stub with Droplet + compose guide 2026-04-18 16:20:01 -04:00
agents refactor(config): move project state under .fabro 2026-04-11 12:55:46 -04:00
api-reference feat(cli): surface debug build profile in version output 2026-04-18 09:44:54 -04:00
brainstorms feat(cli): add --prerelease to fabro upgrade 2026-04-16 20:20:14 -04:00
changelog fix(release): build musl targets via cargo-zigbuild to fix arm64 SIGSEGV 2026-04-18 16:01:45 -04:00
core-concepts docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
examples feat(template): unify workflow and config template syntax 2026-04-11 10:58:50 -04:00
execution refactor(config): move project state under .fabro 2026-04-11 12:55:46 -04:00
getting-started ci(release): attest SLSA build provenance for binaries and image 2026-04-18 15:05:32 -04:00
human-tools docs: migrate reference and guide examples to v2 config shape 2026-04-09 11:30:52 -04:00
ideation docs 2026-04-09 17:24:30 -04:00
images Cut over Fabro web app to a server-backed SPA 2026-04-01 21:36:01 -07:00
integrations docs: update changelog and docs for Apr 14–16 changes 2026-04-16 08:01:59 -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 plans 2026-04-18 12:36:41 -04:00
reference ci(release): attest SLSA build provenance for binaries and image 2026-04-18 15:05:32 -04:00
superpowers/specs docs(install): address third review pass on web-install spec 2026-04-18 19:50:44 -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 refactor(config): move project state under .fabro 2026-04-11 12:55:46 -04:00
.mintignore Fix Mintlify dev server: valid navbar URL and ignore AGENTS.md 2026-03-05 16:29:50 -05:00
docs.json ci(release): attest SLSA build provenance for binaries and image 2026-04-18 15:05:32 -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