@misterhuydo/cairn-mcp 1.1.1 → 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

@@ -69,6 +69,30 @@ Run this once at the start of each session (or use `cairn_resume` to pick up whe
 2. cairn_search       → continue where you left off
 ```
 
+## 6. Complete session lifecycle
+
+```
+─── 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."
+```
+
 ---
 
 **Requirements:** Node.js >= 22.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misterhuydo/cairn-mcp",
-  "version": "1.1.1",
+  "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",

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');