Skip to content

Commit a7316ac

Browse files
committed
docs(cli): note requires: [...] fail-fast on missing provider package (#1597)
`os start` "What it boots" listed `requires: [...]` auto-registration but predated the intent-driven fail-fast behavior. Clarify that a declared service capability whose provider package isn't installed aborts boot (fail-fast), and call out that `auth`/`ui` are the tier-gated exceptions with their own opt-in rules. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TjHfkKmEvgk8v7N8nTe5sH
1 parent 1297d54 commit a7316ac

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

  • content/docs/getting-started

content/docs/getting-started/cli.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -315,7 +315,7 @@ os start
315315

316316
**What it boots:**
317317
- Reads the artifact's `manifest`, `objects`, `views`, `flows`, …
318-
- Auto-registers the platform services declared in `requires: [...]` (e.g. `ai`, `automation`, `analytics`, `auth`, `ui`)
318+
- Auto-registers the platform services declared in `requires: [...]` (e.g. `ai`, `automation`, `analytics`, `auth`, `ui`). Declaring a **service** capability (`automation`, `analytics`, `ai`, `audit`, …) is a *requirement*: if its provider package isn't installed, boot **fails fast** with a clear error instead of silently starting without a capability you asked for. (`auth` and `ui` are tier-gated with their own opt-in rules — `auth`'s secret-gated skip is described below.)
319319
- Auto-detects the driver from the database URL scheme (`memory://` → in-memory, `libsql://`/`https://` → Turso, `postgres[ql]://`/`pg://` → pg, `mongodb[+srv]://` → MongoDB, otherwise sqlite)
320320
- Runs standalone boot mode with one active environment.
321321

0 commit comments

Comments
 (0)