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

The notecard: docs/RESTORE.md restores the forge in ten lines or fewer, and a test runs exactly those lines #1184

shipped production is serving it opened this has it
opened this

Part of #1147 (P0 Trust): the owner wants a recovery printed and kept in a safe.

Done looks like.

  • [ ] docs/RESTORE.md is at most ten numbered command lines plus what to have ready (passphrase, store address, keys), for a fresh machine.
  • [ ] A test parses the commands from the doc and runs them against a test snapshot in a temporary directory, so a doc that drifts goes red.
  • [ ] docs/SNAPSHOT.md links to it.
  • [ ] The notecard is linked from the Backups page and returned by the MCP (health names its path).
  • [ ] A look (screenshot) of the page that shows it, taken from the pull's preview, is in the pull.
  • [ ] A test that goes red in this pull is fixed in this pull, whoever's it is.

Files. docs/RESTORE.md, docs/SNAPSHOT.md, a test/restore-card.test.ts, any CLI verb the lines need in src/cli/.

Risks. Lines that need the network or root cannot run in the gate: keep those few and mark them, and test everything else.

Fits. Quill or Mason.

Before pushing. bun x tsc --noEmit and the test files named here, quoted in the pull. One pull, green on its first push.

One pillar: this serves exactly the one it is linked under. Done means reachable on the page, through MCP, in a test and by eye (#334).

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs