@hasna/todos 0.13.9 → 0.13.11

package/dist/mcp/index.js

@@ -44,7 +44,7 @@ var __require = import.meta.require;
 function isBlockingDependencyStatus(status) {
   return status !== "completed" && status !== "cancelled";
 }
-var TASK_STATUSES, VersionConflictError, TaskNotFoundError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DispatchNotFoundError;
+var TASK_STATUSES, VersionConflictError, TaskNotFoundError, TaskNotStartableError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DispatchNotFoundError;
 var init_types = __esm(() => {
   TASK_STATUSES = [
     "pending",
@@ -77,6 +77,20 @@ var init_types = __esm(() => {
       this.name = "TaskNotFoundError";
     }
   };
+  TaskNotStartableError = class TaskNotStartableError extends Error {
+    taskId;
+    status;
+    agentId;
+    static code = "TASK_NOT_STARTABLE";
+    static suggestion = "Reset the task status to pending before starting it again.";
+    constructor(taskId, status, agentId) {
+      super(`Task ${taskId} is ${status} and cannot be started by ${agentId}; ` + "reset the task status to pending before starting it again");
+      this.taskId = taskId;
+      this.status = status;
+      this.agentId = agentId;
+      this.name = "TaskNotStartableError";
+    }
+  };
   TaskReferenceAmbiguousError = class TaskReferenceAmbiguousError extends Error {
     reference;
     static code = "TASK_REFERENCE_AMBIGUOUS";
@@ -5095,6 +5109,24 @@ var init_agents = __esm(() => {
   init_agent_names();
 });
 
+// src/lib/lock-display.ts
+function lockDisplayState(lockedBy, lockedAt, nowMs = Date.now()) {
+  const holder = lockedBy ?? null;
+  const at = lockedAt ?? null;
+  if (!holder) {
+    return { present: false, held: false, expired: false, holder: null, lockedAt: at };
+  }
+  const expired = isLockExpired(at, nowMs);
+  return { present: true, held: !expired, expired, holder, lockedAt: at };
+}
+function formatExpiredLock(state) {
+  const at = state.lockedAt ? ` at ${state.lockedAt}` : "";
+  return `expired (last held by ${state.holder}${at})`;
+}
+var init_lock_display = __esm(() => {
+  init_database();
+});
+
 // src/lib/logger.ts
 async function logError(_message, _opts) {}
 
@@ -12865,7 +12897,7 @@ function assertStartable(task, agentId) {
     return;
   if (task.status === "in_progress")
     return;
-  throw new Error(`Task is ${task.status} and cannot be started by ${agentId}`);
+  throw new TaskNotStartableError(task.id, task.status, agentId);
 }
 function getBlockingDeps(id, db) {
   const d = db || getDatabase();
@@ -12936,7 +12968,7 @@ function completeTask(id, agentId, db, options) {
   if (task.status === "cancelled") {
     throw new Error(`Task ${id} is cancelled and cannot be completed`);
   }
-  if (agentId && task.locked_by && !sameHolder(task.locked_by, agentId) && !isLockExpired(task.locked_at)) {
+  if (task.locked_by && !sameHolder(task.locked_by, agentId) && !isLockExpired(task.locked_at)) {
     throw new LockError(id, task.locked_by);
   }
   checkCompletionGuard(task, agentId || null, d);
@@ -13571,6 +13603,30 @@ function getTaskWithRelations(id, db) {
     checklist
   };
 }
+function resolveAssignedToAliases(db, ref) {
+  const aliases = new Set([ref]);
+  let agentId;
+  try {
+    agentId = resolvePartialId(db, "agents", ref);
+  } catch (err) {
+    if (!(err instanceof IdentityAliasAmbiguousError))
+      throw err;
+    agentId = null;
+  }
+  if (agentId) {
+    aliases.add(agentId);
+    const row = db.query("SELECT name FROM agents WHERE id = ?").get(agentId);
+    if (row?.name)
+      aliases.add(row.name);
+  }
+  return [...aliases];
+}
+function lowerInClause(column, values, params) {
+  if (values.length === 0)
+    return "1=0";
+  params.push(...values.map((v) => v.toLowerCase()));
+  return `LOWER(${column}) IN (${values.map(() => "?").join(",")})`;
+}
 function listTasks(filter = {}, db) {
   const d = db || getDatabase();
   const { clearExpiredLocks: clearExpiredLocks2 } = (init_database(), __toCommonJS(exports_database));
@@ -13612,8 +13668,7 @@ function listTasks(filter = {}, db) {
     }
   }
   if (filter.assigned_to) {
-    conditions.push("assigned_to = ?");
-    params.push(filter.assigned_to);
+    conditions.push(lowerInClause("assigned_to", resolveAssignedToAliases(d, filter.assigned_to), params));
   }
   if (filter.agent_id) {
     conditions.push("agent_id = ?");
@@ -13773,8 +13828,7 @@ function countTasks(filter = {}, db) {
     }
   }
   if (filter.assigned_to) {
-    conditions.push("assigned_to = ?");
-    params.push(filter.assigned_to);
+    conditions.push(lowerInClause("assigned_to", resolveAssignedToAliases(d, filter.assigned_to), params));
   }
   if (filter.agent_id) {
     conditions.push("agent_id = ?");
@@ -17958,10 +18012,11 @@ function validateAssignee(input, ctx) {
     if (ctx.allowSeat) {
       return { ok: true, assignee: byId ? byId.name : raw, agentId: byId?.id, isSeat: true };
     }
+    const hint = ctx.seatHint?.(raw);
     return {
       ok: false,
       reason: "seat",
-      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or pass --assign-seat if filing at the seat is what you mean.`
+      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or repeat the command with --assign-seat added to confirm the seat is deliberate` + (hint ? `: ${hint}` : " (see --help for this command's exact form).")
     };
   }
   if (byId) {
@@ -20410,6 +20465,16 @@ function classifyRemoteRequestError(baseUrl, route, error) {
   if (status === 403) {
     throw new Error(`REMOTE_API_FORBIDDEN: configured Todos authority ${baseUrl} denied ${route}; local SQLite fallback is disabled`, { cause: error });
   }
+  if (status === 409) {
+    const body = error && typeof error === "object" ? error.body : undefined;
+    if (body && typeof body === "object" && !Array.isArray(body)) {
+      const remoteError = body;
+      if (remoteError.code === "TASK_NOT_STARTABLE" && typeof remoteError.error === "string" && remoteError.error.length > 0) {
+        throw new Error(`${remoteError.code}: ${remoteError.error}`, { cause: error });
+      }
+    }
+    throw error;
+  }
   if (typeof status === "number" && status >= 300 && status < 400) {
     throw new Error(`REMOTE_API_REDIRECT_REJECTED: configured Todos authority ${baseUrl} redirected ${route}; ` + "authenticated redirects are disabled to prevent credential leakage", { cause: error });
   }
@@ -20607,7 +20672,10 @@ function resolveCloudProjectRef(projects, ref) {
     if (matches.length > 1)
       throw new Error(`Project reference is ambiguous: "${input}"`);
   }
-  throw new Error(`Project not found: "${input}"`);
+  if (UUID_RE.test(input) || /^[0-9a-f]{4,}$/i.test(input)) {
+    throw new Error(`Project not found: "${input}"`);
+  }
+  throw new Error(`Project not found: "${input}" \u2014 no project in todos's own project registry matches this ` + `name, path, or slug. This does not know about projects registered elsewhere (for example ` + `a Hasna Projects CLI workspace) \u2014 resolve it there first (e.g. "projects show ${input} ` + `--json") and pass the resulting id or task-list slug, or run "todos projects create" to ` + `register it here. Do not assume "${input}" has never been created.`);
 }
 async function cloudResolveProjectRef(client, ref) {
   return resolveCloudProjectRef(await cloudListProjects(client), ref);
@@ -34775,7 +34843,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.9",
+    version: "0.13.11",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -34825,8 +34893,8 @@ var init_package = __esm(() => {
       "README.md"
     ],
     scripts: {
-      build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
-      "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
+      build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
+      "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
       migrate: "bun run src/server/index.ts migrate",
       "backfill:comment-redaction": "bun run src/server/index.ts redact-comments",
       "generate:sdk": "bun run scripts/generate-sdk.ts",
@@ -45719,7 +45787,16 @@ class PostgresJsonRecordStore {
       updatedAt: stringValue2(row.updated_at) ?? new Date().toISOString()
     }));
   }
-  buildTaskFilterSql(filter) {
+  async resolveAssignedToAliases(ref) {
+    const agent = await resolveAgentForAssignedFilter(ref, this);
+    const aliases = new Set([ref]);
+    if (agent) {
+      aliases.add(agent.id);
+      aliases.add(agent.name);
+    }
+    return [...aliases];
+  }
+  async buildTaskFilterSql(filter) {
     const params = [this.service, "tasks"];
     const conds = ["service = $1", "object_type = $2", "deleted_at IS NULL"];
     const p = (value) => {
@@ -45745,8 +45822,10 @@ class PostgresJsonRecordStore {
       conds.push(inClause("payload->>'status'", toFilterArray(filter.status)));
     if (filter.priority !== undefined)
       conds.push(inClause("payload->>'priority'", toFilterArray(filter.priority)));
-    if (filter.assigned_to !== undefined)
-      conds.push(`payload->>'assigned_to' = ${p(filter.assigned_to)}`);
+    if (filter.assigned_to !== undefined) {
+      const aliases = [...new Set((await this.resolveAssignedToAliases(filter.assigned_to)).map((a) => a.toLowerCase()))];
+      conds.push(inClause("LOWER(payload->>'assigned_to')", aliases));
+    }
     if (filter.agent_id !== undefined)
       conds.push(`payload->>'agent_id' = ${p(filter.agent_id)}`);
     if (filter.created_by !== undefined)
@@ -45780,7 +45859,7 @@ class PostgresJsonRecordStore {
   }
   async listTasks(filter) {
     await this.ensureSchema();
-    const { where, params, queryRef } = this.buildTaskFilterSql(filter);
+    const { where, params, queryRef } = await this.buildTaskFilterSql(filter);
     const orderBy = queryRef ? `ORDER BY ts_rank_cd(task_search_tsv, websearch_to_tsquery('simple', todos_immutable_unaccent(${queryRef}))) DESC, ${TASK_ORDER_TIEBREAK}` : TASK_ORDER_BY;
     let sql = `/* todos:list-tasks */ SELECT payload FROM ${this.tableName} WHERE ${where} ${orderBy}`;
     if (filter.limit !== undefined) {
@@ -45840,7 +45919,7 @@ class PostgresJsonRecordStore {
   }
   async countTasks(filter) {
     await this.ensureSchema();
-    const { where, params } = this.buildTaskFilterSql(filter);
+    const { where, params } = await this.buildTaskFilterSql(filter);
     const sql = `/* todos:count-tasks */ SELECT COUNT(*)::int AS count FROM ${this.tableName} WHERE ${where}`;
     const result = await this.options.client.query(sql, params);
     return Number(result.rows[0]?.count ?? 0);
@@ -46001,9 +46080,13 @@ class PostgresJsonRecordStore {
     } : {};
     const hasEvidence = Object.keys(evidence).length > 0;
     const hasConfidence = options?.confidence !== undefined;
-    const result = await this.options.client.query(`/* todos:complete-task-atomic */ UPDATE ${this.tableName}
+    const lockExpiryCutoff2 = new Date(new Date(operationTimestamp).getTime() - CLOUD_LOCK_EXPIRY_MINUTES * 60 * 1000).toISOString();
+    const result = await this.options.client.query(`/* todos:complete-task-atomic todos:complete-task-lock-guard todos:complete-task-clears-lock */
+       UPDATE ${this.tableName}
        SET payload = payload || jsonb_build_object(
          'status', 'completed',
+         'locked_by', 'null'::jsonb,
+         'locked_at', 'null'::jsonb,
          'assigned_to', CASE
            WHEN jsonb_typeof(payload->'assigned_to') = 'string' THEN payload->'assigned_to'
            ELSE COALESCE(to_jsonb($3::text), 'null'::jsonb)
@@ -46031,6 +46114,16 @@ class PostgresJsonRecordStore {
        updated_at = $9::timestamptz,
        version = COALESCE(version, 0) + 1
        WHERE service = $1 AND object_type = 'tasks' AND object_id = $2 AND deleted_at IS NULL
+         AND (
+           payload->>'locked_by' IS NULL
+           OR BTRIM(payload->>'locked_by') = ''
+           OR payload->>'locked_at' IS NULL
+           OR payload->>'locked_at' < $10::text
+           OR (
+             $3::text IS NOT NULL
+             AND LOWER(BTRIM(payload->>'locked_by')) = LOWER(BTRIM($3::text))
+           )
+         )
        RETURNING payload`, [
       this.service,
       id,
@@ -46040,7 +46133,8 @@ class PostgresJsonRecordStore {
       jsonbParam(evidence),
       hasConfidence,
       options?.confidence ?? null,
-      operationTimestamp
+      operationTimestamp,
+      lockExpiryCutoff2
     ]);
     return result.rows[0] ? payloadRecord2(result.rows[0].payload) : null;
   }
@@ -46321,6 +46415,7 @@ async function updateTask2(id, input, store) {
   if (existing.version !== input.version) {
     throw new Error(`Task ${id} version conflict: expected ${existing.version}, got ${input.version}`);
   }
+  const reopened = existing.status === "completed" && input.status !== undefined && input.status !== "completed" && input.completed_at === undefined;
   const task2 = {
     ...existing,
     ...definedPatch(input),
@@ -46330,7 +46425,8 @@ async function updateTask2(id, input, store) {
     metadata: input.metadata ?? existing.metadata,
     requires_approval: input.requires_approval ?? existing.requires_approval,
     task_list_id: input.task_list_id !== undefined ? input.task_list_id : existing.task_list_id,
-    created_by: existing.created_by
+    created_by: existing.created_by,
+    completed_at: reopened ? null : input.completed_at !== undefined ? input.completed_at : existing.completed_at
   };
   await store.upsert("tasks", task2);
   return task2;
@@ -46338,11 +46434,11 @@ async function updateTask2(id, input, store) {
 async function startTask2(id, agentId, store) {
   const task2 = await requireRecord("tasks", id, store);
   if (task2.status !== "pending" && task2.status !== "in_progress") {
-    throw new Error(`Task is ${task2.status} and cannot be started by ${agentId}`);
+    throw new TaskNotStartableError(task2.id, task2.status, agentId);
   }
   const started = await patchTask(task2, {
     status: "in_progress",
-    assigned_to: task2.assigned_to ?? agentId,
+    assigned_to: task2.assigned_to || agentId,
     agent_id: task2.agent_id ?? agentId,
     locked_by: agentId,
     locked_at: new Date().toISOString(),
@@ -46353,8 +46449,13 @@ async function startTask2(id, agentId, store) {
 }
 async function completeTask2(id, agentId, options, store) {
   const task2 = await store.completeTask(id, agentId, options);
-  if (!task2)
+  if (!task2) {
+    const current = await store.get("tasks", id);
+    if (current?.locked_by && !cloudLockExpired(current.locked_at) && !sameCloudLockHolder(current.locked_by, agentId)) {
+      throw new LockError(id, current.locked_by);
+    }
     throw new Error(`tasks record not found: ${id}`);
+  }
   return task2;
 }
 async function failTask2(id, agentId, reason, options, store) {
@@ -46395,6 +46496,11 @@ async function patchTask(task2, patch, store) {
   await store.upsert("tasks", updated);
   return updated;
 }
+function sameCloudLockHolder(stored, incoming) {
+  if (!stored || !incoming)
+    return false;
+  return canonicalAgentRef(stored) === canonicalAgentRef(incoming);
+}
 function cloudLockExpired(lockedAt) {
   if (!lockedAt)
     return true;
@@ -46712,6 +46818,16 @@ async function resolveAgent3(idOrName, store) {
     return byId;
   return matchAgentByName(await store.list("agents"), idOrName);
 }
+async function resolveAgentForAssignedFilter(idOrName, store) {
+  const byId = await store.get("agents", idOrName);
+  if (byId)
+    return byId;
+  const target = normalizeAgentNameInput(idOrName);
+  if (!target)
+    return null;
+  const matches = (await store.list("agents")).filter((agent) => normalizeAgentNameInput(agent.name) === target);
+  return matches.length === 1 ? matches[0] : null;
+}
 async function heartbeatAgent(idOrName, store, context) {
   const agent = await resolveAgent3(idOrName, store);
   if (!agent)
@@ -47027,6 +47143,7 @@ function postgresConstraintName(error) {
 var CLOUD_LOCK_EXPIRY_MINUTES = 30, TASK_ORDER_TIEBREAK = "CASE payload->>'priority' WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 ELSE 4 END ASC, payload->>'created_at' ASC, payload->>'id' ASC", TASK_ORDER_BY;
 var init_postgres_adapter = __esm(() => {
   init_types();
+  init_creator_identity();
   init_postgres_sync();
   init_integrity();
   init_redaction();
@@ -48048,7 +48165,10 @@ function mapTaskError(e, json2) {
       retry_after: e.retryAfterSeconds ?? null
     }, 409);
   }
-  if (e instanceof Error && (/ is blocked by /.test(e.message) || /cannot be started/.test(e.message))) {
+  if (e instanceof TaskNotStartableError) {
+    return json2({ error: e.message, code: TaskNotStartableError.code }, 409);
+  }
+  if (e instanceof Error && / is blocked by /.test(e.message)) {
     return json2({ error: e.message, code: "TASK_NOT_STARTABLE" }, 409);
   }
   return null;
@@ -51682,6 +51802,9 @@ async function handleV1Request(req, url, dependencies = {}) {
     }
     if (e instanceof LockError)
       return error(409, e.message, { code: LockError.code });
+    if (e instanceof TaskNotStartableError) {
+      return error(409, e.message, { code: TaskNotStartableError.code });
+    }
     if (e instanceof ResourceConflictError)
       return error(409, e.message, { code: e.code, conflict: true });
     if (e instanceof ProjectNotFoundError)
@@ -52508,6 +52631,8 @@ var init_serve = __esm(() => {
 // src/mcp/index.ts
 var exports_mcp = {};
 __export(exports_mcp, {
+  formatTaskDetail: () => formatTaskDetail,
+  formatTask: () => formatTask,
   buildServer: () => buildServer,
   applyFocus: () => applyFocus
 });
@@ -52656,7 +52781,8 @@ function resolveId(partialId, table = "tasks") {
 function formatTask(task2) {
   const id = task2.short_id || task2.id.slice(0, 8);
   const assigned = task2.assigned_to ? ` -> ${task2.assigned_to}` : "";
-  const lock = task2.locked_by ? ` [locked:${task2.locked_by}]` : "";
+  const lockState = lockDisplayState(task2.locked_by, task2.locked_at);
+  const lock = lockState.held ? ` [locked:${lockState.holder}]` : "";
   const recur = task2.recurrence_rule ? ` [\u21BB]` : "";
   return `${id} ${task2.status.padEnd(11)} ${task2.priority.padEnd(8)} ${task2.title}${assigned}${lock}${recur}`;
 }
@@ -52675,8 +52801,11 @@ function formatTaskDetail(task2, maxDescriptionChars) {
     parts.push(`Assigned to: ${task2.assigned_to}`);
   if (task2.agent_id)
     parts.push(`Agent: ${task2.agent_id}`);
-  if (task2.locked_by)
-    parts.push(`Locked by: ${task2.locked_by}`);
+  const detailLock = lockDisplayState(task2.locked_by, task2.locked_at);
+  if (detailLock.held)
+    parts.push(`Locked by: ${detailLock.holder}`);
+  else if (detailLock.expired)
+    parts.push(`Lock: ${formatExpiredLock(detailLock)}`);
   if (task2.parent_id)
     parts.push(`Parent: ${task2.parent_id}`);
   if (task2.project_id)
@@ -52760,6 +52889,7 @@ var agentFocusMap, isDirectRun;
 var init_mcp2 = __esm(() => {
   init_agents();
   init_database();
+  init_lock_display();
   init_types();
   init_dispatch2();
   init_task_crud2();
@@ -52802,6 +52932,8 @@ var init_mcp2 = __esm(() => {
 init_mcp2();
 
 export {
+  formatTaskDetail,
+  formatTask,
   buildServer,
   applyFocus
 };

package/dist/mcp.js

@@ -41,7 +41,7 @@ var __require = import.meta.require;
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.9",
+  version: "0.13.11",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",
@@ -91,8 +91,8 @@ var package_default = {
     "README.md"
   ],
   scripts: {
-    build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
-    "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
+    build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
+    "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
     migrate: "bun run src/server/index.ts migrate",
     "backfill:comment-redaction": "bun run src/server/index.ts redact-comments",
     "generate:sdk": "bun run scripts/generate-sdk.ts",

package/dist/registry.js

@@ -3430,7 +3430,7 @@ var init_machines = __esm(() => {
 function isBlockingDependencyStatus(status) {
   return status !== "completed" && status !== "cancelled";
 }
-var TASK_STATUSES, TASK_PRIORITIES, PLAN_STATUSES, VersionConflictError, TaskNotFoundError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DISPATCH_STATUSES, DispatchNotFoundError;
+var TASK_STATUSES, TASK_PRIORITIES, PLAN_STATUSES, VersionConflictError, TaskNotFoundError, TaskNotStartableError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DISPATCH_STATUSES, DispatchNotFoundError;
 var init_types = __esm(() => {
   TASK_STATUSES = [
     "pending",
@@ -3470,6 +3470,20 @@ var init_types = __esm(() => {
       this.name = "TaskNotFoundError";
     }
   };
+  TaskNotStartableError = class TaskNotStartableError extends Error {
+    taskId;
+    status;
+    agentId;
+    static code = "TASK_NOT_STARTABLE";
+    static suggestion = "Reset the task status to pending before starting it again.";
+    constructor(taskId, status, agentId) {
+      super(`Task ${taskId} is ${status} and cannot be started by ${agentId}; ` + "reset the task status to pending before starting it again");
+      this.taskId = taskId;
+      this.status = status;
+      this.agentId = agentId;
+      this.name = "TaskNotStartableError";
+    }
+  };
   TaskReferenceAmbiguousError = class TaskReferenceAmbiguousError extends Error {
     reference;
     static code = "TASK_REFERENCE_AMBIGUOUS";
@@ -8242,7 +8256,7 @@ function assertStartable(task, agentId) {
     return;
   if (task.status === "in_progress")
     return;
-  throw new Error(`Task is ${task.status} and cannot be started by ${agentId}`);
+  throw new TaskNotStartableError(task.id, task.status, agentId);
 }
 function getBlockingDeps(id, db) {
   const d = db || getDatabase();
@@ -8313,7 +8327,7 @@ function completeTask(id, agentId, db, options) {
   if (task.status === "cancelled") {
     throw new Error(`Task ${id} is cancelled and cannot be completed`);
   }
-  if (agentId && task.locked_by && !sameHolder(task.locked_by, agentId) && !isLockExpired(task.locked_at)) {
+  if (task.locked_by && !sameHolder(task.locked_by, agentId) && !isLockExpired(task.locked_at)) {
     throw new LockError(id, task.locked_by);
   }
   checkCompletionGuard(task, agentId || null, d);
@@ -8948,6 +8962,30 @@ function getTaskWithRelations(id, db) {
     checklist
   };
 }
+function resolveAssignedToAliases(db, ref) {
+  const aliases = new Set([ref]);
+  let agentId;
+  try {
+    agentId = resolvePartialId(db, "agents", ref);
+  } catch (err) {
+    if (!(err instanceof IdentityAliasAmbiguousError))
+      throw err;
+    agentId = null;
+  }
+  if (agentId) {
+    aliases.add(agentId);
+    const row = db.query("SELECT name FROM agents WHERE id = ?").get(agentId);
+    if (row?.name)
+      aliases.add(row.name);
+  }
+  return [...aliases];
+}
+function lowerInClause(column, values, params) {
+  if (values.length === 0)
+    return "1=0";
+  params.push(...values.map((v) => v.toLowerCase()));
+  return `LOWER(${column}) IN (${values.map(() => "?").join(",")})`;
+}
 function listTasks(filter = {}, db) {
   const d = db || getDatabase();
   const { clearExpiredLocks: clearExpiredLocks2 } = (init_database(), __toCommonJS(exports_database));
@@ -8989,8 +9027,7 @@ function listTasks(filter = {}, db) {
     }
   }
   if (filter.assigned_to) {
-    conditions.push("assigned_to = ?");
-    params.push(filter.assigned_to);
+    conditions.push(lowerInClause("assigned_to", resolveAssignedToAliases(d, filter.assigned_to), params));
   }
   if (filter.agent_id) {
     conditions.push("agent_id = ?");
@@ -9150,8 +9187,7 @@ function countTasks(filter = {}, db) {
     }
   }
   if (filter.assigned_to) {
-    conditions.push("assigned_to = ?");
-    params.push(filter.assigned_to);
+    conditions.push(lowerInClause("assigned_to", resolveAssignedToAliases(d, filter.assigned_to), params));
   }
   if (filter.agent_id) {
     conditions.push("agent_id = ?");
@@ -11973,7 +12009,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.9",
+  version: "0.13.11",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",
@@ -12023,8 +12059,8 @@ var package_default = {
     "README.md"
   ],
   scripts: {
-    build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
-    "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
+    build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
+    "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
     migrate: "bun run src/server/index.ts migrate",
     "backfill:comment-redaction": "bun run src/server/index.ts redact-comments",
     "generate:sdk": "bun run scripts/generate-sdk.ts",

package/dist/release-provenance.json

@@ -1,9 +1,9 @@
 {
   "packageName": "@hasna/todos",
-  "packageVersion": "0.13.9",
+  "packageVersion": "0.13.11",
   "repository": "https://github.com/hasna/todos.git",
-  "gitCommit": "0877f637ea98eb762347fc78d43d033cf4999ef6",
-  "gitTree": "458f99b7674b48d37f779b7bc1329369385b6ce5",
-  "sourceTreeSha256": "49de4d648f9049fe5fdab5edfb8d47e17b5c5241b655c203f17fe0046b02e07f",
-  "generatedAt": "2026-08-01T10:18:22.000Z"
+  "gitCommit": "af551bd57da4ef1835d763232c1e3b3b8cee4f9f",
+  "gitTree": "23029d1f9a1afeecf519674e13746e615431ae8b",
+  "sourceTreeSha256": "b14e57ef9ec0cbd0e0142681b993aa34c941d59a18649ddd499f3ee1a62cfef9",
+  "generatedAt": "2026-08-02T06:21:53.000Z"
 }