@hasna/todos 0.15.15 → 0.15.17

package/dist/mcp/index.js

@@ -13596,8 +13596,8 @@ function failTask(id, agentId, reason, options, db) {
   const safeMeta = sanitizePreWriteValue(meta, "task.failure.metadata");
   const timestamp2 = now();
   const failTx = d.transaction(() => {
-    const res = d.run(`UPDATE tasks SET status = 'failed', locked_by = NULL, locked_at = NULL, metadata = ?, version = version + 1, updated_at = ?
-       WHERE id = ? AND version = ?`, [JSON.stringify(safeMeta), timestamp2, id, task.version]);
+    const res = d.run(`UPDATE tasks SET status = 'failed', reason = ?, locked_by = NULL, locked_at = NULL, metadata = ?, version = version + 1, updated_at = ?
+       WHERE id = ? AND version = ?`, [safeReason, JSON.stringify(safeMeta), timestamp2, id, task.version]);
     if (res.changes === 0) {
       const current = getTask(id, d);
       throw new VersionConflictError(id, task.version, current?.version ?? -1);
@@ -13609,6 +13609,7 @@ function failTask(id, agentId, reason, options, db) {
     status: "failed",
     locked_by: null,
     locked_at: null,
+    reason: safeReason,
     metadata: safeMeta,
     version: task.version + 1,
     updated_at: timestamp2
@@ -21041,10 +21042,72 @@ async function requireTagsFilterCapability(client) {
     throw new Error(`REMOTE_TAGS_FILTER_UNSUPPORTED: configured Todos authority ${authority} does not advertise the tags ` + "query param on GET /v1/tasks; deploy the current @hasna/todos /v1 server to filter by tag; " + "no unfiltered task read was issued");
   }
 }
-async function requestCloudTaskPage(client, filter) {
+function parseCloudTaskTotal(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw))
+    return;
+  const total = raw.total;
+  return typeof total === "number" && Number.isSafeInteger(total) && total >= 0 ? total : undefined;
+}
+async function requestRawCloudTaskPage(client, filter) {
   const res = await requiredRemoteRoute(client, "/v1/tasks", () => client.list("tasks", { query: toListQuery(filter) }));
   const envelope = res.raw;
-  return Array.isArray(envelope?.tasks) ? envelope.tasks : res.items;
+  return {
+    tasks: Array.isArray(envelope?.tasks) ? envelope.tasks : res.items,
+    total: parseCloudTaskTotal(res.raw)
+  };
+}
+function cloudTaskListFilterError(code, taskListId, detail) {
+  return new Error(`${code}: hosted authority returned rows outside requested task_list_id ${taskListId}; ${detail}; refusing an incomplete exact-list result`);
+}
+async function requestCloudTaskPage(client, filter) {
+  const firstPage = await requestRawCloudTaskPage(client, filter);
+  const tasks = firstPage.tasks;
+  if (filter.task_list_id === undefined)
+    return tasks;
+  const taskListId = filter.task_list_id;
+  if (tasks.every((task) => task.task_list_id === taskListId))
+    return tasks;
+  const scanLimit = filter.limit;
+  const startOffset = filter.offset ?? 0;
+  if (startOffset !== 0 || scanLimit === undefined || !Number.isSafeInteger(scanLimit) || scanLimit <= 0 || firstPage.total === undefined) {
+    throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_UNSUPPORTED", taskListId, "the response does not provide complete bounded total/offset pagination evidence");
+  }
+  const total = firstPage.total;
+  if (total > scanLimit) {
+    throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_INCOMPLETE", taskListId, `reported total ${total} exceeds bounded scan limit ${scanLimit}`);
+  }
+  if (tasks.length > total) {
+    throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_UNSUPPORTED", taskListId, `the first page contains ${tasks.length} rows but reports total ${total}`);
+  }
+  const seenTaskIds = new Set;
+  for (const task of tasks) {
+    if (seenTaskIds.has(task.id)) {
+      throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_UNSUPPORTED", taskListId, `the first page repeats task id ${task.id}`);
+    }
+    seenTaskIds.add(task.id);
+  }
+  while (tasks.length < total) {
+    const remaining = total - tasks.length;
+    const page = await requestRawCloudTaskPage(client, {
+      ...filter,
+      offset: tasks.length,
+      limit: Math.min(scanLimit - tasks.length, remaining)
+    });
+    if (page.total !== total) {
+      throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_UNSUPPORTED", taskListId, `pagination total changed from ${total} to ${String(page.total)}`);
+    }
+    if (page.tasks.length === 0 || tasks.length + page.tasks.length > total) {
+      throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_UNSUPPORTED", taskListId, "pagination did not make bounded progress toward the reported total");
+    }
+    for (const task of page.tasks) {
+      if (seenTaskIds.has(task.id)) {
+        throw cloudTaskListFilterError("REMOTE_TASK_LIST_FILTER_UNSUPPORTED", taskListId, `pagination repeats task id ${task.id}`);
+      }
+      seenTaskIds.add(task.id);
+    }
+    tasks.push(...page.tasks);
+  }
+  return tasks.filter((task) => task.task_list_id === taskListId);
 }
 async function cloudListTasks(client, filter = {}) {
   if (filter.tags?.length)
@@ -21083,12 +21146,10 @@ async function cloudGetTask(client, id) {
 }
 async function cloudCreateTask(client, input) {
   const expectedParentId = typeof input["parent_id"] === "string" ? input["parent_id"] : null;
-  const created = unwrapTask(await requiredRemoteRoute(client, "/v1/tasks", () => expectedParentId === null ? client.create("tasks", input) : client.create("tasks", input, { retry: false }), ["PARENT_TASK_NOT_FOUND"]));
+  const created = unwrapTask(await requiredRemoteRoute(client, "/v1/tasks", () => client.create("tasks", input, { retry: false }), ["PARENT_TASK_NOT_FOUND"]));
   if (!created || typeof created.id !== "string" || !created.id.trim()) {
     throw new Error(`REMOTE_API_INCOMPATIBLE: configured Todos authority ${remoteAuthorityBase(client)} returned a task create ` + "response without a stored task id; no success row or local SQLite fallback is permitted");
   }
-  if (expectedParentId === null)
-    return created;
   const persisted = await cloudGetTask(client, created.id);
   if (!persisted || persisted.id !== created.id || (persisted.parent_id ?? null) !== expectedParentId) {
     throw new Error(`TASK_CREATE_PERSISTENCE_UNVERIFIED: configured Todos authority ${remoteAuthorityBase(client)} accepted ` + `POST /v1/tasks but authoritative GET /v1/tasks/${encodeURIComponent(created.id)} did not return the same ` + "stored task id and parent_id; no success row or local SQLite fallback is permitted");
@@ -35415,7 +35476,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.15.15",
+    version: "0.15.17",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -51606,6 +51667,22 @@ class PostgresTodosTaskManifestBackend {
   async markOutboxDelivered(outboxId, deliveredAt) {
     await this.ensureSchema();
     await this.client.transaction(async (tx) => {
+      const owned = await tx.query(`SELECT r.operation_id
+         FROM todos_task_manifest_outbox o
+         JOIN todos_task_manifest_receipts r
+           ON r.receipt_id = o.apply_receipt_id
+         WHERE r.tenant_id = $1
+           AND r.authority = 'todos'
+           AND r.route = 'todos.task-manifest.v1'
+           AND r.schema_version = 1
+           AND r.kind = 'apply'
+           AND o.id = $2
+         LIMIT 1`, [this.tenantId, outboxId]);
+      const operationId = owned.rows[0]?.operation_id;
+      if (operationId == null) {
+        throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_GRAPH_CONFLICT", `Pending outbox row not found: ${outboxId}`);
+      }
+      await tx.query("SELECT pg_advisory_xact_lock(hashtextextended($1, 0))", [`${this.service}\x1F${String(operationId)}`]);
       const result = await tx.query(`UPDATE todos_task_manifest_outbox
         SET status = 'delivered', delivered_at = $1, attempts = attempts + 1
         WHERE id = $2 AND status = 'pending'
@@ -51613,10 +51690,28 @@ class PostgresTodosTaskManifestBackend {
             SELECT 1 FROM todos_task_manifest_receipts r
             WHERE r.receipt_id = todos_task_manifest_outbox.apply_receipt_id
               AND r.tenant_id = $3
+              AND r.authority = 'todos'
+              AND r.route = 'todos.task-manifest.v1'
+              AND r.schema_version = 1
+              AND r.kind = 'apply'
           )
         RETURNING id`, [deliveredAt, outboxId, this.tenantId]);
-      if (!result.rows[0])
-        throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_GRAPH_CONFLICT", `Pending outbox row not found: ${outboxId}`);
+      if (result.rows[0])
+        return;
+      const existing = await tx.query(`SELECT o.status
+         FROM todos_task_manifest_outbox o
+         JOIN todos_task_manifest_receipts r
+           ON r.receipt_id = o.apply_receipt_id
+         WHERE r.tenant_id = $1
+           AND r.authority = 'todos'
+           AND r.route = 'todos.task-manifest.v1'
+           AND r.schema_version = 1
+           AND r.kind = 'apply'
+           AND o.id = $2
+         LIMIT 1`, [this.tenantId, outboxId]);
+      if (existing.rows[0]?.status === "delivered")
+        return;
+      throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_GRAPH_CONFLICT", `Pending outbox row not found: ${outboxId}`);
     });
   }
   async compensate(input, receipt, compensationReceiptId, requestDigest, now4) {
@@ -51648,7 +51743,13 @@ class PostgresTodosTaskManifestBackend {
         throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_COMPENSATION_REFUSED", "Graph is not applied");
       const delivered = await tx.query(`SELECT o.id FROM todos_task_manifest_outbox o
          JOIN todos_task_manifest_receipts r ON r.receipt_id = o.apply_receipt_id
-         WHERE r.tenant_id = $1 AND o.apply_receipt_id = $2 AND o.status = 'delivered'
+         WHERE r.tenant_id = $1
+           AND r.authority = 'todos'
+           AND r.route = 'todos.task-manifest.v1'
+           AND r.schema_version = 1
+           AND r.kind = 'apply'
+           AND o.apply_receipt_id = $2
+           AND o.status = 'delivered'
          LIMIT 1`, [this.tenantId, input.receipt_id]);
       if (delivered.rows[0])
         throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_COMPENSATION_REFUSED", "Compensation refused: delivered outbox row exists");
@@ -51661,15 +51762,20 @@ class PostgresTodosTaskManifestBackend {
         },
         ...(manifest.effects ?? []).map((effect2) => ({ topic: effect2.topic, payload: effect2.payload }))
       ];
-      const outboxRows = await tx.query(`SELECT id, topic, payload, payload_digest, status, attempts, delivered_at
-        FROM todos_task_manifest_outbox
-        WHERE apply_receipt_id = $1
+      const outboxRows = await tx.query(`SELECT o.id, o.topic, o.payload, o.payload_digest, o.status, o.attempts, o.delivered_at
+        FROM todos_task_manifest_outbox o
+        WHERE o.apply_receipt_id = $1
           AND EXISTS (
             SELECT 1 FROM todos_task_manifest_receipts r
-            WHERE r.receipt_id = todos_task_manifest_outbox.apply_receipt_id
+            WHERE r.receipt_id = o.apply_receipt_id
               AND r.tenant_id = $2
+              AND r.authority = 'todos'
+              AND r.route = 'todos.task-manifest.v1'
+              AND r.schema_version = 1
+              AND r.kind = 'apply'
           )
-        ORDER BY id`, [input.receipt_id, this.tenantId]);
+        ORDER BY o.id
+        FOR UPDATE OF o`, [input.receipt_id, this.tenantId]);
       if (outboxRows.rows.length !== expectedEffects.length) {
         throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_COMPENSATION_REFUSED", "Compensation refused: outbox changed since apply");
       }
@@ -51769,14 +51875,23 @@ class PostgresTodosTaskManifestBackend {
       }
       if (stored.rows.length !== managedIds.length)
         throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_COMPENSATION_REFUSED", "Compensation refused: managed graph is incomplete");
-      await tx.query(`UPDATE todos_task_manifest_outbox
+      const cancelled = await tx.query(`UPDATE todos_task_manifest_outbox
         SET status = 'cancelled'
         WHERE apply_receipt_id = $1 AND status = 'pending'
           AND EXISTS (
             SELECT 1 FROM todos_task_manifest_receipts r
             WHERE r.receipt_id = todos_task_manifest_outbox.apply_receipt_id
               AND r.tenant_id = $2
-          )`, [input.receipt_id, this.tenantId]);
+              AND r.authority = 'todos'
+              AND r.route = 'todos.task-manifest.v1'
+              AND r.schema_version = 1
+              AND r.kind = 'apply'
+          )
+        RETURNING id`, [input.receipt_id, this.tenantId]);
+      const cancelledIds = new Set(cancelled.rows.map((row) => String(row.id)));
+      if (cancelledIds.size !== applyResult.outbox_ids.length || applyResult.outbox_ids.some((id) => !cancelledIds.has(id))) {
+        throw new TodosTaskManifestError("TODOS_TASK_MANIFEST_COMPENSATION_REFUSED", "Compensation refused: failed to cancel every expected outbox row");
+      }
       const typedIds = [
         ["dependencies", applyResult.graph.dependency_ids],
         ["comments", applyResult.graph.comment_ids],
@@ -51959,6 +52074,7 @@ class PackageOwnedTodosTaskManifestAuthority {
       deterministic_ids: true,
       immutable_receipts: true,
       transactional_outbox: true,
+      idempotent_outbox_delivery: true,
       exact_bounded_readback: true,
       conditional_compensation: true,
       transcript_safe: false,
@@ -53715,8 +53831,8 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
           properties: {
             title: { type: "string" },
             description: { type: "string", nullable: true },
-            status: { type: "string" },
-            priority: { type: "string" },
+            status: { type: "string", enum: [...TASK_STATUSES] },
+            priority: { type: "string", enum: [...TASK_PRIORITIES] },
             project_id: { type: "string" },
             parent_id: { type: "string" },
             plan_id: { type: "string" },
@@ -53730,8 +53846,8 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
           properties: {
             title: { type: "string" },
             description: { type: "string" },
-            status: { type: "string" },
-            priority: { type: "string" },
+            status: { type: "string", enum: [...TASK_STATUSES] },
+            priority: { type: "string", enum: [...TASK_PRIORITIES] },
             assigned_to: { type: "string" },
             project_id: { type: "string", nullable: true },
             plan_id: { type: "string", nullable: true },
@@ -53752,6 +53868,24 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
             confidence: { type: "number", minimum: 0, maximum: 1 }
           }
         },
+        FailTaskInput: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            agent_id: { type: "string", minLength: 1 },
+            reason: { type: "string" },
+            retry: { type: "boolean" }
+          }
+        },
+        TaskFailureResult: {
+          type: "object",
+          additionalProperties: false,
+          required: ["task"],
+          properties: {
+            task: { $ref: "#/components/schemas/Task" },
+            retryTask: { $ref: "#/components/schemas/Task" }
+          }
+        },
         CreateProjectInput: {
           type: "object",
           additionalProperties: false,
@@ -54995,6 +55129,30 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
           responses: { "200": { content: { "application/json": { schema: { type: "object", properties: { task: { $ref: "#/components/schemas/Task" } } } } } } }
         }
       },
+      "/v1/tasks/{id}/fail": {
+        post: {
+          operationId: "failTask",
+          summary: "Fail a task with an optional reason and retry copy",
+          parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+          requestBody: {
+            required: false,
+            content: { "application/json": { schema: { $ref: "#/components/schemas/FailTaskInput" } } }
+          },
+          responses: {
+            "200": {
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    required: ["result"],
+                    properties: { result: { $ref: "#/components/schemas/TaskFailureResult" } }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "/v1/projects": {
         get: {
           operationId: "listProjects",
@@ -55436,12 +55594,13 @@ var init_openapi = __esm(() => {
       id: { type: "string" },
       title: { type: "string" },
       description: { type: "string" },
-      status: { type: "string" },
-      priority: { type: "string" },
+      status: { type: "string", enum: [...TASK_STATUSES] },
+      priority: { type: "string", enum: [...TASK_PRIORITIES] },
       project_id: { type: "string", nullable: true },
       parent_id: { type: "string", nullable: true },
       assigned_to: { type: "string", nullable: true },
       agent_id: { type: "string", nullable: true },
+      reason: { type: "string", nullable: true },
       tags: { type: "array", items: { type: "string" } },
       version: { type: "number" },
       created_at: { type: "string" },
@@ -56321,6 +56480,44 @@ function validateTaskCompletion(value) {
     }
   };
 }
+function validateTaskFailure(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return { ok: false, message: "failure body must be an object" };
+  const body2 = value;
+  const allowed = new Set(["agent_id", "reason", "retry"]);
+  const unknown = Object.keys(body2).find((key2) => !allowed.has(key2));
+  if (unknown)
+    return { ok: false, message: `unknown failure field: ${unknown}` };
+  if (body2.agent_id !== undefined && (typeof body2.agent_id !== "string" || !body2.agent_id.trim())) {
+    return { ok: false, message: "agent_id must be a non-empty string" };
+  }
+  if (body2.reason !== undefined && typeof body2.reason !== "string")
+    return { ok: false, message: "reason must be a string" };
+  if (body2.retry !== undefined && typeof body2.retry !== "boolean")
+    return { ok: false, message: "retry must be a boolean" };
+  return {
+    ok: true,
+    ...typeof body2.agent_id === "string" ? { agentId: body2.agent_id } : {},
+    reason: typeof body2.reason === "string" && body2.reason ? body2.reason : "Unknown failure",
+    retry: body2.retry === true
+  };
+}
+function validateTaskPatchVocabulary(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return { ok: false, message: "task patch must be an object" };
+  const body2 = value;
+  for (const [name, vocabulary] of [["status", TASK_STATUSES], ["priority", TASK_PRIORITIES]]) {
+    const raw = body2[name];
+    if (raw === undefined)
+      continue;
+    if (typeof raw !== "string")
+      return { ok: false, message: `${name} must be a string. Allowed values: ${vocabulary.join(", ")}.` };
+    const parsed = resolveEnumVocabulary(raw, { name, vocabulary, allowList: false });
+    if (!parsed.ok)
+      return { ok: false, message: parsed.message };
+  }
+  return { ok: true, patch: body2 };
+}
 function validateProjectPatch(value) {
   if (!value || typeof value !== "object" || Array.isArray(value))
     return { ok: false, message: "project patch must be an object" };
@@ -57001,7 +57198,12 @@ async function handleV1Request(req, url, dependencies = {}) {
           });
         }
         if (action === "fail" && method === "POST") {
-          return json5({ result: await store.tasks.fail(id, agentId, typeof body2.reason === "string" ? body2.reason : "failed", {}) });
+          const parsed = validateTaskFailure(actionJson.value);
+          if (!parsed.ok)
+            return error(400, parsed.message);
+          return json5({
+            result: await store.tasks.fail(id, parsed.agentId || principal.agent || "todos-serve", parsed.reason, { retry: parsed.retry }, contextFromPrincipal(principal, body2))
+          });
         }
         if (action === "claim" && method === "POST") {
           return json5({ task: await store.tasks.claimNext(agentId, {}) });
@@ -57030,9 +57232,13 @@ async function handleV1Request(req, url, dependencies = {}) {
         return task3 ? json5({ task: task3 }) : error(404, "task not found");
       }
       if (method === "PATCH" || method === "PUT") {
-        const body2 = await readJson3(req);
-        if (!body2)
+        const rawBody = await readJson3(req);
+        if (!rawBody)
           return error(400, "invalid JSON body");
+        const validated = validateTaskPatchVocabulary(rawBody);
+        if (!validated.ok)
+          return error(400, validated.message);
+        const body2 = validated.patch;
         const current = await store.tasks.get(id);
         if (!current)
           return error(404, "task not found");

package/dist/mcp.js

@@ -41,7 +41,7 @@ var __require = import.meta.require;
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.15.15",
+  version: "0.15.17",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/project-registration.js

@@ -8949,8 +8949,8 @@ function failTask2(id, agentId, reason, options, db) {
   const safeMeta = sanitizePreWriteValue(meta, "task.failure.metadata");
   const timestamp2 = now();
   const failTx = d.transaction(() => {
-    const res = d.run(`UPDATE tasks SET status = 'failed', locked_by = NULL, locked_at = NULL, metadata = ?, version = version + 1, updated_at = ?
-       WHERE id = ? AND version = ?`, [JSON.stringify(safeMeta), timestamp2, id, task.version]);
+    const res = d.run(`UPDATE tasks SET status = 'failed', reason = ?, locked_by = NULL, locked_at = NULL, metadata = ?, version = version + 1, updated_at = ?
+       WHERE id = ? AND version = ?`, [safeReason, JSON.stringify(safeMeta), timestamp2, id, task.version]);
     if (res.changes === 0) {
       const current = getTask(id, d);
       throw new VersionConflictError(id, task.version, current?.version ?? -1);
@@ -8962,6 +8962,7 @@ function failTask2(id, agentId, reason, options, db) {
     status: "failed",
     locked_by: null,
     locked_at: null,
+    reason: safeReason,
     metadata: safeMeta,
     version: task.version + 1,
     updated_at: timestamp2
@@ -12382,7 +12383,7 @@ import { createHash as createHash5 } from "crypto";
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.15.15",
+  version: "0.15.17",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/registry.js

@@ -8949,8 +8949,8 @@ function failTask(id, agentId, reason, options, db) {
   const safeMeta = sanitizePreWriteValue(meta, "task.failure.metadata");
   const timestamp2 = now();
   const failTx = d.transaction(() => {
-    const res = d.run(`UPDATE tasks SET status = 'failed', locked_by = NULL, locked_at = NULL, metadata = ?, version = version + 1, updated_at = ?
-       WHERE id = ? AND version = ?`, [JSON.stringify(safeMeta), timestamp2, id, task.version]);
+    const res = d.run(`UPDATE tasks SET status = 'failed', reason = ?, locked_by = NULL, locked_at = NULL, metadata = ?, version = version + 1, updated_at = ?
+       WHERE id = ? AND version = ?`, [safeReason, JSON.stringify(safeMeta), timestamp2, id, task.version]);
     if (res.changes === 0) {
       const current = getTask(id, d);
       throw new VersionConflictError(id, task.version, current?.version ?? -1);
@@ -8962,6 +8962,7 @@ function failTask(id, agentId, reason, options, db) {
     status: "failed",
     locked_by: null,
     locked_at: null,
+    reason: safeReason,
     metadata: safeMeta,
     version: task.version + 1,
     updated_at: timestamp2
@@ -12379,7 +12380,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.15.15",
+  version: "0.15.17",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/release-provenance.json

@@ -1,9 +1,9 @@
 {
   "packageName": "@hasna/todos",
-  "packageVersion": "0.15.15",
+  "packageVersion": "0.15.17",
   "repository": "https://github.com/hasna/todos.git",
-  "gitCommit": "3c9e40955ed30592a313258561b6cc76b928080e",
-  "gitTree": "372cf75a8993b31e328a995694c2f7a4c49fc63c",
-  "sourceTreeSha256": "95cf4fe5ee9dff0b651b37d4a499b714112a0b1a2f13a7eb326d5b79d1a3d77b",
-  "generatedAt": "2026-08-08T18:01:52.000Z"
+  "gitCommit": "f5ad4d8f466d76f7b213b4285cb7eb8be1d65057",
+  "gitTree": "5a91a08de2e8af7d18d37de3dfa5956b141a62ac",
+  "sourceTreeSha256": "798227cadfbde7ad824600dd06968ca9b7c01f4f8a967f9f6e149b75de6dae93",
+  "generatedAt": "2026-08-09T03:22:03.000Z"
 }

package/dist/sdk/index.d.ts

@@ -10,7 +10,7 @@
 export { TodosClient, createClient } from "./client.js";
 export type { TodosClientOptions } from "./client.js";
 export { TodosV1Client, ApiError as TodosV1ApiError } from "./v1.generated.js";
-export type { TodosV1ClientOptions, Task as TodosV1Task, Project as TodosV1Project, TaskManifestBindingLookupRequest as TodosV1TaskManifestBindingLookupRequest, TaskManifestBindingLookupResult as TodosV1TaskManifestBindingLookupResult, TaskManifestBindingLookupResponse as TodosV1TaskManifestBindingLookupResponse, TaskComment as TodosV1TaskComment, CreateTaskInput as TodosV1CreateTaskInput, UpdateTaskInput as TodosV1UpdateTaskInput, CreateProjectInput as TodosV1CreateProjectInput, ProjectTaskListEnsureApplyInput as TodosV1ProjectTaskListEnsureApplyInput, ProjectTaskListRollbackInput as TodosV1ProjectTaskListRollbackInput, ProjectTaskListEnsureReceipt as TodosV1ProjectTaskListEnsureReceipt, ProjectTaskListEnsureResult as TodosV1ProjectTaskListEnsureResult, ProjectTaskListRollbackResult as TodosV1ProjectTaskListRollbackResult, CreateTaskCommentInput as TodosV1CreateTaskCommentInput, AdmitPrGroupInput as TodosV1AdmitPrGroupInput, RecoverPrGroupInput as TodosV1RecoverPrGroupInput, AppendPrGroupEventInput as TodosV1AppendPrGroupEventInput, PrGroupCiProof as TodosV1PrGroupCiProof, PrGroupCleanupProof as TodosV1PrGroupCleanupProof, PrGroupRecord as TodosV1PrGroupRecord, PrGroupAttemptRecord as TodosV1PrGroupAttemptRecord, PrGroupEventRecord as TodosV1PrGroupEventRecord, PrGroupStateView as TodosV1PrGroupStateView, PrGroupEventPage as TodosV1PrGroupEventPage, PrGroupMutationResult as TodosV1PrGroupMutationResult, } from "./v1.generated.js";
+export type { TodosV1ClientOptions, Task as TodosV1Task, Project as TodosV1Project, TaskManifestBindingLookupRequest as TodosV1TaskManifestBindingLookupRequest, TaskManifestBindingLookupResult as TodosV1TaskManifestBindingLookupResult, TaskManifestBindingLookupResponse as TodosV1TaskManifestBindingLookupResponse, TaskComment as TodosV1TaskComment, CreateTaskInput as TodosV1CreateTaskInput, UpdateTaskInput as TodosV1UpdateTaskInput, FailTaskInput as TodosV1FailTaskInput, TaskFailureResult as TodosV1TaskFailureResult, CreateProjectInput as TodosV1CreateProjectInput, ProjectTaskListEnsureApplyInput as TodosV1ProjectTaskListEnsureApplyInput, ProjectTaskListRollbackInput as TodosV1ProjectTaskListRollbackInput, ProjectTaskListEnsureReceipt as TodosV1ProjectTaskListEnsureReceipt, ProjectTaskListEnsureResult as TodosV1ProjectTaskListEnsureResult, ProjectTaskListRollbackResult as TodosV1ProjectTaskListRollbackResult, CreateTaskCommentInput as TodosV1CreateTaskCommentInput, AdmitPrGroupInput as TodosV1AdmitPrGroupInput, RecoverPrGroupInput as TodosV1RecoverPrGroupInput, AppendPrGroupEventInput as TodosV1AppendPrGroupEventInput, PrGroupCiProof as TodosV1PrGroupCiProof, PrGroupCleanupProof as TodosV1PrGroupCleanupProof, PrGroupRecord as TodosV1PrGroupRecord, PrGroupAttemptRecord as TodosV1PrGroupAttemptRecord, PrGroupEventRecord as TodosV1PrGroupEventRecord, PrGroupStateView as TodosV1PrGroupStateView, PrGroupEventPage as TodosV1PrGroupEventPage, PrGroupMutationResult as TodosV1PrGroupMutationResult, } from "./v1.generated.js";
 export type { AdmitPrGroupInput, AppendPrGroupEventInput, PrGroupAdapterViews, PrGroupAttemptRecord, PrGroupCiProof, PrGroupCleanupProof, PrGroupDecisionEnvelopeAdapter, PrGroupEventListOptions, PrGroupEventPage, PrGroupEventRecord, PrGroupEvidenceRefAdapter, PrGroupMutationResult, PrGroupProofBundleAdapter, PrGroupRecord, PrGroupStateView, PrGroupWorkRunAdapter, RecoverPrGroupInput, } from "../pr-groups/types.js";
 export { TodosAPIError, TodosNotFoundError, TodosConflictError, TodosUnauthorizedError, TodosRateLimitError, TodosTimeoutError, } from "./types.js";
 export type { SSEEvent, CursorPage, ListOptions, TaskListResponse, TaskStatusResponse, TaskNextResponse, TaskActiveResponse, TaskStaleResponse, TaskChangedResponse, TaskContextResponse, TaskProgressResponse, TaskAttachmentsResponse, TaskFailResponse, TaskBulkResponse, AgentMeResponse, AgentQueueResponse, OrgNode, PlanWithTasks, ReportResponse, DoctorResponse, DoctorIssue, } from "./types.js";

package/dist/sdk/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,EAAE,aAAa,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,oBAAoB,EACpB,IAAI,IAAI,WAAW,EACnB,OAAO,IAAI,cAAc,EACzB,gCAAgC,IAAI,uCAAuC,EAC3E,+BAA+B,IAAI,sCAAsC,EACzE,iCAAiC,IAAI,wCAAwC,EAC7E,WAAW,IAAI,kBAAkB,EACjC,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,sBAAsB,EACzC,kBAAkB,IAAI,yBAAyB,EAC/C,+BAA+B,IAAI,sCAAsC,EACzE,4BAA4B,IAAI,mCAAmC,EACnE,4BAA4B,IAAI,mCAAmC,EACnE,2BAA2B,IAAI,kCAAkC,EACjE,6BAA6B,IAAI,oCAAoC,EACrE,sBAAsB,IAAI,6BAA6B,EACvD,iBAAiB,IAAI,wBAAwB,EAC7C,mBAAmB,IAAI,0BAA0B,EACjD,uBAAuB,IAAI,8BAA8B,EACzD,cAAc,IAAI,qBAAqB,EACvC,mBAAmB,IAAI,0BAA0B,EACjD,aAAa,IAAI,oBAAoB,EACrC,oBAAoB,IAAI,2BAA2B,EACnD,kBAAkB,IAAI,yBAAyB,EAC/C,gBAAgB,IAAI,uBAAuB,EAC3C,gBAAgB,IAAI,uBAAuB,EAC3C,qBAAqB,IAAI,4BAA4B,GACtD,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,EAAE,aAAa,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,oBAAoB,EACpB,IAAI,IAAI,WAAW,EACnB,OAAO,IAAI,cAAc,EACzB,gCAAgC,IAAI,uCAAuC,EAC3E,+BAA+B,IAAI,sCAAsC,EACzE,iCAAiC,IAAI,wCAAwC,EAC7E,WAAW,IAAI,kBAAkB,EACjC,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,sBAAsB,EACzC,aAAa,IAAI,oBAAoB,EACrC,iBAAiB,IAAI,wBAAwB,EAC7C,kBAAkB,IAAI,yBAAyB,EAC/C,+BAA+B,IAAI,sCAAsC,EACzE,4BAA4B,IAAI,mCAAmC,EACnE,4BAA4B,IAAI,mCAAmC,EACnE,2BAA2B,IAAI,kCAAkC,EACjE,6BAA6B,IAAI,oCAAoC,EACrE,sBAAsB,IAAI,6BAA6B,EACvD,iBAAiB,IAAI,wBAAwB,EAC7C,mBAAmB,IAAI,0BAA0B,EACjD,uBAAuB,IAAI,8BAA8B,EACzD,cAAc,IAAI,qBAAqB,EACvC,mBAAmB,IAAI,0BAA0B,EACjD,aAAa,IAAI,oBAAoB,EACrC,oBAAoB,IAAI,2BAA2B,EACnD,kBAAkB,IAAI,yBAAyB,EAC/C,gBAAgB,IAAI,uBAAuB,EAC3C,gBAAgB,IAAI,uBAAuB,EAC3C,qBAAqB,IAAI,4BAA4B,GACtD,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/sdk/index.js

@@ -980,6 +980,13 @@ class TodosV1Client {
       init
     });
   }
+  async failTask(id, body, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/fail`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
   async listTaskGitRefs(id, init) {
     return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}/refs`, {
       body: undefined,

package/dist/sdk/v1.generated.d.ts

@@ -2,12 +2,13 @@ export interface Task {
     "id"?: string;
     "title"?: string;
     "description"?: string;
-    "status"?: string;
-    "priority"?: string;
+    "status"?: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+    "priority"?: "low" | "medium" | "high" | "critical";
     "project_id"?: string | null;
     "parent_id"?: string | null;
     "assigned_to"?: string | null;
     "agent_id"?: string | null;
+    "reason"?: string | null;
     "tags"?: Array<string>;
     "version"?: number;
     "created_at"?: string;
@@ -206,8 +207,8 @@ export interface CreateTemplateTaskInput {
 export interface CreateTaskInput {
     "title": string;
     "description"?: string | null;
-    "status"?: string;
-    "priority"?: string;
+    "status"?: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+    "priority"?: "low" | "medium" | "high" | "critical";
     "project_id"?: string;
     "parent_id"?: string;
     "plan_id"?: string;
@@ -218,8 +219,8 @@ export interface CreateTaskInput {
 export interface UpdateTaskInput {
     "title"?: string;
     "description"?: string;
-    "status"?: string;
-    "priority"?: string;
+    "status"?: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+    "priority"?: "low" | "medium" | "high" | "critical";
     "assigned_to"?: string;
     "project_id"?: string | null;
     "plan_id"?: string | null;
@@ -235,6 +236,15 @@ export interface CompleteTaskInput {
     "notes"?: string;
     "confidence"?: number;
 }
+export interface FailTaskInput {
+    "agent_id"?: string;
+    "reason"?: string;
+    "retry"?: boolean;
+}
+export interface TaskFailureResult {
+    "task": Task;
+    "retryTask"?: Task;
+}
 export interface CreateProjectInput {
     "name": string;
     "path": string;
@@ -822,6 +832,10 @@ export declare class TodosV1Client {
     completeTask(id: string, body?: CompleteTaskInput, init?: RequestInit): Promise<{
         "task"?: Task;
     }>;
+    /** Fail a task with an optional reason and retry copy */
+    failTask(id: string, body?: FailTaskInput, init?: RequestInit): Promise<{
+        "result": TaskFailureResult;
+    }>;
     /** List git branch and pull-request refs linked to a task */
     listTaskGitRefs(id: string, init?: RequestInit): Promise<{
         "refs": Array<TaskGitRef>;