mcp-coordinator 0.4.0 → 0.6.0

package/dist/cli/server/start.js

@@ -8,7 +8,32 @@ export function createServerStartCommand() {
         .option("--port <port>", "Server port")
         .option("--data-dir <path>", "Data directory")
         .option("--daemon", "Run as background daemon")
+        .option("--repo-root <path>", "Project repo root (enables Layer 4 + FS fallback). Default env COORDINATOR_REPO_ROOT.")
+        .option("--max-body-bytes <bytes>", "Max HTTP request body in bytes. Default 1048576.")
+        .option("--working-files-ttl-min <minutes>", "TTL for working_files claims. Default 30.")
+        .option("--working-files-sweep-ms <ms>", "TTL sweeper tick interval. Default 60000.")
+        .option("--layer4-since-days <days>", "git log --since window. Default 7.")
+        .option("--layer4-max-commits <count>", "git log --max-count. Default 2000.")
+        .option("--layer4-refresh-ms <ms>", "Layer 4 successful-build refresh interval. Default 1800000.")
+        .option("--layer4-retry-ms <ms>", "Layer 4 retry interval on timeout. Default 300000.")
         .action(async (opts) => {
+        // Wire CLI flags to env vars (CLI takes precedence; rest of codebase reads from env)
+        if (opts.repoRoot)
+            process.env.COORDINATOR_REPO_ROOT = opts.repoRoot;
+        if (opts.maxBodyBytes)
+            process.env.COORDINATOR_MAX_BODY_BYTES = opts.maxBodyBytes;
+        if (opts.workingFilesTtlMin)
+            process.env.COORDINATOR_WORKING_FILES_TTL_MIN = opts.workingFilesTtlMin;
+        if (opts.workingFilesSweepMs)
+            process.env.COORDINATOR_WORKING_FILES_SWEEP_INTERVAL_MS = opts.workingFilesSweepMs;
+        if (opts.layer4SinceDays)
+            process.env.COORDINATOR_LAYER4_SINCE_DAYS = opts.layer4SinceDays;
+        if (opts.layer4MaxCommits)
+            process.env.COORDINATOR_LAYER4_MAX_COMMITS = opts.layer4MaxCommits;
+        if (opts.layer4RefreshMs)
+            process.env.COORDINATOR_LAYER4_REFRESH_INTERVAL_MS = opts.layer4RefreshMs;
+        if (opts.layer4RetryMs)
+            process.env.COORDINATOR_LAYER4_RETRY_MS = opts.layer4RetryMs;
         const config = loadConfig();
         const port = parseInt(opts.port ?? process.env.PORT ?? String(config.server.port), 10);
         const dataDir = opts.dataDir ?? process.env.COORDINATOR_DATA_DIR ?? config.server.data_dir;
@@ -47,6 +72,14 @@ export function createServerStartCommand() {
             fwd("COORDINATOR_ADMIN_SECRET", process.env.COORDINATOR_ADMIN_SECRET);
             fwd("COORDINATOR_MQTT_TCP_PORT", process.env.COORDINATOR_MQTT_TCP_PORT);
             fwd("COORDINATOR_MQTT_WS_PATH", process.env.COORDINATOR_MQTT_WS_PATH);
+            fwd("COORDINATOR_REPO_ROOT", process.env.COORDINATOR_REPO_ROOT);
+            fwd("COORDINATOR_MAX_BODY_BYTES", process.env.COORDINATOR_MAX_BODY_BYTES);
+            fwd("COORDINATOR_WORKING_FILES_TTL_MIN", process.env.COORDINATOR_WORKING_FILES_TTL_MIN);
+            fwd("COORDINATOR_WORKING_FILES_SWEEP_INTERVAL_MS", process.env.COORDINATOR_WORKING_FILES_SWEEP_INTERVAL_MS);
+            fwd("COORDINATOR_LAYER4_SINCE_DAYS", process.env.COORDINATOR_LAYER4_SINCE_DAYS);
+            fwd("COORDINATOR_LAYER4_MAX_COMMITS", process.env.COORDINATOR_LAYER4_MAX_COMMITS);
+            fwd("COORDINATOR_LAYER4_REFRESH_INTERVAL_MS", process.env.COORDINATOR_LAYER4_REFRESH_INTERVAL_MS);
+            fwd("COORDINATOR_LAYER4_RETRY_MS", process.env.COORDINATOR_LAYER4_RETRY_MS);
             const child = spawn(cmd, args, {
                 detached: true,
                 stdio: ["ignore", logFd, logFd],

package/dist/src/agent-activity.js

@@ -59,12 +59,12 @@ export class AgentActivityTracker {
     // ── Private ──
     upsert(agentId, status, file, thread) {
         const db = getDb();
-        db.prepare(`INSERT INTO agent_activity_status (agent_id, activity_status, current_file, current_thread, last_activity_at)
-       VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP)
-       ON CONFLICT(agent_id) DO UPDATE SET
-         activity_status = excluded.activity_status,
-         current_file = excluded.current_file,
-         current_thread = excluded.current_thread,
+        db.prepare(`INSERT INTO agent_activity_status (agent_id, activity_status, current_file, current_thread, last_activity_at)
+       VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP)
+       ON CONFLICT(agent_id) DO UPDATE SET
+         activity_status = excluded.activity_status,
+         current_file = excluded.current_file,
+         current_thread = excluded.current_thread,
          last_activity_at = CURRENT_TIMESTAMP`).run(agentId, status, file, thread);
     }
 }

package/dist/src/agent-registry.js

@@ -2,12 +2,12 @@ import { getDb } from "./database.js";
 export class AgentRegistry {
     register(agentId, name, modules) {
         const db = getDb();
-        db.prepare(`INSERT INTO agents (id, name, modules, status, registered_at, last_seen_at)
-       VALUES (?, ?, ?, 'online', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
-       ON CONFLICT(id) DO UPDATE SET
-         name = excluded.name,
-         modules = excluded.modules,
-         status = 'online',
+        db.prepare(`INSERT INTO agents (id, name, modules, status, registered_at, last_seen_at)
+       VALUES (?, ?, ?, 'online', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+       ON CONFLICT(id) DO UPDATE SET
+         name = excluded.name,
+         modules = excluded.modules,
+         status = 'online',
          last_seen_at = CURRENT_TIMESTAMP`).run(agentId, name, JSON.stringify(modules));
         return this.get(agentId);
     }

package/dist/src/announce-workflow.d.ts

@@ -42,6 +42,7 @@ export interface CommonFlowParams {
     depends_on_files?: string[];
     exports_affected?: string[];
     keep_open?: boolean;
+    target_symbols?: string[];
 }
 /**
  * Run the common post-`announceWork` orchestration. Mutates the thread row

package/dist/src/announce-workflow.js

@@ -15,7 +15,16 @@ export function runCommonAnnounceFlow(services, threadId, params) {
         target_files: params.target_files,
         depends_on_files: params.depends_on_files,
         exports_affected: params.exports_affected,
+        target_symbols: params.target_symbols,
     });
+    // Layer firing log: one row per concerned/gray-zone scored agent.
+    // Used by /api/scoring-stats and the dashboard "Conflict signals" panel.
+    const dbForFirings = getDb();
+    const insertFiring = dbForFirings.prepare("INSERT INTO layer_firings (thread_id, layer, score, agent_id) VALUES (?, ?, ?, ?)");
+    for (const s of [...categorized.concerned, ...categorized.gray_zone]) {
+        const layer = inferLayerFromReasons(s.reasons);
+        insertFiring.run(threadId, layer, s.score, s.agent_id);
+    }
     // 2. Override expected_respondents on the thread with the scored set.
     // Auto-resolve only when truly alone — if peers are online but not concerned
     // (e.g., they haven't announced yet), keep the thread open so a subsequent
@@ -72,6 +81,25 @@ export function runCommonAnnounceFlow(services, threadId, params) {
     const respondents = JSON.parse(updated.expected_respondents || "[]");
     return { updated, categorized, respondents, planQuality };
 }
+function inferLayerFromReasons(reasons) {
+    for (const r of reasons) {
+        if (r.includes("disjoint symbols"))
+            return "L0.5";
+        if (r.includes("announced same file") || r.includes("modifies my dependency") || r.includes("they depend on my target"))
+            return "L0";
+        if (r.includes("same file (in flight)"))
+            return "L1";
+        if (r.includes("same file"))
+            return "L1";
+        if (r.includes("co-change"))
+            return "L4";
+        if (r.includes("depends on"))
+            return "L2";
+        if (r.includes("module overlap"))
+            return "L3";
+    }
+    return "L1";
+}
 function scoredCategory(s) {
     if (s.score >= 90)
         return "concerned";

package/dist/src/consultation.js

@@ -92,7 +92,7 @@ export class Consultation {
             const assignedTo = params.assigned_to ?? null;
             const keepOpen = params.keep_open || assignedTo !== null;
             const autoResolve = respondentIds.length === 0 && !keepOpen;
-            db.prepare(`INSERT INTO threads (id, initiator_id, subject, plan, target_modules, target_files, status, expected_respondents, resolved_at, depends_on_files, exports_affected, timeout_seconds, assigned_to)
+            db.prepare(`INSERT INTO threads (id, initiator_id, subject, plan, target_modules, target_files, status, expected_respondents, resolved_at, depends_on_files, exports_affected, timeout_seconds, assigned_to)
          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, params.agent_id, params.subject, params.plan || null, JSON.stringify(params.target_modules), JSON.stringify(params.target_files), autoResolve ? "resolved" : "open", JSON.stringify(respondentIds), autoResolve ? new Date().toISOString() : null, JSON.stringify(params.depends_on_files || []), JSON.stringify(params.exports_affected || []), keepOpen ? 0 : 600, assignedTo);
             return { autoResolve, respondentIds, assignedTo };
         });
@@ -122,7 +122,7 @@ export class Consultation {
         const id = randomUUID();
         // Simple token estimate: ~4 chars per token for English/French
         const tokenEstimate = Math.ceil(params.content.length / 4);
-        db.prepare(`INSERT INTO thread_messages (id, thread_id, agent_id, agent_name, type, content, context_snapshot, in_reply_to, round, token_estimate)
+        db.prepare(`INSERT INTO thread_messages (id, thread_id, agent_id, agent_name, type, content, context_snapshot, in_reply_to, round, token_estimate)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, params.thread_id, params.agent_id, params.agent_name || null, params.type, params.content, params.context_snapshot || null, params.in_reply_to || null, thread.round, tokenEstimate);
         this.log.debug({
             thread_id: params.thread_id,
@@ -252,21 +252,21 @@ export class Consultation {
         // thread IDs to emit for. The transaction makes both observe the same
         // snapshot.
         const tx = db.transaction(() => {
-            const timedOut = db.prepare(`
-        SELECT id FROM threads
-        WHERE status IN ('open', 'resolving')
-        AND timeout_seconds > 0
-        AND datetime(created_at, '+' || (timeout_seconds * round) || ' seconds') < CURRENT_TIMESTAMP
+            const timedOut = db.prepare(`
+        SELECT id FROM threads
+        WHERE status IN ('open', 'resolving')
+        AND timeout_seconds > 0
+        AND datetime(created_at, '+' || (timeout_seconds * round) || ' seconds') < CURRENT_TIMESTAMP
       `).all();
             if (timedOut.length === 0)
                 return [];
-            db.prepare(`
-        UPDATE threads SET status = 'resolved',
-          resolution_summary = 'Résolu par timeout — pas de réponse dans le délai',
-          resolved_at = CURRENT_TIMESTAMP
-        WHERE status IN ('open', 'resolving')
-        AND timeout_seconds > 0
-        AND datetime(created_at, '+' || (timeout_seconds * round) || ' seconds') < CURRENT_TIMESTAMP
+            db.prepare(`
+        UPDATE threads SET status = 'resolved',
+          resolution_summary = 'Résolu par timeout — pas de réponse dans le délai',
+          resolved_at = CURRENT_TIMESTAMP
+        WHERE status IN ('open', 'resolving')
+        AND timeout_seconds > 0
+        AND datetime(created_at, '+' || (timeout_seconds * round) || ' seconds') < CURRENT_TIMESTAMP
       `).run();
             return timedOut;
         });
@@ -333,9 +333,9 @@ export class Consultation {
     }
     getThreadUpdates(agentId, since) {
         const db = getDb();
-        let sql = `SELECT tm.* FROM thread_messages tm
-               JOIN threads t ON tm.thread_id = t.id
-               WHERE t.status IN ('open', 'resolving')
+        let sql = `SELECT tm.* FROM thread_messages tm
+               JOIN threads t ON tm.thread_id = t.id
+               WHERE t.status IN ('open', 'resolving')
                AND tm.agent_id != ?`;
         const params = [agentId];
         if (since) {
@@ -357,7 +357,7 @@ export class Consultation {
     logActionSummary(params) {
         const db = getDb();
         const id = randomUUID();
-        db.prepare(`INSERT INTO action_summaries (id, session_id, agent_id, file_path, summary)
+        db.prepare(`INSERT INTO action_summaries (id, session_id, agent_id, file_path, summary)
        VALUES (?, ?, ?, ?, ?)`).run(id, params.session_id, params.agent_id, params.file_path || null, params.summary);
         return db.prepare("SELECT * FROM action_summaries WHERE id = ?").get(id);
     }
@@ -383,7 +383,7 @@ export class Consultation {
         const db = getDb();
         const thread = this.getThread(threadId);
         const id = randomUUID();
-        db.prepare(`INSERT INTO thread_messages (id, thread_id, agent_id, type, content, round)
+        db.prepare(`INSERT INTO thread_messages (id, thread_id, agent_id, type, content, round)
        VALUES (?, ?, ?, ?, ?, ?)`).run(id, threadId, agentId, type, content, thread.round);
     }
     allRespondentsApproved(threadId) {
@@ -396,7 +396,7 @@ export class Consultation {
         // increments the round, and prior-round approvals must be re-collected
         // for the new proposal.
         const approvals = db
-            .prepare(`SELECT DISTINCT agent_id FROM thread_messages
+            .prepare(`SELECT DISTINCT agent_id FROM thread_messages
          WHERE thread_id = ? AND type = 'approve' AND round = ?`)
             .all(threadId, thread.round);
         const approvedIds = new Set(approvals.map((a) => a.agent_id));

package/dist/src/database.js

@@ -3,132 +3,172 @@ import { mkdirSync } from "fs";
 import { createRequire } from "module";
 const require = createRequire(import.meta.url);
 let db;
-const SCHEMA = `
-    CREATE TABLE IF NOT EXISTS agents (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL,
-      modules TEXT DEFAULT '[]',
-      status TEXT DEFAULT 'offline',
-      registered_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      last_seen_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    CREATE TABLE IF NOT EXISTS threads (
-      id TEXT PRIMARY KEY,
-      initiator_id TEXT NOT NULL,
-      subject TEXT NOT NULL,
-      plan TEXT,
-      target_modules TEXT DEFAULT '[]',
-      target_files TEXT DEFAULT '[]',
-      status TEXT DEFAULT 'open',
-      resolution_summary TEXT,
-      conflicts TEXT,
-      round INTEGER DEFAULT 1,
-      max_rounds INTEGER DEFAULT 4,
-      timeout_seconds INTEGER DEFAULT 600,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      resolved_at TEXT,
-      expected_respondents TEXT,
-      depends_on_files TEXT,
-      exports_affected TEXT,
-      claimed_by TEXT,
-      claimed_at TEXT,
-      FOREIGN KEY (initiator_id) REFERENCES agents(id)
-    );
-
-    CREATE TABLE IF NOT EXISTS thread_messages (
-      id TEXT PRIMARY KEY,
-      thread_id TEXT NOT NULL,
-      agent_id TEXT NOT NULL,
-      agent_name TEXT,
-      type TEXT NOT NULL,
-      content TEXT NOT NULL,
-      context_snapshot TEXT,
-      in_reply_to TEXT,
-      round INTEGER NOT NULL,
-      token_estimate INTEGER DEFAULT 0,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      FOREIGN KEY (thread_id) REFERENCES threads(id),
-      FOREIGN KEY (agent_id) REFERENCES agents(id)
-    );
-
-    CREATE TABLE IF NOT EXISTS action_summaries (
-      id TEXT PRIMARY KEY,
-      session_id TEXT NOT NULL,
-      agent_id TEXT NOT NULL,
-      file_path TEXT,
-      summary TEXT NOT NULL,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      FOREIGN KEY (agent_id) REFERENCES agents(id)
-    );
-
-    CREATE TABLE IF NOT EXISTS events (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      type TEXT NOT NULL,
-      payload TEXT NOT NULL,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    CREATE TABLE IF NOT EXISTS dependency_map (
-      module_id TEXT PRIMARY KEY,
-      depends_on TEXT DEFAULT '[]',
-      exports TEXT DEFAULT '[]',
-      owners TEXT DEFAULT '[]'
-    );
-
-    CREATE TABLE IF NOT EXISTS file_activity (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      session_id TEXT NOT NULL,
-      agent_id TEXT NOT NULL,
-      agent_name TEXT,
-      tool_name TEXT NOT NULL,
-      file_path TEXT NOT NULL,
-      module TEXT,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP
-    );
-
-    CREATE INDEX IF NOT EXISTS idx_threads_status ON threads(status);
-    CREATE INDEX IF NOT EXISTS idx_threads_initiator ON threads(initiator_id);
-    CREATE INDEX IF NOT EXISTS idx_messages_thread ON thread_messages(thread_id);
-    CREATE INDEX IF NOT EXISTS idx_messages_agent ON thread_messages(agent_id);
-    CREATE INDEX IF NOT EXISTS idx_summaries_agent ON action_summaries(agent_id);
-    CREATE INDEX IF NOT EXISTS idx_summaries_session ON action_summaries(session_id);
-    CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
-    CREATE INDEX IF NOT EXISTS idx_file_activity_agent ON file_activity(agent_id);
-    CREATE INDEX IF NOT EXISTS idx_file_activity_path ON file_activity(file_path);
-
-    CREATE TABLE IF NOT EXISTS introspections (
-      id TEXT PRIMARY KEY,
-      thread_id TEXT NOT NULL,
-      agent_id TEXT NOT NULL,
-      score INTEGER NOT NULL,
-      reasons TEXT,
-      status TEXT DEFAULT 'pending',
-      response TEXT,
-      concerned INTEGER DEFAULT 0,
-      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      responded_at TEXT,
-      FOREIGN KEY (thread_id) REFERENCES threads(id),
-      FOREIGN KEY (agent_id) REFERENCES agents(id)
-    );
-
-    CREATE INDEX IF NOT EXISTS idx_introspections_agent ON introspections(agent_id);
-    CREATE INDEX IF NOT EXISTS idx_introspections_status ON introspections(status);
-
-    CREATE TABLE IF NOT EXISTS agent_activity_status (
-      agent_id TEXT PRIMARY KEY,
-      activity_status TEXT DEFAULT 'idle',
-      current_file TEXT,
-      current_thread TEXT,
-      last_activity_at TEXT DEFAULT CURRENT_TIMESTAMP,
-      FOREIGN KEY (agent_id) REFERENCES agents(id)
-    );
-
-    CREATE TABLE IF NOT EXISTS revoked_agents (
-      agent_id TEXT PRIMARY KEY,
-      revoked_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
-      revoked_by TEXT NOT NULL
-    );
+const CURRENT_USER_VERSION = 6;
+const SCHEMA = `
+    CREATE TABLE IF NOT EXISTS agents (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      modules TEXT DEFAULT '[]',
+      status TEXT DEFAULT 'offline',
+      registered_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      last_seen_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE TABLE IF NOT EXISTS threads (
+      id TEXT PRIMARY KEY,
+      initiator_id TEXT NOT NULL,
+      subject TEXT NOT NULL,
+      plan TEXT,
+      target_modules TEXT DEFAULT '[]',
+      target_files TEXT DEFAULT '[]',
+      status TEXT DEFAULT 'open',
+      resolution_summary TEXT,
+      conflicts TEXT,
+      round INTEGER DEFAULT 1,
+      max_rounds INTEGER DEFAULT 4,
+      timeout_seconds INTEGER DEFAULT 600,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      resolved_at TEXT,
+      expected_respondents TEXT,
+      depends_on_files TEXT,
+      exports_affected TEXT,
+      claimed_by TEXT,
+      claimed_at TEXT,
+      FOREIGN KEY (initiator_id) REFERENCES agents(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS thread_messages (
+      id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      agent_name TEXT,
+      type TEXT NOT NULL,
+      content TEXT NOT NULL,
+      context_snapshot TEXT,
+      in_reply_to TEXT,
+      round INTEGER NOT NULL,
+      token_estimate INTEGER DEFAULT 0,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      FOREIGN KEY (thread_id) REFERENCES threads(id),
+      FOREIGN KEY (agent_id) REFERENCES agents(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS action_summaries (
+      id TEXT PRIMARY KEY,
+      session_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT,
+      summary TEXT NOT NULL,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      FOREIGN KEY (agent_id) REFERENCES agents(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS events (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      type TEXT NOT NULL,
+      payload TEXT NOT NULL,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE TABLE IF NOT EXISTS dependency_map (
+      module_id TEXT PRIMARY KEY,
+      depends_on TEXT DEFAULT '[]',
+      exports TEXT DEFAULT '[]',
+      owners TEXT DEFAULT '[]'
+    );
+
+    CREATE TABLE IF NOT EXISTS file_activity (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      agent_name TEXT,
+      tool_name TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      module TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_threads_status ON threads(status);
+    CREATE INDEX IF NOT EXISTS idx_threads_initiator ON threads(initiator_id);
+    CREATE INDEX IF NOT EXISTS idx_messages_thread ON thread_messages(thread_id);
+    CREATE INDEX IF NOT EXISTS idx_messages_agent ON thread_messages(agent_id);
+    CREATE INDEX IF NOT EXISTS idx_summaries_agent ON action_summaries(agent_id);
+    CREATE INDEX IF NOT EXISTS idx_summaries_session ON action_summaries(session_id);
+    CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+    CREATE INDEX IF NOT EXISTS idx_file_activity_agent ON file_activity(agent_id);
+    CREATE INDEX IF NOT EXISTS idx_file_activity_path ON file_activity(file_path);
+
+    CREATE TABLE IF NOT EXISTS introspections (
+      id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      score INTEGER NOT NULL,
+      reasons TEXT,
+      status TEXT DEFAULT 'pending',
+      response TEXT,
+      concerned INTEGER DEFAULT 0,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      responded_at TEXT,
+      FOREIGN KEY (thread_id) REFERENCES threads(id),
+      FOREIGN KEY (agent_id) REFERENCES agents(id)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_introspections_agent ON introspections(agent_id);
+    CREATE INDEX IF NOT EXISTS idx_introspections_status ON introspections(status);
+
+    CREATE TABLE IF NOT EXISTS agent_activity_status (
+      agent_id TEXT PRIMARY KEY,
+      activity_status TEXT DEFAULT 'idle',
+      current_file TEXT,
+      current_thread TEXT,
+      last_activity_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      FOREIGN KEY (agent_id) REFERENCES agents(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS revoked_agents (
+      agent_id TEXT PRIMARY KEY,
+      revoked_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      revoked_by TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS working_files (
+      agent_id          TEXT NOT NULL,
+      file_path         TEXT NOT NULL,
+      started_at        TEXT NOT NULL,
+      last_activity_at  TEXT NOT NULL,
+      claim_until       TEXT NOT NULL,
+      PRIMARY KEY (agent_id, file_path)
+    );
+    CREATE INDEX IF NOT EXISTS idx_working_files_path  ON working_files(file_path);
+    CREATE INDEX IF NOT EXISTS idx_working_files_until ON working_files(claim_until);
+
+    CREATE TABLE IF NOT EXISTS git_cochange (
+      file_a        TEXT NOT NULL,
+      file_b        TEXT NOT NULL,
+      count         INTEGER NOT NULL,
+      total_commits INTEGER NOT NULL,
+      computed_at   TEXT NOT NULL,
+      PRIMARY KEY (file_a, file_b),
+      CHECK (file_a < file_b)
+    );
+    CREATE INDEX IF NOT EXISTS idx_cochange_a ON git_cochange(file_a);
+    CREATE INDEX IF NOT EXISTS idx_cochange_b ON git_cochange(file_b);
+
+    CREATE TABLE IF NOT EXISTS git_cochange_meta (
+      k TEXT PRIMARY KEY,
+      v TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS layer_firings (
+      id        INTEGER PRIMARY KEY AUTOINCREMENT,
+      thread_id TEXT,
+      layer     TEXT NOT NULL,
+      score     INTEGER NOT NULL,
+      agent_id  TEXT,
+      fired_at  TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+    CREATE INDEX IF NOT EXISTS idx_firings_layer  ON layer_firings(layer, fired_at);
+    CREATE INDEX IF NOT EXISTS idx_firings_thread ON layer_firings(thread_id);
 `;
 function createBetterSqlite3(dataDir) {
     mkdirSync(dataDir, { recursive: true });
@@ -157,6 +197,20 @@ export function initDatabase(dataDir) {
     else {
         db = createBetterSqlite3(dataDir);
     }
+    // Check for downgrade: refuse if DB was written by a newer binary
+    let foundVersion = 0;
+    try {
+        const v = db
+            .prepare("PRAGMA user_version")
+            .get();
+        foundVersion = v?.user_version ?? 0;
+    }
+    catch {
+        foundVersion = 0;
+    }
+    if (foundVersion > CURRENT_USER_VERSION) {
+        throw new Error(`Database schema is from a newer version (${foundVersion}) than this binary supports (${CURRENT_USER_VERSION}). Downgrade not supported.`);
+    }
     db.exec(SCHEMA);
     // Migrations for existing databases — columns may already exist
     try {
@@ -182,6 +236,17 @@ export function initDatabase(dataDir) {
         db.exec("ALTER TABLE threads ADD COLUMN assigned_to TEXT");
     }
     catch { /* already exists */ }
+    // v0.6: per-edit symbol metadata on file_activity
+    try {
+        db.exec("ALTER TABLE file_activity ADD COLUMN symbols_touched TEXT");
+    }
+    catch { /* already exists */ }
+    try {
+        db.exec("ALTER TABLE file_activity ADD COLUMN content_hash TEXT");
+    }
+    catch { /* already exists */ }
+    // v0.6: schema version marker. Used by cli/server/restore.ts to refuse downgrades.
+    db.exec("PRAGMA user_version = 6");
 }
 export function getDb() {
     if (!db)

package/dist/src/dependency-map.js

@@ -17,9 +17,9 @@ export class DependencyMapper {
     }
     setMap(map) {
         const db = getDb();
-        const stmt = db.prepare(`INSERT INTO dependency_map (module_id, depends_on, exports, owners)
-       VALUES (?, ?, ?, ?)
-       ON CONFLICT(module_id) DO UPDATE SET
+        const stmt = db.prepare(`INSERT INTO dependency_map (module_id, depends_on, exports, owners)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(module_id) DO UPDATE SET
          depends_on = excluded.depends_on, exports = excluded.exports, owners = excluded.owners`);
         withTransaction(db, () => {
             for (const [id, info] of Object.entries(map)) {

package/dist/src/file-tracker.d.ts

@@ -6,6 +6,8 @@ export declare class FileTracker {
         agent_name?: string;
         tool_name: string;
         file_path: string;
+        content_hash?: string | null;
+        symbols_touched?: string[] | null;
     }): void;
     getBySession(sessionId: string): FileActivity[];
     getHotFiles(sinceMinutes?: number): {

package/dist/src/file-tracker.js

@@ -3,8 +3,9 @@ export class FileTracker {
     log(params) {
         const db = getDb();
         const module = this.fileToModule(params.file_path);
-        db.prepare(`INSERT INTO file_activity (session_id, agent_id, agent_name, tool_name, file_path, module)
-       VALUES (?, ?, ?, ?, ?, ?)`).run(params.session_id, params.agent_id, params.agent_name || null, params.tool_name, params.file_path, module);
+        db.prepare(`INSERT INTO file_activity
+       (session_id, agent_id, agent_name, tool_name, file_path, module, content_hash, symbols_touched)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(params.session_id, params.agent_id, params.agent_name || null, params.tool_name, params.file_path, module, params.content_hash || null, params.symbols_touched ? JSON.stringify(params.symbols_touched) : null);
     }
     getBySession(sessionId) {
         const db = getDb();
@@ -12,11 +13,11 @@ export class FileTracker {
     }
     getHotFiles(sinceMinutes = 30) {
         const db = getDb();
-        const rows = db.prepare(`SELECT file_path, COUNT(DISTINCT agent_id) as agent_count, GROUP_CONCAT(DISTINCT agent_id) as agents
-       FROM file_activity
-       WHERE created_at > datetime('now', '-' || ? || ' minutes')
-       GROUP BY file_path
-       HAVING COUNT(DISTINCT agent_id) > 1
+        const rows = db.prepare(`SELECT file_path, COUNT(DISTINCT agent_id) as agent_count, GROUP_CONCAT(DISTINCT agent_id) as agents
+       FROM file_activity
+       WHERE created_at > datetime('now', '-' || ? || ' minutes')
+       GROUP BY file_path
+       HAVING COUNT(DISTINCT agent_id) > 1
        ORDER BY agent_count DESC`).all(sinceMinutes);
         return rows.map((r) => ({
             file_path: r.file_path,
@@ -26,8 +27,8 @@ export class FileTracker {
     }
     checkFileConflict(filePath, agentId, withinMinutes = 30) {
         const db = getDb();
-        const rows = db.prepare(`SELECT DISTINCT agent_id FROM file_activity
-       WHERE file_path = ? AND agent_id != ?
+        const rows = db.prepare(`SELECT DISTINCT agent_id FROM file_activity
+       WHERE file_path = ? AND agent_id != ?
        AND created_at > datetime('now', '-' || ? || ' minutes')`).all(filePath, agentId, withinMinutes);
         return { conflict: rows.length > 0, agents: rows.map((r) => r.agent_id) };
     }
@@ -49,9 +50,9 @@ export class FileTracker {
         // the impact scorer only passes target_files + depends_on_files (typically
         // a handful of files per announce_work call).
         const placeholders = filePaths.map(() => "?").join(",");
-        const rows = db.prepare(`SELECT DISTINCT file_path, agent_id FROM file_activity
-       WHERE file_path IN (${placeholders})
-       AND agent_id != ?
+        const rows = db.prepare(`SELECT DISTINCT file_path, agent_id FROM file_activity
+       WHERE file_path IN (${placeholders})
+       AND agent_id != ?
        AND created_at > datetime('now', '-' || ? || ' minutes')`).all(...filePaths, excludeAgentId, withinMinutes);
         for (const r of rows) {
             let set = index.get(r.file_path);