continuum-ai-mcp 1.0.0

package/README.md

@@ -0,0 +1,274 @@
+# Continuum
+
+**AI Development Memory Layer — Universal Language Support**
+
+> Give your AI coding assistant persistent memory across context windows. Continuum is a local MCP server that watches your codebase, indexes symbols from 14+ languages, tracks your session state, and lets AI assistants resume exactly where they left off — even after context compaction.
+
+[![CI](https://github.com/yourusername/continuum/actions/workflows/ci.yml/badge.svg)](https://github.com/yourusername/continuum/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org)
+
+---
+
+## The Problem
+
+AI coding assistants lose all context when their conversation fills up (context compaction). Every time this happens:
+- You re-explain the goal from scratch
+- The AI re-reads files it already processed
+- Architectural decisions get forgotten
+- Momentum is lost
+
+**Continuum fixes this.** It persists session state in a local SQLite database and exposes it through MCP tools so any AI assistant can instantly recover full context.
+
+---
+
+## Architecture
+
+```
+Your Codebase
+     │  (chokidar file watcher)
+     ▼
+FileWatcher ──► IncrementalParser ──► SQLite (knowledge.db)
+                  (14 languages)          │
+                                    ┌─────┴──────┐
+                                    │ Symbols     │
+                                    │ Sessions    │
+                                    │ Tasks       │
+                                    │ FTS5 Index  │
+                                    └─────┬───────┘
+                                          │
+                                    McpServer (stdio)
+                                    10 MCP Tools
+                                          │
+                              Claude Code / Cursor / Copilot
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Clone
+git clone https://github.com/yourusername/continuum
+cd continuum
+
+# 2. Install
+npm install --legacy-peer-deps
+
+# 3. Configure
+cp .env.example .env
+# Edit .env: set WATCH_PATHS to your project's src directory
+
+# 4. Run (development)
+npm run dev
+
+# 5. Build (production)
+npm run build
+npm start
+```
+
+---
+
+## Wire to Claude Code
+
+Create `.vscode/mcp.json` in **your project's root** (not inside continuum/):
+
+```json
+{
+  "mcpServers": {
+    "continuum": {
+      "command": "node",
+      "args": ["/absolute/path/to/continuum/dist/mcp/McpServer.js"],
+      "cwd": "/absolute/path/to/continuum",
+      "env": {
+        "WATCH_PATHS": "${workspaceFolder}/src",
+        "DB_PATH": "/absolute/path/to/continuum/knowledge.db",
+        "LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+For development (no build step):
+```json
+{
+  "mcpServers": {
+    "continuum": {
+      "command": "npx",
+      "args": ["tsx", "src/mcp/McpServer.ts"],
+      "cwd": "/absolute/path/to/continuum"
+    }
+  }
+}
+```
+
+Reload VS Code (`Cmd+Shift+P` on Mac / `Ctrl+Shift+P` on Windows → Developer: Reload Window). Verify: ask Claude "what tools do you have?" — you should see all 10 Continuum tools.
+
+---
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_session` | 🔄 **Core recovery tool.** Get full session state — call after any context compaction |
+| `save_task` | 💾 Save structured task state (goal, decisions, next steps, open questions) |
+| `get_touched_files` | 📁 Files modified/created/deleted this session |
+| `find_related_files` | 🔍 Cross-layer search for symbols, features, and files |
+| `search_symbols` | 🔎 Full-text search all indexed symbols (FTS5) |
+| `get_schema` | 🗄️ Live DB schema for a table (MSSQL/PostgreSQL/MySQL, cached 1h) |
+| `get_dependencies` | 🕸️ Symbols defined in a file + outgoing relationships |
+| `list_languages` | 🌍 All supported languages with indexed file/symbol counts |
+| `get_session_report` | 📊 Session metrics: tool calls, files touched, estimated tokens saved |
+| `health_check` | 🩺 Server health, uptime, DB status |
+
+---
+
+## Slash Commands
+
+Create these in your project's `.claude/commands/` folder:
+
+| Command | Action |
+|---------|--------|
+| `/resume` | Recover full session after compaction — continue without re-explaining |
+| `/checkpoint` | Proactively save task state before context fills |
+| `/task [description]` | Start a task with full codebase context pre-loaded |
+| `/report` | Show session efficiency metrics |
+
+---
+
+## Supported Languages
+
+| Language | Extensions | Symbol Types |
+|----------|-----------|--------------|
+| TypeScript | `.ts`, `.tsx` | class, interface, function, enum, type, method, property |
+| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | class, function, method |
+| Python | `.py`, `.pyw` | class, function, method, async def |
+| Rust | `.rs` | struct, enum, trait, fn, mod, type, impl |
+| Go | `.go` | func, method, struct, interface, type |
+| Java | `.java` | class, interface, enum, method, constructor |
+| C# | `.cs` | class, interface, enum, struct, record, method, property |
+| C/C++ | `.c`, `.cpp`, `.h`, `.hpp` | class, struct, function, method |
+| Ruby | `.rb`, `.rake` | class, module, def, method |
+| PHP | `.php` | class, interface, trait, enum, function, method |
+| Swift | `.swift` | class, struct, protocol, enum, func, extension |
+| Kotlin | `.kt`, `.kts` | class, interface, enum, object, fun |
+| SQL | `.sql` | TABLE, VIEW, PROCEDURE, FUNCTION, TYPE, INDEX |
+| Markdown | `.md`, `.mdx` | H1 (doc), H2 (section), H3 (subsection) |
+
+**Adding a new language:** Create a file in `src/languages/definitions/yourlanguage.ts`, call `registerLanguage()` with your rules, and import it in `LanguageRegistry.ts`. No other changes needed.
+
+---
+
+## Database Schema (Optional)
+
+Enable the `get_schema` tool by setting `DB_TYPE` in `.env`:
+
+```bash
+# PostgreSQL
+DB_TYPE=postgres
+PG_HOST=localhost
+PG_PORT=5432
+PG_DATABASE=myapp
+PG_USER=myuser
+PG_PASSWORD=mypassword
+
+# MSSQL
+DB_TYPE=mssql
+MSSQL_HOST=localhost
+MSSQL_DATABASE=myapp
+MSSQL_USER=myuser
+MSSQL_PASSWORD=mypassword
+
+# MySQL / MariaDB
+DB_TYPE=mysql
+MYSQL_HOST=localhost
+MYSQL_DATABASE=myapp
+MYSQL_USER=myuser
+MYSQL_PASSWORD=mypassword
+```
+
+---
+
+## Configuration Reference
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `WATCH_PATHS` | `./src` | Comma-separated paths to watch |
+| `DB_PATH` | `./knowledge.db` | SQLite database location |
+| `LOG_LEVEL` | `info` | `debug` \| `info` \| `warn` \| `error` |
+| `NODE_ENV` | `development` | Set to `production` for JSON logs |
+| `DB_TYPE` | _(none)_ | `mssql` \| `postgres` \| `mysql` |
+
+---
+
+## Development
+
+```bash
+npm run dev          # Run with tsx (no build step)
+npm run type-check   # TypeScript strict check
+npm run lint         # ESLint
+npm run format       # Prettier
+npm test             # Vitest
+npm run test:watch   # Vitest watch mode
+npm run test:coverage # Coverage report
+npm run build        # Production TypeScript compile
+```
+
+### Docker
+
+```bash
+docker build -t continuum .
+docker compose up -d
+```
+
+---
+
+## How It Works
+
+1. **Startup**: Continuum creates a new session UUID in SQLite and starts watching your configured paths.
+2. **Indexing**: Every file change triggers incremental parsing. The file's MD5 hash is checked — unchanged files are skipped. New symbols are extracted and stored in SQLite with FTS5 indexing.
+3. **Session tracking**: Every file change after the initial scan is recorded as a `touched_file` event (debounced to 5 seconds per path).
+4. **MCP tools**: Your AI assistant calls tools via stdio. `save_task` checkpoints the current goal and decisions; `get_session` recovers them after compaction.
+5. **Schema cache**: `get_schema` fetches live database schema and caches it in SQLite for 1 hour.
+
+---
+
+## Troubleshooting
+
+**Claude Code doesn't see the tools**
+→ Reload VS Code after editing `mcp.json`. Check `npm run dev` starts without errors.
+
+**File changes not being indexed**
+→ Ensure `WATCH_PATHS` includes the directory you're editing. Check `LOG_LEVEL=debug` for watcher events.
+
+**MSSQL connection fails**
+→ Set `LOG_LEVEL=debug` and check the error. Ensure `trustServerCertificate=true` for local SQL Server.
+
+**MCP server crashes on startup**
+→ Ensure no `console.log` in any source file (breaks stdio MCP transport). Use the logger utility.
+
+**Symbols not extracted for my language**
+→ Open `src/languages/definitions/` and check the regex rules. Enable `LOG_LEVEL=debug` to see what's parsed.
+
+---
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feat/new-language`
+3. Add your language definition in `src/languages/definitions/`
+4. Add tests in `tests/parser.test.ts`
+5. Run `npm test && npm run type-check`
+6. Submit a PR
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+---
+
+*Continuum v1.0 — Model-agnostic · Offline · No cloud dependencies · Production-ready*

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const command = process.argv[2];
+if (command === 'init') {
+    console.log('Initializing Continuum MCP configuration...');
+    const cwd = process.cwd();
+    // Base MCP Configuration
+    const mcpConfig = {
+        mcpServers: {
+            continuum: {
+                command: "npx",
+                args: ["continuum", "start"],
+                env: {
+                    WATCH_PATHS: "${workspaceFolder}/src",
+                    DB_PATH: "${workspaceFolder}/knowledge.db",
+                    LOG_LEVEL: "info"
+                }
+            }
+        }
+    };
+    // 1. .vscode/mcp.json (Claude Code / Antigravity)
+    const vscodeDir = path.join(cwd, '.vscode');
+    if (!fs.existsSync(vscodeDir)) {
+        fs.mkdirSync(vscodeDir, { recursive: true });
+    }
+    const vscodeMcpPath = path.join(vscodeDir, 'mcp.json');
+    if (!fs.existsSync(vscodeMcpPath)) {
+        fs.writeFileSync(vscodeMcpPath, JSON.stringify(mcpConfig, null, 2));
+        console.log(`✅ Created ${vscodeMcpPath}`);
+    }
+    else {
+        console.log(`ℹ️  Skipped ${vscodeMcpPath} (already exists)`);
+    }
+    // 2. .cursor/mcp.json (Cursor)
+    const cursorDir = path.join(cwd, '.cursor');
+    if (!fs.existsSync(cursorDir)) {
+        fs.mkdirSync(cursorDir, { recursive: true });
+    }
+    const cursorMcpPath = path.join(cursorDir, 'mcp.json');
+    if (!fs.existsSync(cursorMcpPath)) {
+        fs.writeFileSync(cursorMcpPath, JSON.stringify(mcpConfig, null, 2));
+        console.log(`✅ Created ${cursorMcpPath}`);
+    }
+    else {
+        console.log(`ℹ️  Skipped ${cursorMcpPath} (already exists)`);
+    }
+    // 3. AI System Prompts
+    const rulesContent = `You have access to the Continuum MCP tools.
+Always call \`get_session\` when you first start working or if you lose context.
+Use \`save_task\` to proactively save goals, decisions, and next steps before closing sessions.
+`;
+    const cursorRulesPath = path.join(cwd, '.cursorrules');
+    if (!fs.existsSync(cursorRulesPath)) {
+        fs.writeFileSync(cursorRulesPath, rulesContent);
+        console.log(`✅ Created ${cursorRulesPath}`);
+    }
+    else {
+        console.log(`ℹ️  Skipped ${cursorRulesPath} (already exists)`);
+    }
+    const claudePath = path.join(cwd, '.claude.md');
+    if (!fs.existsSync(claudePath)) {
+        fs.writeFileSync(claudePath, rulesContent);
+        console.log(`✅ Created ${claudePath}`);
+    }
+    else {
+        console.log(`ℹ️  Skipped ${claudePath} (already exists)`);
+    }
+    // 4. .env
+    const envPath = path.join(cwd, '.env');
+    if (!fs.existsSync(envPath)) {
+        fs.writeFileSync(envPath, `WATCH_PATHS=./src\nDB_PATH=./knowledge.db\nLOG_LEVEL=info\n`);
+        console.log(`✅ Created ${envPath}`);
+    }
+    else {
+        console.log(`ℹ️  Skipped ${envPath} (already exists)`);
+    }
+    console.log('\n🎉 Initialization complete! Restart your IDE or AI assistant to load the tools.');
+}
+else if (command === 'start') {
+    // Run the MCP server
+    require('../mcp/McpServer.js');
+}
+else {
+    console.log('Continuum AI MCP Setup');
+    console.log('Usage:');
+    console.log('  npx continuum init   - Setup MCP config files in current directory');
+    console.log('  npx continuum start  - Run the MCP server manually');
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/database/Database.d.ts

@@ -0,0 +1,4 @@
+import BetterSqlite3 from 'better-sqlite3';
+export declare function getDb(): BetterSqlite3.Database;
+export declare function closeDb(): void;
+//# sourceMappingURL=Database.d.ts.map

package/dist/database/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/database/Database.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAS3C,wBAAgB,KAAK,IAAI,aAAa,CAAC,QAAQ,CAgC9C;AAED,wBAAgB,OAAO,IAAI,IAAI,CAS9B"}

package/dist/database/Database.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDb = getDb;
+exports.closeDb = closeDb;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DB_PATH = process.env.DB_PATH || './knowledge.db';
+const SCHEMA_PATH = path.join(__dirname, 'schema.sql');
+let db = null;
+function getDb() {
+    if (!db) {
+        db = new better_sqlite3_1.default(DB_PATH);
+        db.pragma('journal_mode = WAL');
+        db.pragma('foreign_keys = ON');
+        db.pragma('cache_size = -16000'); // 16 MB page cache
+        db.pragma('temp_store = MEMORY');
+        const schema = fs.readFileSync(SCHEMA_PATH, 'utf-8');
+        db.exec(schema);
+        // Seed metadata on first boot
+        const versionCheck = db
+            .prepare("SELECT value FROM metadata WHERE key = 'version'")
+            .get();
+        if (!versionCheck) {
+            const now = Math.floor(Date.now() / 1000);
+            db.prepare("INSERT OR IGNORE INTO metadata VALUES ('version', '1.0.0')").run();
+            db.prepare(`INSERT OR IGNORE INTO metadata VALUES ('first_started', '${now}')`).run();
+        }
+        db.prepare(`INSERT OR REPLACE INTO metadata VALUES ('last_started', '${Math.floor(Date.now() / 1000)}')`).run();
+        db.prepare(`INSERT OR REPLACE INTO metadata VALUES ('boot_count',
+        CAST((COALESCE((SELECT value FROM metadata WHERE key='boot_count'), 0)) AS INTEGER) + 1
+      )`).run();
+    }
+    return db;
+}
+function closeDb() {
+    if (db) {
+        try {
+            db.close();
+            db = null;
+        }
+        catch {
+            // already closed
+        }
+    }
+}
+//# sourceMappingURL=Database.js.map

package/dist/database/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sourceRoot":"","sources":["../../src/database/Database.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,sBAgCC;AAED,0BASC;AApDD,oEAA2C;AAC3C,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAEvD,IAAI,EAAE,GAAkC,IAAI,CAAC;AAE7C,SAAgB,KAAK;IACnB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,GAAG,IAAI,wBAAa,CAAC,OAAO,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB;QACrD,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAEjC,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,8BAA8B;QAC9B,MAAM,YAAY,GAAG,EAAE;aACpB,OAAO,CAAC,kDAAkD,CAAC;aAC3D,GAAG,EAAmC,CAAC;QAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC1C,EAAE,CAAC,OAAO,CAAC,4DAA4D,CAAC,CAAC,GAAG,EAAE,CAAC;YAC/E,EAAE,CAAC,OAAO,CAAC,4DAA4D,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACxF,CAAC;QAED,EAAE,CAAC,OAAO,CACR,4DAA4D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAC9F,CAAC,GAAG,EAAE,CAAC;QACR,EAAE,CAAC,OAAO,CACR;;QAEE,CACH,CAAC,GAAG,EAAE,CAAC;IACV,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,OAAO;IACrB,IAAI,EAAE,EAAE,CAAC;QACP,IAAI,CAAC;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,EAAE,GAAG,IAAI,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/database/schema.sql

@@ -0,0 +1,121 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Continuum v1.0 — SQLite Schema
+-- ─────────────────────────────────────────────────────────────────────────────
+
+-- Server metadata (version, boot tracking)
+CREATE TABLE IF NOT EXISTS metadata (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- Files indexed from watched directories
+CREATE TABLE IF NOT EXISTS files (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  path         TEXT    NOT NULL UNIQUE,
+  language     TEXT,                 -- 'typescript' | 'python' | 'rust' | ...
+  last_parsed  INTEGER,              -- unix epoch
+  hash         TEXT,                 -- MD5 of file content for dedup
+  size_bytes   INTEGER,
+  symbol_count INTEGER DEFAULT 0,
+  created_at   INTEGER DEFAULT (unixepoch()),
+  updated_at   INTEGER DEFAULT (unixepoch())
+);
+
+-- Symbols extracted from files (classes, functions, methods, etc.)
+CREATE TABLE IF NOT EXISTS symbols (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  file_id     INTEGER NOT NULL REFERENCES files(id) ON DELETE CASCADE,
+  name        TEXT    NOT NULL,
+  kind        TEXT    NOT NULL, -- class | function | method | interface | enum | struct | trait | module | property | constructor
+  start_line  INTEGER,
+  end_line    INTEGER,
+  signature   TEXT,             -- first ~120 chars of the definition
+  created_at  INTEGER DEFAULT (unixepoch())
+);
+
+-- Full-text search index over symbol names (SQLite FTS5)
+CREATE VIRTUAL TABLE IF NOT EXISTS symbols_fts USING fts5(
+  name,
+  kind,
+  file_path,
+  content=''  -- contentless: we store data in symbols table
+);
+
+-- Relationships between symbols (imports, calls, extends, implements)
+CREATE TABLE IF NOT EXISTS relationships (
+  id        INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_id   INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,
+  to_name   TEXT    NOT NULL,
+  kind      TEXT    NOT NULL, -- calls | imports | extends | implements | uses
+  created_at INTEGER DEFAULT (unixepoch())
+);
+
+-- Active coding sessions
+CREATE TABLE IF NOT EXISTS sessions (
+  id               TEXT    PRIMARY KEY,   -- UUID
+  goal             TEXT,
+  started_at       INTEGER DEFAULT (unixepoch()),
+  updated_at       INTEGER DEFAULT (unixepoch()),
+  compaction_count INTEGER DEFAULT 0
+);
+
+-- Files touched during a session (opened, modified, created, deleted)
+CREATE TABLE IF NOT EXISTS touched_files (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT    NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
+  path       TEXT    NOT NULL,
+  action     TEXT    NOT NULL, -- opened | modified | created | deleted
+  touched_at INTEGER DEFAULT (unixepoch())
+);
+
+-- Structured task state saved by AI during a session
+CREATE TABLE IF NOT EXISTS tasks (
+  id             INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id     TEXT    NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
+  goal           TEXT,
+  decisions      TEXT,          -- JSON array of strings
+  next_steps     TEXT,          -- JSON array of strings
+  open_questions TEXT,          -- JSON array of strings
+  saved_at       INTEGER DEFAULT (unixepoch())
+);
+
+-- Manual feature-to-file mappings (populated by AI via register_feature tool)
+CREATE TABLE IF NOT EXISTS features (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  name        TEXT    NOT NULL,
+  layer       TEXT    NOT NULL, -- controller | service | repository | ui | test | db | model
+  file_path   TEXT    NOT NULL,
+  description TEXT,
+  created_at  INTEGER DEFAULT (unixepoch())
+);
+
+-- Cached live database schema (populated by get_schema tool)
+CREATE TABLE IF NOT EXISTS schema_cache (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  table_name  TEXT    NOT NULL UNIQUE,
+  schema_json TEXT    NOT NULL,
+  cached_at   INTEGER DEFAULT (unixepoch())
+);
+
+-- Every MCP tool call logged for observability
+CREATE TABLE IF NOT EXISTS tool_usage (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id      TEXT,
+  tool_name       TEXT    NOT NULL,
+  input_json      TEXT,
+  tokens_returned INTEGER,
+  duration_ms     INTEGER,
+  called_at       INTEGER DEFAULT (unixepoch())
+);
+
+-- ─── Indexes ────────────────────────────────────────────────────────────────
+CREATE INDEX IF NOT EXISTS idx_symbols_file      ON symbols(file_id);
+CREATE INDEX IF NOT EXISTS idx_symbols_name      ON symbols(name);
+CREATE INDEX IF NOT EXISTS idx_symbols_kind      ON symbols(kind);
+CREATE INDEX IF NOT EXISTS idx_relationships_from ON relationships(from_id);
+CREATE INDEX IF NOT EXISTS idx_touched_session   ON touched_files(session_id);
+CREATE INDEX IF NOT EXISTS idx_touched_path      ON touched_files(path);
+CREATE INDEX IF NOT EXISTS idx_features_name     ON features(name);
+CREATE INDEX IF NOT EXISTS idx_files_language    ON files(language);
+CREATE INDEX IF NOT EXISTS idx_tool_session      ON tool_usage(session_id);
+CREATE INDEX IF NOT EXISTS idx_tool_name         ON tool_usage(tool_name);