@hasna/todos 0.15.17 → 0.15.19

package/dist/cli/index.js

@@ -2123,7 +2123,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.15.17",
+    version: "0.15.19",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -2269,7 +2269,7 @@ function isBlockingDependencyStatus(status) {
 function isTerminalStatus(status) {
   return status === "completed" || status === "failed" || status === "cancelled";
 }
-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 TASK_STATUSES, TASK_PRIORITIES, PLAN_STATUSES, VersionConflictError, TaskNotFoundError, TaskNotStartableError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanRevisionConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DISPATCH_STATUSES, DispatchNotFoundError;
 var init_types = __esm(() => {
   TASK_STATUSES = [
     "pending",
@@ -2357,6 +2357,19 @@ var init_types = __esm(() => {
       this.name = "ResourceConflictError";
     }
   };
+  PlanRevisionConflictError = class PlanRevisionConflictError extends Error {
+    planId;
+    expectedUpdatedAt;
+    currentUpdatedAt;
+    static code = "PLAN_REVISION_CONFLICT";
+    constructor(planId, expectedUpdatedAt, currentUpdatedAt) {
+      super(`Plan revision conflict for ${planId}: expected ${expectedUpdatedAt}, current ${currentUpdatedAt}`);
+      this.planId = planId;
+      this.expectedUpdatedAt = expectedUpdatedAt;
+      this.currentUpdatedAt = currentUpdatedAt;
+      this.name = "PlanRevisionConflictError";
+    }
+  };
   PlanNotFoundError = class PlanNotFoundError extends Error {
     planId;
     static code = "PLAN_NOT_FOUND";
@@ -6004,8 +6017,16 @@ async function cloudTaskAction(client, id, action, body = {}) {
   const raw = await client.transport.post(`/tasks/${encodeURIComponent(id)}/${action}`, body);
   return unwrapTask(raw);
 }
+function isRemoteTaskIdentity(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return false;
+  const id = value["id"];
+  return typeof id === "string" && id.length > 0;
+}
 async function cloudFailTask(client, id, body = {}) {
   const route = `/v1/tasks/${encodeURIComponent(id)}/fail`;
+  if (body.retry === true)
+    await requireRetryCapability(client);
   const raw = await requiredRemoteRoute(client, route, () => client.transport.post(`/tasks/${encodeURIComponent(id)}/fail`, body));
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
     throw new Error(`REMOTE_API_INCOMPATIBLE: ${route} returned an invalid failure response envelope`);
@@ -6016,7 +6037,7 @@ async function cloudFailTask(client, id, body = {}) {
   }
   const task = result["task"];
   const retryTask = result["retryTask"];
-  if (!task || typeof task !== "object" || Array.isArray(task) || retryTask !== undefined && (!retryTask || typeof retryTask !== "object" || Array.isArray(retryTask))) {
+  if (!isRemoteTaskIdentity(task) || body.retry === true && !isRemoteTaskIdentity(retryTask) || body.retry !== true && retryTask !== undefined && !isRemoteTaskIdentity(retryTask)) {
     throw new Error(`REMOTE_API_INCOMPATIBLE: ${route} returned an invalid failure result`);
   }
   return result;
@@ -6039,6 +6060,36 @@ function resolveOpenApiSchema(document, schema) {
   }
   return current && typeof current === "object" && !Array.isArray(current) ? current : null;
 }
+async function fetchRetryCapability(client) {
+  const document = await requiredRemoteRoute(client, "/v1/openapi.json", () => client.transport.get("/openapi.json"));
+  if (!document || typeof document !== "object" || Array.isArray(document))
+    return false;
+  const doc = document;
+  const paths = doc["paths"];
+  const failPath = paths && typeof paths === "object" && !Array.isArray(paths) ? paths["/v1/tasks/{id}/fail"] : undefined;
+  const post = failPath && typeof failPath === "object" && !Array.isArray(failPath) ? failPath["post"] : undefined;
+  const requestBody = post && typeof post === "object" && !Array.isArray(post) ? post["requestBody"] : undefined;
+  const content = requestBody && typeof requestBody === "object" && !Array.isArray(requestBody) ? requestBody["content"] : undefined;
+  const jsonContent = content && typeof content === "object" && !Array.isArray(content) ? content["application/json"] : undefined;
+  const schema = jsonContent && typeof jsonContent === "object" && !Array.isArray(jsonContent) ? jsonContent["schema"] : undefined;
+  const resolved = resolveOpenApiSchema(document, schema);
+  const properties = resolved?.["properties"];
+  if (!properties || typeof properties !== "object" || Array.isArray(properties))
+    return false;
+  const retry = properties["retry"];
+  return !!retry && typeof retry === "object" && !Array.isArray(retry) && retry["type"] === "boolean";
+}
+async function requireRetryCapability(client) {
+  const authority = remoteAuthorityBase(client);
+  let capability = retryCapabilityCache.get(authority);
+  if (!capability) {
+    capability = fetchRetryCapability(client);
+    retryCapabilityCache.set(authority, capability);
+  }
+  if (!await capability) {
+    throw new Error(`REMOTE_RETRY_UNSUPPORTED: configured Todos authority ${authority} does not advertise retry in the ` + "application/json request schema for POST /v1/tasks/{id}/fail; no failure mutation was sent; " + "deploy a compatible @hasna/todos /v1 server before retrying; local SQLite fallback is disabled");
+  }
+}
 async function fetchCompletionCapabilities(client) {
   const document = await requiredRemoteRoute(client, "/v1/openapi.json", () => client.transport.get("/openapi.json"));
   if (!document || typeof document !== "object" || Array.isArray(document))
@@ -6296,11 +6347,62 @@ function unwrapPlan(raw) {
   }
   return raw;
 }
+async function cloudGetPlanById(client, id) {
+  const raw = await client.get("plans", id);
+  return raw ? unwrapPlan(raw) : null;
+}
+function isUnavailablePlanPatchRoute(error) {
+  if (!error || typeof error !== "object" || error.status !== 404)
+    return false;
+  const body = error.body;
+  const remoteMessage = body && typeof body === "object" && !Array.isArray(body) ? body.error : undefined;
+  return remoteMessage === "unknown /v1 resource: plans";
+}
+function isExactPlanCompletionPatch(patch) {
+  const entries = Object.entries(patch).filter(([, value]) => value !== undefined);
+  return entries.length === 1 && entries[0]?.[0] === "status" && entries[0]?.[1] === "completed";
+}
 async function cloudCreatePlan(client, input) {
   return unwrapPlan(await requiredRemoteRoute(client, "/v1/plans", () => client.create("plans", input)));
 }
 async function cloudUpdatePlan(client, id, patch) {
-  return unwrapPlan(await client.update("plans", id, patch));
+  try {
+    return unwrapPlan(await client.update("plans", id, patch));
+  } catch (error) {
+    if (!isExactPlanCompletionPatch(patch) || !isUnavailablePlanPatchRoute(error))
+      throw error;
+    const existing = await cloudGetPlanById(client, id);
+    if (!existing)
+      throw error;
+    if (existing.status === "completed")
+      return existing;
+    const imported = await requiredRemoteRoute(client, "/v1/import", () => client.transport.post("/import", {
+      source: "postgres",
+      planCompletions: [{
+        id,
+        expected_updated_at: existing.updated_at,
+        status: "completed"
+      }]
+    }));
+    const envelope = imported && typeof imported === "object" && !Array.isArray(imported) ? imported : null;
+    const completion = envelope?.planCompletions?.[0];
+    if (envelope?.received !== 1 || !envelope.result || !Array.isArray(envelope.result.errors) || envelope.result.errors.length > 0 || envelope.planCompletions?.length !== 1 || completion?.id !== id || completion.status !== "completed" || completion.expected_updated_at !== existing.updated_at || typeof completion.result_updated_at !== "string" || typeof completion.applied !== "boolean") {
+      throw new Error("REMOTE_API_INCOMPATIBLE: /v1/import did not confirm one atomic plan completion; " + "local SQLite fallback is disabled");
+    }
+    const persisted = await cloudGetPlanById(client, id);
+    if (!persisted) {
+      throw new Error(`REMOTE_API_INCOMPATIBLE: /v1/import acknowledged plan completion ${id} but authoritative readback returned no plan; ` + "local SQLite fallback is disabled");
+    }
+    if (persisted.status !== "completed" || persisted.updated_at !== completion.result_updated_at) {
+      throw new Error(`REMOTE_API_INCOMPATIBLE: /v1/import completion readback did not match its receipt for plan ${id}; ` + "local SQLite fallback is disabled");
+    }
+    for (const key of PLAN_COMPLETION_PROTECTED_FIELDS) {
+      if (persisted[key] !== existing[key]) {
+        throw new Error(`REMOTE_PLAN_COMPLETION_CONFLICT: /v1/import completion changed protected plan field ${key}; ` + "local SQLite fallback is disabled");
+      }
+    }
+    return persisted;
+  }
 }
 async function cloudDeletePlan(client, id) {
   try {
@@ -6840,7 +6942,7 @@ function resolveTaskListFromCandidates(lists, input) {
   ];
   for (const matches of matchGroups) {
     if (matches.length === 1)
-      return matches[0].id;
+      return matches[0];
     if (matches.length > 1) {
       throw new Error(`Task list reference is ambiguous: "${input}"`);
     }
@@ -6853,27 +6955,26 @@ async function legacyProjectTaskLists(client, projectId) {
     return [];
   return (await cloudListTaskLists(client)).filter((list) => list.project_id == null && list.slug === project.task_list_id);
 }
-async function cloudResolveTaskListRef(client, ref, projectId) {
+async function cloudResolveTaskList(client, ref, projectId) {
   const input = ref.trim();
   const normalizedIdRef = input.toLowerCase();
-  if (UUID_RE.test(input) && !projectId)
-    return normalizedIdRef;
-  if (UUID_RE.test(input) && projectId) {
+  if (UUID_RE.test(input)) {
     const direct = await cloudGetTaskList(client, normalizedIdRef);
     if (direct?.id?.toLowerCase() === normalizedIdRef) {
-      if (direct.project_id === projectId)
-        return direct.id;
+      if (!projectId || direct.project_id === projectId)
+        return direct;
       if (direct.project_id == null) {
         const project = await cloudGetProjectById(client, projectId);
         if (project?.task_list_id === direct.slug)
-          return direct.id;
+          return direct;
       }
       throw new Error(`Task list not found: "${input}"`);
     }
   }
   const scopedMatch = resolveTaskListFromCandidates(await cloudListTaskLists(client, projectId), input);
-  if (scopedMatch)
+  if (scopedMatch && (!projectId || scopedMatch.project_id === projectId)) {
     return scopedMatch;
+  }
   if (projectId) {
     const legacyMatch = resolveTaskListFromCandidates(await legacyProjectTaskLists(client, projectId), input);
     if (legacyMatch)
@@ -6881,6 +6982,12 @@ async function cloudResolveTaskListRef(client, ref, projectId) {
   }
   throw new Error(`Task list not found: "${input}"`);
 }
+async function cloudResolveTaskListRef(client, ref, projectId) {
+  const input = ref.trim();
+  if (UUID_RE.test(input) && !projectId)
+    return input.toLowerCase();
+  return (await cloudResolveTaskList(client, ref, projectId)).id;
+}
 async function cloudCreateTaskList(client, input) {
   return unwrapTaskList(await requiredRemoteRoute(client, "/v1/task-lists", () => client.transport.post("/task-lists", input)));
 }
@@ -7038,7 +7145,7 @@ async function cloudTimeline(client, options = {}) {
   const limit = options.limit ?? 50;
   return { entries: entries.slice(offset, offset + limit), total, limit, offset };
 }
-var UUID_RE, TRANSPORT_TOKENS, COMPLETION_EVIDENCE_FIELDS, completionCapabilityCache, gitRefCapabilityCache, SERVER_MODE_CANDIDATES, cachedServerMode = null, PRIORITY_RANK, listTagsCapabilityCache, RELATION_HYDRATION_CONCURRENCY = 6;
+var UUID_RE, TRANSPORT_TOKENS, COMPLETION_EVIDENCE_FIELDS, completionCapabilityCache, retryCapabilityCache, gitRefCapabilityCache, SERVER_MODE_CANDIDATES, cachedServerMode = null, PRIORITY_RANK, listTagsCapabilityCache, PLAN_COMPLETION_PROTECTED_FIELDS, RELATION_HYDRATION_CONCURRENCY = 6;
 var init_cloud_router = __esm(() => {
   init_types();
   init_redaction();
@@ -7063,10 +7170,23 @@ var init_cloud_router = __esm(() => {
     "confidence"
   ];
   completionCapabilityCache = new Map;
+  retryCapabilityCache = new Map;
   gitRefCapabilityCache = new Map;
   SERVER_MODE_CANDIDATES = ["postgres", "cloud", "self_hosted"];
   PRIORITY_RANK = { critical: 0, high: 1, medium: 2, low: 3 };
   listTagsCapabilityCache = new Map;
+  PLAN_COMPLETION_PROTECTED_FIELDS = [
+    "id",
+    "slug",
+    "project_id",
+    "task_list_id",
+    "agent_id",
+    "name",
+    "description",
+    "created_at",
+    "machine_id",
+    "synced_at"
+  ];
 });
 
 // src/cli/stage-a.ts
@@ -18328,6 +18448,48 @@ function updatePlan(id, input, db) {
     return updatePlanStored(id, input, d);
   })();
 }
+function nextPlanCompletionTimestamp(expectedUpdatedAt) {
+  const expected = Date.parse(expectedUpdatedAt);
+  const minimum = Number.isNaN(expected) ? Date.now() : expected + 2;
+  return new Date(Math.max(Date.now(), minimum)).toISOString();
+}
+function completePlanAtRevision(id, expectedUpdatedAt, db) {
+  const d = db || getDatabase();
+  return d.transaction(() => {
+    guardPlanRowsSqlite([id], d);
+    const plan = getPlan(id, d);
+    if (!plan)
+      throw new PlanNotFoundError(id);
+    if (plan.updated_at !== expectedUpdatedAt) {
+      throw new PlanRevisionConflictError(id, expectedUpdatedAt, plan.updated_at);
+    }
+    if (plan.status === "completed")
+      return { plan, applied: false };
+    const updatedAt = nextPlanCompletionTimestamp(expectedUpdatedAt);
+    const result = d.run(`UPDATE plans
+       SET status = 'completed', updated_at = ?
+       WHERE id = ? AND updated_at = ? AND status <> 'completed'`, [updatedAt, id, expectedUpdatedAt]);
+    if (result.changes !== 1) {
+      const current = getPlan(id, d);
+      if (!current)
+        throw new PlanNotFoundError(id);
+      throw new PlanRevisionConflictError(id, expectedUpdatedAt, current.updated_at);
+    }
+    const completed = getPlan(id, d);
+    emitLocalEventHooksQuiet({
+      type: "plan.updated",
+      payload: {
+        id,
+        old_status: plan.status,
+        new_status: completed.status,
+        name: completed.name,
+        project_id: completed.project_id
+      },
+      databasePath: databasePathFromDatabase(d)
+    });
+    return { plan: completed, applied: true };
+  })();
+}
 function deletePlan(id, db) {
   const d = db || getDatabase();
   const plan = getPlan(id, d);
@@ -22125,7 +22287,11 @@ function registerTaskCommands(program2) {
       filter["project_id"] = projectId;
     }
     if (opts.list && cloud) {
-      filter["task_list_id"] = await cloudResolveTaskListRef(cloud, opts.list, projectId);
+      const resolvedTaskList = await cloudResolveTaskList(cloud, opts.list, projectId);
+      filter["task_list_id"] = resolvedTaskList.id;
+      if (!projectId && resolvedTaskList.project_id) {
+        filter["project_id"] = resolvedTaskList.project_id;
+      }
     } else if (opts.list) {
       const db = getDatabase();
       const listId = resolvePartialId(db, "task_lists", opts.list);
@@ -22193,7 +22359,8 @@ function registerTaskCommands(program2) {
     const requestedLimit = filter["limit"];
     const combinesScalarStatusPages = Boolean(cloud && Array.isArray(filter["status"]) && filter["status"].length > 1);
     const reordersAfterQuery = Boolean(opts.sort) || combinesScalarStatusPages;
-    const narrowsAfterQuery = Boolean(opts.dueToday) || Boolean(opts.overdue) || creatorFilterActive && cloud;
+    const taskListFilterActive = Boolean(cloud && filter["task_list_id"]);
+    const narrowsAfterQuery = Boolean(opts.dueToday) || Boolean(opts.overdue) || creatorFilterActive && cloud || taskListFilterActive;
     const withholdLimit = requestedLimit !== undefined && (reordersAfterQuery || narrowsAfterQuery);
     const scanCeiling = cloud && (withholdLimit || requestedLimit === undefined) ? Math.max(requestedLimit ?? 0, listScanLimit()) : undefined;
     const serverFilter = (() => {
@@ -24223,7 +24390,7 @@ function importSqliteTodosStorageSnapshot(snapshot, db) {
   }
   if (result.errors.length > 0)
     return result;
-  const applyRows = (objectType, table, columns, rows, updateClockColumn, afterUpsert) => {
+  const applyRows = (objectType, table, columns, rows, updateClockColumn, acceptEqualClock = true, afterUpsert) => {
     for (const row of rows) {
       try {
         const record = asRecord(row);
@@ -24232,7 +24399,7 @@ function importSqliteTodosStorageSnapshot(snapshot, db) {
           result.skipped += 1;
           continue;
         }
-        const state = upsertById(d, table, columns, record, updateClockColumn);
+        const state = upsertById(d, table, columns, record, updateClockColumn, acceptEqualClock);
         if (state === "inserted")
           result.inserted += 1;
         else if (state === "updated")
@@ -24249,10 +24416,10 @@ function importSqliteTodosStorageSnapshot(snapshot, db) {
   applyRows("project_machine_paths", "project_machine_paths", PROJECT_MACHINE_PATH_COLUMNS, snapshot.projectMachinePaths ?? [], "updated_at");
   applyRows("agents", "agents", AGENT_COLUMNS, snapshot.agents, "last_seen_at");
   applyRows("task_lists", "task_lists", TASK_LIST_COLUMNS, snapshot.taskLists, "updated_at");
-  applyRows("plans", "plans", PLAN_COLUMNS, snapshot.plans, "updated_at");
+  applyRows("plans", "plans", PLAN_COLUMNS, snapshot.plans, "updated_at", false);
   applyRows("templates", "task_templates", TEMPLATE_COLUMNS, snapshot.templates);
   applyRows("template_tasks", "template_tasks", TEMPLATE_TASK_COLUMNS, snapshot.templateTasks ?? []);
-  applyRows("tasks", "tasks", TASK_COLUMNS, sortedTasks(snapshot.tasks), "updated_at", (row, changed) => {
+  applyRows("tasks", "tasks", TASK_COLUMNS, sortedTasks(snapshot.tasks), "updated_at", true, (row, changed) => {
     if (changed && Array.isArray(row["tags"]) && typeof row["id"] === "string") {
       replaceTaskTags(row["id"], row["tags"].filter((tag) => typeof tag === "string"), d);
     }
@@ -24261,7 +24428,7 @@ function importSqliteTodosStorageSnapshot(snapshot, db) {
   applyTombstones(d, snapshot.tombstones ?? [], result);
   return result;
 }
-function upsertById(db, table, columns, row, updateClockColumn) {
+function upsertById(db, table, columns, row, updateClockColumn, acceptEqualClock = true) {
   const id = row["id"];
   if (typeof id !== "string" || !id)
     throw new Error(`${table} row is missing id`);
@@ -24273,7 +24440,7 @@ function upsertById(db, table, columns, row, updateClockColumn) {
   const values = presentColumns.map((column) => valueForColumn(column, row[column]));
   const updateColumns = presentColumns.filter((column) => column !== "id");
   const updateSet = updateColumns.map((column) => column === "version" ? `version = MAX(COALESCE(${table}.version, 0), excluded.version)` : `${column} = excluded.${column}`).join(", ");
-  const clockGuard = updateClockColumn && presentColumns.includes(updateClockColumn) ? ` WHERE ${table}.${updateClockColumn} IS NULL OR ${table}.${updateClockColumn} <= excluded.${updateClockColumn}` : "";
+  const clockGuard = updateClockColumn && presentColumns.includes(updateClockColumn) ? ` WHERE ${table}.${updateClockColumn} IS NULL OR ${table}.${updateClockColumn} ${acceptEqualClock ? "<=" : "<"} excluded.${updateClockColumn}` : "";
   const sql = updateSet ? `INSERT INTO ${table} (${presentColumns.join(", ")}) VALUES (${placeholders})
        ON CONFLICT(id) DO UPDATE SET ${updateSet}${clockGuard}` : `INSERT OR IGNORE INTO ${table} (${presentColumns.join(", ")}) VALUES (${placeholders})`;
   const changes = db.run(sql, values).changes;
@@ -24692,6 +24859,7 @@ function createLocalSqliteTodosStorageAdapter(options = {}) {
       get: (id) => getPlan(id, database()),
       list: (projectId) => listPlans(projectId, database()),
       update: (id, input) => updatePlan(id, input, database()),
+      completeAtRevision: (id, expectedUpdatedAt) => completePlanAtRevision(id, expectedUpdatedAt, database()),
       delete: (id) => deletePlan(id, database())
     },
     planProjectLinks: {
@@ -29224,6 +29392,7 @@ __export(exports_project_commands, {
   registerProjectCommands: () => registerProjectCommands
 });
 import chalk5 from "chalk";
+import { readFileSync as readFileSync9, statSync as statSync6 } from "fs";
 import { basename as basename5, resolve as resolve13, sep as sep3 } from "path";
 function collectOption(value, previous = []) {
   return [...previous, value];
@@ -29417,18 +29586,45 @@ function registerProjectCommands(program2) {
       handleError(e);
     }
   });
-  program2.command("comment <id> <text>").alias("log-progress").description("Add a comment to a task (alias: log-progress, for recording intermediate progress)").option("--pct <percent>", "Progress percentage (0-100) to record alongside the note").action(async (id, text, opts) => {
+  program2.command("comment <id> [text]").alias("log-progress").description("Add a comment to a task (alias: log-progress, for recording intermediate progress)").option("--file <path>", "Read comment text from a UTF-8 file").option("--pct <percent>", "Progress percentage (0-100) to record alongside the note").action(async (id, text, opts) => {
+    const hasPositionalContent = text !== undefined;
+    const hasFileContent = opts.file !== undefined;
+    if (hasPositionalContent === hasFileContent) {
+      handleError(new Error("Provide exactly one comment content source: positional text or --file <path>, not both."));
+    }
+    let content;
+    if (opts.file !== undefined) {
+      const commentFilePath = resolve13(opts.file);
+      let isRegularFile = false;
+      try {
+        isRegularFile = statSync6(commentFilePath).isFile();
+      } catch (error) {
+        handleError(new Error(`Unable to read comment file "${opts.file}".`, { cause: error }));
+      }
+      if (!isRegularFile) {
+        handleError(new Error(`Comment file "${opts.file}" must be a regular file.`));
+      }
+      try {
+        content = readFileSync9(commentFilePath, "utf8");
+      } catch (error) {
+        handleError(new Error(`Unable to read comment file "${opts.file}".`, { cause: error }));
+      }
+    } else {
+      content = text;
+    }
+    if (!content.trim()) {
+      handleError(new Error("Comment content must not be empty."));
+    }
     const globalOpts = program2.opts();
     const cloud = getTodosCloudClient();
     const resolvedId = await resolveTaskIdForCommand(id, cloud);
-    let content = text;
     let progressPct;
     if (opts.pct !== undefined) {
       const pct = parseInt(opts.pct, 10);
       if (!Number.isFinite(pct) || pct < 0 || pct > 100) {
         handleError(new Error("--pct must be a number between 0 and 100"));
       }
-      content = `[progress ${pct}%] ${text}`;
+      content = `[progress ${pct}%] ${content}`;
       progressPct = pct;
     }
     const router = resolveWritableIdentity(globalOpts.agent);
@@ -30188,10 +30384,10 @@ Indexed ${result.index.files.length} file(s), ${result.index.total_symbols} symb
   program2.command("bridge-import <file>").description("Dry-run or apply a local hasna/todos bridge export bundle").option("--apply", "Apply the import. Defaults to dry-run.").option("--decrypt", "Decrypt an encrypted bridge export before importing").option("--resolve-conflicts", "Safely merge existing local tasks by filling blank fields, unioning tags, and recording unresolved divergences").action(async (file, opts) => {
     const globalOpts = program2.opts();
     try {
-      const { readFileSync: readFileSync9 } = await import("fs");
+      const { readFileSync: readFileSync10 } = await import("fs");
       const { importLocalBridgeBundle: importLocalBridgeBundle2 } = await Promise.resolve().then(() => (init_local_bridge(), exports_local_bridge));
       const { decryptBridgeBundle: decryptBridgeBundle2, isEncryptedBridgeBundle: isEncryptedBridgeBundle2 } = await Promise.resolve().then(() => (init_local_encryption(), exports_local_encryption));
-      const parsed = JSON.parse(readFileSync9(resolve13(file), "utf-8"));
+      const parsed = JSON.parse(readFileSync10(resolve13(file), "utf-8"));
       const bundle = isEncryptedBridgeBundle2(parsed) ? opts.decrypt ? decryptBridgeBundle2(parsed) : (() => {
         throw new Error("Bridge bundle is encrypted. Re-run with --decrypt and the configured key environment variable set.");
       })() : parsed;
@@ -30225,9 +30421,9 @@ Indexed ${result.index.files.length} file(s), ${result.index.total_symbols} symb
   program2.command("todos-md-import <file>").alias("markdown-import").alias("import-md").description("Dry-run or apply a local todos.md Markdown import").option("--apply", "Apply the import. Defaults to dry-run.").option("--resolve-conflicts", "Safely merge embedded bridge task conflicts while preserving local divergent fields").action(async (file, opts) => {
     const globalOpts = program2.opts();
     try {
-      const { readFileSync: readFileSync9 } = await import("fs");
+      const { readFileSync: readFileSync10 } = await import("fs");
       const { importTodosMarkdown: importTodosMarkdown2 } = await Promise.resolve().then(() => (init_todos_md(), exports_todos_md));
-      const result = importTodosMarkdown2(readFileSync9(resolve13(file), "utf-8"), { dryRun: !opts.apply, conflictStrategy: opts.resolveConflicts ? "safe_merge" : "skip" });
+      const result = importTodosMarkdown2(readFileSync10(resolve13(file), "utf-8"), { dryRun: !opts.apply, conflictStrategy: opts.resolveConflicts ? "safe_merge" : "skip" });
       const { emitLocalEventHooksQuiet: emitLocalEventHooksQuiet2 } = await Promise.resolve().then(() => (init_event_hooks(), exports_event_hooks));
       emitLocalEventHooksQuiet2({ type: "import.finished", payload: { file: resolve13(file), format: "todos.md", dry_run: result.dry_run, ok: result.ok, inserted: result.inserted, skipped: result.skipped, issues: result.issues.length } });
       if (globalOpts.json) {
@@ -30874,7 +31070,7 @@ async function findFreePort(start) {
 var DEFAULT_PORT = 19427;
 
 // src/lib/db-backup.ts
-import { existsSync as existsSync15, copyFileSync, mkdirSync as mkdirSync8, readFileSync as readFileSync9, renameSync, statSync as statSync6, writeFileSync as writeFileSync7, unlinkSync } from "fs";
+import { existsSync as existsSync15, copyFileSync, mkdirSync as mkdirSync8, readFileSync as readFileSync10, renameSync, statSync as statSync7, writeFileSync as writeFileSync7, unlinkSync } from "fs";
 import { dirname as dirname7, join as join14, resolve as resolve14 } from "path";
 import { Database as Database2 } from "bun:sqlite";
 function resolveDbPath(dbPath) {
@@ -30903,7 +31099,7 @@ function backupDatabase(outputPath, sourcePath) {
   src.close();
   writeFileSync7(outputPath, image);
   const method = "file_copy";
-  const bytes = statSync6(outputPath).size;
+  const bytes = statSync7(outputPath).size;
   return {
     schema_version: DB_BACKUP_SCHEMA,
     source_path: source,
@@ -32240,7 +32436,7 @@ __export(exports_local_extensions, {
   discoverLocalExtensions: () => discoverLocalExtensions
 });
 import { createHash as createHash9, createVerify } from "crypto";
-import { existsSync as existsSync17, readdirSync as readdirSync3, readFileSync as readFileSync10, statSync as statSync7 } from "fs";
+import { existsSync as existsSync17, readdirSync as readdirSync3, readFileSync as readFileSync11, statSync as statSync8 } from "fs";
 import { basename as basename6, join as join16, resolve as resolve15 } from "path";
 function isObject(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
@@ -32322,7 +32518,7 @@ function normalizeManifest(input) {
   };
 }
 function parseJson(path) {
-  return JSON.parse(readFileSync10(path, "utf8"));
+  return JSON.parse(readFileSync11(path, "utf8"));
 }
 function sha2564(bytes) {
   return `sha256:${createHash9("sha256").update(bytes).digest("hex")}`;
@@ -32502,11 +32698,11 @@ function inspectExtensionSource(source2) {
   const resolved = resolve15(source2);
   if (!existsSync17(resolved))
     throw new Error(`extension source not found: ${source2}`);
-  const stat = statSync7(resolved);
+  const stat = statSync8(resolved);
   const manifestPath = stat.isDirectory() ? [join16(resolved, "todos.extension.json"), join16(resolved, "extension.json")].find(existsSync17) : resolved;
   if (!manifestPath)
     throw new Error(`extension directory ${source2} is missing todos.extension.json`);
-  const raw = readFileSync10(manifestPath);
+  const raw = readFileSync11(manifestPath);
   const parsed = parseJson(manifestPath);
   const bundle = isObject(parsed) && isObject(parsed["manifest"]);
   const manifest = normalizeManifest(bundle ? parsed["manifest"] : parsed);
@@ -32608,7 +32804,7 @@ function projectExtensionSources(projectPath) {
       if (entry.startsWith("."))
         continue;
       const full = join16(extensionDir, entry);
-      if (statSync7(full).isDirectory() || entry.endsWith(".json"))
+      if (statSync8(full).isDirectory() || entry.endsWith(".json"))
         candidates.push(full);
     }
   }
@@ -34313,6 +34509,7 @@ function createPostgresTodosStorageAdapter(options) {
       get: (id) => store.get("plans", id),
       list: async (projectId) => (await store.list("plans")).filter((plan) => projectId === undefined || plan.project_id === projectId).sort((a, b) => a.name.localeCompare(b.name)),
       update: (id, input) => updatePlan2(id, input, store),
+      completeAtRevision: (id, expectedUpdatedAt, context) => store.completePlanAtRevision(id, expectedUpdatedAt, context),
       delete: (id, context) => store.deletePlan(id, context)
     },
     planProjectLinks: {
@@ -34800,6 +34997,54 @@ class PostgresJsonRecordStore {
       throw new PlanNotFoundError(value.id);
     return payloadRecord2(row.payload);
   }
+  async completePlanAtRevision(id, expectedUpdatedAt, context = {}) {
+    await this.ensureSchema();
+    const result = await this.options.client.query(`/* todos:complete-plan-revision-cas */ WITH next_clock AS (
+         SELECT date_trunc(
+           'milliseconds',
+           GREATEST(clock_timestamp(), ($3::text)::timestamptz + interval '2 milliseconds')
+         ) AS completed_at
+       ), stored AS (
+         UPDATE ${this.tableName} AS record SET
+           payload = record.payload || jsonb_build_object(
+             'status', 'completed',
+             'updated_at', to_char(
+               next_clock.completed_at AT TIME ZONE 'UTC',
+               'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"'
+             )
+           ),
+           updated_at = next_clock.completed_at,
+           deleted_at = NULL,
+           source_machine_id = COALESCE($4, record.source_machine_id),
+           version = COALESCE(record.version, 0) + 1
+         FROM next_clock
+         WHERE record.service = $1
+           AND record.object_type = 'plans'
+           AND record.object_id = $2
+           AND record.deleted_at IS NULL
+           AND record.payload->>'updated_at' = $3::text
+           AND record.payload->>'status' IS DISTINCT FROM 'completed'
+         RETURNING record.payload
+       )
+       SELECT payload FROM stored`, [
+      this.service,
+      id,
+      expectedUpdatedAt,
+      context.requestId ?? this.sourceMachineId ?? null
+    ]);
+    const payload = result.rows[0]?.payload;
+    if (payload)
+      return { plan: payloadRecord2(payload), applied: true };
+    const current = await this.get("plans", id);
+    if (!current)
+      throw new PlanNotFoundError(id);
+    if (current.updated_at !== expectedUpdatedAt) {
+      throw new PlanRevisionConflictError(id, expectedUpdatedAt, current.updated_at);
+    }
+    if (current.status === "completed")
+      return { plan: current, applied: false };
+    throw new PlanRevisionConflictError(id, expectedUpdatedAt, current.updated_at);
+  }
   async createTemplateWithTasks(template, tasks, context = {}) {
     await this.ensureSchema();
     const records = [
@@ -44635,7 +44880,7 @@ var exports_doctor = {};
 __export(exports_doctor, {
   runTodosDoctor: () => runTodosDoctor
 });
-import { chmodSync as chmodSync2, copyFileSync as copyFileSync2, existsSync as existsSync18, mkdirSync as mkdirSync9, statSync as statSync8 } from "fs";
+import { chmodSync as chmodSync2, copyFileSync as copyFileSync2, existsSync as existsSync18, mkdirSync as mkdirSync9, statSync as statSync9 } from "fs";
 import { basename as basename7, dirname as dirname8, join as join17 } from "path";
 function tableExists3(db, table) {
   return Boolean(db.query("SELECT name FROM sqlite_master WHERE type='table' AND name=?").get(table));
@@ -44782,7 +45027,7 @@ function databasePermissionsAreUnsafe(dbPath) {
   if (dbPath === ":memory:" || dbPath.startsWith("file::memory:"))
     return false;
   try {
-    return (statSync8(dbPath).mode & 63) !== 0;
+    return (statSync9(dbPath).mode & 63) !== 0;
   } catch {
     return false;
   }
@@ -48000,8 +48245,8 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
       "/v1/import": {
         post: {
           operationId: "importSnapshot",
-          summary: "Bulk-ingest a full or partial snapshot (idempotent upsert by id)",
-          description: "Upserts every record carried in the body by primary key. All record arrays are optional and default to []; a caller may backfill a single object type (e.g. just tasks) or a complete snapshot. Re-posting the same rows never duplicates. Requires the todos:write scope.",
+          summary: "Bulk-ingest a snapshot or atomically complete one observed plan",
+          description: "Upserts every snapshot record by primary key, or accepts exactly one planCompletions operation that changes only plan status under an expected_updated_at CAS. Snapshot records and planCompletions are mutually exclusive. Requires the todos:write scope.",
           requestBody: {
             required: true,
             content: {
@@ -48020,7 +48265,22 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
                     templates: { type: "array", items: { type: "object" } },
                     templateTasks: { type: "array", items: { $ref: "#/components/schemas/TemplateTask" } },
                     auditHistory: { type: "array", items: { type: "object" } },
-                    tombstones: { type: "array", items: { type: "object" } }
+                    tombstones: { type: "array", items: { type: "object" } },
+                    planCompletions: {
+                      type: "array",
+                      minItems: 1,
+                      maxItems: 1,
+                      items: {
+                        type: "object",
+                        additionalProperties: false,
+                        required: ["id", "expected_updated_at", "status"],
+                        properties: {
+                          id: { type: "string" },
+                          expected_updated_at: { type: "string", format: "date-time" },
+                          status: { type: "string", enum: ["completed"] }
+                        }
+                      }
+                    }
                   }
                 }
               }
@@ -48043,6 +48303,26 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
                           skipped: { type: "number" },
                           errors: { type: "array", items: { type: "string" } }
                         }
+                      },
+                      planCompletions: {
+                        type: "array",
+                        items: {
+                          type: "object",
+                          required: [
+                            "id",
+                            "status",
+                            "expected_updated_at",
+                            "result_updated_at",
+                            "applied"
+                          ],
+                          properties: {
+                            id: { type: "string" },
+                            status: { type: "string", enum: ["completed"] },
+                            expected_updated_at: { type: "string", format: "date-time" },
+                            result_updated_at: { type: "string", format: "date-time" },
+                            applied: { type: "boolean" }
+                          }
+                        }
                       }
                     }
                   }
@@ -48892,6 +49172,65 @@ function normalizeImportSnapshot(raw) {
 function countSnapshotRecords(s) {
   return s.tasks.length + s.projects.length + (s.projectMachinePaths?.length ?? 0) + s.plans.length + s.agents.length + s.taskLists.length + s.templates.length + s.templateTasks.length + s.auditHistory.length + (s.tombstones?.length ?? 0);
 }
+function validatePlanCompletionImports(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return { present: false, operations: [] };
+  }
+  const body2 = raw;
+  if (!Object.prototype.hasOwnProperty.call(body2, "planCompletions")) {
+    return { present: false, operations: [] };
+  }
+  if (!Array.isArray(body2["planCompletions"]) || body2["planCompletions"].length !== 1) {
+    return {
+      present: true,
+      operations: [],
+      error: "planCompletions must contain exactly one completion operation"
+    };
+  }
+  const operation = body2["planCompletions"][0];
+  if (!operation || typeof operation !== "object" || Array.isArray(operation)) {
+    return { present: true, operations: [], error: "plan completion must be an object" };
+  }
+  const record = operation;
+  const allowed = new Set(["id", "expected_updated_at", "status"]);
+  const unknown = Object.keys(record).find((key2) => !allowed.has(key2));
+  if (unknown) {
+    return { present: true, operations: [], error: `unknown plan completion field: ${unknown}` };
+  }
+  if (typeof record["id"] !== "string" || !record["id"].trim()) {
+    return { present: true, operations: [], error: "plan completion id must be a non-empty string" };
+  }
+  if (record["status"] !== "completed") {
+    return { present: true, operations: [], error: "plan completion status must be completed" };
+  }
+  const expectedUpdatedAt = typeof record["expected_updated_at"] === "string" ? record["expected_updated_at"] : "";
+  const timestampMatch = RFC3339_DATE_TIME.exec(expectedUpdatedAt);
+  const parsedTimestamp = Date.parse(expectedUpdatedAt);
+  if (!timestampMatch || Number.isNaN(parsedTimestamp)) {
+    return {
+      present: true,
+      operations: [],
+      error: "plan completion expected_updated_at must be an RFC 3339 date-time with an explicit offset"
+    };
+  }
+  const [, year, month, day] = timestampMatch;
+  const calendarProbe = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day)));
+  if (calendarProbe.getUTCFullYear() !== Number(year) || calendarProbe.getUTCMonth() !== Number(month) - 1 || calendarProbe.getUTCDate() !== Number(day)) {
+    return {
+      present: true,
+      operations: [],
+      error: "plan completion expected_updated_at names a date that does not exist"
+    };
+  }
+  return {
+    present: true,
+    operations: [{
+      id: record["id"],
+      expected_updated_at: expectedUpdatedAt,
+      status: "completed"
+    }]
+  };
+}
 async function handleV1Request(req, url, dependencies = {}) {
   const path = url.pathname;
   if (path !== "/v1" && !path.startsWith("/v1/"))
@@ -49828,6 +50167,36 @@ async function handleV1Request(req, url, dependencies = {}) {
         return error(400, "invalid JSON body");
       const snapshot = normalizeImportSnapshot(raw);
       const received = countSnapshotRecords(snapshot);
+      const completionImports = validatePlanCompletionImports(raw);
+      if (completionImports.present) {
+        if (completionImports.error)
+          return error(400, completionImports.error);
+        if (received !== 0) {
+          return error(400, "planCompletions cannot be combined with snapshot record arrays");
+        }
+        if (typeof store.plans.completeAtRevision !== "function") {
+          return error(501, "atomic plan completion is not supported by this storage backend");
+        }
+        const operation = completionImports.operations[0];
+        const completed = await store.plans.completeAtRevision(operation.id, operation.expected_updated_at, contextFromPrincipal(principal));
+        return json5({
+          result: {
+            inserted: 0,
+            updated: completed.applied ? 1 : 0,
+            deleted: 0,
+            skipped: completed.applied ? 0 : 1,
+            errors: []
+          },
+          received: 1,
+          planCompletions: [{
+            id: operation.id,
+            status: "completed",
+            expected_updated_at: operation.expected_updated_at,
+            result_updated_at: completed.plan.updated_at,
+            applied: completed.applied
+          }]
+        });
+      }
       if (received === 0) {
         return error(400, "empty snapshot: provide at least one record array (tasks/projects/plans/...)");
       }
@@ -49854,6 +50223,18 @@ async function handleV1Request(req, url, dependencies = {}) {
     if (e instanceof TaskNotFoundError) {
       return error(404, e.message, { code: TaskNotFoundError.code });
     }
+    if (e instanceof PlanNotFoundError) {
+      return error(404, e.message, { code: PlanNotFoundError.code });
+    }
+    if (e instanceof PlanRevisionConflictError) {
+      return error(409, e.message, {
+        code: PlanRevisionConflictError.code,
+        conflict: true,
+        plan_id: e.planId,
+        expected_updated_at: e.expectedUpdatedAt,
+        current_updated_at: e.currentUpdatedAt
+      });
+    }
     if (e instanceof LockError)
       return error(409, e.message, { code: LockError.code });
     if (e instanceof TaskNotStartableError) {
@@ -51005,7 +51386,7 @@ var exports_mention_resolver = {};
 __export(exports_mention_resolver, {
   resolveMentions: () => resolveMentions
 });
-import { existsSync as existsSync19, readdirSync as readdirSync4, readFileSync as readFileSync11, statSync as statSync9 } from "fs";
+import { existsSync as existsSync19, readdirSync as readdirSync4, readFileSync as readFileSync12, statSync as statSync10 } from "fs";
 import { basename as basename8, isAbsolute, join as join19, relative as relative5, resolve as resolve18, sep as sep5 } from "path";
 function blankResolution(parsed) {
   return {
@@ -51108,13 +51489,13 @@ function resolveFile(parsed, workspace) {
     resolution.warnings.push("file does not exist in the local workspace");
     return resolution;
   }
-  const stats = statSync9(absolutePath);
+  const stats = statSync10(absolutePath);
   if (!stats.isFile()) {
     resolution.warnings.push("path exists but is not a file");
     return resolution;
   }
   if (parsed.line !== undefined) {
-    const lineCount = readFileSync11(absolutePath, "utf-8").split(/\r?\n/).length;
+    const lineCount = readFileSync12(absolutePath, "utf-8").split(/\r?\n/).length;
     if (parsed.line < 1 || parsed.line > lineCount) {
       resolution.warnings.push(`line ${parsed.line} is outside the file range 1-${lineCount}`);
       return resolution;
@@ -51146,7 +51527,7 @@ function walkSourceFiles(root, current = root, files = []) {
     if (!entry2.isFile())
       continue;
     const extension = `.${basename8(entry2.name).split(".").pop() || ""}`;
-    if (SOURCE_EXTENSIONS.has(extension) && statSync9(absolutePath).size <= 512 * 1024) {
+    if (SOURCE_EXTENSIONS.has(extension) && statSync10(absolutePath).size <= 512 * 1024) {
       files.push(absolutePath);
     }
   }
@@ -51167,7 +51548,7 @@ function resolveSymbol(parsed, workspace, maxMatches) {
   const pattern = symbolPattern(name);
   const matches = [];
   for (const file of walkSourceFiles(workspace)) {
-    const lines = readFileSync11(file, "utf-8").split(/\r?\n/);
+    const lines = readFileSync12(file, "utf-8").split(/\r?\n/);
     for (let index = 0;index < lines.length; index += 1) {
       const line = lines[index];
       const found = pattern.exec(line);
@@ -53909,7 +54290,7 @@ __export(exports_release_compatibility, {
   createReleaseCompatibilityReport: () => createReleaseCompatibilityReport,
   LOCAL_RELEASE_COMPATIBILITY_SCHEMA_VERSION: () => LOCAL_RELEASE_COMPATIBILITY_SCHEMA_VERSION
 });
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync13 } from "fs";
 import { join as join20, resolve as resolve19 } from "path";
 import { Database as Database3 } from "bun:sqlite";
 function pass(id, message, details) {
@@ -53922,7 +54303,7 @@ function warn(id, message, details) {
   return { id, status: "warning", message, details };
 }
 function readPackageJson2(root) {
-  return JSON.parse(readFileSync12(join20(root, "package.json"), "utf8"));
+  return JSON.parse(readFileSync13(join20(root, "package.json"), "utf8"));
 }
 function sortedKeys(value) {
   return Object.keys(value ?? {}).sort((left, right) => left.localeCompare(right));
@@ -59892,7 +60273,7 @@ __export(exports_verification_providers, {
   getVerificationRecord: () => getVerificationRecord,
   discoverVerificationProviderCapabilities: () => discoverVerificationProviderCapabilities
 });
-import { existsSync as existsSync20, readFileSync as readFileSync13 } from "fs";
+import { existsSync as existsSync20, readFileSync as readFileSync14 } from "fs";
 function normalizeName6(name) {
   const normalized = name.trim().toLowerCase();
   if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(normalized)) {
@@ -60044,7 +60425,7 @@ Timed out after ${provider.timeout_ms}ms`);
   };
 }
 function runCiLogProvider(input) {
-  const text = input.log_text ?? (input.log_path && existsSync20(input.log_path) ? readFileSync13(input.log_path, "utf-8") : "");
+  const text = input.log_text ?? (input.log_path && existsSync20(input.log_path) ? readFileSync14(input.log_path, "utf-8") : "");
   return {
     status: classifyLog(text),
     attempts: 1,
@@ -62347,7 +62728,7 @@ __export(exports_local_backups, {
   LOCAL_BACKUP_CHECKSUM_ALGORITHM: () => LOCAL_BACKUP_CHECKSUM_ALGORITHM
 });
 import { createHash as createHash14 } from "crypto";
-import { readFileSync as readFileSync14, writeFileSync as writeFileSync8 } from "fs";
+import { readFileSync as readFileSync15, writeFileSync as writeFileSync8 } from "fs";
 import { dirname as dirname9, resolve as resolve20 } from "path";
 import { mkdirSync as mkdirSync10 } from "fs";
 function stableJson2(value) {
@@ -62457,7 +62838,7 @@ function writeLocalBackupFile(backup, outputPath) {
   return path;
 }
 function readLocalBackupFile(path) {
-  return JSON.parse(readFileSync14(resolve20(path), "utf-8"));
+  return JSON.parse(readFileSync15(resolve20(path), "utf-8"));
 }
 function verifyLocalBackup(value, options = {}, db) {
   const verifiedAt = options.verified_at ?? now();
@@ -63637,7 +64018,7 @@ __export(exports_agent_replay_simulator, {
   renderAgentReplaySimulationMarkdown: () => renderAgentReplaySimulationMarkdown
 });
 import { createHash as createHash16 } from "crypto";
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 function isObject2(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -63870,7 +64251,7 @@ function simulateAgentReplay(input, options = {}) {
   };
 }
 function simulateAgentReplayFile(path, options = {}) {
-  const parsed = JSON.parse(readFileSync15(path, "utf8"));
+  const parsed = JSON.parse(readFileSync16(path, "utf8"));
   return simulateAgentReplay(parsed, options);
 }
 function renderAgentReplaySimulationMarkdown(simulation) {
@@ -69209,7 +69590,7 @@ __export(exports_environment_snapshots, {
   captureEnvironmentSnapshot: () => captureEnvironmentSnapshot
 });
 import { createHash as createHash18 } from "crypto";
-import { existsSync as existsSync21, readFileSync as readFileSync16, statSync as statSync10 } from "fs";
+import { existsSync as existsSync21, readFileSync as readFileSync17, statSync as statSync11 } from "fs";
 import { hostname as hostname2, platform, arch } from "os";
 import { dirname as dirname10, join as join22, resolve as resolve21 } from "path";
 import { tmpdir as tmpdir4 } from "os";
@@ -69220,10 +69601,10 @@ function fileRecord(root, relativePath) {
   const path = join22(root, relativePath);
   if (!existsSync21(path))
     return null;
-  const stat = statSync10(path);
+  const stat = statSync11(path);
   if (!stat.isFile())
     return null;
-  const content = readFileSync16(path);
+  const content = readFileSync17(path);
   return { path: relativePath, sha256: sha2567(content), size_bytes: content.length };
 }
 function manifestRecord(root, relativePath) {
@@ -72269,7 +72650,7 @@ __export(exports_config_serve_commands, {
   registerConfigServeCommands: () => registerConfigServeCommands
 });
 import chalk7 from "chalk";
-import { existsSync as existsSync23, mkdirSync as mkdirSync12, readFileSync as readFileSync17, writeFileSync as writeFileSync10 } from "fs";
+import { existsSync as existsSync23, mkdirSync as mkdirSync12, readFileSync as readFileSync18, writeFileSync as writeFileSync10 } from "fs";
 import { dirname as dirname12, join as join24 } from "path";
 function registerConfigServeCommands(program2) {
   program2.command("config").description("View or update configuration").option("--get <key>", "Get a config value").option("--set <key=value>", "Set a config value (e.g. completion_guard.enabled=true)").action((opts) => {
@@ -72300,7 +72681,7 @@ function registerConfigServeCommands(program2) {
       }
       let config2 = {};
       try {
-        config2 = JSON.parse(readFileSync17(configPath, "utf-8"));
+        config2 = JSON.parse(readFileSync18(configPath, "utf-8"));
       } catch {}
       const keys = key2.split(".");
       let obj = config2;
@@ -72440,7 +72821,7 @@ function registerConfigServeCommands(program2) {
   redaction.command("scan [text]").description("Scan text or a file for secret-like values without printing values").option("--file <path>", "File to scan").action(async (text2, opts) => {
     const globalOpts = program2.opts();
     const { listSecretFindings: listSecretFindings2 } = await Promise.resolve().then(() => (init_redaction(), exports_redaction));
-    const value = opts.file ? readFileSync17(opts.file, "utf-8") : text2 || "";
+    const value = opts.file ? readFileSync18(opts.file, "utf-8") : text2 || "";
     const findings = listSecretFindings2(value);
     if (globalOpts.json) {
       output({ ok: findings.length === 0, findings }, true);
@@ -74006,7 +74387,7 @@ __export(exports_task_route_sources, {
 });
 import { Database as Database4 } from "bun:sqlite";
 import { createHash as createHash19 } from "crypto";
-import { existsSync as existsSync25, readdirSync as readdirSync5, statSync as statSync11 } from "fs";
+import { existsSync as existsSync25, readdirSync as readdirSync5, statSync as statSync12 } from "fs";
 import { basename as basename10, dirname as dirname14, join as join26, resolve as resolve22 } from "path";
 function normalizePath6(input) {
   return resolve22(input);
@@ -74082,7 +74463,7 @@ function discoverStoresUnderRoot(sourceRoot) {
   }
   let rootStat;
   try {
-    rootStat = statSync11(rootPath);
+    rootStat = statSync12(rootPath);
   } catch (error2) {
     const ref = createStoreRef(join26(rootPath, TODO_STORE_RELATIVE_PATH));
     errors2.push({
@@ -74815,7 +75196,7 @@ __export(exports_query_commands, {
   registerQueryCommands: () => registerQueryCommands
 });
 import chalk9 from "chalk";
-import { readFileSync as readFileSync18, writeFileSync as writeFileSync12 } from "fs";
+import { readFileSync as readFileSync19, writeFileSync as writeFileSync12 } from "fs";
 function parseJsonObjectOption2(value, label) {
   if (!value)
     return;
@@ -75835,13 +76216,13 @@ Findings`));
     try {
       const db = getDatabase();
       const row = db.query("SELECT COUNT(*) as count FROM tasks").get();
-      const { statSync: statSync12 } = await import("fs");
+      const { statSync: statSync13 } = await import("fs");
       const { join: join27 } = await import("path");
       const { getHomeDir: getHomeDir2 } = await Promise.resolve().then(() => (init_sync_utils(), exports_sync_utils));
       const dbPath = process.env["HASNA_TODOS_DB_PATH"] || process.env["TODOS_DB_PATH"] || join27(getHomeDir2(), ".hasna", "todos", "todos.db");
       let size = "unknown";
       try {
-        size = `${(statSync12(dbPath).size / 1024 / 1024).toFixed(1)} MB`;
+        size = `${(statSync13(dbPath).size / 1024 / 1024).toFixed(1)} MB`;
       } catch {}
       checks.push({ name: "Database", ok: true, message: `${row.count} tasks \xB7 ${size} \xB7 ${chalk9.dim(dbPath)}` });
     } catch (e) {
@@ -76558,7 +76939,7 @@ Findings`));
     const sessionId = opts.session || globalOpts.session || undefined;
     try {
       if (opts.import) {
-        const bundle = JSON.parse(readFileSync18(opts.import, "utf-8"));
+        const bundle = JSON.parse(readFileSync19(opts.import, "utf-8"));
         const result = importHandoffBundle(bundle, { apply: opts.apply }, db);
         if (opts.json || globalOpts.json) {
           console.log(JSON.stringify(result));
@@ -76932,7 +77313,7 @@ Findings`));
   });
   calendar.command("import <path>").description("Import VEVENT entries from an ICS file as local imported calendar items").option("-j, --json", "Output JSON").action((path, opts) => {
     try {
-      const result = importCalendarIcs(readFileSync18(path, "utf-8"));
+      const result = importCalendarIcs(readFileSync19(path, "utf-8"));
       if (opts.json || program2.opts().json) {
         output(result, true);
         return;
@@ -77083,7 +77464,7 @@ Findings`));
   });
   board.command("import <path>").description("Import local board definitions from a JSON bundle").option("-j, --json", "Output JSON").action((path, opts) => {
     try {
-      const bundle = JSON.parse(readFileSync18(path, "utf-8"));
+      const bundle = JSON.parse(readFileSync19(path, "utf-8"));
       const result = importTaskBoardBundle(bundle);
       if (opts.json || program2.opts().json) {
         output(result, true);
@@ -77459,7 +77840,7 @@ Findings`));
       const { importExternalIssues: importExternalIssues2 } = await Promise.resolve().then(() => (init_external_issue_importers(), exports_external_issue_importers));
       let body2 = text2 || "";
       if (opts.file)
-        body2 = readFileSync18(opts.file, "utf-8");
+        body2 = readFileSync19(opts.file, "utf-8");
       if (!body2 && !opts.url && !process.stdin.isTTY)
         body2 = await Bun.stdin.text();
       if (!body2.trim() && !opts.url) {
@@ -77516,7 +77897,7 @@ Findings`));
       } = await Promise.resolve().then(() => (init_tester_issue_reports(), exports_tester_issue_reports));
       let body2 = jsonText || "";
       if (opts.file)
-        body2 = readFileSync18(opts.file, "utf-8");
+        body2 = readFileSync19(opts.file, "utf-8");
       if (!body2 && !process.stdin.isTTY)
         body2 = await Bun.stdin.text();
       if (!body2.trim()) {
@@ -77559,11 +77940,11 @@ Findings`));
   const inbox = program2.command("inbox").description("Capture local inbox items from pasted errors, CI logs, git context, files, or GitHub issue URLs");
   inbox.command("add [text]").description("Create a local inbox item and linked task from text, stdin, or a file").option("--file <path>", "Read captured context from a file").option("--source-type <type>", "pasted_error, ci_log, git_context, github_issue, file, or other").option("--source-name <name>", "Human-readable source name").option("--source-url <url>", "Source URL, including GitHub issue URLs").option("--title <title>", "Task/inbox title").option("--priority <priority>", "Task priority").option("--tags <tags>", "Comma-separated extra tags").option("--metadata <json>", "Additional JSON metadata").option("--no-task", "Only store inbox item; do not create a linked task").option("-j, --json", "Output as JSON").action(async (text2, opts) => {
     const globalOpts = program2.opts();
-    const { readFileSync: readFileSync19 } = await import("fs");
+    const { readFileSync: readFileSync20 } = await import("fs");
     const { createInboxItem: createInboxItem2 } = await Promise.resolve().then(() => (init_inbox(), exports_inbox));
     let body2 = text2 || "";
     if (opts.file)
-      body2 = readFileSync19(opts.file, "utf-8");
+      body2 = readFileSync20(opts.file, "utf-8");
     if (!body2 && !process.stdin.isTTY)
       body2 = await Bun.stdin.text();
     if (!body2.trim()) {
@@ -77623,11 +78004,11 @@ ${diff}` : null].filter(Boolean).join(`
   });
   inbox.command("parse [text]").description("Preview or apply deterministic local natural-language task intake").option("--file <path>", "Read natural-language input from a file").option("--priority <priority>", "Default priority for parsed tasks", "medium").option("--project <id>", "Project ID for applied tasks").option("--list <id>", "Task list ID for applied tasks").option("--reference-date <iso>", "Reference date for due today/tomorrow/next week").option("--apply", "Create parsed tasks; default is dry-run preview").option("-j, --json", "Output as JSON").action(async (text2, opts) => {
     const globalOpts = program2.opts();
-    const { readFileSync: readFileSync19 } = await import("fs");
+    const { readFileSync: readFileSync20 } = await import("fs");
     const { previewNaturalLanguageIntake: previewNaturalLanguageIntake2 } = await Promise.resolve().then(() => (init_natural_language_intake(), exports_natural_language_intake));
     let body2 = text2 || "";
     if (opts.file)
-      body2 = readFileSync19(opts.file, "utf-8");
+      body2 = readFileSync20(opts.file, "utf-8");
     if (!body2 && !process.stdin.isTTY)
       body2 = await Bun.stdin.text();
     if (!body2.trim()) {
@@ -77954,7 +78335,7 @@ __export(exports_mcp_hooks_commands, {
 });
 import chalk10 from "chalk";
 import { execSync as execSync3 } from "child_process";
-import { existsSync as existsSync26, readFileSync as readFileSync19, writeFileSync as writeFileSync13, mkdirSync as mkdirSync14, chmodSync as chmodSync3 } from "fs";
+import { existsSync as existsSync26, readFileSync as readFileSync20, writeFileSync as writeFileSync13, mkdirSync as mkdirSync14, chmodSync as chmodSync3 } from "fs";
 import { dirname as dirname15, join as join27 } from "path";
 function getMcpBinaryPath() {
   try {
@@ -77971,7 +78352,7 @@ function readJsonFile2(path) {
   if (!existsSync26(path))
     return {};
   try {
-    return JSON.parse(readFileSync19(path, "utf-8"));
+    return JSON.parse(readFileSync20(path, "utf-8"));
   } catch {
     return {};
   }
@@ -77986,7 +78367,7 @@ function writeJsonFile2(path, data) {
 function readTomlFile(path) {
   if (!existsSync26(path))
     return "";
-  return readFileSync19(path, "utf-8");
+  return readFileSync20(path, "utf-8");
 }
 function writeTomlFile(path, content) {
   const dir = dirname15(path);
@@ -79177,7 +79558,7 @@ Artifacts:`));
       const hookPath = `${gitDir}/hooks/post-commit`;
       const marker = "# todos-auto-link";
       if (existsSync26(hookPath)) {
-        const existing = readFileSync19(hookPath, "utf-8");
+        const existing = readFileSync20(hookPath, "utf-8");
         if (existing.includes(marker)) {
           console.log(chalk10.yellow("Hook already installed."));
           return;
@@ -79207,7 +79588,7 @@ $(dirname "$0")/../../scripts/post-commit-hook.sh
         console.log(chalk10.dim("No post-commit hook found."));
         return;
       }
-      const content = readFileSync19(hookPath, "utf-8");
+      const content = readFileSync20(hookPath, "utf-8");
       if (!content.includes(marker)) {
         console.log(chalk10.dim("Hook not managed by todos."));
         return;
@@ -79458,7 +79839,7 @@ var STDIN_SENTINEL = "-";
 var init_delegation_brief = () => {};
 
 // src/lib/delegation-policy.ts
-import { readFileSync as readFileSync20 } from "fs";
+import { readFileSync as readFileSync21 } from "fs";
 import { homedir as homedir4 } from "os";
 import { join as join28 } from "path";
 function defaultDelegationEmbargoPath() {
@@ -79466,7 +79847,7 @@ function defaultDelegationEmbargoPath() {
 }
 function loadDelegationEmbargo(path = defaultDelegationEmbargoPath()) {
   try {
-    const parsed = JSON.parse(readFileSync20(path, "utf8"));
+    const parsed = JSON.parse(readFileSync21(path, "utf8"));
     const entries = Array.isArray(parsed) ? parsed : Array.isArray(parsed?.embargoed) ? parsed.embargoed : [];
     const names = new Set;
     for (const entry2 of entries) {
@@ -79549,15 +79930,15 @@ __export(exports_delegate, {
   registerDelegateCommands: () => registerDelegateCommands
 });
 import chalk12 from "chalk";
-import { readFileSync as readFileSync21 } from "fs";
+import { readFileSync as readFileSync22 } from "fs";
 function registerDelegateCommands(program2) {
   program2.command("delegate <task> <worker>").description("Hand a filed task to a worker in one call: brief, depth, lineage, assignment, record and notice").option("--brief <path>", "Path to the self-sufficient brief; `-` reads stdin").option("--brief-text <text>", "Inline brief, as an alternative to --brief").option("--depth-threshold <n>", "Open-task count above which this delegation parks").option("--despite-depth", "Proceed past an armed depth threshold; recorded in the [DISPATCH] comment").option("--owner-directive", "Mark as an owner-directive dispatch: depth warns and never parks").option("--seat <slug>", "Seat whose open count is read (default: the lineage parent)").option("--runtime <name>", "Worker runtime label recorded in the comment (e.g. claude-code-subagent)").option("--reports-to <agent>", "Lineage parent for the worker identity (default: the dispatcher)").option("--reuse-identity", "Skip registration and reuse an existing worker identity").option("--depth <n>", "Explicit delegation_depth (default: the task's current depth + 1)").option("--channel <name>", "Channel for the one-line notice (default: $TODOS_DELEGATE_NOTICE_CHANNEL)").option("--no-post", "Skip the channel notice").option("--claim-window <minutes>", `Minutes before the claim deadline (default: ${DEFAULT_CLAIM_WINDOW_MINUTES})`).option("--assign-seat", "Allow <worker> to name a durable seat (a seat queue has no session watching it)").option("--dry-run", "Report all seven effects and perform none").option("-j, --json", "Output as JSON").action(async (taskRef, workerInput, opts) => {
     const globalOpts = program2.opts();
     const useJson = Boolean(opts.json || globalOpts.json);
     try {
       const brief = resolveDelegationBrief({ briefPath: opts.brief, briefText: opts.briefText }, {
-        readFile: (path) => readFileSync21(path, "utf8"),
-        readStdin: () => readFileSync21(0, "utf8")
+        readFile: (path) => readFileSync22(path, "utf8"),
+        readStdin: () => readFileSync22(0, "utf8")
       });
       if (!brief.ok)
         handleError(new Error(brief.message));
@@ -79805,7 +80186,7 @@ __export(exports_machines, {
 });
 import chalk13 from "chalk";
 import { execSync as execSync4 } from "child_process";
-import { readFileSync as readFileSync22, unlinkSync as unlinkSync3, writeFileSync as writeFileSync14 } from "fs";
+import { readFileSync as readFileSync23, unlinkSync as unlinkSync3, writeFileSync as writeFileSync14 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
 import { join as join29 } from "path";
 function getOrCreateLocalMachineName() {
@@ -79849,7 +80230,7 @@ function readRemoteBridgeBundle(sshAddress) {
   try {
     runSsh(sshAddress, `todos export --format bridge --allow-plaintext-sensitive --output ${shellQuote(remotePath)}`, 120000);
     scpFromRemote(sshAddress, remotePath, localPath);
-    return JSON.parse(readFileSync22(localPath, "utf-8"));
+    return JSON.parse(readFileSync23(localPath, "utf-8"));
   } finally {
     try {
       runSsh(sshAddress, `rm -f ${shellQuote(remotePath)}`, 1e4);
@@ -84807,7 +85188,7 @@ var exports_roadmap_commands = {};
 __export(exports_roadmap_commands, {
   registerRoadmapCommands: () => registerRoadmapCommands
 });
-import { readFileSync as readFileSync23, writeFileSync as writeFileSync16 } from "fs";
+import { readFileSync as readFileSync24, writeFileSync as writeFileSync16 } from "fs";
 import chalk24 from "chalk";
 function splitList3(value) {
   return value?.split(";").flatMap((part) => part.split(",")).map((item) => item.trim()).filter(Boolean);
@@ -85036,7 +85417,7 @@ function registerRoadmapCommands(program2) {
     const globalOpts = globalOptions(program2);
     try {
       const { importRoadmapBundle: importRoadmapBundle2 } = await Promise.resolve().then(() => (init_roadmaps(), exports_roadmaps));
-      const bundle = JSON.parse(readFileSync23(path, "utf8"));
+      const bundle = JSON.parse(readFileSync24(path, "utf8"));
       const result = importRoadmapBundle2(bundle, { apply: Boolean(opts.apply) });
       if (globalOpts.json) {
         output(result, true);
@@ -85796,6 +86177,15 @@ function createShadowTodosStorageAdapter(options) {
         mirror.enqueueUpsert("plans", plan, context);
         return plan;
       },
+      async completeAtRevision(id, expectedUpdatedAt, context) {
+        if (typeof local.plans.completeAtRevision !== "function") {
+          throw new Error("Atomic plan completion is not supported by the local shadow adapter");
+        }
+        const completed = await local.plans.completeAtRevision(id, expectedUpdatedAt, context);
+        if (completed.applied)
+          mirror.enqueueUpsert("plans", completed.plan, context);
+        return completed;
+      },
       async delete(id, context) {
         const deleted = await local.plans.delete(id, context);
         if (deleted)