@hasna/todos 0.10.4 → 0.10.7

package/dist/cli/index.js

@@ -6,39 +6,60 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
-var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -2876,6 +2897,20 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived'));
   CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
   INSERT OR IGNORE INTO _migrations (id) VALUES (30);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS file_locks (
+    id TEXT PRIMARY KEY,
+    path TEXT NOT NULL UNIQUE,
+    agent_id TEXT NOT NULL,
+    task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+    expires_at TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_file_locks_path ON file_locks(path);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_agent ON file_locks(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_expires ON file_locks(expires_at);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (31);
   `
   ];
 });
@@ -9774,6 +9809,7 @@ __export(exports_task_files, {
   updateTaskFileStatus: () => updateTaskFileStatus,
   removeTaskFile: () => removeTaskFile,
   listTaskFiles: () => listTaskFiles,
+  listActiveFiles: () => listActiveFiles,
   getTaskFile: () => getTaskFile,
   findTasksByFile: () => findTasksByFile,
   bulkAddTaskFiles: () => bulkAddTaskFiles,
@@ -9816,6 +9852,31 @@ function removeTaskFile(taskId, path, db) {
   const result = d.run("DELETE FROM task_files WHERE task_id = ? AND path = ?", [taskId, path]);
   return result.changes > 0;
 }
+function listActiveFiles(db) {
+  const d = db || getDatabase();
+  return d.query(`
+    SELECT
+      tf.path,
+      tf.status AS file_status,
+      tf.agent_id AS file_agent_id,
+      tf.note,
+      tf.updated_at,
+      t.id AS task_id,
+      t.short_id AS task_short_id,
+      t.title AS task_title,
+      t.status AS task_status,
+      t.locked_by AS task_locked_by,
+      t.locked_at AS task_locked_at,
+      a.id AS agent_id,
+      a.name AS agent_name
+    FROM task_files tf
+    JOIN tasks t ON tf.task_id = t.id
+    LEFT JOIN agents a ON (tf.agent_id = a.id OR (tf.agent_id IS NULL AND t.assigned_to = a.id))
+    WHERE t.status = 'in_progress'
+      AND tf.status != 'removed'
+    ORDER BY tf.updated_at DESC
+  `).all();
+}
 function bulkAddTaskFiles(taskId, paths, agentId, db) {
   const d = db || getDatabase();
   const results = [];
@@ -9831,6 +9892,74 @@ var init_task_files = __esm(() => {
   init_database();
 });
 
+// src/db/file-locks.ts
+var exports_file_locks = {};
+__export(exports_file_locks, {
+  unlockFile: () => unlockFile,
+  lockFile: () => lockFile,
+  listFileLocks: () => listFileLocks,
+  forceUnlockFile: () => forceUnlockFile,
+  cleanExpiredFileLocks: () => cleanExpiredFileLocks,
+  checkFileLock: () => checkFileLock,
+  FILE_LOCK_DEFAULT_TTL_SECONDS: () => FILE_LOCK_DEFAULT_TTL_SECONDS
+});
+function expiresAt(ttlSeconds) {
+  return new Date(Date.now() + ttlSeconds * 1000).toISOString();
+}
+function cleanExpiredFileLocks(db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM file_locks WHERE expires_at <= ?", [now()]);
+  return result.changes;
+}
+function lockFile(input, db) {
+  const d = db || getDatabase();
+  const ttl = input.ttl_seconds ?? FILE_LOCK_DEFAULT_TTL_SECONDS;
+  const expiry = expiresAt(ttl);
+  const timestamp = now();
+  cleanExpiredFileLocks(d);
+  const existing = d.query("SELECT * FROM file_locks WHERE path = ?").get(input.path);
+  if (existing) {
+    if (existing.agent_id === input.agent_id) {
+      d.run("UPDATE file_locks SET expires_at = ?, task_id = COALESCE(?, task_id) WHERE id = ?", [expiry, input.task_id ?? null, existing.id]);
+      return d.query("SELECT * FROM file_locks WHERE id = ?").get(existing.id);
+    }
+    throw new LockError(input.path, existing.agent_id);
+  }
+  const id = uuid();
+  d.run("INSERT INTO file_locks (id, path, agent_id, task_id, expires_at, created_at) VALUES (?, ?, ?, ?, ?, ?)", [id, input.path, input.agent_id, input.task_id ?? null, expiry, timestamp]);
+  return d.query("SELECT * FROM file_locks WHERE id = ?").get(id);
+}
+function unlockFile(path, agentId, db) {
+  const d = db || getDatabase();
+  cleanExpiredFileLocks(d);
+  const result = d.run("DELETE FROM file_locks WHERE path = ? AND agent_id = ?", [path, agentId]);
+  return result.changes > 0;
+}
+function checkFileLock(path, db) {
+  const d = db || getDatabase();
+  cleanExpiredFileLocks(d);
+  return d.query("SELECT * FROM file_locks WHERE path = ?").get(path);
+}
+function listFileLocks(agentId, db) {
+  const d = db || getDatabase();
+  cleanExpiredFileLocks(d);
+  if (agentId) {
+    return d.query("SELECT * FROM file_locks WHERE agent_id = ? ORDER BY created_at DESC").all(agentId);
+  }
+  return d.query("SELECT * FROM file_locks ORDER BY created_at DESC").all();
+}
+function forceUnlockFile(path, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM file_locks WHERE path = ?", [path]);
+  return result.changes > 0;
+}
+var FILE_LOCK_DEFAULT_TTL_SECONDS;
+var init_file_locks = __esm(() => {
+  init_database();
+  init_types();
+  FILE_LOCK_DEFAULT_TTL_SECONDS = 30 * 60;
+});
+
 // src/db/handoffs.ts
 var exports_handoffs = {};
 __export(exports_handoffs, {
@@ -13189,6 +13318,107 @@ ${lines.join(`
       }
     });
   }
