@hasna/todos 0.13.12 → 0.14.0

package/dist/cli/index.js

@@ -2123,7 +2123,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.12",
+    version: "0.14.0",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -2258,7 +2258,10 @@ var init_package_version = __esm(() => {
 function isBlockingDependencyStatus(status) {
   return status !== "completed" && status !== "cancelled";
 }
-var TASK_STATUSES, TASK_PRIORITIES, VersionConflictError, TaskNotFoundError, TaskNotStartableError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DispatchNotFoundError;
+function isTerminalStatus(status) {
+  return status === "completed" || status === "failed" || status === "cancelled";
+}
+var TASK_STATUSES, TASK_PRIORITIES, VersionConflictError, TaskNotFoundError, TaskNotStartableError, TaskReferenceAmbiguousError, ProjectNotFoundError, ResourceConflictError, PlanNotFoundError, LockError, AgentNotFoundError, IdentityAliasAmbiguousError, IdentityIdImmutableError, TaskListNotFoundError, DependencyCycleError, CompletionGuardError, DISPATCH_STATUSES, DispatchNotFoundError;
 var init_types = __esm(() => {
   TASK_STATUSES = [
     "pending",
@@ -2427,6 +2430,7 @@ var init_types = __esm(() => {
       this.name = "CompletionGuardError";
     }
   };
+  DISPATCH_STATUSES = ["pending", "sent", "failed", "cancelled"];
   DispatchNotFoundError = class DispatchNotFoundError extends Error {
     dispatchId;
     static code = "DISPATCH_NOT_FOUND";
@@ -11456,6 +11460,96 @@ var init_lock_display = __esm(() => {
   init_database();
 });
 
+// src/lib/enum-vocabulary.ts
+function editDistance2(a, b) {
+  if (a === b)
+    return 0;
+  if (!a.length)
+    return b.length;
+  if (!b.length)
+    return a.length;
+  let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1;i <= a.length; i += 1) {
+    const current = [i];
+    for (let j = 1;j <= b.length; j += 1) {
+      current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+    }
+    previous = current;
+  }
+  return previous[b.length];
+}
+function suggestVocabularyMatches(value, vocabulary, limit = 3) {
+  const needle = value.trim().toLowerCase();
+  if (!needle)
+    return [];
+  const scored = [];
+  for (const member of vocabulary) {
+    const candidate = member.toLowerCase();
+    if (candidate.startsWith(needle) || needle.startsWith(candidate)) {
+      scored.push({ member, score: 0 });
+      continue;
+    }
+    if (candidate.includes(needle) || needle.includes(candidate)) {
+      scored.push({ member, score: 1 });
+      continue;
+    }
+    const distance = editDistance2(needle, candidate);
+    if (distance <= Math.max(1, Math.floor(candidate.length / 3))) {
+      scored.push({ member, score: 1 + distance });
+    }
+  }
+  return scored.sort((a, b) => a.score - b.score || a.member.localeCompare(b.member)).slice(0, limit).map((entry) => entry.member);
+}
+function resolveEnumVocabulary(raw, spec) {
+  const allowList = spec.allowList !== false;
+  const rawElements = (allowList ? raw.split(",") : [raw]).map((element) => element.trim()).filter((element) => element.length > 0);
+  if (rawElements.length === 0) {
+    return {
+      ok: false,
+      message: `${spec.name} requires a value. Allowed values: ${spec.vocabulary.join(", ")}.`,
+      invalid: []
+    };
+  }
+  const normalized = rawElements.map((element) => spec.normalize ? spec.normalize(element) : element);
+  const allowed = new Set(spec.vocabulary);
+  const invalid2 = [];
+  for (let i = 0;i < normalized.length; i += 1) {
+    if (!allowed.has(normalized[i]))
+      invalid2.push(rawElements[i]);
+  }
+  if (invalid2.length === 0) {
+    return { ok: true, values: [...new Set(normalized)] };
+  }
+  const label = invalid2.length === 1 ? "value" : "values";
+  const parts = [
+    `Invalid ${spec.name} ${label}: ${invalid2.join(", ")}.`,
+    `Allowed values: ${spec.vocabulary.join(", ")}.`
+  ];
+  const hints = new Set;
+  const suggestions = new Set;
+  for (let i = 0;i < normalized.length; i += 1) {
+    const canonical = normalized[i];
+    if (allowed.has(canonical))
+      continue;
+    const hint = spec.hints?.[canonical.toLowerCase()];
+    if (hint) {
+      hints.add(hint);
+      continue;
+    }
+    for (const match of suggestVocabularyMatches(canonical, spec.vocabulary)) {
+      suggestions.add(match);
+    }
+  }
+  if (suggestions.size > 0)
+    parts.push(`Did you mean ${[...suggestions].join(", ")}?`);
+  for (const hint of hints)
+    parts.push(hint);
+  return { ok: false, message: parts.join(" "), invalid: invalid2 };
+}
+function collapseEnumValues(values) {
+  return values.length === 1 ? values[0] : values;
+}
+
 // src/cli/helpers.ts
 var exports_helpers = {};
 __export(exports_helpers, {
@@ -11466,9 +11560,13 @@ __export(exports_helpers, {
   resolveExplicitProject: () => resolveExplicitProject,
   priorityColors: () => priorityColors,
   printJson: () => printJson,
+  parseEnumFlagList: () => parseEnumFlagList,
+  parseEnumFlag: () => parseEnumFlag,
+  outputRecord: () => outputRecord,
   output: () => output,
   normalizeStatusList: () => normalizeStatusList,
   normalizeStatus: () => normalizeStatus,
+  normalizePriority: () => normalizePriority,
   jsonModeRequested: () => jsonModeRequested,
   handleError: () => handleError,
   getPackageVersion: () => getPackageVersion,
@@ -11476,7 +11574,10 @@ __export(exports_helpers, {
   detectGitRoot: () => detectGitRoot,
   cacheCloudTaskForIdResolution: () => cacheCloudTaskForIdResolution,
   autoProject: () => autoProject,
-  autoDetectProject: () => autoDetectProject
+  autoDetectProject: () => autoDetectProject,
+  TASK_STATUS_FLAG_HINTS: () => TASK_STATUS_FLAG_HINTS,
+  TASK_STATUS_FLAG: () => TASK_STATUS_FLAG,
+  TASK_PRIORITY_FLAG: () => TASK_PRIORITY_FLAG
 });
 import chalk from "chalk";
 import { execSync } from "child_process";
@@ -11486,8 +11587,19 @@ import { dirname as dirname3, join as join4, resolve as resolve3, sep } from "pa
 function jsonModeRequested(argv = process.argv) {
   return argv.some((arg) => arg === "--json" || /^-[a-z]+$/i.test(arg) && arg.includes("j"));
 }
+function remoteErrorDetail(e) {
+  if (!e || typeof e !== "object")
+    return null;
+  const body = e.body;
+  if (!body || typeof body !== "object" || Array.isArray(body))
+    return null;
+  const detail = body.error;
+  return typeof detail === "string" && detail.trim() ? detail.trim() : null;
+}
 function handleError(e) {
-  const message = e instanceof Error ? e.message : String(e);
+  const baseMessage = e instanceof Error ? e.message : String(e);
+  const detail = remoteErrorDetail(e);
+  const message = detail && !baseMessage.includes(detail) ? `${baseMessage}: ${detail}` : baseMessage;
   console.error(chalk.red(message));
   if (jsonModeRequested()) {
     console.log(JSON.stringify({ error: message }));
@@ -11665,7 +11777,8 @@ function autoProject(opts) {
   return autoDetectProject(opts)?.id;
 }
 function normalizeStatus(s) {
-  switch (s.toLowerCase().trim()) {
+  const folded = s.toLowerCase().trim();
+  switch (folded) {
     case "done":
       return "completed";
     case "complete":
@@ -11679,14 +11792,33 @@ function normalizeStatus(s) {
     case "canceled":
       return "cancelled";
     default:
-      return s;
+      return folded;
   }
 }
+function normalizePriority(p) {
+  return p.toLowerCase().trim();
+}
 function normalizeStatusList(statuses) {
   if (Array.isArray(statuses))
     return statuses.map(normalizeStatus);
   return normalizeStatus(statuses);
 }
+function parseEnumFlag(raw, spec) {
+  if (raw === undefined || raw === null)
+    return;
+  const result = resolveEnumVocabulary(String(raw), spec);
+  if (!result.ok)
+    handleError(new Error(result.message));
+  return collapseEnumValues(result.values);
+}
+function parseEnumFlagList(raw, spec) {
+  if (raw === undefined || raw === null)
+    return;
+  const result = resolveEnumVocabulary(String(raw), spec);
+  if (!result.ok)
+    handleError(new Error(result.message));
+  return result.values;
+}
 function writeStdoutSync(text) {
   const buffer = Buffer.from(text);
   let offset = 0;
@@ -11718,6 +11850,41 @@ function output(data, jsonMode) {
     printJson(data);
   }
 }
+function formatRecordLines(data) {
+  if (data === null || data === undefined)
+    return [];
+  if (typeof data !== "object")
+    return [String(data)];
+  if (Array.isArray(data)) {
+    return data.flatMap((entry, index) => [
+      chalk.dim(`[${index}]`),
+      ...formatRecordLines(entry).map((line) => `  ${line}`)
+    ]);
+  }
+  const lines = [];
+  for (const [key, value] of Object.entries(data)) {
+    if (value === undefined)
+      continue;
+    const rendered = value === null ? chalk.dim("\u2014") : typeof value === "object" ? JSON.stringify(value) : String(value);
+    lines.push(`  ${chalk.dim(`${key}:`)} ${rendered}`);
+  }
+  return lines;
+}
+function outputRecord(data, jsonMode, heading) {
+  if (jsonMode) {
+    printJson(data);
+    return;
+  }
+  if (heading)
+    console.log(chalk.bold(heading));
+  const lines = formatRecordLines(data);
+  if (lines.length === 0) {
+    console.log(chalk.dim("(empty)"));
+    return;
+  }
+  for (const line of lines)
+    console.log(line);
+}
 function formatTaskLine(t) {
   const statusFn = statusColors[t.status] || chalk.white;
   const priorityFn = priorityColors[t.priority] || chalk.white;
@@ -11728,16 +11895,33 @@ function formatTaskLine(t) {
   const plan = t.plan_id ? chalk.magenta(` [plan:${t.plan_id.slice(0, 8)}]`) : "";
   return `${chalk.dim(t.id.slice(0, 8))} ${statusFn(t.status.padEnd(11))} ${priorityFn(t.priority.padEnd(8))} ${t.title}${assigned}${lock}${tags}${plan}`;
 }
-var stdoutRetryBuffer, stdoutRetrySignal, TASK_UUID_RE, statusColors, priorityColors;
+var stdoutRetryBuffer, stdoutRetrySignal, TASK_UUID_RE, TASK_STATUS_FLAG_HINTS, TASK_STATUS_FLAG, TASK_PRIORITY_FLAG, statusColors, priorityColors;
 var init_helpers = __esm(() => {
   init_cloud_router();
   init_database();
   init_projects();
   init_lock_display();
   init_package_version();
+  init_types();
   stdoutRetryBuffer = new SharedArrayBuffer(4);
   stdoutRetrySignal = new Int32Array(stdoutRetryBuffer);
   TASK_UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  TASK_STATUS_FLAG_HINTS = {
+    all: "To include every status, use -a/--all instead of a --status value.",
+    any: "To include every status, use -a/--all instead of a --status value.",
+    open: "Unstarted and running work is pending and in_progress (the default when no --status is given)."
+  };
+  TASK_STATUS_FLAG = {
+    name: "--status",
+    vocabulary: TASK_STATUSES,
+    normalize: normalizeStatus,
+    hints: TASK_STATUS_FLAG_HINTS
+  };
+  TASK_PRIORITY_FLAG = {
+    name: "--priority",
+    vocabulary: TASK_PRIORITIES,
+    normalize: normalizePriority
+  };
   statusColors = {
     pending: chalk.yellow,
     in_progress: chalk.blue,
@@ -15960,11 +16144,13 @@ function updateTask(id, input, db) {
     }
     sets.push("status = ?");
     params.push(input.status);
+    if (isTerminalStatus(input.status)) {
+      sets.push("locked_by = NULL");
+      sets.push("locked_at = NULL");
+    }
     if (input.status === "completed") {
       sets.push("completed_at = ?");
       params.push(completionTimestamp);
-      sets.push("locked_by = NULL");
-      sets.push("locked_at = NULL");
     } else if (task.status === "completed" && input.completed_at === undefined) {
       sets.push("completed_at = NULL");
     }
@@ -16088,6 +16274,7 @@ function updateTask(id, input, db) {
     logTaskChange(id, "approve", "approved_by", null, input.approved_by, agentId, d);
   const reopened = input.status !== undefined && input.status !== "completed" && task.status === "completed" && input.completed_at === undefined;
   const completedNow = input.status === "completed";
+  const terminalNow = input.status !== undefined && isTerminalStatus(input.status);
   const updatedTask = {
     ...task,
     ...Object.fromEntries(Object.entries(input).filter(([, v]) => v !== undefined)),
@@ -16095,8 +16282,8 @@ function updateTask(id, input, db) {
     metadata: input.metadata ?? task.metadata,
     version: task.version + 1,
     updated_at: timestamp2,
-    locked_by: completedNow ? null : task.locked_by,
-    locked_at: completedNow ? null : task.locked_at,
+    locked_by: terminalNow ? null : task.locked_by,
+    locked_at: terminalNow ? null : task.locked_at,
     completed_at: completedNow ? completionTimestamp : reopened ? null : input.completed_at !== undefined ? input.completed_at : task.completed_at,
     sla_minutes: input.sla_minutes !== undefined ? input.sla_minutes : task.sla_minutes,
     actual_minutes: input.actual_minutes ?? task.actual_minutes,
@@ -20214,11 +20401,7 @@ function resolveProjectIdOrSlug(input) {
 function parseStatus(value) {
   if (!value)
     return;
-  const normalized = normalizeStatus(value);
-  if (!TASK_STATUSES.includes(normalized)) {
-    handleError(new Error(`--status must be one of: ${TASK_STATUSES.join(", ")}`));
-  }
-  return normalized;
+  return parseEnumFlagList(value, { ...TASK_STATUS_FLAG, allowList: false })?.[0];
 }
 function parseIntOption(value, flag) {
   if (value === undefined)
@@ -20243,10 +20426,7 @@ function resolvePlanId(input) {
 function parsePriority(value) {
   if (!value)
     return;
-  if (!TASK_PRIORITIES.includes(value)) {
-    handleError(new Error("--priority must be one of: low, medium, high, critical"));
-  }
-  return value;
+  return parseEnumFlagList(value, { ...TASK_PRIORITY_FLAG, allowList: false })?.[0];
 }
 function parseJsonObject3(value, flag) {
   if (!value)
@@ -20631,12 +20811,12 @@ function registerTaskCommands(program2) {
       filter["task_list_id"] = listId;
     }
     if (opts.status) {
-      filter["status"] = opts.status.includes(",") ? opts.status.split(",").map((s) => normalizeStatus(s.trim())) : normalizeStatus(opts.status);
+      filter["status"] = parseEnumFlag(opts.status, TASK_STATUS_FLAG);
     } else if (!opts.all) {
       filter["status"] = ["pending", "in_progress"];
     }
     if (opts.priority)
-      filter["priority"] = opts.priority;
+      filter["priority"] = parseEnumFlag(opts.priority, TASK_PRIORITY_FLAG);
     if (opts.assigned)
       filter["assigned_to"] = opts.assigned;
     if (opts.createdBy)
@@ -21609,7 +21789,6 @@ var init_task_commands = __esm(() => {
   init_assignee_guard();
   init_helpers();
   init_output_redaction();
-  init_types();
 });
 
 // src/lib/plan-artifacts.ts
@@ -23441,7 +23620,8 @@ __export(exports_saved_search_views, {
   normalizeScope: () => normalizeScope,
   listSearchViews: () => listSearchViews,
   getSearchView: () => getSearchView,
-  deleteSearchView: () => deleteSearchView
+  deleteSearchView: () => deleteSearchView,
+  SAVED_SEARCH_SCOPES: () => SAVED_SEARCH_SCOPES
 });
 function parseFilters(value) {
   if (!value)
@@ -23461,10 +23641,8 @@ function rowToSavedSearchView(row) {
   };
 }
 function normalizeScope(scope) {
-  if (scope === "all" || scope === "tasks" || scope === "projects" || scope === "plans" || scope === "runs" || scope === "comments") {
-    return scope;
-  }
-  return "tasks";
+  const candidate = (scope ?? "").trim().toLowerCase();
+  return SAVED_SEARCH_SCOPES.includes(candidate) ? candidate : "tasks";
 }
 function normalizeName(name) {
   const normalized = name.trim();
@@ -23767,10 +23945,12 @@ function runSearchView(idOrName, db) {
     throw new Error(`Saved search view not found: ${idOrName}`);
   return { ...runSavedSearch(view.filters, view.scope, d), view };
 }
+var SAVED_SEARCH_SCOPES;
 var init_saved_search_views = __esm(() => {
   init_database();
   init_local_fields();
   init_search();
+  SAVED_SEARCH_SCOPES = ["all", "tasks", "projects", "plans", "runs", "comments"];
 });
 
 // src/lib/claude-tasks.ts
@@ -26340,12 +26520,11 @@ function buildSearchFilters(query, opts, projectId) {
   const customFields = parseJsonObjectOption(opts.fieldCustom, "--field-custom");
   const labels = splitList(opts.fieldLabel);
   const tags = splitList(opts.tag);
-  const statuses = splitList(opts.status)?.map(normalizeStatus);
   const filters = {
     query: query || opts.query,
     project_id: opts.allProjects ? undefined : projectId,
-    status: statuses,
-    priority: splitList(opts.priority),
+    status: parseEnumFlagList(opts.status, TASK_STATUS_FLAG),
+    priority: parseEnumFlagList(opts.priority, TASK_PRIORITY_FLAG),
     assigned_to: opts.assigned,
     agent_id: opts.agentId,
     task_list_id: filterPatch?.task_list_id === undefined ? resolveTaskListFilter(opts.taskList, projectId) : undefined,
@@ -26450,7 +26629,7 @@ function registerProjectCommands(program2) {
     try {
       const cloud = getTodosCloudClient();
       const projectId = opts.allProjects ? undefined : cloud ? undefined : autoProject(globalOpts);
-      const scope = normalizeScope(opts.scope);
+      const scope = parseEnumFlag(opts.scope, SEARCH_SCOPE_FLAG) ?? "tasks";
       const searchOpts = buildSearchFilters(query, opts, projectId);
       if (opts.saveAs) {
         const view = saveSearchView({
@@ -26542,7 +26721,7 @@ function registerProjectCommands(program2) {
       const view = saveSearchView({
         name,
         description: opts.description,
-        scope: normalizeScope(opts.scope),
+        scope: parseEnumFlag(opts.scope, SEARCH_SCOPE_FLAG) ?? "tasks",
         filters: buildSearchFilters(opts.query, opts, projectId)
       });
       output(view, Boolean(globalOpts.json));
@@ -26555,7 +26734,7 @@ function registerProjectCommands(program2) {
   views.command("list").description("List local saved search views").option("--scope <scope>", "Filter by scope").action((opts) => {
     const globalOpts = program2.opts();
     try {
-      const rows = listSearchViews(opts.scope ? normalizeScope(opts.scope) : undefined);
+      const rows = listSearchViews(parseEnumFlag(opts.scope, SEARCH_SCOPE_FLAG));
       output(rows, Boolean(globalOpts.json));
       if (!globalOpts.json) {
         if (rows.length === 0) {
@@ -26751,7 +26930,7 @@ function registerProjectCommands(program2) {
     const cloud = getTodosCloudClient();
     if (opts.show) {
       const project = cloud ? await cloudResolveProject(cloud, opts.show) : resolveExplicitProject(opts.show);
-      output(project, Boolean(globalOpts.json));
+      outputRecord(project, Boolean(globalOpts.json), "Project:");
       return;
     }
     if (opts.update) {
@@ -26765,7 +26944,7 @@ function registerProjectCommands(program2) {
       }
       const current = cloud ? await cloudResolveProject(cloud, opts.update) : resolveExplicitProject(opts.update);
       const project = cloud ? await cloudUpdateProject(cloud, current.id, patch) : updateProject(current.id, patch);
-      output(project, Boolean(globalOpts.json));
+      outputRecord(project, Boolean(globalOpts.json), "Project updated:");
       return;
     }
     if (opts.deregister) {
@@ -27073,6 +27252,7 @@ Indexed ${result.index.files.length} file(s), ${result.index.total_symbols} symb
   program2.command("export").description("Export tasks").option("-f, --format <format>", "Format: json, md, todos.md, or bridge", "json").option("-o, --output <path>", "Write export output to a file").option("--encrypt", "Encrypt bridge exports with a local encryption profile").option("--encryption-profile <name>", "Encryption profile name", "default").option("--allow-plaintext-sensitive", "Deprecated; bridge exports are redacted unless --encrypt is used").action(async (opts) => {
     const { listTasks: listTasks2 } = await Promise.resolve().then(() => (init_tasks(), exports_tasks));
     const globalOpts = program2.opts();
+    opts.format = parseEnumFlag(opts.format, EXPORT_FORMAT_FLAG) ?? "json";
     const projectId = autoProject(globalOpts);
     const writeOutput = async (content) => {
       if (opts.output) {
@@ -27234,7 +27414,7 @@ function resolveTaskListId(partialId) {
   }
   return id;
 }
-var CLOUD_GRAPH_EDGE_CONCURRENCY = 6;
+var SEARCH_SCOPE_FLAG, EXPORT_FORMATS, EXPORT_FORMAT_FLAG, CLOUD_GRAPH_EDGE_CONCURRENCY = 6;
 var init_project_commands = __esm(() => {
   init_database();
   init_projects();
@@ -27246,12 +27426,26 @@ var init_project_commands = __esm(() => {
   init_config();
   init_helpers();
   init_output_redaction();
+  SEARCH_SCOPE_FLAG = {
+    name: "--scope",
+    vocabulary: SAVED_SEARCH_SCOPES,
+    normalize: (value) => value.toLowerCase().trim(),
+    allowList: false
+  };
+  EXPORT_FORMATS = ["json", "md", "markdown", "todos.md", "todos-md", "bridge"];
+  EXPORT_FORMAT_FLAG = {
+    name: "--format",
+    vocabulary: EXPORT_FORMATS,
+    normalize: (value) => value.toLowerCase().trim(),
+    allowList: false
+  };
 });
 
 // src/cli/commands/agent-commands.ts
 var exports_agent_commands = {};
 __export(exports_agent_commands, {
-  registerAgentCommands: () => registerAgentCommands
+  registerAgentCommands: () => registerAgentCommands,
+  findCaseVariantRows: () => findCaseVariantRows
 });
 import chalk6 from "chalk";
 import { execSync as execSync2 } from "child_process";
@@ -27265,6 +27459,15 @@ function resolveCloudAgentByNameOrId(agents, nameOrId) {
     return null;
   return matches.reduce((freshest, candidate) => new Date(candidate.last_seen_at).getTime() > new Date(freshest.last_seen_at).getTime() ? candidate : freshest);
 }
+function findCaseVariantRows(agents, requested) {
+  const raw = requested.trim();
+  const target = normalizeAgentNameInput(raw);
+  if (!target)
+    return [];
+  if (agents.some((agent) => agent.name === raw))
+    return [];
+  return agents.filter((agent) => normalizeAgentNameInput(agent.name) === target);
+}
 function clearIdentityIfMine(agentId, agentName) {
   const persisted = readPersistedIdentity();
   if (!persisted)
@@ -27278,7 +27481,22 @@ function registerAgentCommands(program2) {
     const globalOpts = program2.opts();
     try {
       const cloud = getTodosCloudClient();
-      const result = cloud ? await cloudRegisterAgent(cloud, { name, description: opts.description }) : (await Promise.resolve().then(() => (init_agents(), exports_agents))).registerAgent({ name, description: opts.description });
+      const registrationName = name.trim();
+      if (cloud) {
+        let roster = null;
+        try {
+          roster = await cloudListAgents(cloud);
+        } catch {
+          console.error(chalk6.yellow("Warning: could not read the shared roster, so the case-variant check was skipped for this registration."));
+        }
+        const variants = roster ? findCaseVariantRows(roster, registrationName) : [];
+        if (variants.length > 0) {
+          const listed = variants.map((a) => `${a.name} (${a.id})`).join(", ");
+          console.error(chalk6.red(`'${name}' is a case variant of an agent that already exists: ${listed}. ` + `Agent names are ONE case-insensitive identity, so registering this spelling would create a second row ` + `and split the identity in two \u2014 tasks assigned to one spelling are invisible to the other. ` + `Register with the existing spelling instead.`));
+          process.exit(1);
+        }
+      }
+      const result = cloud ? await cloudRegisterAgent(cloud, { name: registrationName, description: opts.description }) : (await Promise.resolve().then(() => (init_agents(), exports_agents))).registerAgent({ name: registrationName, description: opts.description });
       const { isAgentConflict: isAgentConflict2 } = await Promise.resolve().then(() => (init_agents(), exports_agents));
       if (isAgentConflict2(result)) {
         console.error(chalk6.red("CONFLICT:"), result.message);
@@ -27623,7 +27841,7 @@ ${isOnline ? chalk6.green("\u25CF") : chalk6.dim("\u25CB")} ${chalk6.bold(agent.
           const list2 = cloud ? await cloudGetTaskList(cloud, resolved) : getTaskList(resolved);
           if (!list2)
             throw new Error(`Task list not found: ${ref}`);
-          output(list2, Boolean(globalOpts.json));
+          outputRecord(list2, Boolean(globalOpts.json), "Task list:");
           return;
         }
         const patch = {
@@ -27634,7 +27852,7 @@ ${isOnline ? chalk6.green("\u25CF") : chalk6.dim("\u25CB")} ${chalk6.bold(agent.
         if (Object.keys(patch).length === 0)
           throw new Error("lists --update requires --name, --slug, or --description");
         const list = cloud ? await cloudUpdateTaskList(cloud, resolved, patch) : updateTaskList(resolved, patch);
-        output(list, Boolean(globalOpts.json));
+        outputRecord(list, Boolean(globalOpts.json), "Task list updated:");
         return;
       }
       if (opts.delete) {
@@ -32185,9 +32403,11 @@ async function updateTask2(id, input, store) {
     throw new Error(`Task ${id} version conflict: expected ${existing.version}, got ${input.version}`);
   }
   const reopened = existing.status === "completed" && input.status !== undefined && input.status !== "completed" && input.completed_at === undefined;
+  const terminalNow = input.status !== undefined && isTerminalStatus(input.status);
   const task = {
     ...existing,
     ...definedPatch(input),
+    ...terminalNow ? { locked_by: null, locked_at: null } : {},
     version: existing.version + 1,
     updated_at: new Date().toISOString(),
     tags: input.tags ?? existing.tags,
@@ -34528,8 +34748,19 @@ function handleStats(_ctx, json2) {
     recurring_tasks: countRecurringTasks()
   });
 }
+function taskStatusQueryParam(url) {
+  const raw = url.searchParams.get("status");
+  if (!raw)
+    return { ok: true, value: undefined };
+  const result = resolveEnumVocabulary(raw, { name: "status", vocabulary: TASK_STATUSES });
+  if (!result.ok)
+    return { ok: false, message: result.message };
+  return { ok: true, value: collapseEnumValues(result.values) };
+}
 async function handleListTasks(_req, url, _ctx, json2, taskToSummary2) {
-  const status = url.searchParams.get("status") || undefined;
+  const statusParam = taskStatusQueryParam(url);
+  if (!statusParam.ok)
+    return json2({ error: statusParam.message }, 400);
   const projectId = url.searchParams.get("project_id") || undefined;
   const sessionId = url.searchParams.get("session_id") || undefined;
   const agentId = url.searchParams.get("agent_id") || undefined;
@@ -34537,7 +34768,7 @@ async function handleListTasks(_req, url, _ctx, json2, taskToSummary2) {
   const offsetParam = url.searchParams.get("offset");
   const fields = parseFieldsParam(url);
   const tasks = listTasks({
-    status,
+    status: statusParam.value,
     project_id: projectId,
     session_id: sessionId,
     agent_id: agentId,
@@ -34602,9 +34833,19 @@ async function handleUpsertTask(req, ctx, json2, taskToSummary2) {
 }
 function handleTasksExport(_req, url, _ctx, _json, taskToSummary2) {
   const format = url.searchParams.get("format") || "json";
-  const status = url.searchParams.get("status") || undefined;
+  const statusParam = taskStatusQueryParam(url);
+  if (!statusParam.ok) {
+    return new Response(JSON.stringify({ error: statusParam.message }), {
+      status: 400,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
   const projectId = url.searchParams.get("project_id") || undefined;
-  const tasks = listTasks({ status, project_id: projectId, limit: 1e4 });
+  const tasks = listTasks({
+    status: statusParam.value,
+    project_id: projectId,
+    limit: 1e4
+  });
   const summaries = tasks.map((t) => taskToSummary2(t));
   if (format === "csv") {
     const headers = ["id", "short_id", "title", "status", "priority", "project_id", "assigned_to", "agent_id", "created_at", "updated_at", "completed_at", "due_at"];
@@ -35186,6 +35427,7 @@ var init_routes = __esm(() => {
   init_tasks();
   init_database();
   init_types();
+  init_types();
   init_projects();
   init_agents();
   init_plans();
@@ -37070,8 +37312,38 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
           operationId: "listTasks",
           summary: "List tasks",
           parameters: [
-            { name: "status", in: "query", schema: { type: "string" } },
-            { name: "priority", in: "query", schema: { type: "string" } },
+            {
+              name: "status",
+              in: "query",
+              description: `Task status, or a comma-separated list of statuses. Allowed values: ${TASK_STATUSES.join(", ")}.`,
+              style: "form",
+              explode: false,
+              schema: {
+                oneOf: [
+                  { type: "string", enum: [...TASK_STATUSES] },
+                  {
+                    type: "array",
+                    items: { type: "string", enum: [...TASK_STATUSES] }
+                  }
+                ]
+              }
+            },
+            {
+              name: "priority",
+              in: "query",
+              description: `Task priority, or a comma-separated list of priorities. Allowed values: ${TASK_PRIORITIES.join(", ")}.`,
+              style: "form",
+              explode: false,
+              schema: {
+                oneOf: [
+                  { type: "string", enum: [...TASK_PRIORITIES] },
+                  {
+                    type: "array",
+                    items: { type: "string", enum: [...TASK_PRIORITIES] }
+                  }
+                ]
+              }
+            },
             { name: "project_id", in: "query", schema: { type: "string" } },
             { name: "parent_id", in: "query", schema: { type: "string", nullable: true } },
             { name: "include_subtasks", in: "query", schema: { type: "boolean" } },
@@ -37583,6 +37855,7 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
 var taskSchema, projectSchema, taskListSchema, taskCommentSchema, planSchema, templateTaskSchema, templateSchema, templateVariableSchema, createTemplateTaskInputSchema;
 var init_openapi = __esm(() => {
   init_package_version();
+  init_types();
   taskSchema = {
     type: "object",
     properties: {
@@ -37850,6 +38123,15 @@ function json3(body, status = 200) {
 function error(status, message, extra) {
   return json3({ error: message, ...extra ?? {} }, status);
 }
+function enumQueryParam(url, name, vocabulary) {
+  const raw = url.searchParams.get(name);
+  if (raw === null || raw === "")
+    return { ok: true, value: undefined };
+  const result = resolveEnumVocabulary(raw, { name, vocabulary });
+  if (!result.ok)
+    return { ok: false, response: error(400, result.message) };
+  return { ok: true, value: collapseEnumValues(result.values) };
+}
 function validateTaskCompletion(value) {
   if (!value || typeof value !== "object" || Array.isArray(value))
     return { ok: false, message: "completion body must be an object" };
@@ -38270,14 +38552,16 @@ async function handleV1Request(req, url, dependencies = {}) {
             return error(400, "include_subtasks must be true or false");
           }
           const hasParentFilter = url.searchParams.has("parent_id");
+          const statusParam = enumQueryParam(url, "status", TASK_STATUSES);
+          if (!statusParam.ok)
+            return statusParam.response;
+          const priorityParam = enumQueryParam(url, "priority", TASK_PRIORITIES);
+          if (!priorityParam.ok)
+            return priorityParam.response;
           const filter = {
             ...url.searchParams.get("q") ? { query: url.searchParams.get("q") } : {},
-            ...url.searchParams.get("status") ? {
-              status: url.searchParams.get("status").includes(",") ? url.searchParams.get("status").split(",") : url.searchParams.get("status")
-            } : {},
-            ...url.searchParams.get("priority") ? {
-              priority: url.searchParams.get("priority").includes(",") ? url.searchParams.get("priority").split(",") : url.searchParams.get("priority")
-            } : {},
+            ...statusParam.value !== undefined ? { status: statusParam.value } : {},
+            ...priorityParam.value !== undefined ? { priority: priorityParam.value } : {},
             ...url.searchParams.get("project_id") ? { project_id: url.searchParams.get("project_id") } : {},
             ...hasParentFilter ? { parent_id: url.searchParams.get("parent_id") || null, include_subtasks: true } : includeSubtasks !== null ? { include_subtasks: includeSubtasks === "true" } : {},
             ...url.searchParams.get("plan_id") ? { plan_id: url.searchParams.get("plan_id") } : {},
@@ -50421,10 +50705,23 @@ function registerTaskAutoTools(server, ctx) {
           return { content: [{ type: "text", text: "No active agents available for rebalancing." }] };
         const activeTasks = listTasks4({ project_id: resolvedProjectId, status: ["pending", "in_progress"], limit: 1000 }, undefined);
         const agentKeyByAlias = new Map;
+        const ambiguousAgentAliases = new Set;
+        const indexAgentAlias = (alias, agentId) => {
+          const normalizedAlias2 = alias.toLowerCase();
+          if (ambiguousAgentAliases.has(normalizedAlias2))
+            return;
+          const existingAgentId = agentKeyByAlias.get(normalizedAlias2);
+          if (existingAgentId !== undefined && existingAgentId !== agentId) {
+            agentKeyByAlias.delete(normalizedAlias2);
+            ambiguousAgentAliases.add(normalizedAlias2);
+            return;
+          }
+          agentKeyByAlias.set(normalizedAlias2, agentId);
+        };
         for (const agent of agents) {
-          agentKeyByAlias.set(String(agent.id).toLowerCase(), agent.id);
+          indexAgentAlias(String(agent.id), agent.id);
           if (agent.name)
-            agentKeyByAlias.set(String(agent.name).toLowerCase(), agent.id);
+            indexAgentAlias(String(agent.name), agent.id);
         }
         const canonicalAgentKey = (assignedTo) => assignedTo ? agentKeyByAlias.get(assignedTo.toLowerCase()) : undefined;
         const load = new Map(agents.map((agent) => [agent.id, activeTasks.filter((t) => canonicalAgentKey(t.assigned_to) === agent.id).length]));
@@ -61810,9 +62107,16 @@ ${text2}` }] };
           return { content: [{ type: "text", text: `Agent not found: ${id || name}` }], isError: true };
         }
         const oldName = agent.name;
-        const updated = updateAgent(agent.id, { name: new_name });
         const db = getDatabase();
-        const tasksResult = db.run("UPDATE tasks SET assigned_to = ? WHERE LOWER(assigned_to) = LOWER(?)", [new_name, oldName]);
+        let oldNameUniquelyIdentifiesAgent = false;
+        try {
+          oldNameUniquelyIdentifiesAgent = resolvePartialId(db, "agents", oldName) === agent.id;
+        } catch (error2) {
+          if (!(error2 instanceof IdentityAliasAmbiguousError))
+            throw error2;
+        }
+        const updated = updateAgent(agent.id, { name: new_name });
+        const tasksResult = db.run(oldNameUniquelyIdentifiesAgent ? "UPDATE tasks SET assigned_to = ? WHERE LOWER(assigned_to) = LOWER(?)" : "UPDATE tasks SET assigned_to = ? WHERE assigned_to = ?", [new_name, oldName]);
         const taskNote = tasksResult.changes > 0 ? `
 Updated assigned_to on ${tasksResult.changes} task(s).` : "";
         return {
@@ -61996,6 +62300,7 @@ var init_agents2 = __esm(() => {
   init_agents();
   init_config();
   init_database();
+  init_types();
   init_cloud_router();
 });
 
@@ -72161,7 +72466,11 @@ function registerDispatchCommands(program2) {
         process.exit(1);
       }
     }
-    const statuses = opts.status ? opts.status.split(",").map((s) => s.trim()) : undefined;
+    const statuses = parseEnumFlagList(opts.status, {
+      name: "--status",
+      vocabulary: DISPATCH_STATUSES,
+      normalize: (value) => value.toLowerCase().trim()
+    });
     const dispatches = listDispatches({ status: statuses, limit: opts.limit ?? 20 });
     if (useJson) {
       console.log(JSON.stringify(dispatches, null, 2));
@@ -72194,6 +72503,8 @@ var init_dispatch3 = __esm(() => {
   init_dispatch();
   init_dispatch_formatter();
   init_tmux();
+  init_types();
+  init_helpers();
 });
 
 // src/cli/commands/machines.tsx