@misterhuydo/cairn-mcp 1.1.0 → 1.1.2

package/README.md

@@ -239,21 +239,28 @@ cairn_resume()
 2. cairn_search       → continue where you left off
 ```
 
----
-
-## Custom DB path
-
-By default the index is stored at `.cairn/index.db` in your project directory. Override with an env variable:
+## Complete session lifecycle
 
-```json
-{
-  "mcpServers": {
-    "cairn": {
-      "command": "cairn-mcp",
-      "env": { "CAIRN_DB_PATH": "/your/custom/path/index.db" }
-    }
-  }
-}
+```
+─── START OF SESSION ──────────────────────────────────────────
+You:    "Hey Claude, please resume and continue"
+Claude: cairn_resume
+        → "Last session: adding multi-currency to checkout.
+           PaymentStep.vue was modified since checkpoint (2 files changed, re-indexed).
+           Notes: CurrencyService expects ISO 4217 codes. PaymentStep EUR bug not fixed yet.
+           Ready to continue."
+
+─── DURING SESSION ────────────────────────────────────────────
+Claude uses: cairn_search, cairn_bundle, cairn_code_graph, cairn_security
+             as needed — all reading from .cairn/index.db in cwd
+
+─── END OF SESSION ────────────────────────────────────────────
+You:    "Ok let's stop here for today"
+Claude: cairn_checkpoint
+          message="Fixed EUR formatting in PaymentStep, multi-currency complete"
+          active_files=["src/components/checkout/PaymentStep.vue"]
+          notes=["Still need to add JPY — no decimal places", "QA needs to test AED"]
+        → "Session saved. Resume anytime with cairn_resume."
 ```
 
 ---

package/how-to-use.md

@@ -24,36 +24,73 @@ Add to `~/.claude/config.json` (create it if it doesn't exist):
 
 > If you already have other MCP servers, just add `"cairn": { ... }` inside the existing `"mcpServers"` block.
 
-Restart Claude Code. You should see 6 cairn tools available.
+Restart Claude Code. You should see 8 cairn tools available.
 
-## 3. Index your repos
+## 3. Index your project
+
+Run Claude Code from your project root, then:
 
 ```
 cairn_maintain
-  roots: ["/path/to/repo1", "/path/to/repo2"]
 ```
 
-Run this once at the start of each session (or whenever code changes significantly).
+No paths needed — Cairn works like git and finds your project from the current directory. The index is stored in `.cairn/index.db` inside your project.
+
+Run this once at the start of each session (or use `cairn_resume` to pick up where you left off).
 
 ## 4. Tools at a glance
 
 | Tool | What to use it for |
 |---|---|
-| `cairn_maintain` | Index repos (run first) |
+| `cairn_maintain` | Index the current project (run at session start) |
 | `cairn_search` | Find classes, functions, components by name or concept |
 | `cairn_describe` | Summarize what a folder/module does |
 | `cairn_code_graph` | Check instability, health, or cycles before refactoring |
 | `cairn_security` | Scan for vulnerabilities (XSS, SQLi, hardcoded secrets, etc.) |
 | `cairn_bundle` | Package source files into a minified snapshot for Claude to read |
+| `cairn_checkpoint` | Save what you're working on so the next session can resume |
+| `cairn_resume` | Restore the last checkpoint + incremental re-index of changed files |
 
 ## 5. Typical session
 
+**Starting fresh:**
+```
+1. cairn_maintain     → index the project
+2. cairn_search       → find what you need
+3. cairn_bundle       → get a readable snapshot of relevant files
+4. cairn_describe     → understand a module before modifying it
+5. cairn_security     → check for issues before a PR
+6. cairn_checkpoint   → save your progress before ending the session
+```
+
+**Resuming work:**
+```
+1. cairn_resume       → restore last checkpoint + re-index only changed files
+2. cairn_search       → continue where you left off
+```
+
+## 6. Complete session lifecycle
+
 ```
-1. cairn_maintain   → index all repos
-2. cairn_search     → find what you need
-3. cairn_bundle     → get a readable snapshot of relevant files
-4. cairn_describe   → understand a module before modifying it
-5. cairn_security   → check for issues before a PR
+─── START OF SESSION ──────────────────────────────────────────
+You:    "Hey Claude, please resume and continue"
+Claude: cairn_resume
+        → "Last session: adding multi-currency to checkout.
+           PaymentStep.vue was modified since checkpoint (2 files changed, re-indexed).
+           Notes: CurrencyService expects ISO 4217 codes. PaymentStep EUR bug not fixed yet.
+           Ready to continue."
+
+─── DURING SESSION ────────────────────────────────────────────
+Claude uses: cairn_search, cairn_bundle, cairn_code_graph, cairn_security
+             as needed — all reading from .cairn/index.db in cwd
+
+─── END OF SESSION ────────────────────────────────────────────
+You:    "Ok let's stop here for today"
+Claude: cairn_checkpoint
+          message="Fixed EUR formatting in PaymentStep, multi-currency complete"
+          active_files=["src/components/checkout/PaymentStep.vue"]
+          notes=["Still need to add JPY — no decimal places", "QA needs to test AED"]
+        → "Session saved. Resume anytime with cairn_resume."
 ```
 
 ---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@misterhuydo/cairn-mcp",
-  "version": "1.1.0",
-  "description": "Persistent polyglot knowledge graph MCP server for Claude Code. Index once, query forever — across Java, TypeScript, Vue, Python, SQL and more.",
+  "version": "1.1.2",
+  "description": "MCP server that gives Claude Code persistent memory across sessions. Index your codebase once, search symbols, bundle source, scan for vulnerabilities, and checkpoint/resume work — across Java, TypeScript, Vue, Python, SQL and more.",
   "type": "module",
   "main": "index.js",
   "bin": {

package/src/graph/db.js

@@ -1,13 +1,7 @@
 import { DatabaseSync } from 'node:sqlite';
 import path from 'path';
-import fs from 'fs';
 import { getCairnDir } from './cwd.js';
 
-function getDbPath() {
-  if (process.env.CAIRN_DB_PATH) return process.env.CAIRN_DB_PATH;
-  return path.join(getCairnDir(), 'index.db');
-}
-
 const SCHEMA = `
   CREATE TABLE IF NOT EXISTS files (
     id           INTEGER PRIMARY KEY,
@@ -61,9 +55,7 @@ const SCHEMA = `
 `;
 
 export function openDB() {
-  const dbPath = getDbPath();
-  const dir = path.dirname(dbPath);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  const dbPath = path.join(getCairnDir(), 'index.db');
 
   const db = new DatabaseSync(dbPath);
   db.exec('PRAGMA journal_mode = WAL');