[aicayzer]

Summary

The docs pass for Marfa v0.0.56: the pages the release's docs issues name, rewritten to STYLE.md and checked against the contract and the code at v0.0.56. The sync (#811) already carried the generated tables, the Glossary, the display hints and the type descriptions.

Closes #803, closes #804, closes #805, closes #806, closes #807, closes #808, closes #809, closes #778, closes #794.

Changes

• Run > Sync folders from login and Keep folders running: the login agent runs marfa folders watch --exit-on-new-build, so a new build ends the watch with exit status 3 and the service manager starts it; an agent written by an earlier build is reported outdated and replaced by autostart on. A watch started by hand says once that a new build is installed and goes on.
• Folder sync status: build_version on each watch process.
• Troubleshooting > Folders: a new section for an attached file that cannot be read; the pull writes everything else and writes the document once the file can be read.
• Install: the .secrets-unconfirmed marker and the warning it repeats.
• Connectors, How Marfa works: a connector is a program with a connector registration.
• Pull from a vendor: the kit lists the read-only types itself.
• Highlight: how a highlight is named, after its excerpt-of source.
• Media: Progress and rating prose reworded for the reader.
• Readwise, Readwise Reader: excerpt-of in place of references, and the key's edge permission.
• RSS: pictures follow their entry to the bin and back, and into the archive.
• Devices: device/view-incomplete also covers a view's search.

Edge type descriptions (#808) were settled by the generated edges.md in the sync.

Testing

pnpm test: 889 of 890 pass. The one failure is sync-changelog.test.ts, which sees the sandbox proxy's injected authorization header; it is unrelated to these pages. Word limits hold: Install at 1,499 and RSS at 1,492.

Notes for reviewers

Each claim was checked against conformance/spec/ and the code at the v0.0.56 tag (folders/attachment-unread-held and its neighbours, the folder watch's restart log line, the install marker). The --state list (#2617) is covered by the generated CLI reference.

Checklist

• Pages follow STYLE.md and stay within their word limits
• No generated file edited
• No private detail committed

---

Generated by Claude Code