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

docs/SPAWN.md says what tell-me and take-updates do now, with a test that keeps it honest #2660

shipped production is serving it opened this has it
opened this

docs/SPAWN.md (around line 86–93) still says the follow modes are "the owner's recorded choice" that nothing acts on. Since #2631–#2656 they act: an hourly check fetches the parent's code; tell-me sends one inbox card per new tip with its commits; take-updates opens or updates one take pull that a person merges; the chain page, API, terminal and MCP offer take-now; sever stops it all.

Done looks like:

  • [ ] A section "Following the parent forge" in docs/SPAWN.md says the above in a few short paragraphs: what is fetched and where (refs/upstream/*, upstream.json), how often (CHECK_MS), what each mode does, the take branch name, and what never happens (main is never moved, nothing auto-merges). It replaces the stale sentences.
  • [ ] A test reads the doc and fails if CHECK_MS, TAKE_BRANCH or either value of FOLLOW_MODES (from src/spawn/upstream.ts, src/spawn/take.ts and src/spawn/chain.ts) is not in it, the way test/cluster-doc.test.ts keeps docs/CLUSTER.md honest. Name it in GATE in scripts/gate.ts.
  • [ ] Run bun x tsc --noEmit and the new test.
Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs