@hasna/todos 0.13.4 → 0.13.5

package/dist/cli/commands/agent-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QA6erD"}
+{"version":3,"file":"agent-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QA+erD"}

package/dist/cli/commands/task-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/task-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsDzC,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAkPD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA63CpD"}
+{"version":3,"file":"task-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/task-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsDzC,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAkPD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAg4CpD"}

package/dist/cli/index.js

@@ -2123,7 +2123,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.4",
+    version: "0.13.5",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -6362,41 +6362,103 @@ function isMetadataInvocation(args, invocation) {
   }
   return invocation.commandArgs.length === 1 && (HELP_FLAGS.has(invocation.commandArgs[0]) || VERSION_FLAGS.has(invocation.commandArgs[0]));
 }
-function commandSupportsRemote(invocation) {
+function firstPresentOption(args, candidates) {
+  const option = candidates.find((candidate) => hasOption(args, candidate));
+  return option ? dropIt(option) : null;
+}
+function disqualifyingArgument(invocation) {
   const command = invocation.command;
-  if (!command || COMMAND_CAPABILITY_MATRIX.get(command) !== "remote-http")
-    return false;
   const args = invocation.commandArgs;
   switch (command) {
     case "task":
-      return positionalArgs(args)[0] === "upsert";
+      return positionalArgs(args)[0] === "upsert" ? null : { blame: "any subcommand other than `upsert`", remedy: "use `todos task upsert`" };
     case "doctor":
-      return positionalArgs(args)[0] !== "routing" && !hasOption(args, "--apply") && !hasOption(args, "--fix");
+      if (positionalArgs(args)[0] === "routing")
+        return dropIt("the `routing` subcommand");
+      return firstPresentOption(args, ["--apply", "--fix"]);
     case "projects":
-      return !hasOption(args, "--deregister") && !hasOption(args, "--path-prefix") && !hasOption(args, "--dry-run");
+      return firstPresentOption(args, ["--deregister", "--path-prefix", "--dry-run"]);
     case "plans":
-      return !hasOption(args, "--artifact") && !hasOption(args, "--write-artifacts");
+      return firstPresentOption(args, ["--artifact", "--write-artifacts"]);
     case "list":
-      return !hasOption(args, "--recurring");
+      return firstPresentOption(args, ["--recurring"]);
     case "claim":
-      return !invocation.globalOptions.has("--project") && !hasOption(args, "--project") && !hasOption(args, "--stale-minutes") && !hasOption(args, "--steal-stale");
+      if (invocation.globalOptions.has("--project"))
+        return dropIt("--project");
+      return firstPresentOption(args, ["--project", "--stale-minutes", "--steal-stale"]);
     case "status":
-      return !invocation.globalOptions.has("--agent") && !hasOption(args, "--agent");
-    case "deps":
-      return true;
+      if (invocation.globalOptions.has("--agent"))
+        return dropIt("--agent");
+      return firstPresentOption(args, ["--agent"]);
     case "bulk": {
       const action = positionalArgs(args)[0];
       if (action === "plan" || action === "move-plan")
-        return true;
-      return Boolean(action && ["done", "complete", "start", "delete"].includes(action)) && !hasOption(args, "--plan") && !hasOption(args, "--clear-plan");
+        return null;
+      if (!action) {
+        return { blame: "a missing action", remedy: "pass one of done, complete, start, delete, plan, move-plan" };
+      }
+      if (!["done", "complete", "start", "delete"].includes(action)) {
+        return {
+          blame: `the \`${action}\` action`,
+          remedy: "use one of done, complete, start, delete, plan, move-plan"
+        };
+      }
+      return firstPresentOption(args, ["--plan", "--clear-plan"]);
     }
     default:
-      return true;
+      return null;
+  }
+}
+function commandSupportsRemote(invocation) {
+  const command = invocation.command;
+  if (!command || COMMAND_CAPABILITY_MATRIX.get(command) !== "remote-http")
+    return false;
+  return disqualifyingArgument(invocation) === null;
+}
+function editDistance(a, b) {
+  const rows = a.length + 1;
+  const cols = b.length + 1;
+  let twoBack = new Array(cols).fill(0);
+  let previous = Array.from({ length: cols }, (_, index) => index);
+  for (let row = 1;row < rows; row += 1) {
+    const current = [row, ...new Array(cols - 1).fill(0)];
+    for (let col = 1;col < cols; col += 1) {
+      const substitution = previous[col - 1] + (a[row - 1] === b[col - 1] ? 0 : 1);
+      current[col] = Math.min(current[col - 1] + 1, previous[col] + 1, substitution);
+      if (row > 1 && col > 1 && a[row - 1] === b[col - 2] && a[row - 2] === b[col - 1]) {
+        current[col] = Math.min(current[col], twoBack[col - 2] + 1);
+      }
+    }
+    twoBack = previous;
+    previous = current;
   }
+  return previous[cols - 1];
+}
+function nearestCommands(command, limit = 3) {
+  const threshold = command.length <= 4 ? 1 : command.length <= 8 ? 2 : 3;
+  return [...COMMAND_CAPABILITY_MATRIX.entries()].filter(([, owner]) => owner !== "local-only").map(([candidate]) => candidate).map((candidate) => ({ candidate, distance: editDistance(command, candidate) })).filter(({ distance }) => distance <= threshold).sort((left, right) => left.distance - right.distance || left.candidate.localeCompare(right.candidate)).slice(0, limit).map(({ candidate }) => candidate);
 }
 function assertRemoteCommandSupported(invocation) {
-  if (invocation.invalidGlobalOption || invocation.unknownLeadingOption || !commandSupportsRemote(invocation)) {
-    throw new Error(`REMOTE_COMMAND_UNSUPPORTED: ${invocationLabel(invocation)} is not supported by the Todos /v1 CLI; ` + "local SQLite fallback is disabled");
+  if (invocation.invalidGlobalOption) {
+    throw new Error(`REMOTE_COMMAND_UNSUPPORTED: the global option ${invocation.invalidGlobalOption} was given without a value; ` + `pass one as \`${invocation.invalidGlobalOption} <value>\``);
+  }
+  if (invocation.unknownLeadingOption) {
+    throw new Error(`REMOTE_COMMAND_UNSUPPORTED: unknown option ${invocation.unknownLeadingOption} before the command; ` + "run `todos --help` for the global options");
+  }
+  const command = invocation.command;
+  const owner = command ? COMMAND_CAPABILITY_MATRIX.get(command) : undefined;
+  if (command && !owner) {
+    const suggestions = nearestCommands(command);
+    const didYouMean = suggestions.length > 0 ? ` Did you mean: ${suggestions.join(", ")}?` : "";
+    throw new Error(`UNKNOWN_COMMAND: \`${command}\` is not a built-in todos command on the /v1 route.${didYouMean} ` + "Run `todos --help` for the commands available here; verbs contributed by optional packages are local-only. " + "(This is not a connectivity, storage-mode or credential problem.)");
+  }
+  if (command && owner === "local-only") {
+    throw new Error(`REMOTE_COMMAND_UNSUPPORTED: \`${command}\` is a local-only command and the Todos /v1 authority does not ` + "serve it; local SQLite fallback is disabled. Run `todos --help` to see the commands this route supports.");
+  }
+  if (!command || !commandSupportsRemote(invocation)) {
+    const blame = command ? disqualifyingArgument(invocation) : null;
+    const detail = blame ? `\`${command}\` is served by the Todos /v1 authority but ${blame.blame} is not; ${blame.remedy}` : `${invocationLabel(invocation)} is not supported by the Todos /v1 CLI; local SQLite fallback is disabled`;
+    throw new Error(`REMOTE_COMMAND_UNSUPPORTED: ${detail}`);
   }
 }
 function initializeTodosCliAuthority(args = process.argv.slice(2), env = process.env) {
@@ -6415,7 +6477,7 @@ function initializeTodosCliAuthority(args = process.argv.slice(2), env = process
   }
   return { route: "remote-http", v1_base_url: client.baseUrl };
 }
-var REGISTERED_CANONICAL_COMMANDS, TODOS_CLI_COMMAND_ALIASES, DIAGNOSTIC_COMMANDS, REMOTE_COMMANDS, COMMAND_CAPABILITY_MATRIX, GLOBAL_OPTIONS_WITH_VALUES, GLOBAL_FLAGS, HELP_FLAGS, VERSION_FLAGS;
+var REGISTERED_CANONICAL_COMMANDS, TODOS_CLI_COMMAND_ALIASES, DIAGNOSTIC_COMMANDS, REMOTE_COMMANDS, COMMAND_CAPABILITY_MATRIX, GLOBAL_OPTIONS_WITH_VALUES, GLOBAL_FLAGS, HELP_FLAGS, VERSION_FLAGS, dropIt = (blame) => ({ blame, remedy: "re-run without it" });
 var init_stage_a = __esm(() => {
   init_esm();
   init_cloud_router();
@@ -6594,6 +6656,8 @@ var init_stage_a = __esm(() => {
     "template-history": ["templates-history"],
     "agents-normalize": ["normalize-agents"],
     "agent-update": ["agents-update"],
+    done: ["complete"],
+    init: ["register"],
     upgrade: ["self-update"],
     roadmaps: ["roadmap"],
     "env-snapshot": ["environment-snapshot"],
@@ -20099,7 +20163,7 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
       console.log(formatTaskLine(task2));
     }
   });
-  program2.command("done <id>").description("Mark a task as completed").option("--attach-ids <ids>", "Comma-separated @hasna/attachments IDs to link as evidence").option("--files-changed <files>", "Comma-separated list of files changed").option("--test-results <results>", "Test results summary").option("--commit-hash <hash>", "Git commit hash").option("--notes <notes>", "Completion notes").option("--confidence <0-1>", "Agent's confidence 0.0-1.0 that the task is fully complete (default: 1.0, <0.7 flagged for review)").action(async (id, opts) => {
+  program2.command("done <id>").alias("complete").description("Mark a task as completed (alias: complete)").option("--attach-ids <ids>", "Comma-separated @hasna/attachments IDs to link as evidence").option("--files-changed <files>", "Comma-separated list of files changed").option("--test-results <results>", "Test results summary").option("--commit-hash <hash>", "Git commit hash").option("--notes <notes>", "Completion notes").option("--confidence <0-1>", "Agent's confidence 0.0-1.0 that the task is fully complete (default: 1.0, <0.7 flagged for review)").action(async (id, opts) => {
     const globalOpts = program2.opts();
     const attachmentIds = opts.attachIds ? opts.attachIds.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
     const filesChanged = opts.filesChanged ? opts.filesChanged.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
@@ -26747,7 +26811,7 @@ function resolveCloudAgentByNameOrId(agents, nameOrId) {
   return matches.reduce((freshest, candidate) => new Date(candidate.last_seen_at).getTime() > new Date(freshest.last_seen_at).getTime() ? candidate : freshest);
 }
 function registerAgentCommands(program2) {
-  program2.command("init <name>").description("Register an agents and get a short UUID").option("-d, --description <text>", "Agent description").action(async (name, opts) => {
+  program2.command("init <name>").alias("register").description("Register an agent and get a short UUID (alias: register)").option("-d, --description <text>", "Agent description").action(async (name, opts) => {
     const globalOpts = program2.opts();
     try {
       const cloud = getTodosCloudClient();

package/dist/cli/stage-a.d.ts

@@ -26,6 +26,8 @@ export declare const TODOS_CLI_COMMAND_ALIASES: {
     readonly "template-history": readonly ["templates-history"];
     readonly "agents-normalize": readonly ["normalize-agents"];
     readonly "agent-update": readonly ["agents-update"];
+    readonly done: readonly ["complete"];
+    readonly init: readonly ["register"];
     readonly upgrade: readonly ["self-update"];
     readonly roadmaps: readonly ["roadmap"];
     readonly "env-snapshot": readonly ["environment-snapshot"];

package/dist/cli/stage-a.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-a.d.ts","sourceRoot":"","sources":["../../src/cli/stage-a.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAC;AAO1C,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,MAAM,MAAM,+BAA+B,GACvC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1D;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;AAyB/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAuBgB,CAAC;AAsBvD,wBAAgB,kCAAkC,IAAI,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAE9F;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAAG,IAAI,CASnH;AA4KD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,MAAM,EAA0B,EACtC,GAAG,GAAE,GAAwB,GAC5B,+BAA+B,CAgBjC"}
+{"version":3,"file":"stage-a.d.ts","sourceRoot":"","sources":["../../src/cli/stage-a.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAC;AAO1C,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,MAAM,MAAM,+BAA+B,GACvC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1D;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;AAyB/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;CA8BgB,CAAC;AAsBvD,wBAAgB,kCAAkC,IAAI,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAE9F;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC9C,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAAG,IAAI,CASnH;AAiTD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,MAAM,EAA0B,EACtC,GAAG,GAAE,GAAwB,GAC5B,+BAA+B,CAgBjC"}

package/dist/contracts.js

@@ -11900,7 +11900,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.4",
+  version: "0.13.5",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/index.js

@@ -12013,7 +12013,7 @@ var init_dispatches = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.4",
+  version: "0.13.5",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/mcp/index.js

@@ -34571,7 +34571,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.4",
+    version: "0.13.5",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",

package/dist/mcp.js

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

package/dist/registry.js

@@ -11900,7 +11900,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.4",
+  version: "0.13.5",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/release-provenance.json

@@ -1,9 +1,9 @@
 {
   "packageName": "@hasna/todos",
-  "packageVersion": "0.13.4",
+  "packageVersion": "0.13.5",
   "repository": "https://github.com/hasna/todos.git",
-  "gitCommit": "c2c3517bab2321911c44285625ecaa58fcf606ff",
-  "gitTree": "f3acc3cc1322f240e911e1ab483a7a5ef88371cd",
-  "sourceTreeSha256": "445622ccd461d74a6c060130c1bccfa72b829d74b24b5358b0e36cb730eb8374",
-  "generatedAt": "2026-07-31T11:35:34.000Z"
+  "gitCommit": "305b1033309bc22e62d2a636499436f43f01fff3",
+  "gitTree": "e291ed0071837371f5711a02455d6155c42ec7a5",
+  "sourceTreeSha256": "0ad301aa18686673cba69326bacd3aeacbcb92096d6f10b5477e500d6883c467",
+  "generatedAt": "2026-07-31T15:55:50.000Z"
 }

package/dist/server/index.js

@@ -70,7 +70,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.4",
+    version: "0.13.5",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",