Documentation
README
Recovering Observal
Execution contract
- Execute commands with a 60 second timeout unless the operation documents a longer wait.
- Use machine output by default: add
--output jsonwhenever supported. Parse list results fromitemsand pagination fields. - Run
--helpbefore acting when a path or flag is uncertain. - Use dry run before reconciliation when scope or session volume is uncertain.
- Supply documented force flags so version operations never prompt.
- Verify cursor, outbox, installed version, checksum, and rollback state after recovery operations.
- Fail openly. Never hide an unavailable server behind automatic local writes.
- Never retry reconciliation, version changes, or fallback writes without checking resulting state.
This is the opening of the README. Read the full README on GitHub.