@todoforai/cli 0.1.20 → 0.1.22

package/dist/todoai.js

@@ -42825,6 +42825,9 @@ class ApiClient {
   deleteTodo(todoId) {
     return this.request("DELETE", `/api/v1/todos/${todoId}`);
   }
+  listModels() {
+    return this.request("GET", "/api/v1/models");
+  }
   listAgentSettings(filters) {
     const params = new URLSearchParams;
     if (filters?.workspacePath)
@@ -42923,7 +42926,7 @@ function normalizeApiUrl(url) {
     return `https://${url}`;
   return url;
 }
-var SUBCOMMANDS = new Set(["login", "logout"]);
+var SUBCOMMANDS = new Set(["login", "logout", "update"]);
 function credentialsPath() {
   const sys = os2.platform();
   if (sys === "win32") {
@@ -44093,26 +44096,34 @@ Usage:
   todoforai-cli -c ["prompt"]                 # Resume last todo (optional prompt sent on attach)
   todoforai-cli --resume <todo-id> ["prompt"] # Resume specific todo (optional prompt sent on attach)
   todoforai-cli --inspect <todo-id>[@<slice>] # Read chat log. <slice> = -3:, :1, 5:10, 7  (Python-style)
-  todoforai-cli --template <id> [--input k=v] # Start from a registry template
+  todoforai-cli start <id>                    # Start a TODO from the registry (todoregistry.com)
   todoforai-cli --list-agents                 # List available agents and exit
+  todoforai-cli --list-models [filter]        # List models usable with --model and exit
   todoforai-cli agent update <agent> model=<model>    # Update agent settings (see 'agent --help')
   todoforai-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated); see 'list --help'
   todoforai-cli status <todo-id> <STATUS>     # Update a todo's status (run 'status --help' for the full list)
   todoforai-cli delete <todo-id>              # Permanently delete a todo
   todoforai-cli addmessage <todo-id> "text"  # Add a message to an existing todo
   todoforai-cli recommend --template <id>    # Add a template as a NEXT-column card (see 'todoregistry-cli create')
+  todoforai-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]  # Mint /claim/<token> ownership links for a project you own
+  todoforai-cli steering get                 # Show recommendation steering (direction + boosted/muted categories)
+  todoforai-cli steering direction "<text>"  # Set the direction the generator should follow
+  todoforai-cli steering boost|mute <cat>    # Favour / avoid a category
+  todoforai-cli next                         # Generate steered NEXT-column recommendations
 
 Options:
   --path <dir>                    Workspace path (default: cwd)
   --project <id>                  Project ID
   --agent, -a <name>              Agent name (partial match)
+  --model <model>                 Override the agent's model for this todo
+                                  (e.g. anthropic:anthropic/claude-opus-5, openai:openai/gpt-5.6-sol)
   --list-agents                   List available agents (name, id, workspace paths) and exit
+  --list-models                   List models usable with --model (optional substring filter) and exit
   --api-url <url>                 API URL
   --api-key <key>                 API key
   --user-id <id>                  Admin HTTP impersonation; requires --no-watch
   --inspect, -i <todo-id>[@<slice>]     Print chat log (read-only)
-  --template, -t <id>            Start from a registry template
-  --input <key=value>            Template input (repeatable)
+  --template, -t <id>            Start from a registry template (alias: start <id>)
   --resume, -r [todo-id]          Resume existing todo
   --continue, -c                  Continue most recent todo
   --non-interactive, -n           Run to completion and exit without interactive prompt
@@ -44163,16 +44174,19 @@ function parseCliArgs() {
       agent: { type: "string", short: "a" },
       model: { type: "string" },
       "list-agents": { type: "boolean", default: false },
+      "list-models": { type: "boolean", default: false },
       "api-url": { type: "string" },
       "api-key": { type: "string" },
       "user-id": { type: "string" },
       inspect: { type: "string", short: "i" },
       template: { type: "string", short: "t" },
-      input: { type: "string", multiple: true },
       note: { type: "string" },
       priority: { type: "string" },
       title: { type: "string" },
       "business-context": { type: "string" },
+      seed: { type: "string" },
+      emails: { type: "string" },
+      ttl: { type: "string" },
       resume: { type: "string", short: "r" },
       continue: { type: "boolean", short: "c", default: false },
       "non-interactive": { type: "boolean", short: "n", default: false },
@@ -44201,9 +44215,6 @@ function parseCliArgs() {
   return { values, positionals };
 }
 
-// src/input.ts
-import { createInterface } from "readline";
-
 // src/colors.ts
 var on = !process.env.NO_COLOR && !!process.stdout.isTTY;
 var c = (seq) => on ? seq : "";
@@ -44224,15 +44235,6 @@ var BG_RED_HL = c("\x1B[48;2;100;35;35m");
 var BG_GREEN_HL = c("\x1B[48;2;35;85;35m");
 
 // src/input.ts
-function readLine(prompt) {
-  const rl = createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((res) => {
-    rl.question(prompt, (ans) => {
-      rl.close();
-      res(ans.trim());
-    });
-  });
-}
 function readMultiline(prompt, history) {
   let cancelFn = () => {};
   const promise = new Promise((resolve, reject) => {
@@ -45304,7 +45306,7 @@ ${label}${ts}
 }
 
 // src/select.ts
-import { createInterface as createInterface2 } from "readline";
+import { createInterface } from "readline";
 function getDisplayName(item) {
   if (item?.project?.name)
     return item.project.name;
@@ -45338,7 +45340,7 @@ function resolveAgentMatch(agents, query) {
   return {};
 }
 function terminalLine(prompt) {
-  const rl = createInterface2({ input: process.stdin, output: process.stderr });
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve3) => {
     rl.question(prompt, (answer) => {
       rl.close();
@@ -46065,6 +46067,20 @@ async function listAgentsCommand(api, opts) {
   }
 }
 
+// src/list-models.ts
+async function listModelsCommand(api, opts) {
+  const res = await api.listModels();
+  const q = opts.filter?.toLowerCase();
+  const ids = (res?.data || []).map((m) => String(m.id).includes("/") ? `${String(m.id).split("/")[0]}:${m.id}` : String(m.id)).filter((id) => !q || id.toLowerCase().includes(q));
+  if (opts.json) {
+    console.log(JSON.stringify(ids, null, 2));
+    return;
+  }
+  for (const id of ids)
+    process.stderr.write(`${BRAND}${id}${RESET}
+`);
+}
+
 // src/agent-command.ts
 function printAgentHelp() {
   process.stderr.write(`
@@ -46374,6 +46390,92 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 `);
 }
 
+// src/steering-command.ts
+var RED2 = "\x1B[31m";
+var GREEN2 = "\x1B[32m";
+var DIM2 = "\x1B[2m";
+var RESET2 = "\x1B[0m";
+async function rest(ctx, method, path4, body) {
+  const res = await fetch(`${ctx.apiUrl}/api/v1${path4}`, {
+    method,
+    headers: { "content-type": "application/json", "x-api-key": ctx.apiKey },
+    ...body ? { body: JSON.stringify(body) } : {},
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await res.text();
+  if (!res.ok)
+    throw new Error(`${method} ${path4} failed: ${res.status} ${text}`);
+  return text ? JSON.parse(text) : null;
+}
+function printSteering(s) {
+  process.stderr.write(`${GREEN2}Direction:${RESET2} ${s.direction || DIM2 + "(none)" + RESET2}
+`);
+  process.stderr.write(`${GREEN2}Boosted:${RESET2}   ${s.boostedCategoryIds?.join(", ") || DIM2 + "(none)" + RESET2}
+`);
+  process.stderr.write(`${GREEN2}Muted:${RESET2}     ${s.mutedCategoryIds?.join(", ") || DIM2 + "(none)" + RESET2}
+`);
+}
+var USAGE = `${RED2}Usage:
+  todoforai-cli steering get [--project <id>]
+  todoforai-cli steering direction "<text>" [--project <id>]   (empty text clears it)
+  todoforai-cli steering boost <categoryId> [--project <id>]
+  todoforai-cli steering mute  <categoryId> [--project <id>]
+  todoforai-cli steering clear [--project <id>]                (clears all steering)${RESET2}`;
+async function steeringCommand(ctx, argv) {
+  const sub = argv[0];
+  const path4 = `/projects/${ctx.projectId}/recommendation-steering`;
+  if (!sub || sub === "get") {
+    const s = await rest(ctx, "GET", path4);
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      printSteering(s);
+    return;
+  }
+  if (sub === "direction") {
+    const text = argv.slice(1).join(" ").trim();
+    const s = await rest(ctx, "PATCH", path4, { projectId: ctx.projectId, direction: text || null });
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      process.stderr.write(`${GREEN2}\u2705 ${text ? `Direction set: ${text}` : "Direction cleared"}${RESET2}
+`);
+    return;
+  }
+  if (sub === "boost" || sub === "mute") {
+    const categoryId = argv[1];
+    if (!categoryId) {
+      process.stderr.write(USAGE + `
+`);
+      process.exit(2);
+    }
+    const current = await rest(ctx, "GET", path4);
+    const key = sub === "boost" ? "boostedCategoryIds" : "mutedCategoryIds";
+    const other = sub === "boost" ? "mutedCategoryIds" : "boostedCategoryIds";
+    const next = Array.from(new Set([...current[key] ?? [], categoryId]));
+    const nextOther = (current[other] ?? []).filter((c2) => c2 !== categoryId);
+    const s = await rest(ctx, "PATCH", path4, { projectId: ctx.projectId, [key]: next, [other]: nextOther });
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      process.stderr.write(`${GREEN2}\u2705 ${sub === "boost" ? "Boosted" : "Muted"} ${categoryId}${RESET2}
+`);
+    return;
+  }
+  if (sub === "clear") {
+    const s = await rest(ctx, "PATCH", path4, { projectId: ctx.projectId, direction: null, boostedCategoryIds: [], mutedCategoryIds: [] });
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      process.stderr.write(`${GREEN2}\u2705 Steering cleared${RESET2}
+`);
+    return;
+  }
+  process.stderr.write(USAGE + `
+`);
+  process.exit(2);
+}
+
 // src/index.ts
 try {
   const pkgPath = path4.resolve(fileURLToPath(import.meta.url), "../../package.json");
@@ -46464,6 +46566,15 @@ Cancelled by user (Ctrl+C)
     process.exit(130);
   });
   const { values: args, positionals } = parseCliArgs();
+  if (positionals[0] === "start") {
+    if (!positionals[1] && !args.template) {
+      process.stderr.write(`${RED}Usage: todoforai-cli start <todo-id>${RESET}
+`);
+      process.exit(2);
+    }
+    if (!args.template)
+      args.template = positionals[1];
+  }
   if (args.version) {
     console.log(VERSION);
     process.exit(0);
@@ -46565,7 +46676,8 @@ Cancelled by user (Ctrl+C)
     await deviceLogin();
     return;
   }
-  let apiKey = args["api-key"] || readCredential(apiUrl) || getEnv("API_TOKEN") || "";
+  const notDst = (t) => t.startsWith("dst_") ? "" : t;
+  let apiKey = args["api-key"] || notDst(readCredential(apiUrl)) || notDst(getEnv("API_TOKEN")) || "";
   if (!apiKey) {
     apiKey = await deviceLogin();
   }
@@ -46609,8 +46721,8 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (positionals[0] === "addmessage") {
-    const [, todoId, ...rest] = positionals;
-    const content2 = rest.join(" ") || await readStdin();
+    const [, todoId, ...rest2] = positionals;
+    const content2 = rest2.join(" ") || await readStdin();
     if (!todoId || !content2) {
       process.stderr.write(`${RED}Usage: todoforai-cli addmessage <todo-id> "content"${RESET}
 `);
@@ -46652,7 +46764,7 @@ Cancelled by user (Ctrl+C)
     }
     const rec = await api.recommend({
       projectId: projectId2,
-      templateId,
+      specId: templateId,
       ...args.title ? { title: args.title } : {},
       ...args.note ? { note: args.note } : {},
       ...priority ? { priority } : {},
@@ -46665,10 +46777,92 @@ Cancelled by user (Ctrl+C)
 `);
     return;
   }
+  if (positionals[0] === "claim" && positionals[1] === "mint") {
+    let seedProjectId = args.seed || args.project || cfgScope.data.default_project_id;
+    if (!seedProjectId) {
+      const projects2 = await api.listProjects();
+      seedProjectId = projects2.find((p) => p.project?.isDefault)?.project?.id || projects2[0]?.project?.id;
+    }
+    if (!seedProjectId) {
+      process.stderr.write(`${RED}Usage: todoforai-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]${RESET}
+`);
+      process.exit(2);
+    }
+    const emails = args.emails?.split(",").map((e) => e.trim()).filter(Boolean);
+    let ttlSec;
+    if (args.ttl !== undefined) {
+      ttlSec = Number(args.ttl);
+      if (!Number.isFinite(ttlSec)) {
+        process.stderr.write(`${RED}--ttl must be a number (seconds)${RESET}
+`);
+        process.exit(2);
+      }
+    }
+    const res = await fetch(`${apiUrl}/api/v1/claims/mint`, {
+      method: "POST",
+      headers: { "content-type": "application/json", "x-api-key": apiKey },
+      body: JSON.stringify({ seedProjectId, ...emails?.length ? { emails } : {}, ...ttlSec !== undefined ? { ttlSec } : {} }),
+      signal: AbortSignal.timeout(30000)
+    });
+    const text = await res.text();
+    if (!res.ok) {
+      process.stderr.write(`${RED}Mint failed: ${res.status} ${text}${RESET}
+`);
+      process.exit(1);
+    }
+    const out = JSON.parse(text);
+    if (args.json)
+      console.log(JSON.stringify(out, null, 2));
+    else
+      for (const l of out.links)
+        process.stdout.write(`${l.email ? `${l.email}	` : ""}${CYAN}${l.url}${RESET}
+`);
+    return;
+  }
+  if (positionals[0] === "steering" || positionals[0] === "next") {
+    let projectId2 = args.project || cfgScope.data.default_project_id;
+    if (!projectId2) {
+      const projects2 = await api.listProjects();
+      projectId2 = projects2.find((p) => p.project?.isDefault)?.project?.id || projects2[0]?.project?.id;
+    }
+    if (!projectId2) {
+      process.stderr.write(`${RED}No project found \u2014 pass --project <id>${RESET}
+`);
+      process.exit(2);
+    }
+    const sctx = { apiUrl, apiKey, projectId: projectId2, json: !!args.json };
+    if (positionals[0] === "next") {
+      const res = await fetch(`${apiUrl}/api/v1/projects/${projectId2}/recommendations/generate`, {
+        method: "POST",
+        headers: { "content-type": "application/json", "x-api-key": apiKey },
+        body: JSON.stringify({ projectId: projectId2, ...args["business-context"] ? { businessContextId: args["business-context"] } : {} }),
+        signal: AbortSignal.timeout(30000)
+      });
+      const text = await res.text();
+      if (!res.ok) {
+        process.stderr.write(`${RED}Generate failed: ${res.status} ${text}${RESET}
+`);
+        process.exit(1);
+      }
+      const out = JSON.parse(text);
+      if (args.json)
+        console.log(JSON.stringify(out, null, 2));
+      else
+        process.stderr.write(`${GREEN}\u2705 Generating recommendations \u2014 analyzer todo ${out.todoId}${RESET}
+`);
+      return;
+    }
+    await steeringCommand(sctx, positionals.slice(1));
+    return;
+  }
   if (args["list-agents"]) {
     await listAgentsCommand(api, { json: !!args.json, formatPath: formatPathWithTilde });
     return;
   }
+  if (args["list-models"]) {
+    await listModelsCommand(api, { json: !!args.json, filter: positionals[0] });
+    return;
+  }
   if (positionals[0] === "agent") {
     await agentCommand(api, positionals, args, formatPathWithTilde);
     return;
@@ -46722,36 +46916,12 @@ Cancelled by user (Ctrl+C)
     if (!args["no-bridge"] && !args["no-watch"])
       ensureBridgeRunning(apiUrl, apiKey);
     const templateId = args.template;
-    const inputValues = {};
-    for (const kv of args.input || []) {
-      const eq = kv.indexOf("=");
-      if (eq > 0)
-        inputValues[kv.slice(0, eq)] = kv.slice(eq + 1);
-    }
-    const template = await api.getRegistryTemplate(templateId);
-    process.stderr.write(`${DIM}Template:${RESET} ${BRAND}${template.todoname}${RESET}
-`);
-    if (template.description)
-      process.stderr.write(`${DIM}${template.description}${RESET}
+    const spec = await api.getRegistrySpec(templateId);
+    process.stderr.write(`${DIM}Template:${RESET} ${BRAND}${spec.name}${RESET}
 `);
-    const templateInputs = template.inputs || [];
-    if (templateInputs.length && !args["non-interactive"]) {
-      for (const inp of templateInputs) {
-        const key = inp.label.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/_+$/, "");
-        if (inputValues[key])
-          continue;
-        const req = inp.required ? ` ${RED}*${RESET}` : "";
-        const hint = inp.placeholder ? ` ${DIM}(${inp.placeholder.split(`
-`)[0]})${RESET}` : "";
-        const val = await readLine(`${inp.label}${req}${hint}: `);
-        if (val)
-          inputValues[key] = val;
-      }
-    }
-    if (Object.keys(inputValues).length) {
-      process.stderr.write(`${DIM}Inputs:${RESET} ${JSON.stringify(inputValues)}
+    if (spec.description)
+      process.stderr.write(`${DIM}${spec.description}${RESET}
 `);
-    }
     const projects2 = await api.listProjects();
     let projectId2 = args.project;
     if (!projectId2) {
@@ -46762,12 +46932,14 @@ Cancelled by user (Ctrl+C)
 `);
       process.exit(1);
     }
-    const todo2 = await api.startFromTemplate(projectId2, templateId, { inputValues });
+    const todo2 = await api.startFromSpec(projectId2, templateId);
     const todoId = todo2.id;
     cfgScope.setLastTodoId(todoId);
     const frontendUrl2 = getFrontendUrl(apiUrl, projectId2, todoId);
     if (args.json) {
       console.log(JSON.stringify({ ...todo2, frontend_url: frontendUrl2 }, null, 2));
+    } else if (args["no-watch"]) {
+      console.log(`created ${todoId}`);
     } else {
       process.stderr.write(`${DIM}TODO:${RESET} ${CYAN}${frontendUrl2}${RESET}
 `);
@@ -46962,6 +47134,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   const frontendUrl = getFrontendUrl(apiUrl, projectId, actualTodoId);
   if (args.json) {
     console.log(JSON.stringify({ ...todo, frontend_url: frontendUrl }, null, 2));
+  } else if (!ws) {
+    console.log(`created ${actualTodoId}`);
   } else {
     process.stderr.write(`${DIM}TODO:${RESET} ${CYAN}${frontendUrl}${RESET}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "type": "module",
   "bin": {
     "todoforai-cli": "dist/todoai.js",