@vheins/local-memory-mcp 0.9.8 → 0.9.10

package/dist/{chunk-CSEGUZWJ.js → chunk-GAZNK32C.js}

@@ -3,8 +3,8 @@ import { fileURLToPath } from "url";
 import path from "path";
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
 var pkgVersion = "0.1.0";
-if ("0.9.8") {
-  pkgVersion = "0.9.8";
+if ("0.9.10") {
+  pkgVersion = "0.9.10";
 } else {
   let searchDir = __dirname;
   for (let i = 0; i < 5; i++) {
@@ -981,6 +981,17 @@ var BaseEntity = class {
       depends_on: r.depends_on || null,
       parent_code: r.parent_code || null,
       depends_on_code: r.depends_on_code || null,
+      coordination: {
+        active_claim_count: r.active_claim_count || 0,
+        active_claim_agent: r.active_claim_agent || null,
+        active_claim_role: r.active_claim_role || null,
+        active_claim_claimed_at: r.active_claim_claimed_at || null,
+        pending_handoff_count: r.pending_handoff_count || 0,
+        pending_handoff_id: r.pending_handoff_id || null,
+        pending_handoff_summary: r.pending_handoff_summary || null,
+        pending_handoff_to_agent: r.pending_handoff_to_agent || null,
+        pending_handoff_created_at: r.pending_handoff_created_at || null
+      },
       comments_count: r.comments_count || 0
     };
   }
@@ -1446,6 +1457,19 @@ var MemoryEntity = class extends BaseEntity {
 
 // src/mcp/entities/task.ts
 var TaskEntity = class extends BaseEntity {
+  coordinationSelect(alias = "t") {
+    return `
+			(SELECT COUNT(*) FROM claims c WHERE c.task_id = ${alias}.id AND c.released_at IS NULL) as active_claim_count,
+			(SELECT c.agent FROM claims c WHERE c.task_id = ${alias}.id AND c.released_at IS NULL ORDER BY c.claimed_at DESC LIMIT 1) as active_claim_agent,
+			(SELECT c.role FROM claims c WHERE c.task_id = ${alias}.id AND c.released_at IS NULL ORDER BY c.claimed_at DESC LIMIT 1) as active_claim_role,
+			(SELECT c.claimed_at FROM claims c WHERE c.task_id = ${alias}.id AND c.released_at IS NULL ORDER BY c.claimed_at DESC LIMIT 1) as active_claim_claimed_at,
+			(SELECT COUNT(*) FROM handoffs h WHERE h.task_id = ${alias}.id AND h.status = 'pending') as pending_handoff_count,
+			(SELECT h.id FROM handoffs h WHERE h.task_id = ${alias}.id AND h.status = 'pending' ORDER BY h.created_at DESC LIMIT 1) as pending_handoff_id,
+			(SELECT h.summary FROM handoffs h WHERE h.task_id = ${alias}.id AND h.status = 'pending' ORDER BY h.created_at DESC LIMIT 1) as pending_handoff_summary,
+			(SELECT h.to_agent FROM handoffs h WHERE h.task_id = ${alias}.id AND h.status = 'pending' ORDER BY h.created_at DESC LIMIT 1) as pending_handoff_to_agent,
+			(SELECT h.created_at FROM handoffs h WHERE h.task_id = ${alias}.id AND h.status = 'pending' ORDER BY h.created_at DESC LIMIT 1) as pending_handoff_created_at
+		`;
+  }
   insertTask(task) {
     this.run(
       `INSERT INTO tasks (
@@ -1524,7 +1548,8 @@ var TaskEntity = class extends BaseEntity {
   }
   getTaskById(id) {
     const row = this.get(
-      `SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code 
+      `SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code,
+				${this.coordinationSelect("t")}
 			 FROM tasks t 
 			 LEFT JOIN tasks d ON t.depends_on = d.id 
 			 LEFT JOIN tasks p ON t.parent_id = p.id 
@@ -1538,6 +1563,7 @@ var TaskEntity = class extends BaseEntity {
     const placeholders = ids.map(() => "?").join(",");
     const rows = this.all(
       `SELECT t.*, d.task_code as depends_on_code,
+				${this.coordinationSelect("t")},
 				(SELECT COUNT(*) FROM task_comments WHERE task_id = t.id) as comments_count
 			FROM tasks t
 			LEFT JOIN tasks d ON t.depends_on = d.id
@@ -1563,7 +1589,8 @@ var TaskEntity = class extends BaseEntity {
   }
   getTaskByCode(repo, taskCode) {
     const row = this.get(
-      `SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code 
+      `SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code,
+				${this.coordinationSelect("t")}
 			 FROM tasks t 
 			 LEFT JOIN tasks d ON t.depends_on = d.id 
 			 LEFT JOIN tasks p ON t.parent_id = p.id 
@@ -1575,6 +1602,7 @@ var TaskEntity = class extends BaseEntity {
   getTasksByRepo(repo, status, limit, offset, search) {
     let query = `
 			SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code,
+				${this.coordinationSelect("t")},
 				(SELECT COUNT(*) FROM task_comments WHERE task_id = t.id) as comments_count
 			FROM tasks t 
 			LEFT JOIN tasks d ON t.depends_on = d.id 
@@ -1631,6 +1659,7 @@ var TaskEntity = class extends BaseEntity {
   listRecentTasks(limit = 50, offset = 0) {
     const query = `
 		SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code,
+			${this.coordinationSelect("t")},
 			(SELECT COUNT(*) FROM task_comments WHERE task_id = t.id) as comments_count
 		FROM tasks t 
 		LEFT JOIN tasks d ON t.depends_on = d.id 
@@ -1656,6 +1685,7 @@ var TaskEntity = class extends BaseEntity {
     if (!statuses.length) return this.getTasksByRepo(repo, void 0, limit, offset, search);
     let query = `
 			SELECT t.*, d.task_code as depends_on_code, p.task_code as parent_code,
+				${this.coordinationSelect("t")},
 				(SELECT COUNT(*) FROM task_comments WHERE task_id = t.id) as comments_count
 			FROM tasks t 
 			LEFT JOIN tasks d ON t.depends_on = d.id 
@@ -1823,6 +1853,8 @@ var TaskEntity = class extends BaseEntity {
     else if (period === "weekly") dateFilter = "AND date(COALESCE(finished_at, updated_at)) >= date('now', '-7 days')";
     else if (period === "monthly")
       dateFilter = "AND date(COALESCE(finished_at, updated_at)) >= date('now', '-30 days')";
+    const repoWhere = repo ? "repo = ?" : "1=1";
+    const repoParams = repo ? [repo] : [];
     const stats = this.get(
       `SELECT 
 				COUNT(*) as completed_count,
@@ -1835,18 +1867,19 @@ var TaskEntity = class extends BaseEntity {
 					END
 				) as avg_duration_seconds
 			FROM tasks 
-			WHERE repo = ? 
+			WHERE ${repoWhere}
 			AND status = 'completed' 
 			${dateFilter}`,
-      [repo]
+      repoParams
     );
     let addedDateFilter = "";
     if (period === "daily") addedDateFilter = "AND date(created_at) = date('now')";
     else if (period === "weekly") addedDateFilter = "AND date(created_at) >= date('now', '-7 days')";
     else if (period === "monthly") addedDateFilter = "AND date(created_at) >= date('now', '-30 days')";
-    const added = this.get(`SELECT COUNT(*) as count FROM tasks WHERE repo = ? ${addedDateFilter}`, [
-      repo
-    ]);
+    const added = this.get(
+      `SELECT COUNT(*) as count FROM tasks WHERE ${repoWhere} ${addedDateFilter}`,
+      repoParams
+    );
     const avgDurationMinutes = stats?.avg_duration_seconds ? stats.avg_duration_seconds / 60 : 0;
     return {
       completed: stats?.completed_count || 0,
@@ -1871,27 +1904,30 @@ var TaskEntity = class extends BaseEntity {
       labelFormat = "%Y-%m";
       dateFilter = "1=1";
     }
+    const createdDateFilter = dateFilter.replace("COALESCE(finished_at, created_at)", "created_at");
+    const completedDateFilter = dateFilter.replace("COALESCE(finished_at, created_at)", "COALESCE(finished_at, updated_at)");
+    const createdRepoFilter = repo ? "repo = ? AND " : "";
+    const completedRepoFilter = repo ? "repo = ? AND " : "";
     const query = `
 			SELECT label, SUM(created) as created, SUM(completed) as completed
 			FROM (
 				SELECT strftime(?, created_at) as label, 1 as created, 0 as completed 
 				FROM tasks 
-				WHERE repo = ? AND ${dateFilter.replace("COALESCE(finished_at, created_at)", "created_at")}
+				WHERE ${createdRepoFilter}${createdDateFilter}
 				UNION ALL
 				SELECT strftime(?, COALESCE(finished_at, updated_at)) as label, 0 as created, 1 as completed 
 				FROM tasks 
-				WHERE repo = ? AND status = 'completed' AND ${dateFilter.replace("COALESCE(finished_at, created_at)", "COALESCE(finished_at, updated_at)")}
+				WHERE ${completedRepoFilter}status = 'completed' AND ${completedDateFilter}
 			)
 			GROUP BY label
 			ORDER BY label ASC
 			LIMIT 100
 		`;
-    return this.all(query, [
-      labelFormat,
-      repo,
-      labelFormat,
-      repo
-    ]);
+    const params = [labelFormat];
+    if (repo) params.push(repo);
+    params.push(labelFormat);
+    if (repo) params.push(repo);
+    return this.all(query, params);
   }
 };
 
@@ -1983,12 +2019,49 @@ var ActionEntity = class extends BaseEntity {
 
 // src/mcp/entities/system.ts
 var SystemEntity = class extends BaseEntity {
+  buildTaskStats(rows) {
+    const taskStats = {
+      total: 0,
+      backlog: 0,
+      pending: 0,
+      in_progress: 0,
+      completed: 0,
+      blocked: 0,
+      canceled: 0
+    };
+    rows.forEach((r) => {
+      taskStats.total += r.count;
+      if (r.status === "backlog") taskStats.backlog = r.count;
+      else if (r.status === "pending") taskStats.pending = r.count;
+      else if (r.status === "in_progress") taskStats.in_progress = r.count;
+      else if (r.status === "completed") taskStats.completed = r.count;
+      else if (r.status === "blocked") taskStats.blocked = r.count;
+      else if (r.status === "canceled") taskStats.canceled = r.count;
+    });
+    return taskStats;
+  }
   listRepos() {
     const rows = this.all("SELECT DISTINCT repo FROM memories UNION SELECT DISTINCT repo FROM tasks");
     return rows.map((r) => r.repo);
   }
   listRepoNavigation() {
     const repos = this.listRepos();
+    const activeClaimRows = this.all(
+      "SELECT repo, COUNT(*) as count FROM claims WHERE released_at IS NULL GROUP BY repo"
+    );
+    const pendingHandoffRows = this.all(
+      "SELECT repo, COUNT(*) as count FROM handoffs WHERE status = 'pending' GROUP BY repo"
+    );
+    const unassignedHandoffRows = this.all(
+      "SELECT repo, COUNT(*) as count FROM handoffs WHERE status = 'pending' AND to_agent IS NULL GROUP BY repo"
+    );
+    const staleClaimRows = this.all(
+      "SELECT repo, COUNT(*) as count FROM claims WHERE released_at IS NULL AND claimed_at <= datetime('now', '-1 day') GROUP BY repo"
+    );
+    const activeClaimsByRepo = Object.fromEntries(activeClaimRows.map((row) => [row.repo, row.count]));
+    const pendingHandoffsByRepo = Object.fromEntries(pendingHandoffRows.map((row) => [row.repo, row.count]));
+    const unassignedHandoffsByRepo = Object.fromEntries(unassignedHandoffRows.map((row) => [row.repo, row.count]));
+    const staleClaimsByRepo = Object.fromEntries(staleClaimRows.map((row) => [row.repo, row.count]));
     return repos.map((repo) => {
       const memoryCountRow = this.get("SELECT COUNT(*) as count FROM memories WHERE repo = ?", [
         repo
@@ -2014,7 +2087,11 @@ var SystemEntity = class extends BaseEntity {
         pendingCount: taskStatusMap["pending"] ?? 0,
         blockedCount: taskStatusMap["blocked"] ?? 0,
         backlogCount: taskStatusMap["backlog"] ?? 0,
-        lastActivity: lastActivityRow?.last ?? null
+        lastActivity: lastActivityRow?.last ?? null,
+        activeClaims: activeClaimsByRepo[repo] ?? 0,
+        pendingHandoffs: pendingHandoffsByRepo[repo] ?? 0,
+        unassignedHandoffs: unassignedHandoffsByRepo[repo] ?? 0,
+        staleClaims: staleClaimsByRepo[repo] ?? 0
       };
     });
   }
@@ -2043,28 +2120,14 @@ var SystemEntity = class extends BaseEntity {
       "SELECT status, COUNT(*) as count FROM tasks WHERE repo = ? GROUP BY status",
       [repo]
     );
-    const taskStats = {
-      total: 0,
-      backlog: 0,
-      todo: 0,
-      inProgress: 0,
-      completed: 0,
-      blocked: 0
-    };
-    taskRows.forEach((r) => {
-      taskStats.total += r.count;
-      if (r.status === "backlog") taskStats.backlog = r.count;
-      else if (r.status === "pending") taskStats.todo = r.count;
-      else if (r.status === "in_progress") taskStats.inProgress = r.count;
-      else if (r.status === "completed") taskStats.completed = r.count;
-      else if (r.status === "blocked") taskStats.blocked = r.count;
-    });
+    const taskStats = this.buildTaskStats(taskRows);
     const topMemoriesRows = this.all(
       "SELECT * FROM memories WHERE repo = ? ORDER BY importance DESC, created_at DESC LIMIT 5",
       [repo]
     );
     const topMemories = topMemoriesRows.map((r) => this.rowToMemoryEntry(r));
     return {
+      scope: "repo",
       total: totalCountRow?.count ?? 0,
       avgImportance: (avgImportanceRow?.avg ?? 0).toFixed(1),
       totalHitCount: totalHitCountRow?.count ?? 0,
@@ -2074,6 +2137,64 @@ var SystemEntity = class extends BaseEntity {
       topMemories
     };
   }
+  getGlobalDashboardStats() {
+    const totalCountRow = this.get("SELECT COUNT(*) as count FROM memories");
+    const avgImportanceRow = this.get("SELECT AVG(importance) as avg FROM memories");
+    const totalHitCountRow = this.get("SELECT SUM(hit_count) as count FROM memories");
+    const expiringSoonRow = this.get(
+      "SELECT COUNT(*) as count FROM memories WHERE expires_at IS NOT NULL AND expires_at > ? AND expires_at <= ?",
+      [(/* @__PURE__ */ new Date()).toISOString(), new Date(Date.now() + 7 * 86400 * 1e3).toISOString()]
+    );
+    const typeStats = this.all("SELECT type, COUNT(*) as count FROM memories GROUP BY type");
+    const taskRows = this.all("SELECT status, COUNT(*) as count FROM tasks GROUP BY status");
+    const repos = this.listRepoNavigation().sort((a, b) => {
+      const pressureA = a.blockedCount * 5 + a.inProgressCount * 3 + a.pendingCount * 2 + a.pendingHandoffs * 2 + a.activeClaims;
+      const pressureB = b.blockedCount * 5 + b.inProgressCount * 3 + b.pendingCount * 2 + b.pendingHandoffs * 2 + b.activeClaims;
+      return pressureB - pressureA || (b.taskCount || 0) - (a.taskCount || 0);
+    });
+    const byType = {};
+    typeStats.forEach((t) => {
+      byType[t.type] = t.count;
+    });
+    const activeClaimsRow = this.get(
+      "SELECT COUNT(*) as count FROM claims WHERE released_at IS NULL"
+    );
+    const agentsClaimingRow = this.get(
+      "SELECT COUNT(DISTINCT agent) as count FROM claims WHERE released_at IS NULL"
+    );
+    const pendingHandoffsRow = this.get(
+      "SELECT COUNT(*) as count FROM handoffs WHERE status = 'pending'"
+    );
+    const unassignedHandoffsRow = this.get(
+      "SELECT COUNT(*) as count FROM handoffs WHERE status = 'pending' AND to_agent IS NULL"
+    );
+    const staleClaimsRow = this.get(
+      "SELECT COUNT(*) as count FROM claims WHERE released_at IS NULL AND claimed_at <= datetime('now', '-1 day')"
+    );
+    const staleHandoffsRow = this.get(
+      "SELECT COUNT(*) as count FROM handoffs WHERE status = 'pending' AND created_at <= datetime('now', '-1 day')"
+    );
+    return {
+      scope: "global",
+      total: totalCountRow?.count ?? 0,
+      avgImportance: (avgImportanceRow?.avg ?? 0).toFixed(1),
+      totalHitCount: totalHitCountRow?.count ?? 0,
+      expiringSoon: expiringSoonRow?.count ?? 0,
+      byType,
+      taskStats: this.buildTaskStats(taskRows),
+      repoCount: repos.length,
+      activeRepoCount: repos.filter((repo) => repo.inProgressCount > 0 || repo.pendingCount > 0 || repo.blockedCount > 0).length,
+      coordination: {
+        activeClaims: activeClaimsRow?.count ?? 0,
+        agentsClaiming: agentsClaimingRow?.count ?? 0,
+        pendingHandoffs: pendingHandoffsRow?.count ?? 0,
+        unassignedHandoffs: unassignedHandoffsRow?.count ?? 0,
+        staleClaims: staleClaimsRow?.count ?? 0,
+        staleHandoffs: staleHandoffsRow?.count ?? 0
+      },
+      repos
+    };
+  }
   getGlobalStats() {
     const totalMemoriesRow = this.get("SELECT COUNT(*) as count FROM memories");
     const totalTasksRow = this.get("SELECT COUNT(*) as count FROM tasks");
@@ -2368,6 +2489,7 @@ var HandoffEntity = class extends BaseEntity {
       from_agent: row.from_agent,
       to_agent: row.to_agent ?? null,
       task_id: row.task_id ?? null,
+      task_code: "task_code" in row ? row.task_code ?? null : null,
       summary: row.summary,
       context: this.safeJSONParse(row.context, {}),
       status: row.status,
@@ -2381,6 +2503,7 @@ var HandoffEntity = class extends BaseEntity {
       id: row.id,
       repo: row.repo,
       task_id: row.task_id,
+      task_code: "task_code" in row ? row.task_code ?? null : null,
       agent: row.agent,
       role: row.role,
       claimed_at: row.claimed_at,
@@ -2408,7 +2531,7 @@ var HandoffEntity = class extends BaseEntity {
         params.expires_at ?? null
       ]
     );
-    return this.rowToHandoff(this.get("SELECT * FROM handoffs WHERE id = ?", [id]));
+    return this.getHandoffById(id);
   }
   listHandoffs(params) {
     const conditions = ["repo = ?"];
@@ -2429,13 +2552,23 @@ var HandoffEntity = class extends BaseEntity {
     const offset = params.offset ?? 0;
     values.push(limit, offset);
     const rows = this.all(
-      `SELECT * FROM handoffs WHERE ${conditions.join(" AND ")} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
+      `SELECT h.*, t.task_code
+			 FROM handoffs h
+			 LEFT JOIN tasks t ON h.task_id = t.id
+			 WHERE ${conditions.map((condition) => condition.replace(/\brepo\b/g, "h.repo").replace(/\bstatus\b/g, "h.status").replace(/\bto_agent\b/g, "h.to_agent").replace(/\bfrom_agent\b/g, "h.from_agent")).join(" AND ")}
+			 ORDER BY h.created_at DESC LIMIT ? OFFSET ?`,
       values
     );
     return rows.map((r) => this.rowToHandoff(r));
   }
   getHandoffById(id) {
-    const row = this.get("SELECT * FROM handoffs WHERE id = ?", [id]);
+    const row = this.get(
+      `SELECT h.*, t.task_code
+			 FROM handoffs h
+			 LEFT JOIN tasks t ON h.task_id = t.id
+			 WHERE h.id = ?`,
+      [id]
+    );
     return row ? this.rowToHandoff(row) : null;
   }
   updateHandoffStatus(id, status) {
@@ -2473,11 +2606,23 @@ var HandoffEntity = class extends BaseEntity {
         JSON.stringify(params.metadata ?? {})
       ]
     );
-    return this.rowToClaim(this.get("SELECT * FROM claims WHERE id = ?", [id]));
+    return this.rowToClaim(
+      this.get(
+        `SELECT c.*, t.task_code
+				 FROM claims c
+				 LEFT JOIN tasks t ON c.task_id = t.id
+				 WHERE c.id = ?`,
+        [id]
+      )
+    );
   }
   getClaim(task_id) {
     const row = this.get(
-      "SELECT * FROM claims WHERE task_id = ? AND released_at IS NULL ORDER BY claimed_at DESC LIMIT 1",
+      `SELECT c.*, t.task_code
+			 FROM claims c
+			 LEFT JOIN tasks t ON c.task_id = t.id
+			 WHERE c.task_id = ? AND c.released_at IS NULL
+			 ORDER BY c.claimed_at DESC LIMIT 1`,
       [task_id]
     );
     return row ? this.rowToClaim(row) : null;
@@ -2514,7 +2659,11 @@ var HandoffEntity = class extends BaseEntity {
     const offset = params.offset ?? 0;
     values.push(limit, offset);
     const rows = this.all(
-      `SELECT * FROM claims WHERE ${conditions.join(" AND ")} ORDER BY claimed_at DESC LIMIT ? OFFSET ?`,
+      `SELECT c.*, t.task_code
+			 FROM claims c
+			 LEFT JOIN tasks t ON c.task_id = t.id
+			 WHERE ${conditions.map((condition) => condition.replace(/\brepo\b/g, "c.repo").replace(/\bagent\b/g, "c.agent").replace(/released_at/g, "c.released_at")).join(" AND ")}
+			 ORDER BY c.claimed_at DESC LIMIT ? OFFSET ?`,
       values
     );
     return rows.map((r) => this.rowToClaim(r));
@@ -3192,6 +3341,25 @@ var TaskClaimSchema = z.object({
 }).refine((data) => !(data.task_id && data.task_code), {
   message: "Provide either task_id or task_code, not both"
 });
+var ClaimListSchema = z.object({
+  repo: z.string().min(1).transform(normalizeRepo),
+  agent: z.string().min(1).optional(),
+  active_only: z.boolean().default(true),
+  limit: z.number().min(1).max(100).default(20),
+  offset: z.number().min(0).default(0),
+  structured: z.boolean().default(false)
+});
+var ClaimReleaseSchema = z.object({
+  repo: z.string().min(1).transform(normalizeRepo),
+  task_id: z.string().uuid().optional(),
+  task_code: z.string().optional(),
+  agent: z.string().min(1).optional(),
+  structured: z.boolean().default(false)
+}).refine((data) => data.task_id !== void 0 || data.task_code !== void 0, {
+  message: "Either task_id or task_code must be provided"
+}).refine((data) => !(data.task_id && data.task_code), {
+  message: "Provide either task_id or task_code, not both"
+});
 var StandardStoreSchema = z.object({
   name: z.string().min(3).max(255),
   content: z.string().min(10),
@@ -3318,7 +3486,7 @@ var TOOL_DEFINITIONS = [
         title: { type: "string", minLength: 3, maxLength: 100 },
         description: { type: "string", minLength: 1 },
         status: { type: "string", enum: ["backlog", "pending"], default: "backlog" },
-        priority: { type: "number", minimum: 1, maximum: 5, default: 3 },
+        priority: { type: "number", minimum: 1, maximum: 5, default: 3, description: "Task priority where 1=Low, 2=Normal, 3=Medium, 4=High, 5=Critical." },
         agent: { type: "string" },
         role: { type: "string" },
         doc_path: { type: "string" },
@@ -3854,7 +4022,7 @@ var TOOL_DEFINITIONS = [
           default: "backlog",
           description: "New tasks MUST start in 'backlog' if there are already 10 pending tasks. Otherwise can start in 'pending'."
         },
-        priority: { type: "number", minimum: 1, maximum: 5, default: 3 },
+        priority: { type: "number", minimum: 1, maximum: 5, default: 3, description: "Task priority where 1=Low, 2=Normal, 3=Medium, 4=High, 5=Critical." },
         agent: { type: "string" },
         role: { type: "string" },
         doc_path: { type: "string" },
@@ -3873,7 +4041,7 @@ var TOOL_DEFINITIONS = [
               title: { type: "string", minLength: 3, maxLength: 100 },
               description: { type: "string" },
               status: { type: "string", enum: ["backlog", "pending"], default: "backlog" },
-              priority: { type: "number", minimum: 1, maximum: 5, default: 3 },
+              priority: { type: "number", minimum: 1, maximum: 5, default: 3, description: "Task priority where 1=Low, 2=Normal, 3=Medium, 4=High, 5=Critical." },
               agent: { type: "string" },
               role: { type: "string" },
               doc_path: { type: "string" },
@@ -3932,7 +4100,7 @@ var TOOL_DEFINITIONS = [
           enum: ["backlog", "pending", "in_progress", "completed", "canceled", "blocked"],
           description: "New status. Transitions from 'backlog', 'pending' or 'blocked' to 'completed' are NOT allowed."
         },
-        priority: { type: "number", minimum: 1, maximum: 5 },
+        priority: { type: "number", minimum: 1, maximum: 5, description: "Task priority where 1=Low, 2=Normal, 3=Medium, 4=High, 5=Critical." },
         agent: { type: "string" },
         role: { type: "string" },
         model: { type: "string" },
@@ -4191,12 +4359,12 @@ var TOOL_DEFINITIONS = [
             columns: {
               type: "array",
               items: { type: "string" },
-              description: "Column names: [id, from_agent, to_agent, task_id, status, created_at, summary]"
+              description: "Column names: [id, from_agent, to_agent, task_id, task_code, status, created_at, updated_at, expires_at, summary, context]"
             },
             rows: {
               type: "array",
               items: { type: "array" },
-              description: "Each row: [id, from_agent, to_agent, task_id, status, created_at, summary]"
+              description: "Each row: [id, from_agent, to_agent, task_id, task_code, status, created_at, updated_at, expires_at, summary, context]"
             }
           },
           required: ["columns", "rows"]
@@ -4246,6 +4414,87 @@ var TOOL_DEFINITIONS = [
       required: ["id", "repo", "task_id", "agent", "role", "claimed_at", "metadata"]
     }
   },
+  {
+    name: "claim-list",
+    title: "Claim List",
+    description: "List task claims in a repository. Use this to inspect active ownership, optionally filtered by agent.",
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        repo: { type: "string", description: "Repository name" },
+        agent: { type: "string", description: "Optional agent filter" },
+        active_only: { type: "boolean", description: "When true, return only unreleased claims" },
+        limit: { type: "number", minimum: 1, maximum: 100, default: 20 },
+        offset: { type: "number", minimum: 0, default: 0 },
+        structured: { type: "boolean", default: false }
+      },
+      required: ["repo"]
+    },
+    outputSchema: {
+      type: "object",
+      properties: {
+        schema: { type: "string", enum: ["claim-list"] },
+        claims: {
+          type: "object",
+          properties: {
+            columns: {
+              type: "array",
+              items: { type: "string" },
+              description: "Column names: [id, task_id, task_code, agent, role, claimed_at, released_at, metadata]"
+            },
+            rows: {
+              type: "array",
+              items: { type: "array" },
+              description: "Each row: [id, task_id, task_code, agent, role, claimed_at, released_at, metadata]"
+            }
+          },
+          required: ["columns", "rows"]
+        },
+        count: { type: "number" },
+        offset: { type: "number" }
+      },
+      required: ["schema", "claims", "count", "offset"]
+    }
+  },
+  {
+    name: "claim-release",
+    title: "Claim Release",
+    description: "Release an active claim for a task. Optionally restrict the release to a specific agent.",
+    annotations: {
+      readOnlyHint: false,
+      idempotentHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        repo: { type: "string", description: "Repository name" },
+        task_id: { type: "string", format: "uuid", description: "Task id to release. Optional if task_code is provided." },
+        task_code: { type: "string", description: "Task code to release. Optional if task_id is provided." },
+        agent: { type: "string", description: "Optional agent name to release only that claim" },
+        structured: { type: "boolean", default: false }
+      },
+      required: ["repo"]
+    },
+    outputSchema: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        repo: { type: "string" },
+        task_id: { type: "string" },
+        task_code: { type: "string", nullable: true },
+        agent: { type: "string", nullable: true }
+      },
+      required: ["success", "repo", "task_id"]
+    }
+  },
   {
     name: "standard-store",
     title: "Standard Store",
@@ -5054,6 +5303,8 @@ export {
   HandoffUpdateSchema,
   HandoffListSchema,
   TaskClaimSchema,
+  ClaimListSchema,
+  ClaimReleaseSchema,
   StandardStoreSchema,
   StandardUpdateSchema,
   StandardSearchSchema,