git clone https://github.com/duke-of-beans/CONTINUITY.git
cd CONTINUITY
npm install --include=dev
npm run build

{
  "mcpServers": {
    "CONTINUITY": {
      "command": "node",
      "args": ["/path/to/CONTINUITY/dist/index.js"],
      "env": {
        "CONTINUITY_DATA_DIR": "/path/to/your/.continuity"
      }
    }
  }
}

.continuity/
├── config.json       # Settings (auto-generated with defaults)
├── state.db          # SQLite database
├── sessions/         # JSON state snapshots + markdown handoffs
└── decisions/        # JSONL decision log

Session Start:
  → continuity_recover_crash()   # Check for unclean shutdown
  → continuity_load_session()    # Load last session context

During Work:
  → continuity_checkpoint()      # Every 3-5 tool calls
  → continuity_log_decision()    # When architectural choices are made

Session End:
  → continuity_handoff_quality() # Validate completeness
  → continuity_save_session()    # Generate handoff for next session

continuity_log_decision({
  workspace: "my-project",
  category: "architectural",
  decision: "Use PostgreSQL over Neo4j",
  rationale: "Simpler ops, graph extension covers graph needs",
  alternatives: ["Neo4j", "DGraph", "ArangoDB"],
  impact: "high",
  revisit_trigger: "If graph queries exceed 10K nodes/sec"
})

continuity_query_decisions({ keyword: "database", workspace: "my-project" })
// → Returns the decision with full rationale, preventing re-debate

continuity_recover_crash({ workspace: "my-project" })
// → Detects unclean shutdown
// → Returns last checkpoint with active files, next steps, recovery context
// → Zero context loss if checkpoints were regular

Storage Layer
├── SQLite (state.db)        → Checkpoints, session records, fast queries
├── JSONL (decisions.jsonl)  → Append-only architectural decision log
└── JSON (sessions/*.json)   → Full session state snapshots + markdown handoffs

Tool Modules
├── session-tools.ts    → save, load, checkpoint, crash recovery
├── decision-tools.ts   → log + query architectural decisions
└── utility-tools.ts    → compression, handoff validation

Server
└── mcp-server.ts       → MCP SDK wiring, tool registration, error handling