@todoforai/cli 0.1.28 → 0.1.30

package/dist/todoforai-cli.js

@@ -42893,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 });
   }
@@ -43199,6 +43258,8 @@ class FrontendWebSocket {
 // ../packages/shared-fbe/src/enums.ts
 var TodoStatus;
 ((TodoStatus2) => {
+  TodoStatus2["PROPOSED"] = "PROPOSED";
+  TodoStatus2["DISMISSED"] = "DISMISSED";
   TodoStatus2["TODO"] = "TODO";
   TodoStatus2["SCHEDULED"] = "SCHEDULED";
   TodoStatus2["PAUSED"] = "PAUSED";
@@ -43479,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}`
   },
@@ -43939,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.)
 
@@ -43951,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.
@@ -43965,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: {
@@ -44014,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 */]: {
@@ -44052,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"
@@ -44158,7 +44221,7 @@ import { parseArgs } from "util";
 // package.json
 var package_default = {
   name: "@todoforai/cli",
-  version: "0.1.28",
+  version: "0.1.30",
   type: "module",
   bin: {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -44215,7 +44278,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')
@@ -44288,6 +44354,7 @@ function parseCliArgs() {
       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" },
@@ -44300,6 +44367,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" },
@@ -46772,6 +46840,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;
@@ -46799,7 +46893,7 @@ Cancelled by user (Ctrl+C)
       blob = file;
       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
@@ -46824,7 +46918,7 @@ 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}
 `);
@@ -46852,7 +46946,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));

package/package.json

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