@hasna/todos 0.10.5 → 0.10.8

package/dist/cli/index.js

@@ -2897,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);
   `
   ];
 });
@@ -4807,7 +4821,7 @@ function registerAgent(input, db) {
         session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
         working_dir: existing.working_dir,
         suggestions: suggestions.slice(0, 5),
-        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id?.slice(0, 8)}\u2026, dir: ${existing.working_dir ?? "unknown"}). Are you that agent? If so, pass session_id="${existing.session_id}" to reclaim it. Otherwise choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
+        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session \u2026${existing.session_id?.slice(-4)}, dir: ${existing.working_dir ?? "unknown"}). Cannot reclaim an active agent \u2014 choose a different name, or wait for the session to go stale.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
       };
     }
     const updates = ["last_seen_at = ?", "status = 'active'"];
@@ -9878,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, {
@@ -13279,6 +13361,64 @@ ${lines.join(`
       }
     });
   }
+  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/agents.d.ts.map

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

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/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;
@@ -2871,7 +2885,7 @@ function registerAgent(input, db) {
         session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
         working_dir: existing.working_dir,
         suggestions: suggestions.slice(0, 5),
-        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id?.slice(0, 8)}\u2026, dir: ${existing.working_dir ?? "unknown"}). Are you that agent? If so, pass session_id="${existing.session_id}" to reclaim it. Otherwise choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
+        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session \u2026${existing.session_id?.slice(-4)}, dir: ${existing.working_dir ?? "unknown"}). Cannot reclaim an active agent \u2014 choose a different name, or wait for the session to go stale.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
       };
     }
     const updates = ["last_seen_at = ?", "status = 'active'"];

package/dist/mcp/index.js

@@ -39,6 +39,111 @@ var __export = (target, all) => {
 };
 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, {
@@ -837,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);
   `
   ];
 });
@@ -1042,7 +1161,7 @@ function registerAgent(input, db) {
         session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
         working_dir: existing.working_dir,
         suggestions: suggestions.slice(0, 5),
-        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id?.slice(0, 8)}\u2026, dir: ${existing.working_dir ?? "unknown"}). Are you that agent? If so, pass session_id="${existing.session_id}" to reclaim it. Otherwise choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
+        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session \u2026${existing.session_id?.slice(-4)}, dir: ${existing.working_dir ?? "unknown"}). Cannot reclaim an active agent \u2014 choose a different name, or wait for the session to go stale.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
       };
     }
     const updates = ["last_seen_at = ?", "status = 'active'"];
@@ -1318,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, {
@@ -5944,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, "");
@@ -6146,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";
@@ -7489,6 +7571,7 @@ function bulkUpdateTasks(taskIds, updates, db) {
 }
 
 // src/db/comments.ts
+init_types();
 init_database();
 function addComment(input, db) {
   const d = db || getDatabase();
@@ -7519,6 +7602,7 @@ function getComment(id, db) {
 }
 
 // src/db/plans.ts
+init_types();
 init_database();
 function createPlan(input, db) {
   const d = db || getDatabase();
@@ -7591,6 +7675,7 @@ function deletePlan(id, db) {
 init_agents();
 
 // src/db/task-lists.ts
+init_types();
 init_database();
 function rowToTaskList(row) {
   return {
@@ -8277,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";
@@ -11003,6 +11089,64 @@ if (shouldRegisterTool("list_active_files")) {
     }
   });
 }
+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

@@ -858,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);
   `
   ];
 });
@@ -2523,7 +2537,7 @@ function registerAgent(input, db) {
         session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
         working_dir: existing.working_dir,
         suggestions: suggestions.slice(0, 5),
-        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session ${existing.session_id?.slice(0, 8)}\u2026, dir: ${existing.working_dir ?? "unknown"}). Are you that agent? If so, pass session_id="${existing.session_id}" to reclaim it. Otherwise choose a different name.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
+        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago, session \u2026${existing.session_id?.slice(-4)}, dir: ${existing.working_dir ?? "unknown"}). Cannot reclaim an active agent \u2014 choose a different name, or wait for the session to go stale.${suggestions.length > 0 ? ` Available: ${suggestions.slice(0, 3).join(", ")}` : ""}`
       };
     }
     const updates = ["last_seen_at = ?", "status = 'active'"];

package/package.json

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