+  if (shouldRegisterTool("list_active_files")) {
+    server.tool("list_active_files", "Return all files linked to in-progress tasks across all agents \u2014 the bird's-eye view of what's being worked on right now.", {
+      project_id: exports_external.string().optional().describe("Filter by project")
+    }, async ({ project_id }) => {
+      try {
+        const { listActiveFiles: listActiveFiles2 } = (init_task_files(), __toCommonJS(exports_task_files));
+        let files = listActiveFiles2();
+        if (project_id) {
+          const pid = resolveId(project_id, "projects");
+          const db = (init_database(), __toCommonJS(exports_database)).getDatabase();
+          files = db.query(`
+          SELECT
+            tf.path,
+            tf.status AS file_status,
+            tf.agent_id AS file_agent_id,
+            tf.note,
+            tf.updated_at,
+            t.id AS task_id,
+            t.short_id AS task_short_id,
+            t.title AS task_title,
+            t.status AS task_status,
+            t.locked_by AS task_locked_by,
+            t.locked_at AS task_locked_at,
+            a.id AS agent_id,
+            a.name AS agent_name
+          FROM task_files tf
+          JOIN tasks t ON tf.task_id = t.id
+          LEFT JOIN agents a ON (tf.agent_id = a.id OR (tf.agent_id IS NULL AND t.assigned_to = a.id))
+          WHERE t.status = 'in_progress'
+            AND tf.status != 'removed'
+            AND t.project_id = ?
+          ORDER BY tf.updated_at DESC
+        `).all(pid);
+        }
+        if (files.length === 0) {
+          return { content: [{ type: "text", text: "No active files \u2014 no in-progress tasks have linked files." }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(files, null, 2) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("lock_file")) {
+    server.tool("lock_file", "Acquire an exclusive lock on a file path. Throws if another agent holds an active lock. Same agent re-locks refreshes the TTL.", {
+      path: exports_external.string().describe("File path to lock"),
+      agent_id: exports_external.string().describe("Agent acquiring the lock"),
+      task_id: exports_external.string().optional().describe("Task this lock is associated with"),
+      ttl_seconds: exports_external.number().optional().describe("Lock TTL in seconds (default: 1800 = 30 min)")
+    }, async ({ path, agent_id, task_id, ttl_seconds }) => {
+      try {
+        const { lockFile: lockFile2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+        const lock = lockFile2({ path, agent_id, task_id, ttl_seconds });
+        return { content: [{ type: "text", text: JSON.stringify(lock, null, 2) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("unlock_file")) {
+    server.tool("unlock_file", "Release a file lock. Only the lock holder can release it. Returns true if released.", {
+      path: exports_external.string().describe("File path to unlock"),
+      agent_id: exports_external.string().describe("Agent releasing the lock (must be the lock holder)")
+    }, async ({ path, agent_id }) => {
+      try {
+        const { unlockFile: unlockFile2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+        const released = unlockFile2(path, agent_id);
+        return { content: [{ type: "text", text: JSON.stringify({ released, path }) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("check_file_lock")) {
+    server.tool("check_file_lock", "Check who holds a lock on a file path. Returns null if unlocked or expired.", {
+      path: exports_external.string().describe("File path to check")
+    }, async ({ path }) => {
+      try {
+        const { checkFileLock: checkFileLock2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+        const lock = checkFileLock2(path);
+        if (!lock)
+          return { content: [{ type: "text", text: JSON.stringify({ path, locked: false }) }] };
+        return { content: [{ type: "text", text: JSON.stringify({ path, locked: true, ...lock }) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
+  if (shouldRegisterTool("list_file_locks")) {
+    server.tool("list_file_locks", "List all active file locks. Optionally filter by agent_id.", {
+      agent_id: exports_external.string().optional().describe("Filter locks by agent")
+    }, async ({ agent_id }) => {
+      try {
+        const { listFileLocks: listFileLocks2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+        const locks = listFileLocks2(agent_id);
+        return { content: [{ type: "text", text: JSON.stringify(locks, null, 2) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
   if (shouldRegisterTool("create_handoff")) {
     server.tool("create_handoff", "Create a session handoff note for agent coordination.", {
       agent_id: exports_external.string().optional().describe("Agent creating the handoff"),

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AA8gBtC,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAkBrD;AAyRD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAK9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAa,GAAG,MAAM,CAG3D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B9F"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AA6hBtC,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAkBrD;AAyRD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAK9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAa,GAAG,MAAM,CAG3D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B9F"}

package/dist/db/file-locks.d.ts

@@ -0,0 +1,43 @@
+import type { Database } from "bun:sqlite";
+export declare const FILE_LOCK_DEFAULT_TTL_SECONDS: number;
+export interface FileLock {
+    id: string;
+    path: string;
+    agent_id: string;
+    task_id: string | null;
+    expires_at: string;
+    created_at: string;
+}
+export interface LockFileInput {
+    path: string;
+    agent_id: string;
+    task_id?: string;
+    /** TTL in seconds (default: 1800 = 30 min) */
+    ttl_seconds?: number;
+}
+/** Clean up expired locks. Called automatically on read operations. */
+export declare function cleanExpiredFileLocks(db?: Database): number;
+/**
+ * Acquire an exclusive lock on a file path.
+ * - If no lock exists (or existing lock is expired), lock is granted.
+ * - If same agent already holds the lock, the TTL is refreshed.
+ * - If another agent holds an active lock, throws LockError.
+ */
+export declare function lockFile(input: LockFileInput, db?: Database): FileLock;
+/**
+ * Release a file lock. Only the lock holder can release it.
+ * Returns true if released, false if not found or wrong agent.
+ */
+export declare function unlockFile(path: string, agentId: string, db?: Database): boolean;
+/**
+ * Check who holds a lock on a file path.
+ * Returns null if unlocked or expired.
+ */
+export declare function checkFileLock(path: string, db?: Database): FileLock | null;
+/**
+ * List all active (non-expired) file locks, optionally filtered by agent.
+ */
+export declare function listFileLocks(agentId?: string, db?: Database): FileLock[];
+/** Force-release a lock regardless of which agent holds it (admin operation). */
+export declare function forceUnlockFile(path: string, db?: Database): boolean;
+//# sourceMappingURL=file-locks.d.ts.map

package/dist/db/file-locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-locks.d.ts","sourceRoot":"","sources":["../../src/db/file-locks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,eAAO,MAAM,6BAA6B,QAAU,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CA8BtE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAQhF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAOzE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAIpE"}

package/dist/db/task-files.d.ts

@@ -22,5 +22,21 @@ export declare function listTaskFiles(taskId: string, db?: Database): TaskFile[]
 export declare function findTasksByFile(path: string, db?: Database): TaskFile[];
 export declare function updateTaskFileStatus(taskId: string, path: string, status: TaskFile["status"], agentId?: string, db?: Database): TaskFile | null;
 export declare function removeTaskFile(taskId: string, path: string, db?: Database): boolean;
+export interface ActiveFileInfo {
+    path: string;
+    file_status: TaskFile["status"];
+    file_agent_id: string | null;
+    note: string | null;
+    updated_at: string;
+    task_id: string;
+    task_short_id: string | null;
+    task_title: string;
+    task_status: string;
+    task_locked_by: string | null;
+    task_locked_at: string | null;
+    agent_id: string | null;
+    agent_name: string | null;
+}
+export declare function listActiveFiles(db?: Database): ActiveFileInfo[];
 export declare function bulkAddTaskFiles(taskId: string, paths: string[], agentId?: string, db?: Database): TaskFile[];
 //# sourceMappingURL=task-files.d.ts.map

package/dist/db/task-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-files.d.ts","sourceRoot":"","sources":["../../src/db/task-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAwB5E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAGtE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAKvE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAKvE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,QAAQ,GAAG,IAAI,CAWjB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,QAAQ,EAAE,CAUZ"}
+{"version":3,"file":"task-files.d.ts","sourceRoot":"","sources":["../../src/db/task-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAwB5E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAGtE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAKvE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAKvE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,QAAQ,GAAG,IAAI,CAWjB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,cAAc,EAAE,CAwB/D;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,QAAQ,EAAE,CAUZ"}

package/dist/index.js

@@ -702,6 +702,20 @@ var MIGRATIONS = [
   ALTER TABLE agents ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived'));
   CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
   INSERT OR IGNORE INTO _migrations (id) VALUES (30);
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS file_locks (
+    id TEXT PRIMARY KEY,
+    path TEXT NOT NULL UNIQUE,
+    agent_id TEXT NOT NULL,
+    task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+    expires_at TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_file_locks_path ON file_locks(path);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_agent ON file_locks(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_expires ON file_locks(expires_at);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (31);
   `
 ];
 var _db = null;

package/dist/mcp/index.js

@@ -4,32 +4,160 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
+function __accessProp(key) {
+  return this[key];
+}
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
+// src/types/index.ts
+var VersionConflictError, TaskNotFoundError, ProjectNotFoundError, PlanNotFoundError, LockError, AgentNotFoundError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError;
+var init_types = __esm(() => {
+  VersionConflictError = class VersionConflictError extends Error {
+    taskId;
+    expectedVersion;
+    actualVersion;
+    static code = "VERSION_CONFLICT";
+    static suggestion = "Fetch the task with get_task to get the current version before updating.";
+    constructor(taskId, expectedVersion, actualVersion) {
+      super(`Version conflict for task ${taskId}: expected ${expectedVersion}, got ${actualVersion}`);
+      this.taskId = taskId;
+      this.expectedVersion = expectedVersion;
+      this.actualVersion = actualVersion;
+      this.name = "VersionConflictError";
+    }
+  };
+  TaskNotFoundError = class TaskNotFoundError extends Error {
+    taskId;
+    static code = "TASK_NOT_FOUND";
+    static suggestion = "Verify the task ID. Use list_tasks or search_tasks to find the correct ID.";
+    constructor(taskId) {
+      super(`Task not found: ${taskId}`);
+      this.taskId = taskId;
+      this.name = "TaskNotFoundError";
+    }
+  };
+  ProjectNotFoundError = class ProjectNotFoundError extends Error {
+    projectId;
+    static code = "PROJECT_NOT_FOUND";
+    static suggestion = "Use list_projects to see available projects.";
+    constructor(projectId) {
+      super(`Project not found: ${projectId}`);
+      this.projectId = projectId;
+      this.name = "ProjectNotFoundError";
+    }
+  };
+  PlanNotFoundError = class PlanNotFoundError extends Error {
+    planId;
+    static code = "PLAN_NOT_FOUND";
+    static suggestion = "Use list_plans to see available plans.";
+    constructor(planId) {
+      super(`Plan not found: ${planId}`);
+      this.planId = planId;
+      this.name = "PlanNotFoundError";
+    }
+  };
+  LockError = class LockError extends Error {
+    taskId;
+    lockedBy;
+    static code = "LOCK_ERROR";
+    static suggestion = "Wait for the lock to expire (30 min) or contact the lock holder.";
+    constructor(taskId, lockedBy) {
+      super(`Task ${taskId} is locked by ${lockedBy}`);
+      this.taskId = taskId;
+      this.lockedBy = lockedBy;
+      this.name = "LockError";
+    }
+  };
+  AgentNotFoundError = class AgentNotFoundError extends Error {
+    agentId;
+    static code = "AGENT_NOT_FOUND";
+    static suggestion = "Use register_agent to create the agent first, or list_agents to find existing ones.";
+    constructor(agentId) {
+      super(`Agent not found: ${agentId}`);
+      this.agentId = agentId;
+      this.name = "AgentNotFoundError";
+    }
+  };
+  TaskListNotFoundError = class TaskListNotFoundError extends Error {
+    taskListId;
+    static code = "TASK_LIST_NOT_FOUND";
+    static suggestion = "Use list_task_lists to see available lists.";
+    constructor(taskListId) {
+      super(`Task list not found: ${taskListId}`);
+      this.taskListId = taskListId;
+      this.name = "TaskListNotFoundError";
+    }
+  };
+  DependencyCycleError = class DependencyCycleError extends Error {
+    taskId;
+    dependsOn;
+    static code = "DEPENDENCY_CYCLE";
+    static suggestion = "Check the dependency chain with get_task to avoid circular references.";
+    constructor(taskId, dependsOn) {
+      super(`Adding dependency ${taskId} -> ${dependsOn} would create a cycle`);
+      this.taskId = taskId;
+      this.dependsOn = dependsOn;
+      this.name = "DependencyCycleError";
+    }
+  };
+  CompletionGuardError = class CompletionGuardError extends Error {
+    reason;
+    retryAfterSeconds;
+    static code = "COMPLETION_BLOCKED";
+    static suggestion = "Wait for the cooldown period, then retry.";
+    constructor(reason, retryAfterSeconds) {
+      super(reason);
+      this.reason = reason;
+      this.retryAfterSeconds = retryAfterSeconds;
+      this.name = "CompletionGuardError";
+    }
+  };
+});
+
 // src/db/database.ts
+var exports_database = {};
+__export(exports_database, {
+  uuid: () => uuid,
+  resolvePartialId: () => resolvePartialId,
+  resetDatabase: () => resetDatabase,
+  now: () => now,
+  lockExpiryCutoff: () => lockExpiryCutoff,
+  isLockExpired: () => isLockExpired,
+  getDatabase: () => getDatabase,
+  closeDatabase: () => closeDatabase,
+  clearExpiredLocks: () => clearExpiredLocks,
+  LOCK_EXPIRY_MINUTES: () => LOCK_EXPIRY_MINUTES
+});
 import { Database } from "bun:sqlite";
 import { existsSync, mkdirSync } from "fs";
 import { dirname, join, resolve } from "path";
@@ -332,6 +460,15 @@ function backfillTaskTags(db) {
     }
   } catch {}
 }
+function closeDatabase() {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}
+function resetDatabase() {
+  _db = null;
+}
 function now() {
   return new Date().toISOString();
 }
@@ -805,6 +942,20 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived'));
   CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
   INSERT OR IGNORE INTO _migrations (id) VALUES (30);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS file_locks (
+    id TEXT PRIMARY KEY,
+    path TEXT NOT NULL UNIQUE,
+    agent_id TEXT NOT NULL,
+    task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+    expires_at TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_file_locks_path ON file_locks(path);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_agent ON file_locks(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_expires ON file_locks(expires_at);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (31);
   `
   ];
 });
@@ -1203,6 +1354,7 @@ __export(exports_task_files, {
   updateTaskFileStatus: () => updateTaskFileStatus,
   removeTaskFile: () => removeTaskFile,
   listTaskFiles: () => listTaskFiles,
+  listActiveFiles: () => listActiveFiles,
   getTaskFile: () => getTaskFile,
   findTasksByFile: () => findTasksByFile,
   bulkAddTaskFiles: () => bulkAddTaskFiles,
@@ -1245,6 +1397,31 @@ function removeTaskFile(taskId, path, db) {
   const result = d.run("DELETE FROM task_files WHERE task_id = ? AND path = ?", [taskId, path]);
   return result.changes > 0;
 }
+function listActiveFiles(db) {
+  const d = db || getDatabase();
+  return d.query(`
+    SELECT
+      tf.path,
+      tf.status AS file_status,
+      tf.agent_id AS file_agent_id,
+      tf.note,
+      tf.updated_at,
+      t.id AS task_id,
+      t.short_id AS task_short_id,
+      t.title AS task_title,
+      t.status AS task_status,
+      t.locked_by AS task_locked_by,
+      t.locked_at AS task_locked_at,
+      a.id AS agent_id,
+      a.name AS agent_name
+    FROM task_files tf
+    JOIN tasks t ON tf.task_id = t.id
+    LEFT JOIN agents a ON (tf.agent_id = a.id OR (tf.agent_id IS NULL AND t.assigned_to = a.id))
+    WHERE t.status = 'in_progress'
+      AND tf.status != 'removed'
+    ORDER BY tf.updated_at DESC
+  `).all();
+}
 function bulkAddTaskFiles(taskId, paths, agentId, db) {
   const d = db || getDatabase();
   const results = [];
@@ -1260,6 +1437,74 @@ var init_task_files = __esm(() => {
   init_database();
 });
 
+// src/db/file-locks.ts
+var exports_file_locks = {};
+__export(exports_file_locks, {
+  unlockFile: () => unlockFile,
+  lockFile: () => lockFile,
+  listFileLocks: () => listFileLocks,
+  forceUnlockFile: () => forceUnlockFile,
+  cleanExpiredFileLocks: () => cleanExpiredFileLocks,
+  checkFileLock: () => checkFileLock,
+  FILE_LOCK_DEFAULT_TTL_SECONDS: () => FILE_LOCK_DEFAULT_TTL_SECONDS
+});
+function expiresAt(ttlSeconds) {
+  return new Date(Date.now() + ttlSeconds * 1000).toISOString();
+}
+function cleanExpiredFileLocks(db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM file_locks WHERE expires_at <= ?", [now()]);
+  return result.changes;
+}
+function lockFile(input, db) {
+  const d = db || getDatabase();
+  const ttl = input.ttl_seconds ?? FILE_LOCK_DEFAULT_TTL_SECONDS;
+  const expiry = expiresAt(ttl);
+  const timestamp = now();
+  cleanExpiredFileLocks(d);
+  const existing = d.query("SELECT * FROM file_locks WHERE path = ?").get(input.path);
+  if (existing) {
+    if (existing.agent_id === input.agent_id) {
+      d.run("UPDATE file_locks SET expires_at = ?, task_id = COALESCE(?, task_id) WHERE id = ?", [expiry, input.task_id ?? null, existing.id]);
+      return d.query("SELECT * FROM file_locks WHERE id = ?").get(existing.id);
+    }
+    throw new LockError(input.path, existing.agent_id);
+  }
+  const id = uuid();
+  d.run("INSERT INTO file_locks (id, path, agent_id, task_id, expires_at, created_at) VALUES (?, ?, ?, ?, ?, ?)", [id, input.path, input.agent_id, input.task_id ?? null, expiry, timestamp]);
+  return d.query("SELECT * FROM file_locks WHERE id = ?").get(id);
+}
+function unlockFile(path, agentId, db) {
+  const d = db || getDatabase();
+  cleanExpiredFileLocks(d);
+  const result = d.run("DELETE FROM file_locks WHERE path = ? AND agent_id = ?", [path, agentId]);
+  return result.changes > 0;
+}
+function checkFileLock(path, db) {
+  const d = db || getDatabase();
+  cleanExpiredFileLocks(d);
+  return d.query("SELECT * FROM file_locks WHERE path = ?").get(path);
+}
+function listFileLocks(agentId, db) {
+  const d = db || getDatabase();
+  cleanExpiredFileLocks(d);
+  if (agentId) {
+    return d.query("SELECT * FROM file_locks WHERE agent_id = ? ORDER BY created_at DESC").all(agentId);
+  }
+  return d.query("SELECT * FROM file_locks ORDER BY created_at DESC").all();
+}
+function forceUnlockFile(path, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM file_locks WHERE path = ?", [path]);
+  return result.changes > 0;
+}
+var FILE_LOCK_DEFAULT_TTL_SECONDS;
+var init_file_locks = __esm(() => {
+  init_database();
+  init_types();
+  FILE_LOCK_DEFAULT_TTL_SECONDS = 30 * 60;
+});
+
 // src/db/handoffs.ts
 var exports_handoffs = {};
 __export(exports_handoffs, {
@@ -5886,120 +6131,12 @@ var coerce = {
   date: (arg) => ZodDate.create({ ...arg, coerce: true })
 };
 var NEVER = INVALID;
-// src/types/index.ts
-class VersionConflictError extends Error {
-  taskId;
-  expectedVersion;
-  actualVersion;
-  static code = "VERSION_CONFLICT";
-  static suggestion = "Fetch the task with get_task to get the current version before updating.";
-  constructor(taskId, expectedVersion, actualVersion) {
-    super(`Version conflict for task ${taskId}: expected ${expectedVersion}, got ${actualVersion}`);
-    this.taskId = taskId;
-    this.expectedVersion = expectedVersion;
-    this.actualVersion = actualVersion;
-    this.name = "VersionConflictError";
-  }
-}
-
-class TaskNotFoundError extends Error {
-  taskId;
-  static code = "TASK_NOT_FOUND";
-  static suggestion = "Verify the task ID. Use list_tasks or search_tasks to find the correct ID.";
-  constructor(taskId) {
-    super(`Task not found: ${taskId}`);
-    this.taskId = taskId;
-    this.name = "TaskNotFoundError";
-  }
-}
-
-class ProjectNotFoundError extends Error {
-  projectId;
-  static code = "PROJECT_NOT_FOUND";
-  static suggestion = "Use list_projects to see available projects.";
-  constructor(projectId) {
-    super(`Project not found: ${projectId}`);
-    this.projectId = projectId;
-    this.name = "ProjectNotFoundError";
-  }
-}
-
-class PlanNotFoundError extends Error {
-  planId;
-  static code = "PLAN_NOT_FOUND";
-  static suggestion = "Use list_plans to see available plans.";
-  constructor(planId) {
-    super(`Plan not found: ${planId}`);
-    this.planId = planId;
-    this.name = "PlanNotFoundError";
-  }
-}
-
-class LockError extends Error {
-  taskId;
-  lockedBy;
-  static code = "LOCK_ERROR";
-  static suggestion = "Wait for the lock to expire (30 min) or contact the lock holder.";
-  constructor(taskId, lockedBy) {
-    super(`Task ${taskId} is locked by ${lockedBy}`);
-    this.taskId = taskId;
-    this.lockedBy = lockedBy;
-    this.name = "LockError";
-  }
-}
-
-class AgentNotFoundError extends Error {
-  agentId;
-  static code = "AGENT_NOT_FOUND";
-  static suggestion = "Use register_agent to create the agent first, or list_agents to find existing ones.";
-  constructor(agentId) {
-    super(`Agent not found: ${agentId}`);
-    this.agentId = agentId;
-    this.name = "AgentNotFoundError";
-  }
-}
-
-class TaskListNotFoundError extends Error {
-  taskListId;
-  static code = "TASK_LIST_NOT_FOUND";
-  static suggestion = "Use list_task_lists to see available lists.";
-  constructor(taskListId) {
-    super(`Task list not found: ${taskListId}`);
-    this.taskListId = taskListId;
-    this.name = "TaskListNotFoundError";
-  }
-}
-
-class DependencyCycleError extends Error {
-  taskId;
-  dependsOn;
-  static code = "DEPENDENCY_CYCLE";
-  static suggestion = "Check the dependency chain with get_task to avoid circular references.";
-  constructor(taskId, dependsOn) {
-    super(`Adding dependency ${taskId} -> ${dependsOn} would create a cycle`);
-    this.taskId = taskId;
-    this.dependsOn = dependsOn;
-    this.name = "DependencyCycleError";
-  }
-}
-
-class CompletionGuardError extends Error {
-  reason;
-  retryAfterSeconds;
-  static code = "COMPLETION_BLOCKED";
-  static suggestion = "Wait for the cooldown period, then retry.";
-  constructor(reason, retryAfterSeconds) {
-    super(reason);
-    this.reason = reason;
-    this.retryAfterSeconds = retryAfterSeconds;
-    this.name = "CompletionGuardError";
-  }
-}
-
 // src/db/tasks.ts
+init_types();
 init_database();
 
 // src/db/projects.ts
+init_types();
 init_database();
 function slugify(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
@@ -6088,6 +6225,9 @@ function nextTaskShortId(projectId, db) {
   return `${updated.task_prefix}-${padded}`;
 }
 
+// src/lib/completion-guard.ts
+init_types();
+
 // src/lib/config.ts
 import { existsSync as existsSync3 } from "fs";
 import { join as join3 } from "path";
@@ -7431,6 +7571,7 @@ function bulkUpdateTasks(taskIds, updates, db) {
 }
 
 // src/db/comments.ts
+init_types();
 init_database();
 function addComment(input, db) {
   const d = db || getDatabase();
@@ -7461,6 +7602,7 @@ function getComment(id, db) {
 }
 
 // src/db/plans.ts
+init_types();
 init_database();
 function createPlan(input, db) {
   const d = db || getDatabase();
@@ -7533,6 +7675,7 @@ function deletePlan(id, db) {
 init_agents();
 
 // src/db/task-lists.ts
+init_types();
 init_database();
 function rowToTaskList(row) {
   return {
@@ -8219,6 +8362,7 @@ function syncWithAgents(agents, taskListIdByAgent, projectId, direction = "both"
 
 // src/mcp/index.ts
 init_database();
+init_types();
 import { readFileSync as readFileSync3 } from "fs";
 import { join as join6, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
@@ -10902,6 +11046,107 @@ ${lines.join(`
     }
   });
 }
+if (shouldRegisterTool("list_active_files")) {
+  server.tool("list_active_files", "Return all files linked to in-progress tasks across all agents \u2014 the bird's-eye view of what's being worked on right now.", {
+    project_id: exports_external.string().optional().describe("Filter by project")
+  }, async ({ project_id }) => {
+    try {
+      const { listActiveFiles: listActiveFiles2 } = (init_task_files(), __toCommonJS(exports_task_files));
+      let files = listActiveFiles2();
+      if (project_id) {
+        const pid = resolveId(project_id, "projects");
+        const db = (init_database(), __toCommonJS(exports_database)).getDatabase();
+        files = db.query(`
+          SELECT
+            tf.path,
+            tf.status AS file_status,
+            tf.agent_id AS file_agent_id,
+            tf.note,
+            tf.updated_at,
+            t.id AS task_id,
+            t.short_id AS task_short_id,
+            t.title AS task_title,
+            t.status AS task_status,
+            t.locked_by AS task_locked_by,
+            t.locked_at AS task_locked_at,
+            a.id AS agent_id,
+            a.name AS agent_name
+          FROM task_files tf
+          JOIN tasks t ON tf.task_id = t.id
+          LEFT JOIN agents a ON (tf.agent_id = a.id OR (tf.agent_id IS NULL AND t.assigned_to = a.id))
+          WHERE t.status = 'in_progress'
+            AND tf.status != 'removed'
+            AND t.project_id = ?
+          ORDER BY tf.updated_at DESC
+        `).all(pid);
+      }
+      if (files.length === 0) {
+        return { content: [{ type: "text", text: "No active files \u2014 no in-progress tasks have linked files." }] };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(files, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("lock_file")) {
+  server.tool("lock_file", "Acquire an exclusive lock on a file path. Throws if another agent holds an active lock. Same agent re-locks refreshes the TTL.", {
+    path: exports_external.string().describe("File path to lock"),
+    agent_id: exports_external.string().describe("Agent acquiring the lock"),
+    task_id: exports_external.string().optional().describe("Task this lock is associated with"),
+    ttl_seconds: exports_external.number().optional().describe("Lock TTL in seconds (default: 1800 = 30 min)")
+  }, async ({ path, agent_id, task_id, ttl_seconds }) => {
+    try {
+      const { lockFile: lockFile2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+      const lock = lockFile2({ path, agent_id, task_id, ttl_seconds });
+      return { content: [{ type: "text", text: JSON.stringify(lock, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("unlock_file")) {
+  server.tool("unlock_file", "Release a file lock. Only the lock holder can release it. Returns true if released.", {
+    path: exports_external.string().describe("File path to unlock"),
+    agent_id: exports_external.string().describe("Agent releasing the lock (must be the lock holder)")
+  }, async ({ path, agent_id }) => {
+    try {
+      const { unlockFile: unlockFile2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+      const released = unlockFile2(path, agent_id);
+      return { content: [{ type: "text", text: JSON.stringify({ released, path }) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("check_file_lock")) {
+  server.tool("check_file_lock", "Check who holds a lock on a file path. Returns null if unlocked or expired.", {
+    path: exports_external.string().describe("File path to check")
+  }, async ({ path }) => {
+    try {
+      const { checkFileLock: checkFileLock2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+      const lock = checkFileLock2(path);
+      if (!lock)
+        return { content: [{ type: "text", text: JSON.stringify({ path, locked: false }) }] };
+      return { content: [{ type: "text", text: JSON.stringify({ path, locked: true, ...lock }) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
+if (shouldRegisterTool("list_file_locks")) {
+  server.tool("list_file_locks", "List all active file locks. Optionally filter by agent_id.", {
+    agent_id: exports_external.string().optional().describe("Filter locks by agent")
+  }, async ({ agent_id }) => {
+    try {
+      const { listFileLocks: listFileLocks2 } = (init_file_locks(), __toCommonJS(exports_file_locks));
+      const locks = listFileLocks2(agent_id);
+      return { content: [{ type: "text", text: JSON.stringify(locks, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("create_handoff")) {
   server.tool("create_handoff", "Create a session handoff note for agent coordination.", {
     agent_id: exports_external.string().optional().describe("Agent creating the handoff"),

package/dist/server/index.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env bun
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -854,6 +858,20 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'archived'));
   CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
   INSERT OR IGNORE INTO _migrations (id) VALUES (30);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS file_locks (
+    id TEXT PRIMARY KEY,
+    path TEXT NOT NULL UNIQUE,
+    agent_id TEXT NOT NULL,
+    task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+    expires_at TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_file_locks_path ON file_locks(path);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_agent ON file_locks(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_file_locks_expires ON file_locks(expires_at);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (31);
   `
   ];
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.10.4",
+  "version": "0.10.7",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",