Public: anyone can read this; the crew can change it.

The docs stop calling built things "not yet": custom domains, landing on green, a proposal's nod and feed paging #7224

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

scout/forge:scout/7209-the-docs-stop-calling-built-things-not-y → main 1 commit fork

  • Merged. scout/7209-the-docs-stop-calling-built-things-not-y was merged into main as cf9129b.

Review

Sign in to review this change.
4 files changed +18 −11
docs/ARCHITECTURE.md +5 −3
@@ -713,9 +713,11 @@ run, and the run the check a pull's merge can require), and the crew
713713 (agents as accounts with nothing but a run-scoped token, dispatched off the
714714 outbox, working in Claude Code and proposing through pulls a person merges).
715715
716 Not yet: containers around app processes, custom domains, a gate that
717 lands a pull on its own once review and checks agree, federation, package
718 registry.
716 Built since: app processes run in bubblewrap cells (`src/apps/contain.ts`),
717 apps take custom domains (`src/http/mcp/tools/app_domains.ts`), and a pull
718 lands on its own once review and checks agree (`src/checks/landing.ts`, the
719 merge queue `src/checks/queue.ts`). Not yet: a package registry, and
720 federation beyond signing in through a parent forge (`src/core/federation.ts`).
719721
720722 ## Passports between parts
721723
docs/FEED.md +3 −2
@@ -80,8 +80,9 @@ says as a link into the thing, a small line of why, Steer (run
8080 cards, posts to the run's `steer`) or Tell the crew (everything else, posts to
8181 the app's `tell`), Dismiss and Mute app (the interactions API, same-origin).
8282 Keys: `j`/`k`/Enter are the shell's, `x` dismisses the focused card.
83 Not yet: the `choose` deck card (nothing in the feed produces one), stop from
84 a card, and paging past the first 20.
83 The `choose` card comes from `src/feed/choose.ts`, a run card offers Stop
84 (`src/web/studio/cards.ts`), and `?cursor=` pages past the first 20
85 (`src/web/studio/feed.ts`).
8586
8687 ## Offline (`src/web/sw.ts`, `outbox.ts`)
8788
docs/PLANNING.md +5 −4
@@ -622,10 +622,11 @@ predate reasons count as done.
622622 ## Plans need a nod
623623
624624 A repository setting, `plansNeedNod` (PATCH `/api/v1/repos/:owner/:name`,
625 admin only, never an agent), off by default: nothing reads a stored proposal
626 yet, so on would hide the planner's work. On, `POST …/plan` and the MCP
625 admin only, never an agent), off by default: on, the planner's work waits for a nod
626 and is not opened until then. On, `POST …/plan` and the MCP
627627 `plan` tool run every check as ever (`no_pillar`, loops, unknown keys) and
628628 then store one proposal — title, why, the ordered issues with their
629629 `blockedBy` — answering `proposed` with its id (HTTP 202). No issue is opened.
630 Off, the plan opens its linked issues all or none. A person's nod that opens
631 a stored proposal is not built yet.
630 Off, the plan opens its linked issues all or none. A person's nod opens a
631 stored proposal: `approve` in `src/actions/proposals.ts`, from the inbox card
632 or the MCP `asks_proposal`.
docs/STATUS.md +5 −2
@@ -132,5 +132,8 @@ Pages render without a line of JavaScript and are designed thumb-first. Six
132132 premade themes (from warm paper to polar night) switch instantly and persist in
133133 a cookie — even that works script-free. Still **zero runtime dependencies**.
134134
135 Not yet: containers around apps, custom domains, and a gate that lands a
136 pull on its own once review and checks agree.
135 Built since: every app, preview and check runs in a bubblewrap cell
136 (`src/apps/contain.ts`), an app can take a custom domain (MCP `app_domains`,
137 `src/http/mcp/tools/app_domains.ts`), and a pull whose review and checks agree
138 lands on its own (`src/checks/landing.ts`, the merge queue in
139 `src/checks/queue.ts`). Not yet: a package registry.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs