@todoforai/cli 0.1.50 → 0.1.51

package/dist/todoforai-cli.js

@@ -42926,6 +42926,15 @@ class ApiClient {
   upsertProjectGroup(projectId, slug, fields) {
     return this.request("PUT", `/api/v1/projects/${projectId}/groups/${encodeURIComponent(slug)}`, { projectId, slug, ...fields });
   }
+  listProjectSurfaces(projectId) {
+    return this.request("GET", `/api/v1/projects/${projectId}/surfaces`);
+  }
+  upsertProjectSurface(projectId, surfaceId, fields) {
+    return this.request("PUT", `/api/v1/projects/${projectId}/surfaces/${encodeURIComponent(surfaceId)}`, { projectId, surfaceId, ...fields });
+  }
+  deleteProjectSurface(projectId, surfaceId) {
+    return this.request("DELETE", `/api/v1/projects/${projectId}/surfaces/${encodeURIComponent(surfaceId)}`, { projectId, surfaceId });
+  }
   reorderProjectGroups(projectId, slugs) {
     return this.request("PUT", `/api/v1/projects/${projectId}/groups-order`, { projectId, slugs });
   }
@@ -43729,6 +43738,9 @@ var SERVER_TO_FRONTENDS = {
   hexGrid: {
     updated: (projectId) => `${"hexgrid:updated" /* HEXGRID_UPDATED */}:${projectId}`
   },
+  surfaces: {
+    updated: (projectId) => `${"project:surfaces_updated" /* PROJECT_SURFACES_UPDATED */}:${projectId}`
+  },
   killSwitch: {
     changed: (projectId) => `${"project:kill_switch" /* KILL_SWITCH */}:${projectId}`
   },
@@ -44393,6 +44405,10 @@ var TOPICS = {
     channel: (p) => SERVER_TO_FRONTENDS.hexGrid.updated(p.projectId),
     audience: "frontend"
   },
+  ["project:surfaces_updated" /* PROJECT_SURFACES_UPDATED */]: {
+    channel: (p) => SERVER_TO_FRONTENDS.surfaces.updated(p.projectId),
+    audience: "frontend"
+  },
   ["project:kill_switch" /* KILL_SWITCH */]: {
     channel: (p) => SERVER_TO_FRONTENDS.killSwitch.changed(p.projectId),
     audience: "frontend"
@@ -44533,7 +44549,7 @@ import { parseArgs } from "util";
 // package.json
 var package_default = {
   name: "@todoforai/cli",
-  version: "0.1.50",
+  version: "0.1.51",
   type: "module",
   bin: {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -47853,11 +47869,18 @@ Usage:
   tfa-cli project groups                           List todo groups
   tfa-cli project groups set <slug> <field=value>… Create/update a group: name description pinned archived order
   tfa-cli project groups reorder <slug>…           Set wall order
+  tfa-cli project surfaces                         List the board's card surfaces (live refs shown as cards)
+  tfa-cli project surfaces set <id> ref=<ref> [title=…] [group=<slug>] [order=N]
+                                                   Show a ref on the board: a todo id, <todoId>:<alias>
+                                                   (shown artifact) or an http(s) url. group= puts it
+                                                   inside that group's card; group="" makes it standalone.
+  tfa-cli project surfaces rm <id>                 Take it off the board
 
 Examples:
   tfa-cli project set name="Q4 launch"
   tfa-cli project groups set marketing name=Marketing description="Top-of-funnel work"
   tfa-cli project groups reorder marketing sales ops
+  tfa-cli project surfaces set weekly-kpis ref=$TODOFORAI_TODO_ID:kpi title="Weekly KPIs" group=marketing
 `);
 }
 var TODO_ALIASES = {
@@ -48010,6 +48033,43 @@ async function projectCommand(api, positionals, args) {
     }
     fail(`Unknown 'project groups' verb: ${verb}`);
   }
+  if (sub === "surfaces") {
+    const [verb, ...sargs] = rest;
+    if (!verb) {
+      const surfaces = await api.listProjectSurfaces(projectId);
+      if (args.json) {
+        console.log(JSON.stringify(surfaces, null, 2));
+        return;
+      }
+      for (const s of surfaces)
+        process.stderr.write(`${s.id}  ${s.ref}  ${DIM}${[s.title, s.group && `in ${s.group}`].filter(Boolean).join("  ")}${RESET}
+`);
+      return;
+    }
+    if (verb === "set") {
+      const [id, ...fields] = sargs;
+      if (!id)
+        fail("Usage: tfa-cli project surfaces set <id> ref=<ref> [title=…] [group=<slug>] [order=N]");
+      const surface = await api.upsertProjectSurface(projectId, id, parseAssignments2(fields));
+      if (args.json) {
+        console.log(JSON.stringify(surface, null, 2));
+        return;
+      }
+      process.stderr.write(`${GREEN}✅ surface ${id} shows ${surface.ref}${surface.group ? ` in ${surface.group}` : ""}${RESET}
+`);
+      return;
+    }
+    if (verb === "rm") {
+      const [id] = sargs;
+      if (!id)
+        fail("Usage: tfa-cli project surfaces rm <id>");
+      await api.deleteProjectSurface(projectId, id);
+      process.stderr.write(`${GREEN}✅ surface ${id} removed${RESET}
+`);
+      return;
+    }
+    fail(`Unknown 'project surfaces' verb: ${verb}`);
+  }
   fail(`Unknown 'project' subcommand: ${sub}`);
 }
 function printBrandHelp() {
@@ -69765,6 +69825,22 @@ var zUsageUpdate = object({
     return;
   })
 });
+var zNoticeSeverity = union([
+  literal("info"),
+  literal("warning"),
+  literal("error"),
+  string2()
+]);
+var zNotice = object({
+  severity: zNoticeSeverity,
+  title: string2().min(1),
+  description: defaultOnError(string2().nullish(), () => {
+    return;
+  }),
+  _meta: defaultOnError(record(string2(), unknown()).nullish(), () => {
+    return;
+  })
+});
 var zCompactionId = string2();
 var zCompactionStatus = union([
   literal("in_progress"),
@@ -69833,6 +69909,9 @@ var zSessionUpdate = union([
   zUsageUpdate.and(object({
     sessionUpdate: literal("usage_update")
   })),
+  zNotice.and(object({
+    sessionUpdate: literal("notice")
+  })),
   zCompactionUpdate.and(object({
     sessionUpdate: literal("compaction_update")
   })),
@@ -69894,6 +69973,7 @@ var zSessionConfigOptionsCapabilities = object({
     return;
   })
 });
+var zNoticeCapabilities = record(string2(), unknown());
 var zClientSessionCapabilities = object({
   compaction: defaultOnError(zCompactionCapabilities.nullish(), () => {
     return;
@@ -69901,6 +69981,9 @@ var zClientSessionCapabilities = object({
   configOptions: defaultOnError(zSessionConfigOptionsCapabilities.nullish(), () => {
     return;
   }),
+  notices: defaultOnError(zNoticeCapabilities.nullish(), () => {
+    return;
+  }),
   _meta: defaultOnError(record(string2(), unknown()).nullish(), () => {
     return;
   })

package/package.json

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