@todoforai/cli 0.1.27 → 0.1.29

package/bin/todoforai-cli.js

@@ -5,5 +5,5 @@ import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 
 const src = fileURLToPath(new URL("../src/index.ts", import.meta.url));
-const dist = fileURLToPath(new URL("../dist/todoai.js", import.meta.url));
+const dist = fileURLToPath(new URL("../dist/todoforai-cli.js", import.meta.url));
 await import(existsSync(src) ? src : dist);

package/dist/{todoai.js → todoforai-cli.js}

@@ -41771,9 +41771,9 @@ var require_route = __commonJS((exports, module) => {
   var conversions = require_conversions();
   function buildGraph() {
     const graph = {};
-    const models = Object.keys(conversions);
-    for (let len = models.length, i = 0;i < len; i++) {
-      graph[models[i]] = {
+    const models2 = Object.keys(conversions);
+    for (let len = models2.length, i = 0;i < len; i++) {
+      graph[models2[i]] = {
         distance: -1,
         parent: null
       };
@@ -41805,23 +41805,23 @@ var require_route = __commonJS((exports, module) => {
     };
   }
   function wrapConversion(toModel, graph) {
-    const path4 = [graph[toModel].parent, toModel];
+    const path3 = [graph[toModel].parent, toModel];
     let fn = conversions[graph[toModel].parent][toModel];
     let cur = graph[toModel].parent;
     while (graph[cur].parent) {
-      path4.unshift(graph[cur].parent);
+      path3.unshift(graph[cur].parent);
       fn = link(conversions[graph[cur].parent][cur], fn);
       cur = graph[cur].parent;
     }
-    fn.conversion = path4;
+    fn.conversion = path3;
     return fn;
   }
   module.exports = function(fromModel) {
     const graph = deriveBFS(fromModel);
     const conversion = {};
-    const models = Object.keys(graph);
-    for (let len = models.length, i = 0;i < len; i++) {
-      const toModel = models[i];
+    const models2 = Object.keys(graph);
+    for (let len = models2.length, i = 0;i < len; i++) {
+      const toModel = models2[i];
       const node = graph[toModel];
       if (node.parent === null) {
         continue;
@@ -41837,7 +41837,7 @@ var require_color_convert = __commonJS((exports, module) => {
   var conversions = require_conversions();
   var route = require_route();
   var convert = {};
-  var models = Object.keys(conversions);
+  var models2 = Object.keys(conversions);
   function wrapRaw(fn) {
     const wrappedFn = function(...args) {
       const arg0 = args[0];
@@ -41876,7 +41876,7 @@ var require_color_convert = __commonJS((exports, module) => {
     }
     return wrappedFn;
   }
-  models.forEach((fromModel) => {
+  models2.forEach((fromModel) => {
     convert[fromModel] = {};
     Object.defineProperty(convert[fromModel], "channels", { value: conversions[fromModel].channels });
     Object.defineProperty(convert[fromModel], "labels", { value: conversions[fromModel].labels });
@@ -42039,7 +42039,7 @@ var require_has_flag = __commonJS((exports, module) => {
 
 // node_modules/supports-color/index.js
 var require_supports_color = __commonJS((exports, module) => {
-  var os4 = __require("os");
+  var os3 = __require("os");
   var tty = __require("tty");
   var hasFlag = require_has_flag();
   var { env } = process;
@@ -42087,7 +42087,7 @@ var require_supports_color = __commonJS((exports, module) => {
       return min;
     }
     if (process.platform === "win32") {
-      const osRelease = os4.release().split(".");
+      const osRelease = os3.release().split(".");
       if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
         return Number(osRelease[2]) >= 14931 ? 3 : 2;
       }
@@ -42665,7 +42665,7 @@ import { realpathSync, readFileSync as readFileSync3 } from "fs";
 import { resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
 import { homedir as homedir3 } from "os";
-import path4 from "path";
+import path3 from "path";
 
 // node_modules/@todoforai/update-notifier/src/index.ts
 import fs from "fs";
@@ -42731,7 +42731,7 @@ function randomTip() {
   return TIPS[Math.floor(Math.random() * TIPS.length)];
 }
 
-// ../edge/bun/src/api.ts
+// ../packages/shared-api/src/api.ts
 function restBasePath(apiKey) {
   return apiKey.startsWith("dst_") ? "/dst/v1" : "/api/v1";
 }
@@ -42812,8 +42812,8 @@ class ApiClient {
   deleteProject(projectId) {
     return this.request("DELETE", `/api/v1/projects/${projectId}`);
   }
-  createTodo(projectId, content, agentSettings) {
-    return this.request("POST", `/api/v1/projects/${projectId}/todos`, { content, agentSettings });
+  createTodo(projectId, content, agentSettings, groupTag, groupName) {
+    return this.request("POST", `/api/v1/projects/${projectId}/todos`, { content, agentSettings, groupTag, groupName });
   }
   listTodos(projectId, opts) {
     if (!projectId)
@@ -42851,12 +42851,16 @@ class ApiClient {
   getAgentSettings(id) {
     return this.request("GET", `/api/v1/agents/${id}`);
   }
-  addMessage(projectId, content, agentSettings, todoId, attachments, scheduledTimestamp) {
+  addMessage(projectId, content, agentSettings, todoId, attachments, scheduledTimestamp, groupTag, groupName) {
     const payload = { content, agentSettings, attachments: attachments || [] };
     if (todoId)
       payload.todoId = todoId;
     if (scheduledTimestamp)
       payload.scheduledTimestamp = scheduledTimestamp;
+    if (!todoId && groupTag)
+      payload.groupTag = groupTag;
+    if (!todoId && groupName)
+      payload.groupName = groupName;
     return this.request("POST", `/api/v1/projects/${projectId}/todos`, payload);
   }
   async showFile(todoId, file, filename, opts = {}) {
@@ -42889,6 +42893,65 @@ class ApiClient {
       throw new Error(`API POST /resources/open failed: ${res.status} ${await res.text()}`);
     return res.json();
   }
+  async listShows(opts = {}) {
+    const qs = new URLSearchParams;
+    if (opts.todoId)
+      qs.set("todoId", opts.todoId);
+    if (opts.projectId)
+      qs.set("projectId", opts.projectId);
+    if (opts.card)
+      qs.set("card", opts.card);
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/show?${qs}`;
+    const res = await fetch(url, { headers: { "x-api-key": this.apiKey }, signal: AbortSignal.timeout(30000) });
+    if (!res.ok)
+      throw new Error(`API GET /resources/show failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  async upsertCard(projectId, name, html, opts = {}) {
+    const form = new FormData;
+    form.append("file", html, `${name}.html`);
+    for (const [k, v] of Object.entries(opts))
+      if (v)
+        form.append(k, v);
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/cards/${projectId}/${name}`;
+    const res = await fetch(url, {
+      method: "PUT",
+      headers: { "x-api-key": this.apiKey },
+      body: form,
+      signal: AbortSignal.timeout(60000)
+    });
+    if (!res.ok)
+      throw new Error(`API PUT cards failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  async listCards(projectId) {
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/cards/${projectId}`;
+    const res = await fetch(url, { headers: { "x-api-key": this.apiKey }, signal: AbortSignal.timeout(30000) });
+    if (!res.ok)
+      throw new Error(`API GET cards failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  async getCard(projectId, name) {
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/cards/${projectId}/${name}`;
+    const res = await fetch(url, { headers: { "x-api-key": this.apiKey }, signal: AbortSignal.timeout(30000) });
+    if (!res.ok)
+      throw new Error(`API GET card failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  async getCardBody(projectId, name) {
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/cards/${projectId}/${name}?body=1`;
+    const res = await fetch(url, { headers: { "x-api-key": this.apiKey }, signal: AbortSignal.timeout(30000) });
+    if (!res.ok)
+      throw new Error(`API GET card body failed: ${res.status} ${await res.text()}`);
+    return res.text();
+  }
+  async deleteCard(projectId, name) {
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/cards/${projectId}/${name}`;
+    const res = await fetch(url, { method: "DELETE", headers: { "x-api-key": this.apiKey }, signal: AbortSignal.timeout(30000) });
+    if (!res.ok)
+      throw new Error(`API DELETE card failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
   patchEdgeConfig(edgeId, updates) {
     return this.request("PATCH", `/api/v1/edges/${edgeId}`, { updates });
   }
@@ -42898,6 +42961,9 @@ class ApiClient {
   updateAgentSettings(agentId, agentSettingsId, updates) {
     return this.request("PUT", `/api/v1/agents/${agentId}/settings`, { agentSettingsId, updates });
   }
+  deleteAgentSettings(agentSettingsId) {
+    return this.request("DELETE", `/api/v1/agents/${agentSettingsId}`);
+  }
   getGlobalAgentSettings() {
     return this.request("GET", "/api/v1/agents/global");
   }
@@ -42933,11 +42999,11 @@ class ApiClient {
       throw new Error(`Spec '${specId}' not found (${res.status})`);
     return res.json();
   }
-  async initDeviceLogin(clientName = "edge") {
+  async initDeviceLogin(clientName = "edge", opts = {}) {
     const res = await fetch(`${this.apiUrl}/api/v1/cli/login/init`, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({ clientName })
+      body: JSON.stringify({ clientName, ...opts })
     });
     if (!res.ok)
       throw new Error(`Device login init failed: ${res.status}`);
@@ -42957,35 +43023,50 @@ class ApiClient {
     return res.json();
   }
 }
-
-// ../edge/bun/src/frontend-ws.ts
+// ../packages/shared-api/src/frontend-ws.ts
 import WebSocket from "ws";
 
-// ../edge/bun/src/config.ts
-import path2 from "path";
-import os2 from "os";
+// ../packages/shared-credentials/src/index.ts
+import { readFileSync, writeFileSync, mkdirSync, chmodSync } from "fs";
+import { join, dirname } from "path";
+import { homedir, platform } from "os";
 function normalizeApiUrl(url) {
   if (url.startsWith("localhost"))
     return `http://${url}`;
   if (!url.startsWith("http://") && !url.startsWith("https://"))
     return `https://${url}`;
-  return url;
+  return url.replace(/\/+$/, "");
 }
-var SUBCOMMANDS = new Set(["login", "logout", "update"]);
 function credentialsPath() {
-  const sys = os2.platform();
-  if (sys === "win32") {
-    return path2.join(os2.homedir(), "AppData", "Roaming", "todoforai", "credentials.json");
-  }
-  if (sys === "darwin") {
-    return path2.join(os2.homedir(), "Library", "Application Support", "todoforai", "credentials.json");
+  return platform() === "win32" ? join(homedir(), "AppData", "Roaming", "todoforai", "credentials.json") : platform() === "darwin" ? join(homedir(), "Library", "Application Support", "todoforai", "credentials.json") : join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "todoforai", "credentials.json");
+}
+function read() {
+  try {
+    return JSON.parse(readFileSync(credentialsPath(), "utf-8"));
+  } catch {
+    return {};
   }
-  const xdg = process.env.XDG_CONFIG_HOME || path2.join(os2.homedir(), ".config");
-  return path2.join(xdg, "todoforai", "credentials.json");
 }
-var CREDENTIALS_PATH = credentialsPath();
+function writeSecure(data) {
+  const p = credentialsPath();
+  mkdirSync(dirname(p), { recursive: true });
+  writeFileSync(p, JSON.stringify(data, null, 2), { encoding: "utf-8", mode: 384 });
+  try {
+    chmodSync(p, 384);
+  } catch {}
+}
+function readCredential(apiUrl) {
+  const c = read();
+  const v = c[apiUrl] || c.apiToken || c.apiKey;
+  return typeof v === "string" ? v : "";
+}
+function writeCredential(apiUrl, apiKey) {
+  const c = read();
+  c[apiUrl] = apiKey;
+  writeSecure(c);
+}
 
-// ../edge/bun/src/frontend-ws.ts
+// ../packages/shared-api/src/frontend-ws.ts
 var log = (level, ...args) => console.log(`[frontend-ws:${level}]`, ...args);
 
 class FrontendWebSocket {
@@ -43174,51 +43255,11 @@ class FrontendWebSocket {
     });
   }
 }
-
-// src/args.ts
-import { parseArgs } from "util";
-// package.json
-var package_default = {
-  name: "@todoforai/cli",
-  version: "0.1.27",
-  type: "module",
-  bin: {
-    "todoforai-cli": "bin/todoforai-cli.js",
-    todoai: "bin/todoforai-cli.js"
-  },
-  files: [
-    "bin",
-    "dist/todoai.js"
-  ],
-  scripts: {
-    build: "bun build src/index.ts --target=bun --outfile dist/todoai.js --external ws",
-    prepublishOnly: "bun run build",
-    start: "bun run src/index.ts",
-    dev: "bun run src/index.ts"
-  },
-  dependencies: {
-    "@shared/credentials": "file:../packages/shared-credentials",
-    "@todoforai/update-notifier": "^0.1.0",
-    "cli-highlight": "^2.1.11",
-    "diff-match-patch": "^1.0.5",
-    ws: "^8.18.0"
-  },
-  peerDependencies: {
-    "@todoforai/edge": ">=0.12.0"
-  },
-  peerDependenciesMeta: {
-    "@todoforai/edge": {
-      optional: true
-    }
-  },
-  devDependencies: {
-    "@types/ws": "^8.5.13",
-    typescript: "^5.7.0"
-  }
-};
 // ../packages/shared-fbe/src/enums.ts
 var TodoStatus;
 ((TodoStatus2) => {
+  TodoStatus2["PROPOSED"] = "PROPOSED";
+  TodoStatus2["DISMISSED"] = "DISMISSED";
   TodoStatus2["TODO"] = "TODO";
   TodoStatus2["SCHEDULED"] = "SCHEDULED";
   TodoStatus2["PAUSED"] = "PAUSED";
@@ -43238,6 +43279,59 @@ var TodoStatus;
   TodoStatus2["ARCHIVED"] = "ARCHIVED";
   TodoStatus2["DELETED"] = "DELETED";
 })(TodoStatus ||= {});
+// ../packages/shared-fbe/src/models.ts
+var DEFAULT_MODEL = "anthropic:anthropic/claude-sonnet-5";
+var MODEL_ALIASES = {
+  claude: DEFAULT_MODEL
+};
+var PROVIDER_BY_AUTHOR = {
+  anthropic: "anthropic",
+  openai: "openai",
+  deepseek: "deepseek",
+  poolside: "poolside",
+  "x-ai": "xai",
+  "z-ai": "z.ai",
+  google: "google-ai-studio",
+  moonshotai: "opencode_go"
+};
+function isQualifiedModel(model) {
+  const id = model.trim();
+  const colon = id.indexOf(":");
+  const slash = id.indexOf("/");
+  return colon > 0 && colon < id.length - 1 && (slash === -1 || colon < slash);
+}
+function qualifyModel(model) {
+  const id = model?.trim();
+  if (!id)
+    return { model: DEFAULT_MODEL };
+  if (isQualifiedModel(id))
+    return { model: id };
+  const suffix = id.match(/\([^)]+\)$/)?.[0] ?? "";
+  const bare = suffix ? id.slice(0, -suffix.length) : id;
+  const aliased = MODEL_ALIASES[bare.toLowerCase()];
+  if (aliased)
+    return { model: aliased + suffix };
+  const lower = bare.toLowerCase();
+  const provider = PROVIDER_BY_AUTHOR[lower.split("/")[0]];
+  if (provider && lower.includes("/"))
+    return { model: `${provider}:${lower}${suffix}` };
+  return { model: DEFAULT_MODEL, fallback: id };
+}
+function qualifiedModelIds(listing, filter) {
+  const q = filter?.toLowerCase();
+  const ids = [];
+  for (const m of listing?.data ?? []) {
+    const id = String(m.id);
+    if (m.provider) {
+      ids.push(`${m.provider.toLowerCase()}:${id}`);
+      continue;
+    }
+    const r = qualifyModel(id);
+    if (!r.fallback)
+      ids.push(r.model);
+  }
+  return q ? ids.filter((id) => id.toLowerCase().includes(q)) : ids;
+}
 // ../packages/shared-fbe/src/billing.ts
 var USAGE_WINDOWS = {
   SESSION_MS: 5 * 60 * 60 * 1000,
@@ -43288,7 +43382,7 @@ var mimetypes_default = {
     gif: { mime: "image/gif", type: "image" },
     webp: { mime: "image/webp", type: "image" },
     bmp: { mime: "image/bmp", type: "image" },
-    svg: { mime: "image/svg+xml", type: "text" },
+    svg: { mime: "image/svg+xml", type: "image" },
     heic: { mime: "image/heic", type: "image", conversionProfile: "to_jpeg_90" },
     heif: { mime: "image/heif", type: "image", conversionProfile: "to_jpeg_90" },
     mp3: { mime: "audio/mpeg", type: "audio" },
@@ -43446,9 +43540,6 @@ var SERVER_TO_FRONTENDS = {
   hexGrid: {
     updated: (projectId) => `${"hexgrid:updated" /* HEXGRID_UPDATED */}:${projectId}`
   },
-  placement: {
-    updated: (projectId) => `${"placement:updated" /* PLACEMENT_UPDATED */}:${projectId}`
-  },
   sandbox: {
     state: (userId) => `${"sandbox:state" /* SANDBOX_STATE */}:${userId}`
   },
@@ -43496,7 +43587,7 @@ var SERVER_TO_FRONTENDS = {
     predicted_reply_updated: (todoId) => `${"predict:reply_updated" /* PREDICTED_REPLY_UPDATED */}:${todoId}`,
     error_result: (todoId) => `${"block:error_result" /* BLOCK_ERROR_RESULT */}:${todoId}`,
     meta_result: (todoId) => `${"block:meta_result" /* BLOCK_META_RESULT */}:${todoId}`,
-    file_changed: (edgeId, path3) => `${"block:file_changed" /* BLOCK_FILE_CHANGED */}:${edgeId}:${path3}`,
+    file_changed: (edgeId, path2) => `${"block:file_changed" /* BLOCK_FILE_CHANGED */}:${edgeId}:${path2}`,
     notify: (todoId) => `${"NOTIFY" /* NOTIFY */}:${todoId}`
   },
   notify: {
@@ -43744,13 +43835,10 @@ function getBlockServerPrefix(block) {
   const prefixMatch = agentPattern.match(/^(.*?:)BASH(?:\(|$)/);
   return prefixMatch ? prefixMatch[1] : "";
 }
-var BASH_LIKE_BLOCK_TYPES = new Set(["bash", "machine_exec"]);
 function getBlockPatterns(block) {
   if (Array.isArray(block.generalized_pattern))
     return block.generalized_pattern;
-  const agentPattern = typeof block.generalized_pattern === "string" ? block.generalized_pattern : "";
-  const isBashLike = BASH_LIKE_BLOCK_TYPES.has(block.type.toLowerCase()) || /:BASH(\(|$)/.test(agentPattern);
-  if (isBashLike && block.cmd) {
+  if (block.type.toLowerCase() === "bash" && block.cmd) {
     const prefix = getBlockServerPrefix(block);
     return generalizeBashCmd(block.cmd).map((p) => prefix + p);
   }
@@ -43848,8 +43936,7 @@ function getBlockNewPatterns(block, permissions) {
   if (Array.isArray(block.generalized_pattern)) {
     return getNewPatterns(block.generalized_pattern, permissions);
   }
-  const agentPattern = typeof block.generalized_pattern === "string" ? block.generalized_pattern : "";
-  const isBash = (block.type.toLowerCase() === "bash" || agentPattern.includes(":BASH(")) && !!block.cmd;
+  const isBash = block.type.toLowerCase() === "bash" && !!block.cmd;
   if (!isBash) {
     return getBlockPatterns(block).filter((p) => !isPatternAllowed(permissions, p));
   }
@@ -43910,7 +43997,7 @@ Rules for the Presence block:
 - \`score\` is an integer 0-100, or \`null\` when you checked but found no presence. Base scores on real findings, not guesses. Include every channel you actually checked.
 - Keep it consistent with the prose Online Presence section \u2014 the JSON is the structured mirror of those findings.
 
-Growth recommendations are NOT part of this block \u2014 they live in the project's Recommendations column as placement cards (see "Recommending actionable TODOs" below). After any analysis that surfaces growth opportunities, materialize your top recommendations as cards there; the prose Next Steps section stays human-readable advice.
+Growth recommendations are NOT part of this block \u2014 they live on the project board as proposed todos (\u2727 rows on their group cards; see "Recommending actionable TODOs" below). After any analysis that surfaces growth opportunities, materialize your top recommendations as proposals there; the prose Next Steps section stays human-readable advice.
 
 Document order for the saved brand page: human-readable sections first, then the **Next Steps** section, then Open Questions (if any), and finally exactly one \`growth-plan\` block as the very last element. (Your chat reply can still end with a short spoken summary; only the saved markdown must end with the machine block.)
 
@@ -43922,8 +44009,14 @@ In follow-up conversations, act as an ongoing advisor: answer growth and digital
 
 When the user asks you to recommend how to grow (e.g. "recommend growth TODOs", the brand page's guided suggestion, the board's Recommend button), read the current business context (including the presence block), research only where information is missing or stale, refresh the presence block if findings changed, then materialize your top growth actions as recommendation cards (see below). The cards ARE the growth plan \u2014 do not write a separate recommendations list into the markdown.
 
+Strategic workstreams (board groups):
+The project board is organized into group cards, and each group should be a strategic workstream for THIS company \u2014 a front the business is (or should be) pushing on, e.g. "SEO & Content", "Outbound to agencies", "Community on Reddit", "Retention & Email". Your recommendation-generation prompt includes the board's existing groups as JSON (\`slug\`, \`name\`, and \`description\` when set \u2014 the description states the workstream's strategic intent). Treat them as the company's current strategic map:
+- FIRST fit each recommendation into an existing group when it genuinely advances that workstream \u2014 pass its slug as the \`group\` parameter of \`api_recommend_template\`. Match on strategy (read the descriptions), not keywords.
+- When your analysis surfaces a strategic direction the board doesn't cover yet, introduce it: pass a new short kebab-case \`group\` slug plus a human \`groupName\` (2-4 words, strategy-level \u2014 "Partner Channel", not "Misc" or "Growth") and a one-sentence \`groupDescription\` stating the strategic bet and its target outcome for THIS company (e.g. "Win comparison searches against Zapier and n8n to capture switchers"). The group is created with the card.
+- Keep the map tight: 3-7 workstreams total is healthy. Never invent a new group when an existing one fits, never create catch-all groups, and never mirror priority or channel-lists as groups \u2014 a group is a strategic bet, its cards are the moves.
+
 Recommending actionable TODOs from your recommendations:
-To materialize growth recommendations, create recommendation cards in the project's Recommendations column. You NEVER create running todos \u2014 you only recommend templates by reference. Two tools, strict roles:
+To materialize growth recommendations, propose todos on the project board. A proposal is a real todo in PROPOSED state \u2014 it sits as a \u2727 row on its group card until the user starts (accepts) or dismisses it. You NEVER create running todos \u2014 you only propose. Two tools, strict roles:
 
 1. GET A TEMPLATE (api_create_template) \u2014 generate-first, reuse only on a close fit:
    - Default: CREATE a template tailored to THIS business with the \`api_create_template\` tool. It returns the new template id.
@@ -43936,12 +44029,12 @@ To materialize growth recommendations, create recommendation cards in the projec
    - Then the request, using these exact standalone heading lines (letters only, each on its own line, ending with a colon): \`Your task:\`, \`Steps:\`, \`Data needed:\`. Everything under these headings becomes the first user turn.
    - Headings must match exactly (e.g. \`Your task:\`, not \`Your task (SEO):\`) or the split breaks. Put the business-specific detail in the body text under each heading, never in the heading itself.
 
-2. RECOMMEND (api_recommend_template \u2014 references a template id onto the project; never creates a running todo):
-   Call \`api_recommend_template\` with the template id, a one-line \`note\` (the WHY for THIS business \u2014 it becomes the card's tooltip) and a \`priority\` of high, medium or low. Project and business context default to the current session, so pass them only when targeting a different one. The card appears in the Recommendations column for the user to review before any credits are spent.
+2. RECOMMEND (api_recommend_template \u2014 proposes the template as a PROPOSED todo on the project; never creates a running todo):
+   Call \`api_recommend_template\` with the template id, a one-line \`note\` (the WHY for THIS business \u2014 it becomes the proposal's tooltip), a \`priority\` of high, medium or low, and the \`group\` slug of the strategic workstream it belongs to (see "Strategic workstreams" above \u2014 reuse an existing slug when one fits; a new slug + \`groupName\` creates the workstream). Project and business context default to the current session, so pass them only when targeting a different one. The proposal appears as a \u2727 row on that group's board card for the user to review before any credits are spent. Re-proposing the same template refreshes the open proposal instead of duplicating it; dismissed proposals since your last run are fed back to you \u2014 don't re-propose those, steer elsewhere.
 
    Both tools run in-process and need no machine or shell \u2014 never shell out to \`todoregistry-cli\` / \`todoforai-cli\` for this.
 
-3. Recommend 3-6 cards (highest priority first). Then reply with a one-line summary per card and tell the user they're waiting in the Recommendations column for review.`,
+3. Propose 3-6 todos (highest priority first). Then reply with a one-line summary per proposal grouped by workstream, and tell the user they're waiting on the board for review.`,
   mcpConfigs: {},
   edgesMcpConfigs: {},
   permissions: {
@@ -43985,6 +44078,9 @@ var OUTPUT_POLICIES = {
   full: { firstLimit: Infinity, lastLimit: 0, hardCap: RUN_OUTPUT_CAP, lineLimit: MAX_LINE_LEN },
   raw: { firstLimit: Infinity, lastLimit: 0, hardCap: Infinity, lineLimit: Infinity }
 };
+// ../packages/shared-fbe/src/toolInstallCommand.ts
+var PYTHON_MIN_MINOR = 10;
+var PYTHON_VERSION_CHECK = `-c 'import sys; sys.exit(0 if sys.version_info[:2] >= (3, ${PYTHON_MIN_MINOR}) else 1)'`;
 // ../packages/shared-fbe/src/realtime/topics.ts
 var TOPICS = {
   ["todo:new" /* NEW_TODO */]: {
@@ -44023,10 +44119,6 @@ var TOPICS = {
     channel: (p) => SERVER_TO_FRONTENDS.hexGrid.updated(p.projectId),
     audience: "frontend"
   },
-  ["placement:updated" /* PLACEMENT_UPDATED */]: {
-    channel: (p) => SERVER_TO_FRONTENDS.placement.updated(p.projectId),
-    audience: "frontend"
-  },
   ["sandbox:state" /* SANDBOX_STATE */]: {
     channel: (p) => SERVER_TO_FRONTENDS.sandbox.state(p.userId),
     audience: "frontend"
@@ -44124,15 +44216,51 @@ var TOPICS = {
     audience: "frontend"
   }
 };
+// src/args.ts
+import { parseArgs } from "util";
+// package.json
+var package_default = {
+  name: "@todoforai/cli",
+  version: "0.1.29",
+  type: "module",
+  bin: {
+    "todoforai-cli": "bin/todoforai-cli.js",
+    "tfa-cli": "bin/todoforai-cli.js",
+    todoai: "bin/todoforai-cli.js"
+  },
+  files: [
+    "bin",
+    "dist/todoforai-cli.js"
+  ],
+  scripts: {
+    build: "bun build src/index.ts --target=bun --outfile dist/todoforai-cli.js --external ws",
+    prepublishOnly: "bun run build",
+    start: "bun run src/index.ts",
+    dev: "bun run src/index.ts"
+  },
+  dependencies: {
+    "@shared/api": "file:../packages/shared-api",
+    "@shared/credentials": "file:../packages/shared-credentials",
+    "@todoforai/update-notifier": "^0.1.0",
+    "cli-highlight": "^2.1.11",
+    "diff-match-patch": "^1.0.5",
+    ws: "^8.18.0"
+  },
+  devDependencies: {
+    "@types/ws": "^8.5.13",
+    typescript: "^5.7.0"
+  }
+};
+
 // src/args.ts
 var DEFAULT_API_URL = "https://api.todofor.ai";
 var VERSION = package_default.version;
 function getEnv(name) {
-  return process.env[`TODOFORAI_${name}`] || process.env[`TODO4AI_${name}`] || "";
+  return (process.env[`TODOFORAI_${name}`] || process.env[`TODO4AI_${name}`] || "").trim();
 }
 function printUsage() {
   process.stderr.write(`
-todoforai-cli \u2014 TODOforAI CLI (Bun)
+todoforai-cli \u2014 TODOforAI CLI (Bun). Aliases: tfa-cli, todoai.
 
 Usage:
   todoforai-cli login                          # Browser-based device auth
@@ -44152,7 +44280,10 @@ Usage:
   todoforai-cli delete <todo-id>              # Permanently delete a todo
   todoforai-cli addmessage <todo-id> "text"  # Add a message to an existing todo
   todoforai-cli show <file|-> [todo-id]     # Show a file in the chat (rendered by mimetype; - reads stdin)
-                                            #   [--title T] [--alias A] [--mime M] [--json]
+                                            #   [--title T] [--alias A] [--mime M] [--card <name>] [--json]
+  todoforai-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
   todoforai-cli open <url> [todo-id]        # Show a live http(s) url in the chat as a preview
                                             #   [--title T] [--alias A] [--json]
   todoforai-cli recommend --template <id>    # Add a template as a recommendation card (see 'todoregistry-cli create')
@@ -44163,6 +44294,8 @@ Options:
   --path <dir>                    Workspace path (default: cwd)
   --project <id>                  Project ID
   --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
@@ -44221,6 +44354,9 @@ function parseCliArgs() {
       project: { type: "string" },
       agent: { type: "string", short: "a" },
       model: { type: "string" },
+      group: { type: "string" },
+      "group-name": { type: "string" },
+      "group-description": { type: "string" },
       "list-agents": { type: "boolean", default: false },
       "list-models": { type: "boolean", default: false },
       "api-url": { type: "string" },
@@ -44233,6 +44369,7 @@ function parseCliArgs() {
       title: { type: "string" },
       alias: { type: "string" },
       mime: { type: "string" },
+      card: { type: "string" },
       direction: { type: "string" },
       "business-context": { type: "string" },
       seed: { type: "string" },
@@ -44601,8 +44738,8 @@ import { resolve, basename } from "path";
 // src/ensure-bridge.ts
 import { spawn, spawnSync } from "child_process";
 import fs2 from "fs";
-import path3 from "path";
-import os3 from "os";
+import path2 from "path";
+import os2 from "os";
 function hasBridge() {
   const probe = spawnSync("todoforai-bridge", ["--version"], { stdio: "ignore" });
   return probe.status === 0;
@@ -44671,31 +44808,44 @@ function ensureBridgeCredentials(apiUrl) {
   const login = spawnSync("todoforai-bridge", bridgeLoginArgs(apiUrl), { stdio: "inherit" });
   return login.status === 0;
 }
-function bridgeAlreadyRunning() {
-  if (process.platform === "win32")
-    return Promise.resolve(false);
-  return new Promise((resolve) => {
-    const r = spawn("pgrep", ["-f", "todoforai-bridge"]);
-    let out = "";
-    r.stdout.on("data", (d) => out += d);
-    r.on("error", () => resolve(false));
-    r.on("close", (code) => resolve(code === 0 && out.trim().length > 0));
-  });
+async function bridgeState(apiUrl, apiKey, deviceId) {
+  try {
+    const devices = await new ApiClient(apiUrl, apiKey).listDevices();
+    return Array.isArray(devices) && devices.some((device) => device.id === deviceId && device.status === "ONLINE") ? "online" : "offline";
+  } catch {
+    return "unknown";
+  }
 }
-async function ensureBridgeRunning(apiUrl, _apiKey) {
-  if (await bridgeAlreadyRunning())
-    return;
+async function waitForBridgeOnline(apiUrl, apiKey, deviceId, timeoutMs = 5000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const state = await bridgeState(apiUrl, apiKey, deviceId);
+    if (state !== "offline")
+      return state === "online";
+    await new Promise((resolve) => setTimeout(resolve, 150));
+  } while (Date.now() < deadline);
+  return false;
+}
+async function ensureBridgeRunning(apiUrl, apiKey) {
   if (!hasBridge()) {
     console.error("\x1B[2mBridge not started: `todoforai-bridge` was not found on PATH. Install TODOforAI Bridge, or pass --no-bridge (or deprecated --no-edge) to silence this.\x1B[0m");
-    return;
+    return false;
   }
   if (!ensureBridgeCredentials(apiUrl)) {
     console.error("\x1B[33mBridge not started: `todoforai-bridge login` did not complete successfully.\x1B[0m");
-    return;
+    return false;
   }
-  const logDir = path3.join(os3.homedir(), ".todoforai");
+  const deviceId = bridgeDeviceId(apiUrl);
+  if (!deviceId) {
+    console.error("\x1B[33mBridge not started: could not determine this device's id.\x1B[0m");
+    return false;
+  }
+  const initialState = await bridgeState(apiUrl, apiKey, deviceId);
+  if (initialState === "online" || initialState === "unknown")
+    return initialState === "online";
+  const logDir = path2.join(os2.homedir(), ".todoforai");
   fs2.mkdirSync(logDir, { recursive: true });
-  const logFile = path3.join(logDir, "bridge.log");
+  const logFile = path2.join(logDir, "bridge.log");
   const out = fs2.openSync(logFile, "a");
   const child = spawn("todoforai-bridge", bridgeRunArgs(apiUrl), {
     detached: true,
@@ -44712,13 +44862,13 @@ async function ensureBridgeRunning(apiUrl, _apiKey) {
   });
   child.unref();
   if (!child.pid)
-    return;
-  const shortLog = logFile.replace(os3.homedir(), "~");
-  setTimeout(() => {
-    if (exited && exitCode !== 0) {
-      console.error(`\x1B[2mBridge not running (exit ${exitCode}), see ${shortLog}\x1B[0m`);
-    }
-  }, 500);
+    return false;
+  if (await waitForBridgeOnline(apiUrl, apiKey, deviceId))
+    return true;
+  const shortLog = logFile.replace(os2.homedir(), "~");
+  const reason = exited ? `exit ${exitCode}` : "startup timed out";
+  console.error(`\x1B[33mBridge not ready (${reason}), see ${shortLog}\x1B[0m`);
+  return false;
 }
 
 // src/agent.ts
@@ -44752,9 +44902,13 @@ async function autoCreateAgent(api, resolvedPath) {
     return resp;
   }
   const edges = await api.listEdges();
-  const edgeId = Array.isArray(edges) && edges.length ? edges[0].id : null;
-  if (!edgeId)
+  if (!Array.isArray(edges) || edges.length === 0) {
     throw new Error("No bridge device or edge available to configure workspace path");
+  }
+  if (edges.length > 1) {
+    throw new Error("No local bridge device found and multiple legacy edges are available; choose an existing agent explicitly");
+  }
+  const edgeId = edges[0].id;
   await api.setAgentEdgeMcpConfig(agentId, agentSettingsId, edgeId, "todoai_edge", { workspacePaths: [resolvedPath] });
   const matches = await api.listAgentSettings({ workspacePath: resolvedPath });
   if (matches.length)
@@ -44765,20 +44919,29 @@ async function autoCreateAgent(api, resolvedPath) {
 }
 
 // src/config.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join, resolve as resolve2 } from "path";
-import { homedir, platform } from "os";
+import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join2, resolve as resolve2 } from "path";
+import { homedir as homedir2, platform as platform2 } from "os";
+function getConfigBase() {
+  const sys = platform2();
+  if (sys === "win32")
+    return process.env.APPDATA || join2(homedir2(), "AppData", "Roaming");
+  if (sys === "darwin")
+    return join2(homedir2(), "Library", "Application Support");
+  return process.env.XDG_CONFIG_HOME || join2(homedir2(), ".config");
+}
 function getConfigDir() {
-  const sys = platform();
-  if (sys === "win32") {
-    const base = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
-    return join(base, "todoai-cli");
-  }
-  if (sys === "darwin") {
-    return join(homedir(), "Library", "Application Support", "todoai-cli");
+  const base = getConfigBase();
+  const dir = join2(base, "todoforai-cli");
+  const legacy = join2(base, "todoai-cli");
+  if (!existsSync(dir) && existsSync(legacy)) {
+    try {
+      renameSync(legacy, dir);
+    } catch {
+      return legacy;
+    }
   }
-  const xdg = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
-  return join(xdg, "todoai-cli");
+  return dir;
 }
 function defaultScope() {
   return {
@@ -44830,10 +44993,10 @@ class ConfigStore {
   data;
   constructor(pathArg) {
     if (pathArg) {
-      const p = resolve2(pathArg.replace(/^~/, homedir()));
-      this.path = p.endsWith(".json") ? p : join(p, "config.json");
+      const p = resolve2(pathArg.replace(/^~/, homedir2()));
+      this.path = p.endsWith(".json") ? p : join2(p, "config.json");
     } else {
-      this.path = join(getConfigDir(), "config.json");
+      this.path = join2(getConfigDir(), "config.json");
     }
     this.data = this.load();
   }
@@ -44841,7 +45004,7 @@ class ConfigStore {
     if (!existsSync(this.path))
       return defaultConfig();
     try {
-      const raw = JSON.parse(readFileSync(this.path, "utf-8"));
+      const raw = JSON.parse(readFileSync2(this.path, "utf-8"));
       delete raw.default_api_key;
       const cfg = migrate(raw);
       const needsMigration = raw.per_api_url == null;
@@ -44856,8 +45019,8 @@ class ConfigStore {
   }
   save() {
     try {
-      mkdirSync(dirname(this.path), { recursive: true });
-      writeFileSync(this.path, JSON.stringify(this.data, null, 2), "utf-8");
+      mkdirSync2(dirname2(this.path), { recursive: true });
+      writeFileSync2(this.path, JSON.stringify(this.data, null, 2), "utf-8");
     } catch {}
   }
   scope(apiUrl) {
@@ -44917,39 +45080,6 @@ class ScopedConfig {
     this.store.save();
   }
 }
-
-// ../packages/shared-credentials/src/index.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, chmodSync } from "fs";
-import { join as join2, dirname as dirname2 } from "path";
-import { homedir as homedir2, platform as platform2 } from "os";
-function credentialsPath2() {
-  return platform2() === "win32" ? join2(homedir2(), "AppData", "Roaming", "todoforai", "credentials.json") : platform2() === "darwin" ? join2(homedir2(), "Library", "Application Support", "todoforai", "credentials.json") : join2(process.env.XDG_CONFIG_HOME || join2(homedir2(), ".config"), "todoforai", "credentials.json");
-}
-function read() {
-  try {
-    return JSON.parse(readFileSync2(credentialsPath2(), "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function writeSecure(data) {
-  const p = credentialsPath2();
-  mkdirSync2(dirname2(p), { recursive: true });
-  writeFileSync2(p, JSON.stringify(data, null, 2), { encoding: "utf-8", mode: 384 });
-  try {
-    chmodSync(p, 384);
-  } catch {}
-}
-function readCredential(apiUrl) {
-  const c2 = read();
-  const v = c2[apiUrl] || c2.apiToken || c2.apiKey;
-  return typeof v === "string" ? v : "";
-}
-function writeCredential(apiUrl, apiKey) {
-  const c2 = read();
-  c2[apiUrl] = apiKey;
-  writeSecure(c2);
-}
 // src/logo.ts
 var LETTERS = {
   t: [" x  ", "xxxx", " x  ", " xll", " xll", " xxx"],
@@ -45023,6 +45153,12 @@ function printLogo() {
 `);
 }
 
+// src/urls.ts
+function getFrontendUrl(apiUrl, todoId) {
+  const local = apiUrl.includes("localhost:4000") || apiUrl.includes("127.0.0.1:4000");
+  return `${local ? "http://localhost:3000" : "https://todofor.ai"}/t/${todoId}`;
+}
+
 // src/inspect.ts
 var xmlAttr = (v) => JSON.stringify(String(v));
 var DROP_IF_EMPTY = new Set(["runMeta", "meta", "attachments", "blocks"]);
@@ -45448,7 +45584,16 @@ function selectProject(projects, defaultId, setDefault) {
       return Promise.resolve({ id: defaultId, name });
     }
   }
+  const accountDefault = projects.find((p) => p?.project?.isDefault) || projects[0];
+  if (!process.stdin.isTTY) {
+    const id = getItemId(accountDefault);
+    const name = getDisplayName(accountDefault);
+    process.stderr.write(`Using account default project: ${name}
+`);
+    return Promise.resolve({ id, name });
+  }
   return (async () => {
+    const defIdx = projects.indexOf(accountDefault);
     process.stderr.write(`
 Please choose a project:
 
@@ -45456,7 +45601,7 @@ Please choose a project:
     for (let i = 0;i < projects.length; i++) {
       const name = getDisplayName(projects[i]);
       const id = getItemId(projects[i]);
-      process.stderr.write(` [${i + 1}] ${name}
+      process.stderr.write(` [${i + 1}] ${name}${i === defIdx ? " (default)" : ""}
 `);
       if (id && id !== name)
         process.stderr.write(`     ${id}
@@ -45465,8 +45610,8 @@ Please choose a project:
     process.stderr.write(`
 `);
     while (true) {
-      const choice = await terminalLine("Please enter your numeric choice: ");
-      const idx = parseInt(choice, 10) - 1;
+      const choice = await terminalLine(`Please enter your numeric choice [${defIdx + 1}]: `);
+      const idx = choice === "" ? defIdx : parseInt(choice, 10) - 1;
       if (idx >= 0 && idx < projects.length) {
         const id = getItemId(projects[idx]);
         const name = getDisplayName(projects[idx]);
@@ -45854,17 +45999,6 @@ async function watchTodo(ws, todoId, projectId, opts = {}) {
     "block:start_catfile"
   ]);
   const signalActivity = () => opts.activityEvent?.set();
-  let edgeId;
-  let rootPath = "";
-  if (opts.agentSettings) {
-    const emc = opts.agentSettings.edgesMcpConfigs || {};
-    edgeId = Object.keys(emc)[0];
-    if (edgeId) {
-      const ec = emc[edgeId];
-      const tc = ec?.todoai_edge || ec?.todoai || {};
-      rootPath = (tc.workspacePaths || [])[0] || "";
-    }
-  }
   const blocksStore = new Map;
   const diffStore = diffStoreByWs.get(ws) ?? new Map;
   diffStoreByWs.set(ws, diffStore);
@@ -46051,6 +46185,12 @@ ${YELLOW}*${RESET} ${YELLOW}${blockType}${RESET}${extra}
 `);
         signalActivity();
       }
+    } else if (msgType === "NOTIFY") {
+      const sevColor = payload.severity === "error" ? RED : YELLOW;
+      process.stderr.write(`
+${sevColor}\u26A0 ${payload.title || "Notice"}${RESET}${payload.message ? ` ${DIM}${payload.message}${RESET}` : ""}
+`);
+      signalActivity();
     } else if (msgType === "todo:status") {
       const status = payload.status || "";
       process.stderr.write(`
@@ -46081,6 +46221,9 @@ ${DIM}[todo:status] ${status}${RESET}
       const status = result?.payload?.status || result?.type || "unknown";
       process.stderr.write(`Warning: Stopped: ${status}
 `);
+      process.exitCode = 1;
+    } else {
+      process.exitCode = 0;
     }
     return true;
   } catch (e) {
@@ -46124,20 +46267,6 @@ 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(`
@@ -46147,6 +46276,7 @@ Usage:
   todoforai-cli agent list                            List agents (name, model, id, paths)
   todoforai-cli agent get <agent>                     Show a single agent's settings
   todoforai-cli agent update <agent> <field=value>\u2026   Update one or more settings
+  todoforai-cli agent delete <agent>                  Delete an agent configuration (asks to confirm)
 
 <agent> is a name or id (unique partial name also works).
 Fields map directly to agent settings; values are parsed as JSON when possible
@@ -46244,6 +46374,32 @@ async function agentCommand(api, positionals, args, formatPath) {
     }
     const summary = Object.keys(updates).map((k) => `${k}=${JSON.stringify(updated[k])}`).join(" ");
     process.stderr.write(`${GREEN}\u2705 ${getDisplayName(agent)} updated: ${summary}${RESET}
+`);
+    return;
+  }
+  if (sub === "delete" || sub === "rm") {
+    const query = positionals[2];
+    if (!query) {
+      process.stderr.write(`${RED}Usage: todoforai-cli agent delete <name|id>${RESET}
+`);
+      process.exit(2);
+    }
+    const agents = await api.listAgentSettings();
+    const agent = resolveAgent(agents, query);
+    const name = getDisplayName(agent);
+    if (!process.stdin.isTTY) {
+      process.stderr.write(`${RED}Refusing to delete '${name}' non-interactively (delete needs an interactive confirm).${RESET}
+`);
+      process.exit(2);
+    }
+    const ok = await singleChar(`${RED}Delete agent '${name}'? [y/N] ${RESET}`);
+    if (ok !== "y") {
+      process.stderr.write(`Aborted
+`);
+      return;
+    }
+    await api.deleteAgentSettings(getItemId(agent));
+    process.stderr.write(`${GREEN}\u2705 Deleted ${name}${RESET}
 `);
     return;
   }
@@ -46449,18 +46605,12 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 
 // src/index.ts
 try {
-  const pkgPath = path4.resolve(fileURLToPath(import.meta.url), "../../package.json");
+  const pkgPath = path3.resolve(fileURLToPath(import.meta.url), "../../package.json");
   checkForUpdates(JSON.parse(readFileSync3(pkgPath, "utf-8")));
 } catch {}
-function formatPathWithTilde(path5) {
+function formatPathWithTilde(path4) {
   const home = homedir3();
-  return path5.startsWith(home) ? path5.replace(home, "~") : path5;
-}
-function getFrontendUrl(apiUrl, projectId, todoId) {
-  if (apiUrl.includes("localhost:4000") || apiUrl.includes("127.0.0.1:4000")) {
-    return `http://localhost:3000/${projectId}/${todoId}`;
-  }
-  return `https://todofor.ai/${projectId}/${todoId}`;
+  return path4.startsWith(home) ? path4.replace(home, "~") : path4;
 }
 async function interactiveLoop(ws, api, todoId, projectId, agent, json, autoApprove, cfg) {
   while (true) {
@@ -46537,6 +46687,8 @@ Cancelled by user (Ctrl+C)
     process.exit(130);
   });
   const { values: args, positionals } = parseCliArgs();
+  const groupTag = args.group === undefined ? getEnv("GROUP_ID") : String(args.group);
+  const groupName = args["group-name"] === undefined ? undefined : String(args["group-name"]);
   if (positionals[0] === "start") {
     if (!positionals[1] && !args.template) {
       process.stderr.write(`${RED}Usage: todoforai-cli start <todo-id>${RESET}
@@ -46699,7 +46851,8 @@ Cancelled by user (Ctrl+C)
       process.exit(2);
     }
     const todo2 = await api.getTodo(todoId);
-    const msg = await api.addMessage(todo2.projectId, content2, todo2.agentSettings || { id: todo2.agentSettingsId }, todoId);
+    const agent2 = todo2.agentSettings || await api.getAgentSettings(todo2.agentSettingsId);
+    const msg = await api.addMessage(todo2.projectId, content2, agent2, todoId);
     if (args.json)
       console.log(JSON.stringify(msg, null, 2));
     else
@@ -46707,6 +46860,32 @@ Cancelled by user (Ctrl+C)
 `);
     return;
   }
+  if (positionals[0] === "show" && positionals[1] === "list") {
+    const explicitProject = !!args.project;
+    const todoId = positionals[2] || (!explicitProject ? getEnv("TODO_ID") || cfgScope.data.last_todo_id : undefined);
+    const projectId2 = todoId ? undefined : args.project || getEnv("PROJECT_ID") || cfgScope.data.default_project_id;
+    if (!todoId && !projectId2) {
+      process.stderr.write(`${RED}Usage: todoforai-cli show list [todo-id] [--project <id>] [--card <name>]${RESET}
+`);
+      process.exit(2);
+    }
+    const { items } = await api.listShows({ todoId, projectId: projectId2, card: args.card });
+    if (args.json) {
+      console.log(JSON.stringify(items, null, 2));
+      return;
+    }
+    if (items.length === 0) {
+      process.stderr.write(`${DIM}No show blocks in ${todoId || `project ${projectId2}`}${RESET}
+`);
+      return;
+    }
+    for (const it of items) {
+      const kind = it.url ? `url ${it.url}` : it.mime || "";
+      const card = it.cardRef ? ` card=${it.cardRef}` : "";
+      console.log(`${it.ref}  ${it.title || it.filename || ""}  ${kind}${card}`);
+    }
+    return;
+  }
   if (positionals[0] === "show") {
     const [, filePath, todoArg] = positionals;
     const todoId = todoArg || getEnv("TODO_ID") || cfgScope.data.last_todo_id;
@@ -46732,9 +46911,9 @@ Cancelled by user (Ctrl+C)
         process.exit(1);
       }
       blob = file;
-      name = path4.basename(filePath);
+      name = path3.basename(filePath);
     }
-    const res = await api.showFile(todoId, blob, name, { title: args.title, alias: args.alias, mime: args.mime });
+    const res = await api.showFile(todoId, blob, name, { title: args.title, alias: args.alias, mime: args.mime, card: args.card });
     if (args.json)
       console.log(JSON.stringify(res, null, 2));
     else
@@ -46759,13 +46938,13 @@ Cancelled by user (Ctrl+C)
   if (positionals[0] === "recommend") {
     const templateId = args.template || positionals[1];
     if (!templateId) {
-      process.stderr.write(`${RED}Usage: todoforai-cli recommend --template <id> [--note "why"] [--priority high|medium|low] [--title "..."] [--project <id>]${RESET}
+      process.stderr.write(`${RED}Usage: todoforai-cli recommend --template <id> [--note "why"] [--priority high|medium|low] [--title "..."] [--group <slug> [--group-name "..."] [--group-description "..."]] [--project <id>]${RESET}
 `);
       process.stderr.write(`${DIM}Create a template first with: todoregistry-cli create --name ... --description ... --body @prompt.md${RESET}
 `);
       process.exit(2);
     }
-    let projectId2 = args.project || cfgScope.data.default_project_id;
+    let projectId2 = args.project || getEnv("PROJECT_ID") || 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;
@@ -46787,7 +46966,10 @@ Cancelled by user (Ctrl+C)
       ...args.title ? { title: args.title } : {},
       ...args.note ? { note: args.note } : {},
       ...priority ? { priority } : {},
-      ...args["business-context"] ? { businessContextId: args["business-context"] } : {}
+      ...args["business-context"] ? { businessContextId: args["business-context"] } : {},
+      ...args.group ? { group: args.group } : {},
+      ...args["group-name"] ? { groupName: args["group-name"] } : {},
+      ...args["group-description"] ? { groupDescription: args["group-description"] } : {}
     });
     if (args.json)
       console.log(JSON.stringify(rec, null, 2));
@@ -46797,7 +46979,7 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (positionals[0] === "claim" && positionals[1] === "mint") {
-    let seedProjectId = args.seed || args.project || cfgScope.data.default_project_id;
+    let seedProjectId = args.seed || args.project || getEnv("PROJECT_ID") || 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;
@@ -46839,7 +47021,7 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (positionals[0] === "next") {
-    let projectId2 = args.project || cfgScope.data.default_project_id;
+    let projectId2 = args.project || getEnv("PROJECT_ID") || 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;
@@ -46875,7 +47057,13 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (args["list-models"]) {
-    await listModelsCommand(api, { json: !!args.json, filter: positionals[0] });
+    const ids = qualifiedModelIds(await api.listModels(), positionals[0]);
+    if (args.json)
+      console.log(JSON.stringify(ids, null, 2));
+    else
+      for (const id of ids)
+        process.stderr.write(`${BRAND}${id}${RESET}
+`);
     return;
   }
   if (positionals[0] === "agent") {
@@ -46883,7 +47071,7 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (positionals[0] === "list" || positionals[0] === "ls") {
-    let defaultProjectId = args.project || cfgScope.data.default_project_id;
+    let defaultProjectId = args.project || getEnv("PROJECT_ID") || cfgScope.data.default_project_id;
     if (!defaultProjectId) {
       const projects2 = await api.listProjects();
       defaultProjectId = projects2.find((p) => p.project?.isDefault)?.project?.id || projects2[0]?.project?.id;
@@ -46922,14 +47110,14 @@ Cancelled by user (Ctrl+C)
     }
     const mode = args.debug ? "debug" : args.detailed ? "detailed" : "default";
     const format = args["format-anthropic"] ? "anthropic" : "compact";
-    printFullChat(todo2, getFrontendUrl(apiUrl, todo2.projectId, todoId), slice, mode, format);
+    printFullChat(todo2, getFrontendUrl(apiUrl, todoId), slice, mode, format);
     return;
   }
   if (process.stderr.isTTY)
     printLogo();
   if (args.template) {
     if (!args["no-bridge"] && !args["no-watch"])
-      ensureBridgeRunning(apiUrl, apiKey);
+      await ensureBridgeRunning(apiUrl, apiKey);
     const templateId = args.template;
     const spec = await api.getRegistrySpec(templateId);
     process.stderr.write(`${DIM}Template:${RESET} ${BRAND}${spec.name}${RESET}
@@ -46938,7 +47126,7 @@ Cancelled by user (Ctrl+C)
       process.stderr.write(`${DIM}${spec.description}${RESET}
 `);
     const projects2 = await api.listProjects();
-    let projectId2 = args.project;
+    let projectId2 = args.project || getEnv("PROJECT_ID");
     if (!projectId2) {
       const cached = cfgScope.data.default_project_id;
       projectId2 = (cached && projects2.some((p) => getItemId(p) === cached) ? cached : null) || projects2.find((p) => p.project?.isDefault)?.project?.id || projects2[0]?.project?.id;
@@ -46948,10 +47136,13 @@ Cancelled by user (Ctrl+C)
 `);
       process.exit(1);
     }
-    const todo2 = await api.startFromSpec(projectId2, templateId);
+    const todo2 = await api.startFromSpec(projectId2, templateId, {
+      ...groupTag ? { groupTag } : {},
+      ...groupName ? { groupName } : {}
+    });
     const todoId = todo2.id;
     cfgScope.setLastTodoId(todoId);
-    const frontendUrl2 = getFrontendUrl(apiUrl, projectId2, todoId);
+    const frontendUrl2 = getFrontendUrl(apiUrl, todoId);
     if (args.json) {
       console.log(JSON.stringify({ ...todo2, frontend_url: frontendUrl2 }, null, 2));
     } else if (args["no-watch"]) {
@@ -46996,7 +47187,7 @@ ${"\u2500".repeat(40)}
   }
   if (args.resume || args.continue) {
     if (!args["no-bridge"])
-      ensureBridgeRunning(apiUrl, apiKey);
+      await ensureBridgeRunning(apiUrl, apiKey);
     const todoId = args.resume || cfgScope.data.last_todo_id;
     if (!todoId) {
       process.stderr.write(`Error: No recent todo found
@@ -47013,7 +47204,7 @@ ${"\u2500".repeat(40)}
     }
     process.stderr.write(`
 ${"\u2500".repeat(40)}
-Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
+Resumed: ${CYAN}${getFrontendUrl(apiUrl, todoId)}${RESET}
 `);
     const ws2 = new FrontendWebSocket(apiUrl, apiKey);
     await ws2.connect();
@@ -47037,8 +47228,7 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   const ws = args["no-watch"] ? null : new FrontendWebSocket(apiUrl, apiKey);
   const wsReady = ws ? ws.connect() : null;
-  if (!args["no-bridge"] && !args["no-watch"])
-    ensureBridgeRunning(apiUrl, apiKey);
+  const bridgeReady = !args["no-bridge"] && !args["no-watch"] ? ensureBridgeRunning(apiUrl, apiKey) : null;
   let preMatchedAgent = null;
   let agents = null;
   if (args.agent) {
@@ -47096,7 +47286,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   } else {
     content = await readStdin();
   }
-  const hasProject = args.project || cfgScope.data.default_project_id;
+  const envProjectId = getEnv("PROJECT_ID");
+  const hasProject = args.project || envProjectId || cfgScope.data.default_project_id;
   const storedAgent = cfgScope.data.default_agent_settings;
   const hasAgent = preMatchedAgent || storedAgent?.id && !args.agent;
   let projects = null;
@@ -47107,8 +47298,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   let projectId;
   let projectName;
-  if (args.project) {
-    projectId = args.project;
+  if (args.project || envProjectId) {
+    projectId = args.project || envProjectId;
     projectName = projectId;
     if (projects) {
       const match = projects.find((p) => getItemId(p) === projectId);
@@ -47133,6 +47324,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   if (wsReady)
     await wsReady;
+  if (bridgeReady)
+    await bridgeReady;
   if (args.model)
     agent = { ...agent, model: args.model };
   if (args["raw-sysmsg"]) {
@@ -47146,9 +47339,9 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   cfg.addToHistory(content);
   let todo;
   try {
-    todo = await api.addMessage(projectId, content, agent);
+    todo = await api.addMessage(projectId, content, agent, undefined, undefined, undefined, groupTag || undefined, groupName);
   } catch (e) {
-    if (!args.project && cfgScope.data.default_project_id === projectId && /failed: 403/.test(e.message || "")) {
+    if (!args.project && !envProjectId && cfgScope.data.default_project_id === projectId && /failed: 403/.test(e.message || "")) {
       cfgScope.clearDefaultProject();
       process.stderr.write(`${RED}Not authorized for cached default project ${projectName} (${projectId}) \u2014 cleared it. Re-run to pick a project.${RESET}
 `);
@@ -47158,7 +47351,7 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   const actualTodoId = todo.id || crypto.randomUUID();
   cfgScope.setLastTodoId(actualTodoId);
-  const frontendUrl = getFrontendUrl(apiUrl, projectId, actualTodoId);
+  const frontendUrl = getFrontendUrl(apiUrl, actualTodoId);
   if (args.json) {
     console.log(JSON.stringify({ ...todo, frontend_url: frontendUrl }, null, 2));
   } else if (!ws) {
@@ -47183,7 +47376,7 @@ ${"\u2500".repeat(40)}
     await ws.close();
   }
 }
-main().then(() => process.exit(0)).catch((e) => {
+main().then(() => process.exit(process.exitCode ?? 0)).catch((e) => {
   process.stderr.write(`Error: ${e.message}
 `);
   process.exit(1);

package/package.json

@@ -1,36 +1,30 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "type": "module",
   "bin": {
     "todoforai-cli": "bin/todoforai-cli.js",
+    "tfa-cli": "bin/todoforai-cli.js",
     "todoai": "bin/todoforai-cli.js"
   },
   "files": [
     "bin",
-    "dist/todoai.js"
+    "dist/todoforai-cli.js"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --target=bun --outfile dist/todoai.js --external ws",
+    "build": "bun build src/index.ts --target=bun --outfile dist/todoforai-cli.js --external ws",
     "prepublishOnly": "bun run build",
     "start": "bun run src/index.ts",
     "dev": "bun run src/index.ts"
   },
   "dependencies": {
+    "@shared/api": "file:../packages/shared-api",
     "@shared/credentials": "file:../packages/shared-credentials",
     "@todoforai/update-notifier": "^0.1.0",
     "cli-highlight": "^2.1.11",
     "diff-match-patch": "^1.0.5",
     "ws": "^8.18.0"
   },
-  "peerDependencies": {
-    "@todoforai/edge": ">=0.12.0"
-  },
-  "peerDependenciesMeta": {
-    "@todoforai/edge": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/ws": "^8.5.13",
     "typescript": "^5.7.0"