@todoforai/cli 0.1.48 → 0.1.50

package/dist/todoforai-cli.js

@@ -42905,8 +42905,8 @@ class ApiClient {
   removeVoiceSource(businessContextId, channel) {
     return this.request("POST", "/api/v1/business-context/remove-voice-source", { businessContextId, channel });
   }
-  refineBrandVoice(businessContextId, answers, source) {
-    return this.request("POST", "/api/v1/business-context/refine-brand-voice", { businessContextId, answers, ...source && { source } });
+  refineBrandVoice(businessContextId, answers, source, correction) {
+    return this.request("POST", "/api/v1/business-context/refine-brand-voice", { businessContextId, answers, ...source && { source }, ...correction && { correction } });
   }
   getProfile() {
     return this.request("GET", "/api/v1/users/profile");
@@ -43729,6 +43729,9 @@ var SERVER_TO_FRONTENDS = {
   hexGrid: {
     updated: (projectId) => `${"hexgrid:updated" /* HEXGRID_UPDATED */}:${projectId}`
   },
+  killSwitch: {
+    changed: (projectId) => `${"project:kill_switch" /* KILL_SWITCH */}:${projectId}`
+  },
   sandbox: {
     state: (userId) => `${"sandbox:state" /* SANDBOX_STATE */}:${userId}`
   },
@@ -44390,6 +44393,10 @@ var TOPICS = {
     channel: (p) => SERVER_TO_FRONTENDS.hexGrid.updated(p.projectId),
     audience: "frontend"
   },
+  ["project:kill_switch" /* KILL_SWITCH */]: {
+    channel: (p) => SERVER_TO_FRONTENDS.killSwitch.changed(p.projectId),
+    audience: "frontend"
+  },
   ["sandbox:state" /* SANDBOX_STATE */]: {
     channel: (p) => SERVER_TO_FRONTENDS.sandbox.state(p.userId),
     audience: "frontend"
@@ -44526,7 +44533,7 @@ import { parseArgs } from "util";
 // package.json
 var package_default = {
   name: "@todoforai/cli",
-  version: "0.1.48",
+  version: "0.1.50",
   type: "module",
   bin: {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -44568,45 +44575,35 @@ function getEnv(name) {
 }
 function printUsage() {
   process.stderr.write(`
-tfa-cli — TODOforAI CLI. Legacy aliases: todoforai-cli, todoai.
+tfa-cli — TODOforAI CLI
 
-Usage:
+Usage: tfa-cli [OPTIONS] ["prompt"]
+       tfa-cli [OPTIONS] <COMMAND> [ARGS]
+
+Examples:
   tfa-cli login                          # Browser-based device auth
-  tfa-cli "prompt text"                  # Prompt as argument
-  tfa-cli -n "Quick task"               # Non-interactive (run and exit)
-  echo "content" | tfa-cli              # Pipe from stdin
-  tfa-cli --path /my/project "Fix bug"  # Explicit workspace path
-  tfa-cli -c ["prompt"]                 # Resume last todo (optional prompt sent on attach)
-  tfa-cli --resume <todo-id> ["prompt"] # Resume specific todo (optional prompt sent on attach)
-  tfa-cli --inspect <todo-id>[@<slice>] # Read chat log. <slice> = -3:, :1, 5:10, 7  (Python-style)
-  tfa-cli start <id>                    # Start a TODO from the registry (todoregistry.com)
-  tfa-cli acp                           # Agent Client Protocol server on stdio (Zed, JetBrains, …; see README)
-  tfa-cli --list-agents                 # List available agents and exit
-  tfa-cli --list-models [filter]        # List models usable with --model and exit
-  tfa-cli agent update <agent> model=<model>    # Update agent settings (see 'agent --help'; also 'agent create')
-  tfa-cli todo set <todo-id|-> title=… group=… star=true   # Edit a todo's fields (see 'todo --help')
-  tfa-cli project set|settings|groups|default|agent …  # Edit the project, groups, defaults (see 'project --help')
-  tfa-cli brand list|create|select|voice …      # Brands (business contexts) + voice learning (see 'brand --help')
-  tfa-cli device list|rename|wallpaper …        # Paired machines (see 'device --help')
-  tfa-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated); see 'list --help'
-  tfa-cli status <todo-id> <STATUS>     # Update a todo's status (run 'status --help' for the full list)
+  tfa-cli "prompt text"                  # New todo
+  echo "content" | tfa-cli              # From stdin
+  tfa-cli start <id>                    # Registry template
+  tfa-cli acp                           # Agent Client Protocol (stdio)
+  tfa-cli agents                        # List agents
+  tfa-cli models [filter]               # Available models
+  tfa-cli agent list|get|update|create …        # Agents (update <agent> model=…)
+  tfa-cli todo set <todo-id|-> title=… group=… star=true   # Edit a todo's fields
+  tfa-cli project list|set|settings|groups|default|agent … # Projects; edit the current one
+  tfa-cli brand list|create|select|voice …      # Brands (business contexts) + voice learning
+  tfa-cli device list|rename|wallpaper …        # Paired machines
+  tfa-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated)
+  tfa-cli status <todo-id> <STATUS>     # Update a todo's status
   tfa-cli delete <todo-id>              # Permanently delete a todo
-  tfa-cli addmessage <todo-id> "text"  # Add a message to an existing todo
-  tfa-cli show <file|-> [todo-id]     # Show a file in the chat (rendered by mimetype; - reads stdin)
-                                            #   [--title T] [--alias A] [--mime M] [--card <name>] [--link] [--json]
-                                            #   --link = compact chip (name+size+download) instead of inline render
-                                            #   Prints "<todoId>:<alias|id>  <public url>". Re-showing with the same
-                                            #   --alias updates that block in place and pushes a new version to the
-                                            #   same url (older versions stay reachable at /<id>/<version>).
-  tfa-cli show rm <ref|alias>         # Take a shown file down (block, url, every version)
-  tfa-cli show list [todo-id]         # List show blocks (ref, title, mime/url, card)
-                                            #   [--project <id>] [--card <name>] [--json]
-                                            #   no todo-id + --project (or $TODOFORAI_PROJECT_ID) = every todo
-  tfa-cli open <url> [todo-id]        # Show a live http(s) url in the chat as a preview
-                                            #   [--title T] [--alias A] [--json]
-  tfa-cli recommend --template <id>    # Add a template as a recommendation card (see 'todoregistry-cli create')
-  tfa-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]  # Mint /claim/<token> ownership links for a project you own
-  tfa-cli next [--direction "<text>"]  # Ask the analyzer for growth recommendation cards (optional free-text steer)
+  tfa-cli addmessage <todo-id> "text"  # Send a message and exit (like -r, no watch/bridge)
+  tfa-cli show <file|-> [todo-id]     # Render a local file (image/pdf/html…) in the chat; - = stdin
+  tfa-cli show list|rm …              # List / take down shown files
+  tfa-cli open <url> [todo-id]        # Live url preview in the chat
+  tfa-cli recommend --template <id>    # Add a template as a recommendation card
+  tfa-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]  # Mint /claim/<token> links for a project you own
+  tfa-cli next [--direction "<text>"]  # Analyzer growth recommendation cards
+  tfa-cli <command> help                # Details per command
 
 Options:
   --path <dir>                    Workspace path (default: cwd)
@@ -44614,36 +44611,46 @@ Options:
   --agent, -a <name>              Agent name (partial match)
   --group <slug>                 Group new todo; omitted inherits TODOFORAI_GROUP_ID
   --group-name <name>            Display name for --group (last write wins)
-  --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
+  --model <model>                 Model for this todo only (see 'models')
+  --api-url <url>
+  --api-key <key>
   --user-id <id>                  Admin HTTP impersonation; requires --no-watch
-  --inspect, -i <todo-id>[@<slice>]     Print chat log (read-only)
-  --template, -t <id> ["prompt"] Start from a registry template (alias: start <id>); prompt overrides the template task
-  --resume, -r [todo-id]          Resume existing todo
-  --continue, -c                  Continue most recent todo
-  --non-interactive, -n           Run to completion and exit without interactive prompt
-  --dangerously-skip-permissions  Auto-approve all blocks (for CI/benchmarks)
-  --allow-all                     Set permissions to allow all tools (no approval needed)
+  --inspect, -i <todo-id>[@<slice>]  Read chat log; slices: -3:, :1, 5:10, 7
+  --template, -t <id> ["prompt"]   Same as start; prompt overrides template task
+  --resume, -r <todo-id> ["prompt"]  Resume; optional follow-up
+  --continue, -c ["prompt"]       Resume last; optional follow-up
+  --non-interactive, -n           Run to completion, then exit
+  --dangerously-skip-permissions  CLI auto-approves every block
+  --allow-all                     Agent permissions allow:*:* — nothing ever asks
   --raw-sysmsg <file>             Use file contents verbatim as system prompt (new TODO only)
   --no-watch                      Create todo and exit
-  --isolated                      Spawn an ephemeral, task-scoped bridge: the agent sees ONLY
-                                  this machine (workspace = --path/cwd); session dies with the CLI
+  --isolated                      Agent sees ONLY this machine + dir (no cloud VM/other devices); ends with CLI
   --no-bridge                     Do not auto-spawn bridge
-  --no-edge                       Deprecated alias for --no-bridge
-  --json                          Output as JSON
-  --detailed                      'inspect --json': keep ids, timestamps, agentSettingsId, scheduledTimestamp
-  --format-anthropic              'inspect --json': Anthropic-style shape (tool_result in next user msg); attachment sources are uri-typed, so not a 1:1 messages.create input
+  --json
+  --detailed | --format-anthropic  inspect --json: keep ids/timestamps | Anthropic messages shape
   --safe                          Validate API key upfront
-  --debug, -d                     Debug output
+  --debug, -d
   --debug-dump                    Attach LLM request debug info per turn (requires server grant)
-  --show-config                   Show config
-  --reset-config                  Reset config file
-  --version, -v                   Print version and exit
-  --help, -h                      Show this help
+  help | version | config         = -h | -v | --show-config   (--reset-config wipes it)
+`);
+}
+function printShowHelp() {
+  process.stderr.write(`
+tfa-cli show — put a file or url into the chat
+
+Usage:
+  tfa-cli show <file|-> [todo-id]     Render a file by mimetype (- reads stdin)
+                                      [--title T] [--alias A] [--mime M] [--card <name>] [--link] [--json]
+                                      --link: compact download chip instead of inline render
+                                      Prints "<todoId>:<alias|id>  <public url>". Re-showing with the same
+                                      --alias updates the block in place; old versions stay at /<id>/<version>
+  tfa-cli show rm <ref|alias>         Take it down (block, url, every version)
+  tfa-cli show list [todo-id]         List show blocks (ref, title, mime/url, card)
+                                      [--project <id>] [--card <name>] [--json]
+                                      no todo-id + --project (or $TODOFORAI_PROJECT_ID) = every todo
+  tfa-cli open <url> [todo-id]        Live http(s) url as a preview  [--title T] [--alias A] [--json]
+
+todo-id defaults to $TODOFORAI_TODO_ID (agent shell) or the last todo this CLI touched.
 `);
 }
 var STATUS_HELP = {
@@ -44667,6 +44674,14 @@ All valid statuses:
   ${Object.values(TodoStatus).join(", ")}
 `);
 }
+var WORD_FLAGS = {
+  help: "help",
+  version: "version",
+  models: "list-models",
+  agents: "list-agents",
+  config: "show-config"
+};
+var HELP_SUBCOMMANDS = ["agent", "todo", "project", "brand", "device", "list", "ls", "status", "show", "open"];
 function parseCliArgs() {
   const { values, positionals } = parseArgs({
     args: process.argv.slice(2),
@@ -44698,6 +44713,8 @@ function parseCliArgs() {
       url: { type: "string" },
       "pasted-file": { type: "string" },
       "from-company": { type: "boolean", default: false },
+      "dry-run": { type: "boolean", default: false },
+      max: { type: "string" },
       seed: { type: "string" },
       emails: { type: "string" },
       ttl: { type: "string" },
@@ -44728,6 +44745,15 @@ function parseCliArgs() {
   });
   if (values["no-edge"])
     values["no-bridge"] = true;
+  const asFlag = !values["list-models"] && !values["list-agents"] && !values["show-config"] ? WORD_FLAGS[positionals[0]] : undefined;
+  if (asFlag) {
+    values[asFlag] = true;
+    positionals.shift();
+  }
+  if (positionals[1] === "help" && HELP_SUBCOMMANDS.includes(positionals[0])) {
+    values.help = true;
+    positionals.splice(1, 1);
+  }
   return { values, positionals };
 }
 
@@ -47608,6 +47634,180 @@ var STATUS_HELP2 = {
   ["DELETED" /* DELETED */]: "Marked for deletion"
 };
 
+// src/voice-collect.ts
+import { execFileSync } from "node:child_process";
+var run = (bin, args) => execFileSync(bin, args, { encoding: "utf8", maxBuffer: 256 << 20, timeout: 60000, stdio: ["ignore", "pipe", "ignore"] });
+var installed = (bin) => {
+  try {
+    run("which", [bin]);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var MIN_CHARS = 30;
+var SEP = /^─{20,}$/m;
+function parseThread(out) {
+  return out.split(SEP).slice(1).map((chunk) => {
+    const lines = chunk.trim().split(`
+`);
+    let i = 0;
+    const h = {};
+    for (;i < lines.length && /^\s*(From|To|Date|Auth|Cc):/.test(lines[i]); i++) {
+      const [k, ...v] = lines[i].trim().split(":");
+      h[k] = v.join(":").trim();
+    }
+    return { from: h.From ?? "", date: h.Date ?? "", body: lines.slice(i).join(`
+`).trim() };
+  }).filter((m) => m.from);
+}
+function stripReply(body) {
+  const lines = body.split(`
+`);
+  const cut = lines.findIndex((l, i) => /^>/.test(l) || /^(On .{6,}wrote:|.{3,} ezt írta \(időpont:|Le .{6,} a écrit :|Am .{6,} schrieb .*:|-----Original Message-----|From: .*|________________________________)$/i.test(l.trim()) || /^(On .{6,}|.{3,} ezt írta)/.test(l.trim()) && i + 1 < lines.length && /^>|wrote:$|\):$/.test(lines[i + 1].trim()));
+  let kept = (cut >= 0 ? lines.slice(0, cut) : lines).filter((l) => !/^Attachments: /.test(l)).join(`
+`).trim();
+  kept = kept.replace(/\n--\s*\n[\s\S]*$/, "").trim();
+  return kept;
+}
+var gmail = {
+  tool: "zele",
+  check: () => {
+    if (!installed("zele"))
+      return "zele is not installed";
+    const who = (() => {
+      try {
+        return run("zele", ["whoami"]);
+      } catch {
+        return "";
+      }
+    })();
+    return /email:/.test(who) ? null : "zele is not signed in (run: zele login --method google)";
+  },
+  collect: (max) => {
+    const accounts = [...run("zele", ["whoami"]).matchAll(/email: (\S+)/g)].map((m) => m[1]);
+    const isMe = (from) => accounts.some((a) => from.toLowerCase().includes(a.toLowerCase()));
+    const samples = [];
+    for (const account of accounts) {
+      const list = run("zele", ["mail", "search", "from:me", "--limit", String(max), "--account", account]);
+      const ids = [...list.matchAll(/^  - id: ([0-9a-f]+)\n(?:.*\n)*?    messages: (\d+)/gm)].filter((m) => Number(m[2]) > 1).map((m) => m[1]);
+      for (const id of ids) {
+        if (samples.length >= max)
+          break;
+        const msgs = parseThread(run("zele", ["mail", "read", id, "--account", account]));
+        for (let i = 1;i < msgs.length && samples.length < max; i++) {
+          if (!isMe(msgs[i].from) || isMe(msgs[i - 1].from))
+            continue;
+          const text = stripReply(msgs[i].body), prompt = stripReply(msgs[i - 1].body);
+          if (text.length < MIN_CHARS || prompt.length < 20)
+            continue;
+          samples.push({ at: msgs[i].date, text, prompt, url: `gmail:${account}/${id}#${i}` });
+        }
+      }
+    }
+    return { samples, note: `${accounts.length} account(s)` };
+  }
+};
+var outlook = {
+  tool: "outlook-api",
+  check: () => {
+    if (!installed("outlook-api"))
+      return "outlook-api is not installed";
+    try {
+      const me = JSON.parse(run("outlook-api", ["whoami"]));
+      return me?.mail || me?.userPrincipalName ? null : "outlook-api is not signed in";
+    } catch {
+      return "outlook-api is not signed in (run: outlook-api auth)";
+    }
+  },
+  collect: (max) => {
+    const me = JSON.parse(run("outlook-api", ["whoami"]));
+    const mine = [me.mail, me.userPrincipalName].filter(Boolean).map((a) => a.toLowerCase());
+    const isMe = (m) => mine.includes((m.from?.emailAddress?.address ?? "").toLowerCase());
+    const sent = JSON.parse(run("outlook-api", ["list", "-f", "sentitems", "-n", String(max), "--select", "id,conversationId,from,sentDateTime,webLink"]));
+    const sentRows = Array.isArray(sent) ? sent : sent.value ?? [];
+    const samples = [];
+    const seenConv = new Set;
+    for (const s of sentRows) {
+      if (!s.conversationId || seenConv.has(s.conversationId))
+        continue;
+      seenConv.add(s.conversationId);
+      const conv = JSON.parse(run("outlook-api", ["get", `/me/messages?$filter=conversationId eq '${s.conversationId.replace(/'/g, "''")}'&$top=50&$select=id,from,receivedDateTime,sentDateTime,webLink`]));
+      const msgs = (conv.value ?? []).sort((a, b) => (a.receivedDateTime ?? "").localeCompare(b.receivedDateTime ?? ""));
+      const body = (id) => stripReply(JSON.parse(run("outlook-api", ["read", id, "--text"])).body?.content ?? "");
+      for (let i = 1;i < msgs.length && samples.length < max; i++) {
+        if (!isMe(msgs[i]) || isMe(msgs[i - 1]))
+          continue;
+        const text = body(msgs[i].id), prompt = body(msgs[i - 1].id);
+        if (text.length < MIN_CHARS || prompt.length < 20)
+          continue;
+        samples.push({ at: msgs[i].sentDateTime ?? msgs[i].receivedDateTime, text, prompt, url: msgs[i].webLink ?? `outlook:${msgs[i].id}` });
+      }
+      if (samples.length >= max)
+        break;
+    }
+    return { samples };
+  }
+};
+var QUERIES = "the we you ok this that fix why do how make add run test build post code file error need want should could now more less good bad new old first last".split(" ");
+var chat = {
+  tool: "tfa-memory",
+  check: () => installed("tfa-memory") ? null : "tfa-memory is not installed",
+  collect: (max) => {
+    const mem = (...a) => run("tfa-memory", a);
+    const anchors = new Map;
+    for (const q of QUERIES) {
+      for (const line of mem("search", q, "--source", "todo", "--mode", "lexical", "--limit", "50").split(`
+`)) {
+        const m = line.match(/todo\/([0-9a-f-]{36}):([0-9a-f-]{36})/);
+        if (m && !anchors.has(m[1]))
+          anchors.set(m[1], `todo/${m[1]}:${m[2]}`);
+      }
+      if (anchors.size >= max)
+        break;
+    }
+    const samples = [];
+    for (const anchor of [...anchors.values()].slice(0, max)) {
+      let msgs;
+      try {
+        msgs = JSON.parse(mem("around", anchor, "--before", "200", "--after", "200", "--json"));
+      } catch {
+        continue;
+      }
+      msgs.sort((a, b) => a.createdAt - b.createdAt);
+      for (let i = 1;i < msgs.length; i++) {
+        if (msgs[i].meta?.role !== "user" || msgs[i - 1].meta?.role === "user")
+          continue;
+        const text = msgs[i].content.trim(), prompt = msgs[i - 1].content.trim();
+        if (text.length < MIN_CHARS || prompt.length < 40)
+          continue;
+        if (/^\s*(#|\/|@|\{)/.test(text))
+          continue;
+        if (text.split(`
+`).length > 6)
+          continue;
+        if (/^Wait w_|\nWait w_[0-9a-f]+ '|^Connected \w+ \(card\)|^\[/m.test(text))
+          continue;
+        samples.push({ at: new Date(msgs[i].createdAt).toISOString(), text, prompt: prompt.slice(0, 4000), url: msgs[i].address });
+      }
+    }
+    return { samples: samples.slice(0, max), note: `${anchors.size} todos` };
+  }
+};
+var ADAPTERS = { Gmail: gmail, Outlook: outlook, Chat: chat };
+var DEVICE_CHANNELS = Object.keys(ADAPTERS);
+function checkChannel(channel) {
+  const a = ADAPTERS[channel];
+  return a ? a.check() : `${channel} is not read on the device (server-side: pass --url, or paste)`;
+}
+function collectChannel(channel, max = 40) {
+  const a = ADAPTERS[channel];
+  if (!a)
+    throw new Error(`No device adapter for ${channel}`);
+  const r = a.collect(Math.min(200, Math.max(1, Math.floor(Number(max) || 40))));
+  return { ...r, samples: r.samples.filter((x) => x.text.trim().length >= MIN_CHARS) };
+}
+
 // src/manage-command.ts
 function printTodoHelp() {
   process.stderr.write(`
@@ -47644,6 +47844,7 @@ tfa-cli project — edit the current project
 --project <id> or $TODOFORAI_PROJECT_ID selects the project.
 
 Usage:
+  tfa-cli project list                             Projects you can access (* = default)
   tfa-cli project set <field=value>…               name=… description=… brand=<businessContextId>
                                                     (isPublic refused from an agent shell)
   tfa-cli project default                          Make it the project you land on at /
@@ -47725,6 +47926,19 @@ async function projectCommand(api, positionals, args) {
     printProjectHelp();
     process.exit(0);
   }
+  if (sub === "list" || sub === "ls") {
+    const projects = await api.listProjects();
+    if (args.json) {
+      console.log(JSON.stringify(projects, null, 2));
+      return;
+    }
+    for (const p of projects) {
+      const pr = p.project ?? p;
+      process.stderr.write(`${pr.isDefault ? "*" : " "} ${pr.name ?? ""}  ${DIM}${pr.id}${RESET}
+`);
+    }
+    return;
+  }
   if (!projectId)
     fail("No project — pass --project <id> or set TODOFORAI_PROJECT_ID");
   if (sub === "set") {
@@ -47812,12 +48026,18 @@ Usage:
   tfa-cli brand select <brand|none>                Active brand for the account
   tfa-cli brand voice                              Learned profile + sources
   tfa-cli brand voice answers [<q>=<a>…]           Show / set the brand-voice answers (strings)
-  tfa-cli brand voice collect <channel> [--url U | --pasted-file <F|->]
-                                                   Add a writing sample source
-                                                   channels: X LinkedIn Facebook Instagram
-                                                             Gmail Outlook Slack Teams
+  tfa-cli brand voice collect <channel> [--url U | --pasted-file <F|-> | --max N]
+                                                   Add a writing sample source.
+                                                   On this device (signed-in CLI, reply pairs):
+                                                     Gmail (zele)  Outlook (outlook-api)  Chat (tfa-memory)
+                                                   Server-side (--url or paste):
+                                                     X LinkedIn Facebook Instagram Slack Teams
+                                                   --dry-run  print the samples as JSONL, store nothing
+  tfa-cli brand voice check [<channel>|--all]      Can this device read the channel? tool, login, sample count
   tfa-cli brand voice remove <channel>
   tfa-cli brand voice learn [--from-company]       Run the refinement loop, store the profile
+  tfa-cli brand voice correct "<what is off>"      Tell the learner what it got wrong; profile is updated
+                                                   in one pass and the correction is kept for every re-learn
 
 <brand> is an id or name (unique partial works). Voice subcommands use the
 selected brand unless --brand <id|name> is given (--pasted-file - reads stdin).
@@ -47896,8 +48116,61 @@ async function brandCommand(api, positionals, args) {
     return voiceCommand(api, rest, args);
   fail(`Unknown 'brand' subcommand: ${sub}`);
 }
+function dryCollect(channel, max) {
+  const reason = checkChannel(channel);
+  if (reason)
+    fail(`${channel}: ${reason}`);
+  const { samples, note } = collectChannel(channel, max);
+  for (const x of samples)
+    console.log(JSON.stringify(x));
+  process.stderr.write(`${DIM}${samples.length} samples${note ? ` · ${note}` : ""} (not stored)${RESET}
+`);
+}
+async function voiceDeviceCommand(rest, args) {
+  const [verb, ...vargs] = rest;
+  if (verb === "check") {
+    const channels3 = args.all || !vargs[0] ? DEVICE_CHANNELS : [vargs[0]];
+    let failed = 0;
+    const report = {};
+    for (const ch of channels3) {
+      const reason = checkChannel(ch);
+      if (reason) {
+        failed++;
+        report[ch] = { ok: false, reason };
+        continue;
+      }
+      try {
+        const r = collectChannel(ch, Number(args.max ?? 10));
+        const bad = r.samples.filter((x) => !x.text.trim() || ADAPTERS[ch] && !x.prompt).length;
+        const ok = r.samples.length > 0 && bad === 0;
+        if (!ok)
+          failed++;
+        report[ch] = { ok, samples: r.samples.length, ...r.note && { note: r.note }, ...bad ? { reason: `${bad} sample(s) without a prompt` } : r.samples.length ? {} : { reason: "no samples came back" } };
+      } catch (e) {
+        failed++;
+        report[ch] = { ok: false, reason: e.message };
+      }
+    }
+    if (args.json)
+      console.log(JSON.stringify(report, null, 2));
+    else
+      for (const [ch, r] of Object.entries(report))
+        process.stderr.write(`${r.ok ? GREEN + "✅" : RED + "❌"} ${ch}${RESET}  ${DIM}${r.ok ? `${r.samples} samples${r.note ? ` · ${r.note}` : ""}` : r.reason}${RESET}
+`);
+    process.exit(failed ? 1 : 0);
+  }
+  if (verb === "collect" && args["dry-run"]) {
+    if (!vargs[0])
+      fail("Usage: tfa-cli brand voice collect <channel> --dry-run [--max N]");
+    dryCollect(vargs[0], Number(args.max ?? 40));
+    return true;
+  }
+  return false;
+}
 async function voiceCommand(api, rest, args) {
   const [verb, ...vargs] = rest;
+  if (verb === "collect" && !vargs[0])
+    fail("Usage: tfa-cli brand voice collect <channel> [--url U | --pasted-file F|- | --max N] [--dry-run]");
   const onboarding = await api.getOnboarding();
   if (verb === "answers") {
     if (vargs.length) {
@@ -47946,13 +48219,26 @@ ${DIM}match ${profile.match}/100 · source ${profile.source}${RESET}
   }
   if (verb === "collect") {
     const channel = vargs[0];
-    if (!channel)
-      fail("Usage: tfa-cli brand voice collect <channel> [--url U | --pasted-file F|-]");
     let pasted;
     if (args["pasted-file"]) {
       const { readFileSync: readFileSync3 } = await import("node:fs");
       pasted = readFileSync3(args["pasted-file"] === "-" ? 0 : args["pasted-file"], "utf8");
     }
+    const onDevice = !pasted && !args.url && ADAPTERS[channel];
+    if (onDevice) {
+      const reason = checkChannel(channel);
+      if (reason)
+        fail(`${channel}: ${reason}`);
+      process.stderr.write(`${DIM}reading ${channel} on this device…${RESET}
+`);
+      const { samples, note } = collectChannel(channel, Number(args.max ?? 40));
+      if (!samples.length)
+        fail(`${channel}: nothing usable came back${note ? ` (${note})` : ""}`);
+      const { sources: sources2 } = await api.collectVoiceSource(brand.id, channel, { samples });
+      process.stderr.write(`${GREEN}✅ ${channel}: ${samples.length} reply pairs stored (${sources2.length} source(s))${RESET}
+`);
+      return;
+    }
     const { sources } = await api.collectVoiceSource(brand.id, channel, { url: args.url, pasted });
     process.stderr.write(`${GREEN}✅ ${channel} collected (${sources.length} source(s))${RESET}
 `);
@@ -47983,6 +48269,31 @@ ${DIM}match ${profile.match}/100 · source ${profile.source}${RESET}
     }
     process.stderr.write(`${GREEN}✅ voice learned (match ${res.match}/100, source ${res.source})${RESET}
 ${res.profile}
+`);
+    return;
+  }
+  if (verb === "correct") {
+    const text = vargs.join(" ").trim();
+    if (!text)
+      fail('Usage: tfa-cli brand voice correct "<what is off>"');
+    const stored = onboarding.voiceProfiles?.[brand.id];
+    if (!stored?.profile)
+      fail("No voice learned yet — 'tfa-cli brand voice learn' first");
+    process.stderr.write(`${DIM}applying correction…${RESET}
+`);
+    const res = await api.refineBrandVoice(brand.id, onboarding.styleAnswers ?? {}, undefined, text);
+    if (!res.profile)
+      fail("The correction pass returned nothing — try rewording it");
+    const { [brand.id]: _stale, ...styleAiAnswers } = onboarding.styleAiAnswers ?? {};
+    await api.patchOnboarding({ voiceProfiles: { ...onboarding.voiceProfiles ?? {}, [brand.id]: { ...res, updatedAt: Date.now() } }, styleAiAnswers });
+    if (args.json) {
+      console.log(JSON.stringify(res, null, 2));
+      return;
+    }
+    const last = res.iterations[res.iterations.length - 1];
+    process.stderr.write(`${GREEN}✅ voice corrected (match ${res.match}/100)${RESET}
+${res.profile}
+${DIM}sample: ${last?.sample ?? ""}${RESET}
 `);
     return;
   }
@@ -48255,10 +48566,10 @@ function probeBridge2(bin) {
 function hasBridge2() {
   if (probeBridge2(bridgeBin2))
     return true;
-  const installed = path3.join(INSTALL_PREFIX2, "todoforai-bridge");
-  if (!probeBridge2(installed))
+  const installed2 = path3.join(INSTALL_PREFIX2, "todoforai-bridge");
+  if (!probeBridge2(installed2))
     return false;
-  bridgeBin2 = installed;
+  bridgeBin2 = installed2;
   return true;
 }
 function installBridge2() {
@@ -67726,7 +68037,7 @@ function visit(schema, fnOrHandlers) {
     return h ? h(node2, rewritten) : node2;
   };
   const cache = new Map;
-  function run(s) {
+  function run2(s) {
     const cached2 = cache.get(s);
     if (cached2 === RESOLVING) {
       return new $ZodLazy({
@@ -67752,21 +68063,21 @@ function visit(schema, fnOrHandlers) {
         let changed = false;
         const newShape = {};
         for (const k of keys) {
-          const mapped = run(oldShape[k]);
+          const mapped = run2(oldShape[k]);
           if (mapped !== oldShape[k])
             changed = true;
           newShape[k] = mapped;
         }
         let newCatchall = def.catchall;
         if (def.catchall) {
-          newCatchall = run(def.catchall);
+          newCatchall = run2(def.catchall);
           if (newCatchall !== def.catchall)
             changed = true;
         }
         return changed ? clone(s, { ...def, shape: newShape, catchall: newCatchall }) : s;
       }
       case "array": {
-        const mapped = run(def.element);
+        const mapped = run2(def.element);
         return mapped === def.element ? s : clone(s, { ...def, element: mapped });
       }
       case "tuple": {
@@ -67774,14 +68085,14 @@ function visit(schema, fnOrHandlers) {
         let changed = false;
         const newItems = [];
         for (const item of oldItems) {
-          const mapped = run(item);
+          const mapped = run2(item);
           if (mapped !== item)
             changed = true;
           newItems.push(mapped);
         }
         let newRest = def.rest;
         if (def.rest) {
-          newRest = run(def.rest);
+          newRest = run2(def.rest);
           if (newRest !== def.rest)
             changed = true;
         }
@@ -67789,12 +68100,12 @@ function visit(schema, fnOrHandlers) {
       }
       case "record":
       case "map": {
-        const newKey = run(def.keyType);
-        const newVal = run(def.valueType);
+        const newKey = run2(def.keyType);
+        const newVal = run2(def.valueType);
         return newKey === def.keyType && newVal === def.valueType ? s : clone(s, { ...def, keyType: newKey, valueType: newVal });
       }
       case "set": {
-        const newVal = run(def.valueType);
+        const newVal = run2(def.valueType);
         return newVal === def.valueType ? s : clone(s, { ...def, valueType: newVal });
       }
       case "union": {
@@ -67802,7 +68113,7 @@ function visit(schema, fnOrHandlers) {
         let changed = false;
         const newOptions = [];
         for (const opt of oldOptions) {
-          const mapped = run(opt);
+          const mapped = run2(opt);
           if (mapped !== opt)
             changed = true;
           newOptions.push(mapped);
@@ -67810,8 +68121,8 @@ function visit(schema, fnOrHandlers) {
         return changed ? clone(s, { ...def, options: newOptions }) : s;
       }
       case "intersection": {
-        const newLeft = run(def.left);
-        const newRight = run(def.right);
+        const newLeft = run2(def.left);
+        const newRight = run2(def.right);
         return newLeft === def.left && newRight === def.right ? s : clone(s, { ...def, left: newLeft, right: newRight });
       }
       case "optional":
@@ -67823,23 +68134,23 @@ function visit(schema, fnOrHandlers) {
       case "nonoptional":
       case "promise":
       case "success": {
-        const newInner = run(def.innerType);
+        const newInner = run2(def.innerType);
         return newInner === def.innerType ? s : clone(s, { ...def, innerType: newInner });
       }
       case "pipe": {
-        const newIn = run(def.in);
-        const newOut = run(def.out);
+        const newIn = run2(def.in);
+        const newOut = run2(def.out);
         return newIn === def.in && newOut === def.out ? s : clone(s, { ...def, in: newIn, out: newOut });
       }
       case "function": {
-        const newInput = run(def.input);
-        const newOutput = run(def.output);
+        const newInput = run2(def.input);
+        const newOutput = run2(def.output);
         return newInput === def.input && newOutput === def.output ? s : clone(s, { ...def, input: newInput, output: newOutput });
       }
       case "lazy": {
         const original = def.getter;
         const { _cachedInner, ...rest } = def;
-        return clone(s, { ...rest, getter: () => run(original()) });
+        return clone(s, { ...rest, getter: () => run2(original()) });
       }
       case "template_literal":
       case "string":
@@ -67867,7 +68178,7 @@ function visit(schema, fnOrHandlers) {
       }
     }
   }
-  return run(schema);
+  return run2(schema);
 }
 
 // node_modules/zod/v4/classic/deep-partial.js
@@ -72552,6 +72863,16 @@ function formatPathWithTilde(path5) {
   const home = homedir3();
   return path5.startsWith(home) ? path5.replace(home, "~") : path5;
 }
+function promptArg(words) {
+  if (words.length === 0)
+    return;
+  if (words.length > 1 || !/\s/.test(words[0])) {
+    process.stderr.write(`${RED3}Error: "${words.join(" ")}" is not a subcommand, and a prompt must be ONE quoted argument, e.g. tfa-cli "fix the login bug" (or pipe it on stdin). Run tfa-cli --help for subcommands.${RESET2}
+`);
+    process.exit(2);
+  }
+  return words[0];
+}
 async function interactiveLoop(ws, api2, todoId, projectId, agent2, json2, autoApprove, cfg) {
   while (true) {
     try {
@@ -72653,6 +72974,10 @@ Cancelled by user (Ctrl+C)
     printStatusHelp();
     process.exit(0);
   }
+  if ((positionals[0] === "show" || positionals[0] === "open") && args.help) {
+    printShowHelp();
+    process.exit(0);
+  }
   if (positionals[0] === "agent" && args.help) {
     printAgentHelp();
     process.exit(0);
@@ -72724,6 +73049,8 @@ Cancelled by user (Ctrl+C)
       process.exit(2);
     }
   }
+  if (positionals[0] === "brand" && positionals[1] === "voice" && await voiceDeviceCommand(positionals.slice(2), args))
+    return;
   const deviceLogin = () => runDeviceLogin(apiUrl).catch((e) => {
     if (!(e instanceof DeviceLoginError))
       throw e;
@@ -73143,7 +73470,7 @@ Cancelled by user (Ctrl+C)
       process.exit(1);
     }
     const promptWords = positionals[0] === "start" ? positionals.slice(2) : positionals;
-    const content2 = promptWords.join(" ").trim();
+    const content2 = (promptArg(promptWords) ?? "").trim();
     const todo2 = await api2.startFromSpec(projectId2, templateId, {
       ...content2 ? { content: content2 } : {},
       ...groupTag ? { groupTag } : {},
@@ -73218,7 +73545,7 @@ Resumed: ${CYAN2}${getFrontendUrl(apiUrl, todoId)}${RESET2}
     const ws2 = new FrontendWebSocket(apiUrl, apiKey);
     await ws2.connect();
     const autoApprove = !!args["dangerously-skip-permissions"];
-    const followUp = positionals.length > 0 ? positionals.join(" ") : process.stdin.isTTY ? "" : await readStdin();
+    const followUp = promptArg(positionals) ?? (process.stdin.isTTY ? "" : await readStdin());
     if (followUp) {
       cfg.addToHistory(followUp);
       await api2.addMessage(projectId2, followUp, agent3, todoId);
@@ -73236,11 +73563,7 @@ Resumed: ${CYAN2}${getFrontendUrl(apiUrl, todoId)}${RESET2}
 `);
     process.exit(2);
   }
-  if (positionals.length === 1 && !/\s/.test(positionals[0])) {
-    process.stderr.write(`${RED3}Error: "${positionals[0]}" is not a subcommand, and a prompt needs more than one word (or pipe it on stdin).${RESET2}
-`);
-    process.exit(2);
-  }
+  const argPrompt = promptArg(positionals);
   const ws = args["no-watch"] ? null : new FrontendWebSocket(apiUrl, apiKey);
   const wsReady = ws ? ws.connect() : null;
   const bridgeReady = !args["no-bridge"] && !args["no-watch"] && !args.isolated ? ensureBridgeRunning2(apiUrl, apiKey) : null;
@@ -73300,12 +73623,7 @@ Resumed: ${CYAN2}${getFrontendUrl(apiUrl, todoId)}${RESET2}
   }
   process.stderr.write(`${DIM2}Tip: ${randomTip()}${RESET2}
 `);
-  let content;
-  if (positionals.length > 0) {
-    content = positionals.join(" ");
-  } else {
-    content = await readStdin();
-  }
+  const content = argPrompt ?? await readStdin();
   const envProjectId = getEnv("PROJECT_ID");
   const hasProject = args.project || envProjectId || cfgScope.data.default_project_id;
   const storedAgent = cfgScope.data.default_agent_settings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.48",
+  "version": "0.1.50",
   "type": "module",
   "bin": {
     "todoforai-cli": "bin/todoforai-cli.js",