@workser/cli 0.6.12 → 0.6.14

package/dist/index.js

@@ -3583,6 +3583,7 @@ function ownerOnly(opts) {
 }
 
 // src/output.ts
+var OUT_OF_SCOPE_EXIT = 7;
 var mode = "text";
 var quiet = false;
 function configureOutput(opts) {
@@ -3633,7 +3634,13 @@ function fail(err) {
     } else if (e.status === 401 || e.code === "unauthorized") {
       process.stderr.write(import_picocolors.default.dim("  Run `workser login` to authenticate.\n"));
     } else if (e.code === "no_project") {
-      process.stderr.write(import_picocolors.default.dim("  Run `workser project use <id>` or pass --project <id>.\n"));
+      process.stderr.write(import_picocolors.default.dim("  cd into the project's folder, or open it in Workser.\n"));
+    } else if (e.code === "out_of_scope") {
+      process.stderr.write(
+        import_picocolors.default.dim(
+          "  You can move between your organization's projects; another organization's are not reachable.\n"
+        )
+      );
     } else if (e.code === "awaiting_approval") {
       process.stderr.write(import_picocolors.default.dim("  Approve the action in Workser Orbit, then retry.\n"));
     } else if (e.code === "owner_only") {
@@ -3647,6 +3654,7 @@ function exitCodeFor(e) {
   if (e.status === 401 || e.code === "unauthorized") return 3;
   if (e.code === "awaiting_approval") return 5;
   if (e.code === "owner_only") return OWNER_ONLY_EXIT;
+  if (e.code === "out_of_scope") return OUT_OF_SCOPE_EXIT;
   return 1;
 }
 
@@ -4063,6 +4071,84 @@ Two things worth knowing:
 
 An app that has never been published has no address, so there is nothing to
 check. That is reported as a note, not as a pass.
+`
+  },
+  {
+    topic: "cloud-agents",
+    title: "Ship an agent inside the app",
+    summary: "Create an AI agent that runs on Workser and can be called from this project's apps.",
+    commands: ["cloud-agent"],
+    source: "skills/workser/reference/cloud-agents.md",
+    body: `# Ship an agent inside the app
+
+\`workser cloud-agent\` creates an AI agent that runs on **Workser's**
+infrastructure, keeps its own memory and tools, and can be called from the web,
+mobile, API or Python apps in this project.
+
+**This is not \`workser agent\`.** That one hands a subtask to a coding agent on
+this machine \u2014 a teammate helping you build. This one is a thing the project
+*ships*: it works for the user after you are gone.
+
+\`\`\`
+workser cloud-agent list
+workser cloud-agent create "Order desk" --instructions "..."
+workser cloud-agent show <agentId>
+workser cloud-agent run <agentId> "<what to do>"
+workser cloud-agent runs <agentId>        # recent runs
+workser cloud-agent runs <runId>          # one run, with what it cost
+\`\`\`
+
+Every call is scoped to the project this folder belongs to.
+
+## When to reach for this
+
+When the user describes a job that **keeps happening** and needs judgement:
+"check every order for stock and email me the problems", "read the LINE
+messages and file them", "reconcile these invoices". That is an agent.
+
+A one-off transformation is not an agent \u2014 write the code. A fixed sequence of
+steps with no judgement in it is not an agent either \u2014 that is \`workser
+workflow\`.
+
+## Calling it from the app you are building
+
+Do NOT shell out to the CLI from app code. Use the SDK, which streams:
+
+\`\`\`ts
+import { workser } from '@workser/app';
+
+const run = await workser.agents.run(agentId, { message }, {
+  referenceUserId: user.id,   // who it is acting for
+});
+
+for await (const event of workser.agents.stream(run.id)) {
+  // event.type, event.data \u2014 forward these to the browser
+}
+\`\`\`
+
+\`stream()\` reconnects itself through dropped connections, so the person
+watching sees the agent think. See the \`workser-sdk\` skill, \`reference/agents.md\`.
+
+## Things that will bite you
+
+1. **A run costs money by the minute.** It is metered \u2014 runtime, workspace, and
+   a per-run fee \u2014 so a loop that starts agents is a loop that spends. Cancel
+   what you abandon: \`workser cloud-agent runs <runId>\` shows the cost.
+
+2. **Instructions are the product.** The agent does what its instructions say,
+   in the user's own words. Write them the way you would brief a new colleague:
+   what to do, what to leave alone, when to ask. Vague instructions are the
+   single biggest cause of an agent that "doesn't work".
+
+3. **Free plans cannot run agents at all**, and a trial has a small allowance.
+   A \`402\` with \`spend_limit_reached\` is not a bug \u2014 tell the user what it says
+   and point them at their plan.
+
+4. **Say who it is for.** An agent acting for one of the app's customers needs
+   \`referenceUserId\`, or its memory and audit trail belong to nobody.
+
+5. **Do not invent an agent the user did not ask for.** Creating one is cheap;
+   an agent nobody wanted, quietly costing money per run, is not.
 `
   },
   {
@@ -5624,6 +5710,9 @@ async function api(ctx, path, opts = {}) {
   if (ctx.mode === "daemon" && ctx.runId) {
     headers["x-workser-run-id"] = ctx.runId;
   }
+  if (ctx.mode === "daemon" && ctx.cwd) {
+    headers["x-workser-cwd"] = encodeURIComponent(ctx.cwd);
+  }
   if (opts.body !== void 0) headers["content-type"] = "application/json";
   const method = opts.method ?? (opts.body !== void 0 ? "POST" : "GET");
   const bodyText = opts.body !== void 0 ? JSON.stringify(opts.body) : void 0;
@@ -5709,6 +5798,12 @@ function registerStatus(program3) {
           `  project:   ${data.project?.name ?? "\u2014"}` + (data.project?.id ? import_picocolors3.default.dim(`  (${data.project.id})`) : "")
         );
         if (ctx.projectRoot) line(`  folder:    ${import_picocolors3.default.dim(ctx.projectRoot)}`);
+        if (data.scope) {
+          const why = data.scope.source === "folder" ? "this folder" : data.scope.source === "active" ? "the project open in Workser" : null;
+          line(
+            data.scope.orgId ? `  org:       ${data.scope.orgId}` + (why ? import_picocolors3.default.dim(`  (from ${why})`) : "") : `  org:       ${import_picocolors3.default.yellow("unscoped \u2014 every project is reachable")}`
+          );
+        }
         if (ctx.appId) {
           line(
             `  app:       ${ctx.appName ?? "\u2014"}` + import_picocolors3.default.dim(`  (${ctx.appId})`)
@@ -5921,7 +6016,7 @@ function registerProject(program3) {
       });
     })
   );
-  project.command("list").description("List the workspace's projects").action(
+  project.command("list").description("List the projects in your organization").action(
     action(async ({ ctx }) => {
       const items = await api(ctx, `/v1/projects`);
       ok(items, () => {
@@ -5930,6 +6025,11 @@ function registerProject(program3) {
           const pinned = ctx.projectId && p.id === ctx.projectId ? import_picocolors4.default.green("\u25CF ") : "  ";
           line(`${pinned}${p.name ?? "\u2014"}${p.id ? import_picocolors4.default.dim(`  (${p.id})`) : ""}`);
         }
+        line(
+          import_picocolors4.default.dim(
+            "\nYour organization's projects. Other organizations are not reachable from here."
+          )
+        );
       });
     })
   );
@@ -7437,8 +7537,154 @@ function formatRole(r) {
   return `${label}  ${agent}  ${enabled}  ${ready}${tail}`;
 }
 
-// src/commands/verify.ts
+// src/commands/cloud-agent.ts
 var import_picocolors17 = __toESM(require_picocolors(), 1);
+function registerCloudAgent(program3) {
+  const cloud = program3.command("cloud-agent").description(
+    "Agents that run in the cloud and can be called from this project's apps (not the local coding agents \u2014 that's `workser agent`)"
+  );
+  cloud.command("list").description("List this project's cloud agents").action(
+    action(async ({ ctx }) => {
+      const res = await api(ctx, "/v1/cloud-agents");
+      const agents = res?.agents ?? res ?? [];
+      ok(res, () => {
+        if (!agents.length) {
+          line(import_picocolors17.default.dim("No cloud agents yet."));
+          line(
+            import_picocolors17.default.dim("Create one: ") + import_picocolors17.default.bold('workser cloud-agent create "Order desk" --instructions "..."')
+          );
+          return;
+        }
+        for (const a of agents) {
+          line(
+            `${import_picocolors17.default.bold(a.name ?? a.id)}  ${import_picocolors17.default.dim(a.id)}` + (a.status ? `  ${import_picocolors17.default.dim(a.status)}` : "")
+          );
+          if (a.description) line("  " + import_picocolors17.default.dim(a.description));
+        }
+      });
+    })
+  );
+  cloud.command("create <name>").description("Create a cloud agent in this project").option("--description <text>", "What it is for, in the owner's words").option(
+    "--instructions <text>",
+    "The agent's standing instructions \u2014 what it should always do"
+  ).action(
+    action(async ({ ctx, args, opts }) => {
+      const res = await api(ctx, "/v1/cloud-agents", {
+        method: "POST",
+        body: {
+          name: args[0],
+          description: opts.description,
+          instructions: opts.instructions
+        }
+      });
+      ok(res, () => {
+        line(import_picocolors17.default.green("Created ") + import_picocolors17.default.bold(res?.name ?? args[0]));
+        if (res?.id) line(import_picocolors17.default.dim(res.id));
+        line("");
+        line(
+          import_picocolors17.default.dim("Give it work: ") + import_picocolors17.default.bold(`workser cloud-agent run ${res?.id ?? "<id>"} "..."`)
+        );
+      });
+    })
+  );
+  cloud.command("show <agentId>").description("One cloud agent, with its configuration").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(ctx, `/v1/cloud-agents/${encodeURIComponent(args[0])}`);
+      ok(res, () => {
+        line(import_picocolors17.default.bold(res?.name ?? args[0]));
+        if (res?.description) line(import_picocolors17.default.dim(res.description));
+        if (res?.instructions) {
+          line("");
+          line(import_picocolors17.default.bold("instructions:"));
+          line(res.instructions);
+        }
+      });
+    })
+  );
+  cloud.command("run <agentId> <message>").description("Give a cloud agent something to do").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(
+        ctx,
+        `/v1/cloud-agents/${encodeURIComponent(args[0])}/runs`,
+        { method: "POST", body: { input: { message: args[1] } } }
+      );
+      ok(res, () => {
+        line(import_picocolors17.default.green("Started run ") + import_picocolors17.default.bold(res?.id ?? ""));
+        line(
+          import_picocolors17.default.dim("Follow it: ") + import_picocolors17.default.bold(`workser cloud-agent runs ${res?.id ?? "<runId>"}`)
+        );
+      });
+    })
+  );
+  cloud.command("runs [agentIdOrRunId]").description("Recent runs for an agent, or one run in detail").option("--limit <n>", "How many to list", "10").action(
+    action(async ({ ctx, args, opts }) => {
+      const id = args[0];
+      if (!id) {
+        warn("Give an agent id to list its runs, or a run id to inspect one.");
+        return;
+      }
+      try {
+        const run = await api(
+          ctx,
+          `/v1/cloud-agents/runs/${encodeURIComponent(id)}`
+        );
+        ok(run, () => printRun(run));
+        return;
+      } catch {
+      }
+      const res = await api(
+        ctx,
+        `/v1/cloud-agents/${encodeURIComponent(id)}/runs`,
+        { query: { limit: opts.limit } }
+      );
+      const runs = res?.runs ?? res ?? [];
+      ok(res, () => {
+        if (!runs.length) {
+          line(import_picocolors17.default.dim("No runs yet."));
+          return;
+        }
+        for (const r of runs) printRun(r, true);
+      });
+    })
+  );
+}
+function printRun(run, compact = false) {
+  const status = String(run?.status ?? "").toLowerCase();
+  const colour2 = status === "completed" ? import_picocolors17.default.green : status === "failed" ? import_picocolors17.default.red : import_picocolors17.default.yellow;
+  line(
+    `${colour2(status || "unknown")}  ${import_picocolors17.default.bold(run?.id ?? "")}` + (run?.duration_ms ? `  ${import_picocolors17.default.dim(formatDuration(run.duration_ms))}` : "")
+  );
+  const breakdown = run?.cost_breakdown;
+  if (breakdown) {
+    if (!breakdown.settled) {
+      line("  " + import_picocolors17.default.dim("cost: still being worked out"));
+    } else {
+      line("  " + import_picocolors17.default.dim(`cost: $${Number(breakdown.total_usd).toFixed(4)}`));
+      line(
+        "    " + import_picocolors17.default.dim(
+          `model $${Number(breakdown.model_usd).toFixed(4)} \xB7 infrastructure $${Number(breakdown.infrastructure_usd).toFixed(4)}`
+        )
+      );
+    }
+  } else if (run?.cost_usd !== void 0 && run?.cost_usd !== null) {
+    line("  " + import_picocolors17.default.dim(`model cost: $${Number(run.cost_usd).toFixed(4)}`));
+  }
+  if (!compact && run?.output) {
+    line("");
+    line(typeof run.output === "string" ? run.output : JSON.stringify(run.output, null, 2));
+  }
+  if (run?.error?.message) line("  " + import_picocolors17.default.red(run.error.message));
+}
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  const seconds = Math.round(ms / 1e3);
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  return `${minutes}m ${seconds % 60}s`;
+}
+
+// src/commands/verify.ts
+var import_picocolors18 = __toESM(require_picocolors(), 1);
 function registerVerify(program3) {
   program3.command("verify").description(
     "Run the project's checks (typecheck/lint/build) \u2014 use before declaring a task done"
@@ -7460,23 +7706,23 @@ function registerVerify(program3) {
 function printVerify(res) {
   if (!res) return;
   if (!res.checks?.length) {
-    line(import_picocolors17.default.dim(res.note ?? "No checks detected."));
+    line(import_picocolors18.default.dim(res.note ?? "No checks detected."));
     return;
   }
   for (const c of res.checks) {
     line(
-      `  ${c.ok ? import_picocolors17.default.green("\u2713") : import_picocolors17.default.red("\u2717")} ${c.name}${c.ok ? "" : import_picocolors17.default.dim(` (exit ${c.exitCode})`)}`
+      `  ${c.ok ? import_picocolors18.default.green("\u2713") : import_picocolors18.default.red("\u2717")} ${c.name}${c.ok ? "" : import_picocolors18.default.dim(` (exit ${c.exitCode})`)}`
     );
   }
   if (res.ok) success("All checks passed");
   else
     line(
-      import_picocolors17.default.red("Some checks failed \u2014 fix the errors above and re-run ") + import_picocolors17.default.bold("workser verify") + import_picocolors17.default.red(".")
+      import_picocolors18.default.red("Some checks failed \u2014 fix the errors above and re-run ") + import_picocolors18.default.bold("workser verify") + import_picocolors18.default.red(".")
     );
 }
 
 // src/commands/checkpoint.ts
-var import_picocolors18 = __toESM(require_picocolors(), 1);
+var import_picocolors19 = __toESM(require_picocolors(), 1);
 function registerCheckpoint(program3) {
   program3.command("checkpoint [label]").description(
     "Save the current state of this folder so you can come back to it"
@@ -7493,8 +7739,8 @@ function registerCheckpoint(program3) {
       ok(res, () => {
         const p = res?.point;
         success(`Saved a checkpoint${p?.label ? `: ${p.label}` : ""}`);
-        if (p?.ref) line(import_picocolors18.default.dim(`  ${p.ref.slice(0, 7)}`));
-        line(import_picocolors18.default.dim("  Come back to it with `workser restore`."));
+        if (p?.ref) line(import_picocolors19.default.dim(`  ${p.ref.slice(0, 7)}`));
+        line(import_picocolors19.default.dim("  Come back to it with `workser restore`."));
       });
     })
   );
@@ -7520,12 +7766,12 @@ function registerCheckpoint(program3) {
         );
         if (res?.filesChanged) {
           line(
-            import_picocolors18.default.dim(
+            import_picocolors19.default.dim(
               `  ${res.filesChanged} file${res.filesChanged === 1 ? "" : "s"} changed`
             )
           );
         }
-        line(import_picocolors18.default.dim("  This is reversible: `workser restore` again."));
+        line(import_picocolors19.default.dim("  This is reversible: `workser restore` again."));
       });
     })
   );
@@ -7542,25 +7788,25 @@ function registerCheckpoint(program3) {
 function printPoints(points) {
   if (!points.length) {
     info("No checkpoints yet for this folder.");
-    line(import_picocolors18.default.dim("  Take one with `workser checkpoint`."));
+    line(import_picocolors19.default.dim("  Take one with `workser checkpoint`."));
     return;
   }
-  line(import_picocolors18.default.bold("Checkpoints"));
+  line(import_picocolors19.default.bold("Checkpoints"));
   for (const p of points) {
     const when = p.at ? new Date(p.at).toLocaleString() : "";
     line(
-      `  ${import_picocolors18.default.dim(p.ref.slice(0, 7))}  ${p.label}${when ? import_picocolors18.default.dim(`  ${when}`) : ""}`
+      `  ${import_picocolors19.default.dim(p.ref.slice(0, 7))}  ${p.label}${when ? import_picocolors19.default.dim(`  ${when}`) : ""}`
     );
   }
   line(
-    import_picocolors18.default.dim(
+    import_picocolors19.default.dim(
       "\nGo back with `workser restore <ref>`, or just `workser restore` for the newest."
     )
   );
 }
 
 // src/commands/sync.ts
-var import_picocolors19 = __toESM(require_picocolors(), 1);
+var import_picocolors20 = __toESM(require_picocolors(), 1);
 function registerSync(program3) {
   program3.command("sync").description(
     "Reconcile this folder with the copy Workser holds (pull, then push)"
@@ -7587,7 +7833,7 @@ function registerSync(program3) {
           warn(res?.message ?? "Couldn't sync this folder.");
           if (res?.state === "diverged") {
             line(
-              import_picocolors19.default.dim(
+              import_picocolors20.default.dim(
                 "  This folder and Workser's copy have both changed. Open Workser to resolve it."
               )
             );
@@ -7599,7 +7845,7 @@ function registerSync(program3) {
           return;
         }
         success("Synced");
-        if (res?.ref) line(import_picocolors19.default.dim(`  ${String(res.ref).slice(0, 7)}`));
+        if (res?.ref) line(import_picocolors20.default.dim(`  ${String(res.ref).slice(0, 7)}`));
       });
       if (refused) process.exitCode = 1;
     })
@@ -7607,7 +7853,7 @@ function registerSync(program3) {
 }
 
 // src/commands/workflow.ts
-var import_picocolors20 = __toESM(require_picocolors(), 1);
+var import_picocolors21 = __toESM(require_picocolors(), 1);
 function registerWorkflow(program3) {
   const wf = program3.command("workflow").description("Create, run, and inspect workflow automations for the project");
   wf.command("list").description("List the project's workflows").action(
@@ -7615,10 +7861,10 @@ function registerWorkflow(program3) {
       const projectId = requireProject(ctx);
       const items = await api(ctx, `/v1/projects/${projectId}/workflows`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors20.default.dim("No workflows yet. `workser workflow create`."));
+        if (!items?.length) return line(import_picocolors21.default.dim("No workflows yet. `workser workflow create`."));
         for (const w of items) {
-          const status = w.is_active ? import_picocolors20.default.green("active") : import_picocolors20.default.dim("inactive");
-          line(`${w.id}  ${import_picocolors20.default.bold(w.name ?? "Untitled")}  ${status}`);
+          const status = w.is_active ? import_picocolors21.default.green("active") : import_picocolors21.default.dim("inactive");
+          line(`${w.id}  ${import_picocolors21.default.bold(w.name ?? "Untitled")}  ${status}`);
         }
       });
     })
@@ -7630,7 +7876,7 @@ function registerWorkflow(program3) {
       const res = await api(ctx, `/v1/projects/${projectId}/workflows`, {
         body: { name: args[0], ...extra }
       });
-      ok(res, () => line(`Created workflow ${import_picocolors20.default.bold(res.id)}.`));
+      ok(res, () => line(`Created workflow ${import_picocolors21.default.bold(res.id)}.`));
     })
   );
   wf.command("get <id>").description("Show a workflow's full definition").action(
@@ -7665,8 +7911,8 @@ function registerWorkflow(program3) {
     action(async ({ ctx, args }) => {
       const items = await api(ctx, `/v1/workflows/${args[0]}/executions`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors20.default.dim("No runs yet."));
-        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors20.default.dim(e.started_at ?? "")}`);
+        if (!items?.length) return line(import_picocolors21.default.dim("No runs yet."));
+        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors21.default.dim(e.started_at ?? "")}`);
       });
     })
   );
@@ -7674,15 +7920,15 @@ function registerWorkflow(program3) {
     action(async ({ ctx, args }) => {
       const items = await api(ctx, `/v1/node-types`, { query: { q: args[0] } });
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors20.default.dim("No matching node types."));
-        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors20.default.dim(n.category ?? "")}`);
+        if (!items?.length) return line(import_picocolors21.default.dim("No matching node types."));
+        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors21.default.dim(n.category ?? "")}`);
       });
     })
   );
 }
 
 // src/commands/connection.ts
-var import_picocolors21 = __toESM(require_picocolors(), 1);
+var import_picocolors22 = __toESM(require_picocolors(), 1);
 function registerConnection(program3) {
   const connection = program3.command("connection").description("Connect and use third-party app connections (Gmail, Slack, Stripe, ...)");
   connection.command("list").description("List connectable toolkits and this project's existing connections").option("--toolkit <slug>", "filter connections to one toolkit").action(
@@ -7695,8 +7941,8 @@ function registerConnection(program3) {
       ok({ catalog, connections }, () => {
         const connected = new Set((connections ?? []).map((c) => c.toolkit ?? c.composio_app));
         for (const t of catalog ?? []) {
-          const status = connected.has(t.slug) ? import_picocolors21.default.green("connected") : import_picocolors21.default.dim("not connected");
-          line(`${t.slug}  ${import_picocolors21.default.bold(t.name ?? t.slug)}  ${status}`);
+          const status = connected.has(t.slug) ? import_picocolors22.default.green("connected") : import_picocolors22.default.dim("not connected");
+          line(`${t.slug}  ${import_picocolors22.default.bold(t.name ?? t.slug)}  ${status}`);
         }
       });
     })
@@ -7708,9 +7954,9 @@ function registerConnection(program3) {
         query: { q: args[0], toolkit: opts.toolkit, limit: opts.limit }
       });
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors21.default.dim("No matching actions."));
+        if (!items?.length) return line(import_picocolors22.default.dim("No matching actions."));
         for (const t of items) {
-          line(`${t.slug}  ${import_picocolors21.default.dim(`[${t.toolkit}]`)}  ${t.description ?? ""}`);
+          line(`${t.slug}  ${import_picocolors22.default.dim(`[${t.toolkit}]`)}  ${t.description ?? ""}`);
         }
       });
     })
@@ -7727,7 +7973,7 @@ function registerConnection(program3) {
       });
       ok(
         res,
-        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors21.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
+        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors22.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
       );
     })
   );
@@ -7745,8 +7991,8 @@ function registerConnection(program3) {
       const projectId = requireProject(ctx);
       const items = await api(ctx, `/v1/projects/${projectId}/integrations/${args[0]}/tools`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors21.default.dim("No tools found."));
-        for (const t of items) line(`${t.slug}  ${import_picocolors21.default.dim(t.description ?? "")}`);
+        if (!items?.length) return line(import_picocolors22.default.dim("No tools found."));
+        for (const t of items) line(`${t.slug}  ${import_picocolors22.default.dim(t.description ?? "")}`);
       });
     })
   );
@@ -7762,7 +8008,7 @@ function registerConnection(program3) {
 }
 
 // src/commands/tool.ts
-var import_picocolors22 = __toESM(require_picocolors(), 1);
+var import_picocolors23 = __toESM(require_picocolors(), 1);
 function registerTool(program3) {
   const tool = program3.command("tool").description(
     "Computer-use tools: filesystem, shell, screenshot, input control, clipboard, notifications, basic browser"
@@ -7771,7 +8017,7 @@ function registerTool(program3) {
     action(async ({ ctx }) => {
       const tools = await api(ctx, "/v1/tool/list");
       ok(tools, () => {
-        if (!tools?.length) return line(import_picocolors22.default.dim("No tools available."));
+        if (!tools?.length) return line(import_picocolors23.default.dim("No tools available."));
         const byCategory = /* @__PURE__ */ new Map();
         for (const t of tools) {
           const list = byCategory.get(t.category) ?? [];
@@ -7779,9 +8025,9 @@ function registerTool(program3) {
           byCategory.set(t.category, list);
         }
         for (const [category, items] of byCategory) {
-          line(import_picocolors22.default.bold(category) + ":");
+          line(import_picocolors23.default.bold(category) + ":");
           for (const t of items) {
-            line(`  ${t.name}  ${import_picocolors22.default.dim(t.description ?? "")}`);
+            line(`  ${t.name}  ${import_picocolors23.default.dim(t.description ?? "")}`);
           }
         }
       });
@@ -7799,7 +8045,7 @@ function registerTool(program3) {
 }
 
 // src/commands/memory.ts
-var import_picocolors23 = __toESM(require_picocolors(), 1);
+var import_picocolors24 = __toESM(require_picocolors(), 1);
 function registerMemory(program3) {
   const memory = program3.command("memory").description("Durable, cross-conversation project memory (shared with cloud agents on the same project)");
   memory.command("add <content>").description("Store something worth remembering across future conversations").option("--metadata <json>", "extra metadata for filtering, as a JSON string").option("--id <customId>", "custom id for dedup/updates").action(
@@ -7823,9 +8069,9 @@ function registerMemory(program3) {
       });
       ok(res, () => {
         const results = res?.results ?? res ?? [];
-        if (!results?.length) return line(import_picocolors23.default.dim("No matching memories."));
+        if (!results?.length) return line(import_picocolors24.default.dim("No matching memories."));
         for (const r of results) {
-          line(`${import_picocolors23.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
+          line(`${import_picocolors24.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
         }
       });
     })
@@ -7841,8 +8087,52 @@ function registerMemory(program3) {
   );
 }
 
+// src/commands/note.ts
+var import_picocolors25 = __toESM(require_picocolors(), 1);
+function registerNote(program3) {
+  program3.command("note <text>").description("Leave a fact the rest of the team will need").addHelpText(
+    "after",
+    '\nFor things that are true about the WORK, not about your step:\n  workser note "the API base path is /api/v2, not /api"\n  workser note "added STRIPE_KEY to local, preview and production"\n\nWhat your own step did goes in `workser task done --summary` instead.\n'
+  ).option(
+    "--task <id>",
+    "the plan to leave it on (default: the plan this step belongs to)"
+  ).action(
+    action(async ({ ctx, args, opts }) => {
+      const text = typeof args[0] === "string" ? args[0].trim() : "";
+      if (!text) {
+        info("Nothing to note \u2014 give it a sentence.");
+        return;
+      }
+      const taskId = opts.task || ctx.parentTaskId || ctx.projectTaskId;
+      if (!taskId) {
+        info(
+          "No plan to leave this on. Run it from inside a step, or pass --task <id>."
+        );
+        return;
+      }
+      const res = await api(ctx, "/v1/team-notes", {
+        body: {
+          cwd: ctx.cwd,
+          taskId,
+          text,
+          role: ctx.agentRole,
+          agent: ctx.agentType
+        }
+      }).catch(() => null);
+      if (!res) {
+        info("Couldn't save that note \u2014 carrying on.");
+        return;
+      }
+      ok(res, () => {
+        success("Noted for the team.");
+        line(import_picocolors25.default.dim(`  ${text}`));
+      });
+    })
+  );
+}
+
 // src/commands/business.ts
-var import_picocolors24 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 var RESOURCE_PATHS = {
   "business-config": "business-config",
   "business-settings": "business-settings",
@@ -7902,7 +8192,7 @@ function registerBusiness(program3) {
       const projectId = requireProject(ctx);
       const [resource] = args;
       const res = await api(ctx, businessPath(projectId, resource), { body: JSON.parse(opts.body) });
-      ok(res, () => line(`Created ${resource} ${import_picocolors24.default.bold(res?.id ?? "")}.`));
+      ok(res, () => line(`Created ${resource} ${import_picocolors26.default.bold(res?.id ?? "")}.`));
     })
   );
   biz.command("update <resource> <id>").description("Update a record by id (PATCH/PUT \u2014 matches the underlying route)").option("--body <json>", "changed fields as a JSON object string", "{}").action(
@@ -7944,7 +8234,7 @@ function businessPath(projectId, resource, subpath) {
 }
 
 // src/commands/artifact.ts
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors27 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve3, basename as basename3 } from "path";
 var KINDS = [
@@ -8041,7 +8331,7 @@ function registerArtifact(program3) {
       ok(
         res,
         () => success(
-          `Recorded ${import_picocolors25.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors25.default.dim(` (${res.kind})`) : ""}`
+          `Recorded ${import_picocolors27.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors27.default.dim(` (${res.kind})`) : ""}`
         )
       );
     })
@@ -8073,13 +8363,13 @@ function registerArtifact(program3) {
   artifact.command("run").description("Show the task/conversation this agent run is attached to").action(
     action(async ({ ctx }) => {
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}`);
-      ok(res, () => printRun(res));
+      ok(res, () => printRun2(res));
     })
   );
 }
 function printArtifacts(rows) {
   if (!rows.length) {
-    line(import_picocolors25.default.dim("Nothing produced yet."));
+    line(import_picocolors27.default.dim("Nothing produced yet."));
     return;
   }
   const byStep = /* @__PURE__ */ new Map();
@@ -8089,26 +8379,26 @@ function printArtifacts(rows) {
     byStep.set(r.subtask_id, list);
   }
   for (const [stepId, items] of byStep) {
-    line(import_picocolors25.default.bold(`step ${stepId}`));
+    line(import_picocolors27.default.bold(`step ${stepId}`));
     for (const a of items) {
-      const flag = a.promoted_at ? import_picocolors25.default.green(" *") : "  ";
+      const flag = a.promoted_at ? import_picocolors27.default.green(" *") : "  ";
       const where = a.local_path || a.cloud_url || "";
       line(
-        `${flag} ${import_picocolors25.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors25.default.dim(`  ${where}`) : "")
+        `${flag} ${import_picocolors27.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors27.default.dim(`  ${where}`) : "")
       );
-      if (a.description) line(import_picocolors25.default.dim(`     ${a.description}`));
+      if (a.description) line(import_picocolors27.default.dim(`     ${a.description}`));
     }
     line("");
   }
-  line(import_picocolors25.default.dim("* = handed over as a deliverable; the rest is working material."));
+  line(import_picocolors27.default.dim("* = handed over as a deliverable; the rest is working material."));
 }
-function printRun(run) {
+function printRun2(run) {
   if (!run) return;
-  line(`  run      ${import_picocolors25.default.bold(run.runId)}`);
+  line(`  run      ${import_picocolors27.default.bold(run.runId)}`);
   if (run.taskId) line(`  task     ${run.taskId}`);
   if (run.conversationId) line(`  chat     ${run.conversationId}`);
   if (run.projectId) line(`  project  ${run.projectId}`);
-  if (run.cwd) line(`  folder   ${import_picocolors25.default.dim(run.cwd)}`);
+  if (run.cwd) line(`  folder   ${import_picocolors27.default.dim(run.cwd)}`);
 }
 
 // src/commands/image.ts
@@ -8289,7 +8579,7 @@ function registerAudio(program3) {
 }
 
 // src/commands/ask.ts
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __toESM(require_picocolors(), 1);
 var TYPES = [
   "input",
   "choice",
@@ -8367,7 +8657,7 @@ function registerAsk(program3) {
           code: "bad_request"
         });
       }
-      info(import_picocolors26.default.dim("Waiting for the user to answer\u2026"));
+      info(import_picocolors28.default.dim("Waiting for the user to answer\u2026"));
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}/ask`, {
         body: {
           type,
@@ -8395,12 +8685,12 @@ function deriveTitle(message) {
 function printAnswer(res) {
   if (!res) return;
   if (res.status === "answered") {
-    line(`  ${import_picocolors26.default.green("answered")}`);
+    line(`  ${import_picocolors28.default.green("answered")}`);
     const value = extract(res.response);
     if (value) line(`  ${value}`);
     return;
   }
-  line(`  ${import_picocolors26.default.yellow(res.status)}  ${import_picocolors26.default.dim(res.reason ?? "")}`);
+  line(`  ${import_picocolors28.default.yellow(res.status)}  ${import_picocolors28.default.dim(res.reason ?? "")}`);
 }
 function extract(response) {
   if (response == null) return "";
@@ -8419,7 +8709,7 @@ function extract(response) {
 }
 
 // src/commands/search.ts
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 function registerSearch(program3) {
   program3.command("search <query>").description("Search the web (Google-grounded, server-side)").option("-n, --max-results <n>", "max results", "5").action(
     action(async ({ ctx, args, opts }) => {
@@ -8432,9 +8722,9 @@ function registerSearch(program3) {
           line("");
         }
         const results = res?.results ?? [];
-        if (!results.length) return line(import_picocolors27.default.dim("No results."));
+        if (!results.length) return line(import_picocolors29.default.dim("No results."));
         for (const r of results) {
-          line(`${r.title || import_picocolors27.default.dim("(untitled)")}  ${import_picocolors27.default.dim(r.url)}`);
+          line(`${r.title || import_picocolors29.default.dim("(untitled)")}  ${import_picocolors29.default.dim(r.url)}`);
         }
       });
     })
@@ -8442,7 +8732,7 @@ function registerSearch(program3) {
 }
 
 // src/commands/board.ts
-var import_picocolors28 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __toESM(require_picocolors(), 1);
 
 // src/commands/record-step.ts
 async function recordEntityStep(ctx, opts) {
@@ -8481,7 +8771,7 @@ function registerBoard(program3) {
       }
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors28.default.dim("No cards on the Board yet."));
+          line(import_picocolors30.default.dim("No cards on the Board yet."));
           return;
         }
         for (const r of rows) line(formatRow(r));
@@ -8496,7 +8786,7 @@ function registerBoard(program3) {
         `/v1/projects/${projectId}/work-items/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.id)}`);
+        line(`${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.id)}`);
         line(`${statusTag(row.status)}  priority ${row.priority}`);
         if (row.ownerHuman) line(`owner: ${row.ownerHuman}`);
         if (row.labels?.length) line(`labels: ${row.labels.join(", ")}`);
@@ -8537,7 +8827,7 @@ ${row.description}`);
         refId: row?.id,
         output: { workItem: row }
       });
-      ok(row, () => line(`Created work item ${import_picocolors28.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created work item ${import_picocolors30.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   board.command("update <id>").description("Change fields on a card \u2014 pass only what changes").option("--title <text>", "new title").option("--description <text>", "new description").option("--status <value>", STATUSES.join(" | ")).option("--priority <value>", PRIORITIES.join(" | ")).option(
@@ -8571,7 +8861,7 @@ ${row.description}`);
         );
       }
       const row = await patchItem(ctx, projectId, String(args[0]), body);
-      ok(row, () => line(`Updated ${import_picocolors28.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
+      ok(row, () => line(`Updated ${import_picocolors30.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
     })
   );
   board.command("move <id> <status>").description(
@@ -8582,14 +8872,14 @@ ${row.description}`);
       const status = String(args[1]);
       assertStatus(status);
       const row = await patchItem(ctx, projectId, String(args[0]), { status });
-      ok(row, () => line(`Moved ${import_picocolors28.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
+      ok(row, () => line(`Moved ${import_picocolors30.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
     })
   );
   board.command("close <id>").description("Shorthand for `board move <id> done`").action(
     action(async ({ ctx, args }) => {
       const projectId = requireProject(ctx);
       const row = await patchItem(ctx, projectId, String(args[0]), { status: "done" });
-      ok(row, () => line(`Closed ${import_picocolors28.default.bold(row.title)} ${statusTag(row.status)}`));
+      ok(row, () => line(`Closed ${import_picocolors30.default.bold(row.title)} ${statusTag(row.status)}`));
     })
   );
 }
@@ -8622,23 +8912,23 @@ function assertPriority(value) {
   }
 }
 function formatRow(r) {
-  const labels = r.labels?.length ? import_picocolors28.default.dim(` [${r.labels.join(", ")}]`) : "";
-  const owner = r.ownerHuman ? import_picocolors28.default.dim(` @${r.ownerHuman}`) : "";
-  return `${import_picocolors28.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
+  const labels = r.labels?.length ? import_picocolors30.default.dim(` [${r.labels.join(", ")}]`) : "";
+  const owner = r.ownerHuman ? import_picocolors30.default.dim(` @${r.ownerHuman}`) : "";
+  return `${import_picocolors30.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
 }
 function statusTag(status) {
   const label = status.padEnd(11);
-  if (status === "done") return import_picocolors28.default.green(label);
-  if (status === "in-progress") return import_picocolors28.default.yellow(label);
-  if (status === "in-review") return import_picocolors28.default.cyan(label);
-  return import_picocolors28.default.dim(label);
+  if (status === "done") return import_picocolors30.default.green(label);
+  if (status === "in-progress") return import_picocolors30.default.yellow(label);
+  if (status === "in-review") return import_picocolors30.default.cyan(label);
+  return import_picocolors30.default.dim(label);
 }
 function collect2(value, previous) {
   return [...previous, value];
 }
 
 // src/commands/task.ts
-var import_picocolors29 = __toESM(require_picocolors(), 1);
+var import_picocolors31 = __toESM(require_picocolors(), 1);
 
 // src/subtask-attachments.ts
 var MAX_REF_NOTE = 500;
@@ -8752,7 +9042,7 @@ function registerTask(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors29.default.dim("No tasks on the board yet."));
+          line(import_picocolors31.default.dim("No tasks on the board yet."));
           return;
         }
         for (const r of rows) line(formatRow2(r));
@@ -8861,10 +9151,10 @@ function registerTask(program3) {
       };
       ok(result, () => {
         line(
-          `${import_picocolors29.default.green("opened")} ${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.key ?? row.id)}`
+          `${import_picocolors31.default.green("opened")} ${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`
         );
         if (channelMessage)
-          line(import_picocolors29.default.dim("posted to the channel as Project Manager"));
+          line(import_picocolors31.default.dim("posted to the channel as Project Manager"));
         if (channelMessageError) {
           warn(
             `Task opened, but its Project Manager card could not be posted: ${channelMessageError.message}`
@@ -8943,12 +9233,12 @@ function registerTask(program3) {
       ) : null;
       ok(runner ?? row, () => {
         line(
-          `${import_picocolors29.default.green("added")} ${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.key ?? row.id)}`
+          `${import_picocolors31.default.green("added")} ${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`
         );
-        if (row.role) line(import_picocolors29.default.dim(`role: ${row.role}`));
+        if (row.role) line(import_picocolors31.default.dim(`role: ${row.role}`));
         if (runner) {
           line(
-            import_picocolors29.default.dim(
+            import_picocolors31.default.dim(
               `runs on: ${[opts.agent, opts.model, opts.effort].filter(Boolean).join(" \xB7 ")}`
             )
           );
@@ -8966,7 +9256,7 @@ function registerTask(program3) {
       const rows = row.subtasks ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors29.default.dim("No subtasks yet."));
+          line(import_picocolors31.default.dim("No subtasks yet."));
           return;
         }
         rows.forEach((r, i) => line(formatSubtask(r, i + 1)));
@@ -9014,7 +9304,7 @@ function registerTask(program3) {
           }
         }
       );
-      ok(row, () => line(`${import_picocolors29.default.green("updated")} ${import_picocolors29.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors31.default.green("updated")} ${import_picocolors31.default.bold(row.title)}`));
     })
   );
   subtask.command("remove <id>").description("Remove a subtask (only before the work starts)").action(
@@ -9022,7 +9312,7 @@ function registerTask(program3) {
       await api(ctx, `/v1/project-tasks/${encodeURIComponent(args[0])}`, {
         method: "DELETE"
       });
-      ok({ removed: args[0] }, () => line(import_picocolors29.default.green("removed")));
+      ok({ removed: args[0] }, () => line(import_picocolors31.default.green("removed")));
     })
   );
   task.command("move <id> <status>").description(
@@ -9037,7 +9327,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors29.default.green("moved")} ${import_picocolors29.default.bold(row.title)} \u2192 ${args[1]}`)
+        () => line(`${import_picocolors31.default.green("moved")} ${import_picocolors31.default.bold(row.title)} \u2192 ${args[1]}`)
       );
     })
   );
@@ -9053,18 +9343,18 @@ function registerTask(program3) {
       );
       ok(row, () => {
         if (!row?.queued) {
-          line(import_picocolors29.default.yellow("could not resume it \u2014 check the step id"));
+          line(import_picocolors31.default.yellow("could not resume it \u2014 check the step id"));
           return;
         }
         const started = row.started ?? 0;
         if (started > 0) {
           line(
-            `${import_picocolors29.default.green("resumed")} \u2014 ${started} step${started === 1 ? "" : "s"} started`
+            `${import_picocolors31.default.green("resumed")} \u2014 ${started} step${started === 1 ? "" : "s"} started`
           );
           return;
         }
         line(
-          `${import_picocolors29.default.green("resumed")} \u2014 it is queued, but nothing started yet. Check the plan is approved and that no step is blocking the rest.`
+          `${import_picocolors31.default.green("resumed")} \u2014 it is queued, but nothing started yet. Check the plan is approved and that no step is blocking the rest.`
         );
       });
     })
@@ -9078,11 +9368,11 @@ function registerTask(program3) {
       );
       ok(row, () => {
         if (row?.reopened) {
-          line(`${import_picocolors29.default.green("sent back")} \u2014 it will be picked up again`);
+          line(`${import_picocolors31.default.green("sent back")} \u2014 it will be picked up again`);
           return;
         }
         line(
-          import_picocolors29.default.yellow(
+          import_picocolors31.default.yellow(
             row?.reason === "already_open" ? "already waiting to be picked up \u2014 nothing to send back" : row?.reason === "still_working" ? "still working \u2014 let it finish before sending it back" : "could not send that step back"
           )
         );
@@ -9099,7 +9389,7 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(id)}/dispatch-check`,
         { method: "POST" }
       );
-      ok(row, () => line(import_picocolors29.default.green("approved \u2014 you may start")));
+      ok(row, () => line(import_picocolors31.default.green("approved \u2014 you may start")));
     })
   );
   task.command("start [id]").description(
@@ -9114,13 +9404,13 @@ function registerTask(program3) {
         const started = row?.started ?? null;
         if (started && started > 0) {
           line(
-            import_picocolors29.default.green(
+            import_picocolors31.default.green(
               `started ${started} step${started === 1 ? "" : "s"} \u2014 they are running now`
             )
           );
           return;
         }
-        line(import_picocolors29.default.yellow(row?.note ?? "Nothing started."));
+        line(import_picocolors31.default.yellow(row?.note ?? "Nothing started."));
       });
     })
   );
@@ -9135,7 +9425,7 @@ function registerTask(program3) {
         );
         ok({ awaiting: row2.approval_state === "awaiting", task: row2 }, () => {
           line(
-            row2.approval_state === "awaiting" ? import_picocolors29.default.yellow(
+            row2.approval_state === "awaiting" ? import_picocolors31.default.yellow(
               "The plan is waiting on the owner. They see it in the task."
             ) : `Already ${row2.approval_state}.`
           );
@@ -9160,7 +9450,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors29.default.green(row.approval_state)} ${import_picocolors29.default.bold(row.title)}`)
+        () => line(`${import_picocolors31.default.green(row.approval_state)} ${import_picocolors31.default.bold(row.title)}`)
       );
     })
   );
@@ -9176,7 +9466,7 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(id)}/move`,
         { body: { status: "ready" } }
       );
-      ok(row, () => line(`${import_picocolors29.default.green("ready")} ${import_picocolors29.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors31.default.green("ready")} ${import_picocolors31.default.bold(row.title)}`));
     })
   );
 }
@@ -9221,24 +9511,24 @@ function assertOneOf(flag, value, allowed) {
   }
 }
 function formatRow2(r) {
-  const key = import_picocolors29.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
-  const steps = r.subtaskTotal ? import_picocolors29.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
-  const gate = r.approval_state === "awaiting" ? import_picocolors29.default.yellow(" awaiting approval") : "";
+  const key = import_picocolors31.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
+  const steps = r.subtaskTotal ? import_picocolors31.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
+  const gate = r.approval_state === "awaiting" ? import_picocolors31.default.yellow(" awaiting approval") : "";
   return `${key} ${statusTag2(r.status)} ${r.title}${steps}${gate}`;
 }
 function formatSubtask(r, index) {
-  const n = import_picocolors29.default.dim(String(index).padStart(2, "0"));
-  const role = r.role ? import_picocolors29.default.dim(` [${r.role}]`) : "";
-  const scope = r.scope_paths?.length ? import_picocolors29.default.dim(`  owns: ${r.scope_paths.join(", ")}`) : "";
+  const n = import_picocolors31.default.dim(String(index).padStart(2, "0"));
+  const role = r.role ? import_picocolors31.default.dim(` [${r.role}]`) : "";
+  const scope = r.scope_paths?.length ? import_picocolors31.default.dim(`  owns: ${r.scope_paths.join(", ")}`) : "";
   const head = `${n} ${statusTag2(r.status)} ${r.title}${role}${scope}`;
   const summary = (r.result_summary ?? "").trim();
   if (!summary) return head;
   const wrapped = summary.split("\n").map((l) => `      ${l}`).join("\n");
   return `${head}
-${import_picocolors29.default.dim(wrapped)}`;
+${import_picocolors31.default.dim(wrapped)}`;
 }
 function printTask(row, goal) {
-  line(`${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.key ?? row.id)}`);
+  line(`${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`);
   line(`${statusTag2(row.status)}  approval: ${row.approval_state}`);
   if (row.summary) line(`
 ${row.summary}`);
@@ -9251,53 +9541,53 @@ touches: ${row.targets.map((t) => t.appName ?? t.ref ?? t.kind).join(", ")}`
   }
   if (row.subtasks?.length) {
     line(`
-${import_picocolors29.default.bold("subtasks")}`);
+${import_picocolors31.default.bold("subtasks")}`);
     row.subtasks.forEach((s, i) => line(formatSubtask(s, i + 1)));
     line(
-      import_picocolors29.default.dim(
+      import_picocolors31.default.dim(
         `
 Run \`workser artifact list\` to see what these subtasks produced,`
       )
     );
     line(
-      import_picocolors29.default.dim(
+      import_picocolors31.default.dim(
         `or \`workser artifact list --step <id>\` for one subtask's output alone.`
       )
     );
   } else {
-    line(import_picocolors29.default.dim("\nNo subtasks yet."));
+    line(import_picocolors31.default.dim("\nNo subtasks yet."));
   }
 }
 function printGoalContext(row, goal) {
   const mine = row.phase ?? null;
   line(`
-${import_picocolors29.default.bold("part of")}: ${goal.title}`);
-  if (goal.outcome) line(import_picocolors29.default.dim(`done means: ${goal.outcome}`));
+${import_picocolors31.default.bold("part of")}: ${goal.title}`);
+  if (goal.outcome) line(import_picocolors31.default.dim(`done means: ${goal.outcome}`));
   const progress = goal.progress ?? [];
   for (const p of progress) {
     const where = p.total === 0 ? "not started" : `${p.done} of ${p.total} done`;
-    const here = mine && p.name === mine ? import_picocolors29.default.cyan("  <- this task") : "";
-    const mark = p.state === "done" ? import_picocolors29.default.green("*") : import_picocolors29.default.dim("-");
+    const here = mine && p.name === mine ? import_picocolors31.default.cyan("  <- this task") : "";
+    const mark = p.state === "done" ? import_picocolors31.default.green("*") : import_picocolors31.default.dim("-");
     line(`  ${mark} ${p.name} \u2014 ${where}${here}`);
   }
   const next = progress.find((p) => p.state !== "done");
   const running = progress.some((p) => p.state === "working");
   if (next && !running) {
     line(
-      import_picocolors29.default.dim(
+      import_picocolors31.default.dim(
         `
 Nothing is running. The next part waiting is "${next.name}" \u2014 offer it to them in a sentence rather than starting it unasked.`
       )
     );
   } else if (!next) {
     line(
-      import_picocolors29.default.dim(
+      import_picocolors31.default.dim(
         "\nEvery part of this plan is done. Say so, and offer to wrap it up."
       )
     );
   }
   line(
-    import_picocolors29.default.dim(
+    import_picocolors31.default.dim(
       "The plan is a reference for what was agreed, not a rule about what may run. Work can start on any part at any time if they ask for it."
     )
   );
@@ -9305,22 +9595,22 @@ Nothing is running. The next part waiting is "${next.name}" \u2014 offer it to t
 function statusTag2(status) {
   switch (status) {
     case "ready":
-      return import_picocolors29.default.green("[ready]");
+      return import_picocolors31.default.green("[ready]");
     case "working":
-      return import_picocolors29.default.blue("[working]");
+      return import_picocolors31.default.blue("[working]");
     case "checking":
-      return import_picocolors29.default.cyan("[checking]");
+      return import_picocolors31.default.cyan("[checking]");
     case "accepted":
-      return import_picocolors29.default.green("[accepted]");
+      return import_picocolors31.default.green("[accepted]");
     case "archived":
-      return import_picocolors29.default.dim("[archived]");
+      return import_picocolors31.default.dim("[archived]");
     default:
-      return import_picocolors29.default.dim("[todo]");
+      return import_picocolors31.default.dim("[todo]");
   }
 }
 
 // src/commands/goal.ts
-var import_picocolors30 = __toESM(require_picocolors(), 1);
+var import_picocolors32 = __toESM(require_picocolors(), 1);
 var STATUSES3 = ["proposed", "agreed", "working", "delivered", "abandoned"];
 function registerGoal(program3) {
   const goal = program3.command("goal").description("Business goals and the phases that deliver them");
@@ -9332,7 +9622,7 @@ function registerGoal(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors30.default.dim("No goals yet \u2014 every task here stands on its own."));
+          line(import_picocolors32.default.dim("No goals yet \u2014 every task here stands on its own."));
           return;
         }
         for (const g of rows) line(formatGoal(g));
@@ -9409,10 +9699,10 @@ function registerGoal(program3) {
         }
       });
       ok(row, () => {
-        success(`Proposed ${import_picocolors30.default.bold(row?.title ?? "goal")}`);
+        success(`Proposed ${import_picocolors32.default.bold(row?.title ?? "goal")}`);
         printGoal(row);
         line(
-          import_picocolors30.default.dim(
+          import_picocolors32.default.dim(
             "\nNothing has been created yet. The owner agrees the shape first."
           )
         );
@@ -9441,7 +9731,7 @@ function registerGoal(program3) {
       ok(
         row,
         () => line(
-          row?.recorded ? met === true ? import_picocolors30.default.green("recorded \u2014 met") : met === false ? import_picocolors30.default.yellow("recorded \u2014 not met") : import_picocolors30.default.dim("recorded \u2014 back to unchecked") : import_picocolors30.default.yellow(
+          row?.recorded ? met === true ? import_picocolors32.default.green("recorded \u2014 met") : met === false ? import_picocolors32.default.yellow("recorded \u2014 not met") : import_picocolors32.default.dim("recorded \u2014 back to unchecked") : import_picocolors32.default.yellow(
             "couldn't record it \u2014 check the goal id, the phase name and the criterion id"
           )
         )
@@ -9484,7 +9774,7 @@ function registerGoal(program3) {
       }
       ok({ goalId, phase, filed }, () => {
         success(
-          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors30.default.bold(phase)}`
+          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors32.default.bold(phase)}`
         );
       });
     })
@@ -9516,42 +9806,42 @@ function registerGoal(program3) {
 function appScope(g) {
   const n = g.appIds?.length ?? 0;
   if (!n) return "";
-  return import_picocolors30.default.dim(`  ${n} part${n === 1 ? "" : "s"} of the system`);
+  return import_picocolors32.default.dim(`  ${n} part${n === 1 ? "" : "s"} of the system`);
 }
 function formatGoal(g) {
-  const where = g.currentPhase && g.status !== "delivered" ? import_picocolors30.default.dim(`  now: ${g.currentPhase}`) : "";
-  const count = g.taskTotal != null ? import_picocolors30.default.dim(`  ${g.taskDone}/${g.taskTotal} done`) : "";
-  return `${statusTag3(g.status)} ${g.title}${appScope(g)}${where}${count}  ${import_picocolors30.default.dim(g.id)}`;
+  const where = g.currentPhase && g.status !== "delivered" ? import_picocolors32.default.dim(`  now: ${g.currentPhase}`) : "";
+  const count = g.taskTotal != null ? import_picocolors32.default.dim(`  ${g.taskDone}/${g.taskTotal} done`) : "";
+  return `${statusTag3(g.status)} ${g.title}${appScope(g)}${where}${count}  ${import_picocolors32.default.dim(g.id)}`;
 }
 function printGoal(g) {
   if (!g) return;
-  line(`${import_picocolors30.default.bold(g.title)}  ${import_picocolors30.default.dim(g.id)}`);
+  line(`${import_picocolors32.default.bold(g.title)}  ${import_picocolors32.default.dim(g.id)}`);
   line(statusTag3(g.status));
   if (g.outcome) line(`
 done means: ${g.outcome}`);
   const progress = g.progress ?? [];
   if (!progress.length) {
-    line(import_picocolors30.default.dim("\nNo phases agreed yet."));
+    line(import_picocolors32.default.dim("\nNo phases agreed yet."));
     return;
   }
   line(`
-${import_picocolors30.default.bold("phases")}`);
+${import_picocolors32.default.bold("phases")}`);
   for (const p of progress) {
-    const bar2 = p.total > 0 ? `${p.done}/${p.total} done` : import_picocolors30.default.dim("nothing filed yet");
-    const mark = p.state === "done" ? import_picocolors30.default.green("done") : p.state === "working" ? import_picocolors30.default.blue("working") : import_picocolors30.default.dim("waiting");
+    const bar2 = p.total > 0 ? `${p.done}/${p.total} done` : import_picocolors32.default.dim("nothing filed yet");
+    const mark = p.state === "done" ? import_picocolors32.default.green("done") : p.state === "working" ? import_picocolors32.default.blue("working") : import_picocolors32.default.dim("waiting");
     line(
-      `  ${import_picocolors30.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors30.default.dim(bar2)}`
+      `  ${import_picocolors32.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors32.default.dim(bar2)}`
     );
     for (const c of p.criteria ?? []) {
-      const tick = c.met === true ? import_picocolors30.default.green("\u2713") : c.met === false ? import_picocolors30.default.red("\u2717") : import_picocolors30.default.dim("\xB7");
-      line(`       ${tick} ${c.text}  ${import_picocolors30.default.dim(c.id)}`);
-      if (c.note) line(import_picocolors30.default.dim(`         ${c.note}`));
+      const tick = c.met === true ? import_picocolors32.default.green("\u2713") : c.met === false ? import_picocolors32.default.red("\u2717") : import_picocolors32.default.dim("\xB7");
+      line(`       ${tick} ${c.text}  ${import_picocolors32.default.dim(c.id)}`);
+      if (c.note) line(import_picocolors32.default.dim(`         ${c.note}`));
     }
   }
   const current = progress.find((p) => p.name === g.currentPhase);
   if (current) {
     line(
-      import_picocolors30.default.dim(
+      import_picocolors32.default.dim(
         `
 ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current.index} of ${progress.length}).`
       )
@@ -9561,15 +9851,15 @@ ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current
 function statusTag3(status) {
   switch (status) {
     case "agreed":
-      return import_picocolors30.default.cyan("[agreed]");
+      return import_picocolors32.default.cyan("[agreed]");
     case "working":
-      return import_picocolors30.default.blue("[working]");
+      return import_picocolors32.default.blue("[working]");
     case "delivered":
-      return import_picocolors30.default.green("[delivered]");
+      return import_picocolors32.default.green("[delivered]");
     case "abandoned":
-      return import_picocolors30.default.dim("[abandoned]");
+      return import_picocolors32.default.dim("[abandoned]");
     default:
-      return import_picocolors30.default.yellow("[proposed]");
+      return import_picocolors32.default.yellow("[proposed]");
   }
 }
 
@@ -9622,7 +9912,15 @@ var READS = [
   // have `create` subcommands — these write the project's RECORD, not the
   // project. What stops a reviewer editing code is its filesystem mode, and
   // that is untouched.
-  "artifact"
+  "artifact",
+  // LEAVING A FACT FOR THE TEAM IS NOT CHANGING THE PROJECT — the same
+  // argument as `artifact` directly above, and it belongs in READS rather than
+  // BUILDS on purpose. The roles that DISCOVER things are the reading ones: a
+  // tester that found the real cause, an analyst that found the actual column
+  // name, a security engineer that found where a key is read from. A shared
+  // memory only builders could write to would be missing most of what is worth
+  // sharing. See the daemon's `team-memory.ts`.
+  "note"
 ];
 var BUILDS = [
   ...READS,
@@ -9642,6 +9940,7 @@ var BUILDS = [
 ];
 var ROLE_VERBS = {
   pm: [...READS, "ask", "app"],
+  // `note` reaches this via READS.
   architect: [...BUILDS, "versions"],
   web: BUILDS,
   api: BUILDS,
@@ -9744,7 +10043,7 @@ function stripLeadingGlobalOptions(argv) {
 }
 
 // src/commands/decision.ts
-var import_picocolors31 = __toESM(require_picocolors(), 1);
+var import_picocolors33 = __toESM(require_picocolors(), 1);
 function registerDecision(program3) {
   const decision = program3.command("decision").description("Read and record the project's architecture decisions");
   decision.command("list").description("Every decision on record \u2014 read this before changing how something works").option("--limit <n>", "cap the number returned (newest first)").action(
@@ -9757,11 +10056,11 @@ function registerDecision(program3) {
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors31.default.dim("No decisions recorded yet."));
+          line(import_picocolors33.default.dim("No decisions recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors31.default.dim(r.id)}  ${import_picocolors31.default.dim(shortDate(r.createdAt))}  ${r.title}`);
+          line(`${import_picocolors33.default.dim(r.id)}  ${import_picocolors33.default.dim(shortDate(r.createdAt))}  ${r.title}`);
           line(`    ${truncate(r.decision, 100)}`);
         }
       });
@@ -9775,16 +10074,16 @@ function registerDecision(program3) {
         `/v1/projects/${projectId}/architecture-decisions/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.id)}`);
-        line(import_picocolors31.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+        line(import_picocolors33.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
-${import_picocolors31.default.bold("Context")}
+${import_picocolors33.default.bold("Context")}
 ${row.context}`);
         line(`
-${import_picocolors31.default.bold("Decision")}
+${import_picocolors33.default.bold("Decision")}
 ${row.decision}`);
         if (row.consequences) line(`
-${import_picocolors31.default.bold("Consequences")}
+${import_picocolors33.default.bold("Consequences")}
 ${row.consequences}`);
       });
     })
@@ -9813,7 +10112,7 @@ ${row.consequences}`);
         refId: row?.id,
         output: { decision: row }
       });
-      ok(row, () => line(`Recorded decision ${import_picocolors31.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded decision ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   const requirement = program3.command("requirement").description("Read and record the project's requirements");
@@ -9825,11 +10124,11 @@ ${row.consequences}`);
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors31.default.dim("No requirements recorded yet."));
+          line(import_picocolors33.default.dim("No requirements recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors31.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
+          line(`${import_picocolors33.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
         }
       });
     })
@@ -9842,8 +10141,8 @@ ${row.consequences}`);
         `/v1/projects/${projectId}/requirements/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.id)}`);
-        line(import_picocolors31.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+        line(import_picocolors33.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
 ${row.body}`);
       });
@@ -9869,7 +10168,7 @@ ${row.body}`);
         refId: row?.id,
         output: { requirement: row }
       });
-      ok(row, () => line(`Recorded requirement ${import_picocolors31.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded requirement ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   requirement.command("update <id>").description(
@@ -9898,7 +10197,7 @@ ${row.body}`);
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated requirement ${import_picocolors31.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
+      ok(row, () => line(`Updated requirement ${import_picocolors33.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
     })
   );
 }
@@ -9921,7 +10220,7 @@ function shortDate(iso) {
 }
 
 // src/commands/doc.ts
-var import_picocolors32 = __toESM(require_picocolors(), 1);
+var import_picocolors34 = __toESM(require_picocolors(), 1);
 
 // src/mermaid-fences.ts
 function hasDiagram(code) {
@@ -9966,13 +10265,13 @@ function registerDoc(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors32.default.dim("No documents yet."));
+          line(import_picocolors34.default.dim("No documents yet."));
           return;
         }
         for (const r of rows) {
-          const link = r.workItemId ? import_picocolors32.default.dim(` \u21B3 ${r.workItemId}`) : "";
-          const file = r.filePath ? import_picocolors32.default.dim(`  ${r.filePath}`) : "";
-          line(`${import_picocolors32.default.dim(r.id)}  ${r.title}${link}${file}`);
+          const link = r.workItemId ? import_picocolors34.default.dim(` \u21B3 ${r.workItemId}`) : "";
+          const file = r.filePath ? import_picocolors34.default.dim(`  ${r.filePath}`) : "";
+          line(`${import_picocolors34.default.dim(r.id)}  ${r.title}${link}${file}`);
         }
       });
     })
@@ -9986,17 +10285,17 @@ function registerDoc(program3) {
       );
       if (opts.markdown) {
         ok({ id: row.id, title: row.title, filePath: row.filePath }, () => {
-          line(`${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
+          line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
           line(
-            row.filePath ? `Read it at ${import_picocolors32.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors32.default.dim("This document has no markdown mirror on disk yet.")
+            row.filePath ? `Read it at ${import_picocolors34.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors34.default.dim("This document has no markdown mirror on disk yet.")
           );
         });
         return;
       }
       ok(row, () => {
-        line(`${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
-        if (row.workItemId) line(import_picocolors32.default.dim(`linked to work item ${row.workItemId}`));
-        if (row.filePath) line(import_picocolors32.default.dim(`markdown mirror: ${row.filePath}`));
+        line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
+        if (row.workItemId) line(import_picocolors34.default.dim(`linked to work item ${row.workItemId}`));
+        if (row.filePath) line(import_picocolors34.default.dim(`markdown mirror: ${row.filePath}`));
         line("");
         line(row.contentJson);
       });
@@ -10025,7 +10324,7 @@ function registerDoc(program3) {
         refId: row?.id,
         output: { document: row }
       });
-      ok(row, () => line(`Created document ${import_picocolors32.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created document ${import_picocolors34.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   doc.command("diagram <id>").description(
@@ -10051,19 +10350,19 @@ function registerDoc(program3) {
         diagrams: diagrams.map((code) => ({ kind: diagramKind(code), code }))
       };
       ok(payload, () => {
-        line(`${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
+        line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
         if (markdown === null) {
           line(
-            import_picocolors32.default.dim(
+            import_picocolors34.default.dim(
               row.filePath ? `Could not read ${row.filePath} from this folder.` : "This document has no markdown mirror on disk yet."
             )
           );
         } else if (!diagrams.length) {
-          line(import_picocolors32.default.dim("No diagrams in this document."));
+          line(import_picocolors34.default.dim("No diagrams in this document."));
         } else {
           for (const [i, code] of diagrams.entries()) {
             const kind = diagramKind(code) ?? "diagram";
-            line(`${import_picocolors32.default.dim(String(i + 1))}  ${kind}  ${import_picocolors32.default.dim(`${code.split("\n").length} lines`)}`);
+            line(`${import_picocolors34.default.dim(String(i + 1))}  ${kind}  ${import_picocolors34.default.dim(`${code.split("\n").length} lines`)}`);
           }
         }
       });
@@ -10099,7 +10398,7 @@ function registerDoc(program3) {
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated document ${import_picocolors32.default.bold(row.id)} \u2014 ${row.title}`));
+      ok(row, () => line(`Updated document ${import_picocolors34.default.bold(row.id)} \u2014 ${row.title}`));
     })
   );
 }
@@ -10113,7 +10412,7 @@ function readMirror(cwd, filePath) {
 }
 
 // src/commands/design.ts
-var import_picocolors33 = __toESM(require_picocolors(), 1);
+var import_picocolors35 = __toESM(require_picocolors(), 1);
 function registerDesign(program3) {
   const design = program3.command("design").description("Read the project's brand (colours, fonts, logo)");
   design.command("show").description("Show this project's brand \u2014 read it before writing any UI").option("--raw", "print the generated token files verbatim instead of a summary").action(
@@ -10127,11 +10426,11 @@ function registerDesign(program3) {
       if (opts.raw) {
         ok(files, () => {
           if (!files.length) {
-            line(import_picocolors33.default.dim("No brand set for this project."));
+            line(import_picocolors35.default.dim("No brand set for this project."));
             return;
           }
           for (const f of files) {
-            line(import_picocolors33.default.bold(f.path));
+            line(import_picocolors35.default.bold(f.path));
             line(f.contents);
             line("");
           }
@@ -10148,21 +10447,21 @@ function registerDesign(program3) {
       } : { hasBrand: false, colors: {}, fonts: {}, brand: {}, files: [] };
       ok(summary, () => {
         if (!tokens) {
-          line(import_picocolors33.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
+          line(import_picocolors35.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
           return;
         }
         for (const [name, value] of Object.entries(tokens.brand)) {
-          line(`${import_picocolors33.default.dim(name.padEnd(12))} ${value}`);
+          line(`${import_picocolors35.default.dim(name.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.color)) {
-          line(`${import_picocolors33.default.dim(`color.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors35.default.dim(`color.${name}`.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.font)) {
-          line(`${import_picocolors33.default.dim(`font.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors35.default.dim(`font.${name}`.padEnd(12))} ${value}`);
         }
         line("");
         line(
-          import_picocolors33.default.dim(
+          import_picocolors35.default.dim(
             `Generated into the working tree as ${files.map((f) => f.path).join(", ")} \u2014 wire those in, never edit them.`
           )
         );
@@ -10193,7 +10492,7 @@ function unwrap(group) {
 }
 
 // src/commands/api.ts
-var import_picocolors34 = __toESM(require_picocolors(), 1);
+var import_picocolors36 = __toESM(require_picocolors(), 1);
 import { readdirSync, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { join as join3, relative, sep } from "path";
 
@@ -10307,10 +10606,10 @@ function registerApi(program3) {
       const appId = requireApp2(opts.app);
       const res = await api(ctx, `/v1/apps/${encodeURIComponent(appId)}/api/requests`);
       ok(res, () => {
-        for (const note of res?.notes ?? []) line(import_picocolors34.default.dim(note));
+        for (const note of res?.notes ?? []) line(import_picocolors36.default.dim(note));
         for (const r of res?.requests ?? []) {
           line(
-            `${import_picocolors34.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors34.default.dim(`  ${r.note}`) : ""}`
+            `${import_picocolors36.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors36.default.dim(`  ${r.note}`) : ""}`
           );
         }
       });
@@ -10344,14 +10643,14 @@ function registerApi(program3) {
       );
       ok(res, () => {
         if (!res?.ok) {
-          line(import_picocolors34.default.red(res?.error ?? "The service did not answer."));
+          line(import_picocolors36.default.red(res?.error ?? "The service did not answer."));
           return;
         }
         const code = `${res.status}${res.statusText ? ` ${res.statusText}` : ""}`;
-        const colour2 = res.status && res.status < 300 ? import_picocolors34.default.green : res.status && res.status < 500 ? import_picocolors34.default.yellow : import_picocolors34.default.red;
-        line(`${colour2(code)}  ${import_picocolors34.default.dim(`${res.durationMs}ms  ${res.url}`)}`);
+        const colour2 = res.status && res.status < 300 ? import_picocolors36.default.green : res.status && res.status < 500 ? import_picocolors36.default.yellow : import_picocolors36.default.red;
+        line(`${colour2(code)}  ${import_picocolors36.default.dim(`${res.durationMs}ms  ${res.url}`)}`);
         if (res.body) line(res.body);
-        if (res.truncated) line(import_picocolors34.default.dim("(answer truncated)"));
+        if (res.truncated) line(import_picocolors36.default.dim("(answer truncated)"));
       });
       if (!res?.ok) process.exitCode = 1;
     })
@@ -10371,15 +10670,15 @@ function registerApi(program3) {
         for (const r of report.routes) {
           const known = report.missing.some((m) => m.path === r.path);
           line(
-            `${known ? import_picocolors34.default.yellow("undocumented") : import_picocolors34.default.green("documented  ")}  ${r.path}${import_picocolors34.default.dim(`  ${r.file}`)}`
+            `${known ? import_picocolors36.default.yellow("undocumented") : import_picocolors36.default.green("documented  ")}  ${r.path}${import_picocolors36.default.dim(`  ${r.file}`)}`
           );
         }
         for (const p of report.stale) {
-          line(`${import_picocolors34.default.dim("in spec only ")}  ${p}`);
+          line(`${import_picocolors36.default.dim("in spec only ")}  ${p}`);
         }
         line("");
         if (report.ok && specFile) success(summary);
-        else line(import_picocolors34.default.yellow(summary));
+        else line(import_picocolors36.default.yellow(summary));
       });
       if (opts.check && !report.ok) {
         throw new WorkserError(summary, { code: "bad_request" });
@@ -10450,7 +10749,7 @@ function listRepoFiles(root, maxDepth = 8) {
 }
 
 // src/commands/analysis.ts
-var import_picocolors35 = __toESM(require_picocolors(), 1);
+var import_picocolors37 = __toESM(require_picocolors(), 1);
 import { readFileSync as readFileSync4 } from "fs";
 function registerAnalysis(program3) {
   const cmd = program3.command("analysis").description("Run Python analysis locally, recorded in the task");
@@ -10460,14 +10759,14 @@ function registerAnalysis(program3) {
       const res = await api(ctx, path);
       ok(res, () => {
         line(
-          `${res?.available ? import_picocolors35.default.green("python") : import_picocolors35.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors35.default.dim(res?.python ?? "")}`
+          `${res?.available ? import_picocolors37.default.green("python") : import_picocolors37.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors37.default.dim(res?.python ?? "")}`
         );
         for (const lib of res?.libraries ?? []) {
           line(
-            `${lib.present ? import_picocolors35.default.green(lib.name) : import_picocolors35.default.yellow(lib.name)}${import_picocolors35.default.dim(lib.present ? "" : "  missing")}`
+            `${lib.present ? import_picocolors37.default.green(lib.name) : import_picocolors37.default.yellow(lib.name)}${import_picocolors37.default.dim(lib.present ? "" : "  missing")}`
           );
         }
-        for (const note of res?.notes ?? []) line(import_picocolors35.default.dim(note));
+        for (const note of res?.notes ?? []) line(import_picocolors37.default.dim(note));
       });
       if (!res?.available) process.exitCode = 1;
     })
@@ -10489,15 +10788,15 @@ function registerAnalysis(program3) {
       );
       ok(res, () => {
         if (res?.stdout) line(res.stdout.replace(/\n$/, ""));
-        if (res?.stderr) line(import_picocolors35.default.dim(res.stderr.replace(/\n$/, "")));
-        if (res?.truncated) line(import_picocolors35.default.dim("(output truncated)"));
+        if (res?.stderr) line(import_picocolors37.default.dim(res.stderr.replace(/\n$/, "")));
+        if (res?.truncated) line(import_picocolors37.default.dim("(output truncated)"));
         const took = `${Math.round((res?.durationMs ?? 0) / 100) / 10}s`;
         line(
-          res?.ok ? import_picocolors35.default.green(`\u2713 ${res.summary ?? "It finished."}`) + import_picocolors35.default.dim(`  ${took}`) : import_picocolors35.default.yellow(res?.summary ?? "It did not finish.") + import_picocolors35.default.dim(`  ${took}`)
+          res?.ok ? import_picocolors37.default.green(`\u2713 ${res.summary ?? "It finished."}`) + import_picocolors37.default.dim(`  ${took}`) : import_picocolors37.default.yellow(res?.summary ?? "It did not finish.") + import_picocolors37.default.dim(`  ${took}`)
         );
         if (res && !res.sandboxed) {
           line(
-            import_picocolors35.default.dim(
+            import_picocolors37.default.dim(
               "This platform has no OS sandbox, so the script ran with your own file access."
             )
           );
@@ -10525,7 +10824,7 @@ function readCode(file, inline) {
 }
 
 // src/commands/scan.ts
-var import_picocolors36 = __toESM(require_picocolors(), 1);
+var import_picocolors38 = __toESM(require_picocolors(), 1);
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync3, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync3 } from "fs";
 import { join as join4, relative as relative2, sep as sep2 } from "path";
@@ -10809,22 +11108,22 @@ function runPermissions(cwd, findings, checked, skipped) {
 }
 function print2(report, summary) {
   for (const s of report.skipped) {
-    line(`${import_picocolors36.default.yellow("not checked")}  ${s.check}${import_picocolors36.default.dim(` \u2014 ${s.reason}`)}`);
+    line(`${import_picocolors38.default.yellow("not checked")}  ${s.check}${import_picocolors38.default.dim(` \u2014 ${s.reason}`)}`);
   }
   for (const f of report.findings) {
-    const where = f.file ? import_picocolors36.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
+    const where = f.file ? import_picocolors38.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
     line(`${severityTag(f.severity)}  ${f.title}${where}`);
-    line(`             ${import_picocolors36.default.dim(f.fix)}`);
+    line(`             ${import_picocolors38.default.dim(f.fix)}`);
   }
   if (report.findings.length || report.skipped.length) line("");
   if (report.ok && !report.skipped.length) success(summary);
-  else if (report.ok) line(import_picocolors36.default.yellow(summary));
-  else line(import_picocolors36.default.red(summary));
+  else if (report.ok) line(import_picocolors38.default.yellow(summary));
+  else line(import_picocolors38.default.red(summary));
 }
 function severityTag(severity) {
-  if (severity === "high") return import_picocolors36.default.red("serious    ");
-  if (severity === "medium") return import_picocolors36.default.yellow("worth fixing");
-  return import_picocolors36.default.dim("minor      ");
+  if (severity === "high") return import_picocolors38.default.red("serious    ");
+  if (severity === "medium") return import_picocolors38.default.yellow("worth fixing");
+  return import_picocolors38.default.dim("minor      ");
 }
 function git(cwd, args) {
   try {
@@ -10885,7 +11184,7 @@ function listRepoFiles2(root, maxDepth = 8) {
 }
 
 // src/commands/health.ts
-var import_picocolors37 = __toESM(require_picocolors(), 1);
+var import_picocolors39 = __toESM(require_picocolors(), 1);
 function registerHealth(program3) {
   program3.command("health").description("Check that the published apps in this project are still answering").option("--app <webAppId>", "check one app rather than all of them").action(
     action(async ({ ctx, opts }) => {
@@ -10899,16 +11198,16 @@ function registerHealth(program3) {
 }
 function print3(res) {
   if (!res?.checks?.length) {
-    line(import_picocolors37.default.dim(res?.note ?? "Nothing to check."));
+    line(import_picocolors39.default.dim(res?.note ?? "Nothing to check."));
     return;
   }
   for (const c of res.checks) {
-    const mark = c.ok ? import_picocolors37.default.green("up  ") : import_picocolors37.default.red("down");
-    const timing = import_picocolors37.default.dim(`${c.ms}ms`);
-    const detail = c.ok ? timing : import_picocolors37.default.dim(`${c.error ?? "no answer"}${c.failures > 1 ? ` \xB7 ${c.failures} in a row` : ""}`);
-    line(`  ${mark}  ${c.appName} ${import_picocolors37.default.dim(`(${c.environment})`)}  ${c.url}  ${detail}`);
+    const mark = c.ok ? import_picocolors39.default.green("up  ") : import_picocolors39.default.red("down");
+    const timing = import_picocolors39.default.dim(`${c.ms}ms`);
+    const detail = c.ok ? timing : import_picocolors39.default.dim(`${c.error ?? "no answer"}${c.failures > 1 ? ` \xB7 ${c.failures} in a row` : ""}`);
+    line(`  ${mark}  ${c.appName} ${import_picocolors39.default.dim(`(${c.environment})`)}  ${c.url}  ${detail}`);
     if (c.incidentOpened) {
-      line(import_picocolors37.default.yellow(`        An incident has been opened on the board for this.`));
+      line(import_picocolors39.default.yellow(`        An incident has been opened on the board for this.`));
     }
   }
   const down = res.checks.filter((c) => !c.ok);
@@ -10921,14 +11220,14 @@ function print3(res) {
   }
   const production = down.filter((c) => c.environment === "production").length;
   line(
-    import_picocolors37.default.red(
+    import_picocolors39.default.red(
       `${down.length} of ${res.checks.length} not answering` + (production ? ` \u2014 ${production} customer-facing.` : " (preview only).")
     )
   );
 }
 
 // src/commands/urls.ts
-var import_picocolors38 = __toESM(require_picocolors(), 1);
+var import_picocolors40 = __toESM(require_picocolors(), 1);
 function registerUrls(program3) {
   program3.command("urls").description("The stable preview and production addresses of every app in this project").option("--app <webAppId>", "just one app").action(
     action(async ({ ctx, opts }) => {
@@ -10942,20 +11241,20 @@ function registerUrls(program3) {
       const summary = urlsSummary(rows);
       ok({ rows, summary }, () => {
         for (const row of rows) {
-          const label = import_picocolors38.default.dim(row.environment.padEnd(10));
-          const value = row.url ? import_picocolors38.default.cyan(row.url) : import_picocolors38.default.dim(row.note ?? "not published");
+          const label = import_picocolors40.default.dim(row.environment.padEnd(10));
+          const value = row.url ? import_picocolors40.default.cyan(row.url) : import_picocolors40.default.dim(row.note ?? "not published");
           line(`  ${row.appName.padEnd(22)} ${label} ${value}`);
         }
         line("");
         if (rows.some((r) => r.url)) success(summary);
-        else line(import_picocolors38.default.yellow(summary));
+        else line(import_picocolors40.default.yellow(summary));
       });
     })
   );
 }
 
 // src/commands/deployments.ts
-var import_picocolors39 = __toESM(require_picocolors(), 1);
+var import_picocolors41 = __toESM(require_picocolors(), 1);
 function registerDeployments(program3) {
   const cmd = program3.command("deployments").description("Deployment history, and putting a build in front of customers");
   cmd.command("list").description("What has been built, newest first").option("--app <webAppId>", "just one app (default: every app in the project)").option("--env <environment>", "preview or production").option("--limit <n>", "how many to show", "20").action(
@@ -10973,7 +11272,7 @@ function registerDeployments(program3) {
       ok(res, () => {
         if (!items.length) {
           return line(
-            import_picocolors39.default.dim(
+            import_picocolors41.default.dim(
               environment ? `Nothing has been deployed to ${environment} yet.` : "Nothing has been deployed yet. `workser deploy` builds the first one."
             )
           );
@@ -10993,13 +11292,13 @@ function registerDeployments(program3) {
       ).catch(() => null) : null;
       ok({ ...dep, logs }, () => {
         line(formatDeployment(dep));
-        if (dep?.error_message) line(import_picocolors39.default.red(`  ${dep.error_message}`));
+        if (dep?.error_message) line(import_picocolors41.default.red(`  ${dep.error_message}`));
         const events = logs?.events ?? [];
         for (const e of events) {
-          line(`  ${import_picocolors39.default.dim(String(e.type ?? "log"))}  ${e.text ?? ""}`);
+          line(`  ${import_picocolors41.default.dim(String(e.type ?? "log"))}  ${e.text ?? ""}`);
         }
         if (opts.logs && !events.length) {
-          line(import_picocolors39.default.dim("  That build produced no output."));
+          line(import_picocolors41.default.dim("  That build produced no output."));
         }
       });
     })
@@ -11043,16 +11342,16 @@ function printPromoted(res, version) {
   const what = version === null ? "the latest build" : `version ${version}`;
   const url = res.url ?? res.vercel_url;
   success(`Production is being rebuilt from ${what}.`);
-  if (url) line(import_picocolors39.default.dim(`It will be at ${url}`));
-  line(import_picocolors39.default.dim("`workser deploy status` follows it."));
+  if (url) line(import_picocolors41.default.dim(`It will be at ${url}`));
+  line(import_picocolors41.default.dim("`workser deploy status` follows it."));
 }
 function formatDeployment(d) {
   if (!d) return "";
-  const version = d.version !== void 0 ? import_picocolors39.default.yellow(`v${d.version}`) : import_picocolors39.default.dim("v?");
-  const env = import_picocolors39.default.dim((d.environment ?? "?").padEnd(10));
+  const version = d.version !== void 0 ? import_picocolors41.default.yellow(`v${d.version}`) : import_picocolors41.default.dim("v?");
+  const env = import_picocolors41.default.dim((d.environment ?? "?").padEnd(10));
   const app = d.webAppName ? `${d.webAppName}  ` : "";
-  const when = import_picocolors39.default.dim(formatTime2(d.created_at));
-  const url = d.url ? "  " + import_picocolors39.default.cyan(d.url) : "";
+  const when = import_picocolors41.default.dim(formatTime2(d.created_at));
+  const url = d.url ? "  " + import_picocolors41.default.cyan(d.url) : "";
   return `${version}  ${env} ${colorStatus(d.status ?? "")}  ${app}${when}${url}`;
 }
 function formatTime2(t) {
@@ -11062,7 +11361,7 @@ function formatTime2(t) {
 }
 
 // src/commands/usage.ts
-var import_picocolors40 = __toESM(require_picocolors(), 1);
+var import_picocolors42 = __toESM(require_picocolors(), 1);
 
 // src/usage.ts
 var NEAR_LIMIT_FRACTION = 0.8;
@@ -11157,7 +11456,7 @@ function registerUsage(program3) {
 function print4(report) {
   const dims = report.dimensions ?? [];
   if (!dims.length) {
-    return line(import_picocolors40.default.dim("Nothing to measure for this project yet."));
+    return line(import_picocolors42.default.dim("Nothing to measure for this project yet."));
   }
   const width = Math.max(...dims.map((d) => d.label.length));
   for (const d of dims) {
@@ -11166,23 +11465,23 @@ function print4(report) {
   line("");
   const summary = usageSummary(report);
   const worst = dims.map(usageState);
-  if (worst.includes("over")) line(import_picocolors40.default.red(summary));
+  if (worst.includes("over")) line(import_picocolors42.default.red(summary));
   else if (worst.includes("near") || worst.includes("unknown"))
-    line(import_picocolors40.default.yellow(summary));
+    line(import_picocolors42.default.yellow(summary));
   else success(summary);
 }
 function gauge(d, _labelWidth) {
   const drawn = bar(d);
-  return drawn ? `  ${import_picocolors40.default.dim(drawn)}` : "";
+  return drawn ? `  ${import_picocolors42.default.dim(drawn)}` : "";
 }
 function colour(d) {
   switch (usageState(d)) {
     case "over":
-      return d.kind === "hard" ? import_picocolors40.default.red : import_picocolors40.default.yellow;
+      return d.kind === "hard" ? import_picocolors42.default.red : import_picocolors42.default.yellow;
     case "near":
-      return import_picocolors40.default.yellow;
+      return import_picocolors42.default.yellow;
     case "unknown":
-      return import_picocolors40.default.dim;
+      return import_picocolors42.default.dim;
     default:
       return (s) => s;
   }
@@ -11190,7 +11489,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.12" : "0.0.0-dev"
+  version: true ? "0.6.14" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(
@@ -11223,6 +11522,7 @@ registerDomain(program2);
 registerOpen(program2);
 registerDoctor(program2);
 registerAgent(program2);
+registerCloudAgent(program2);
 registerVerify(program2);
 registerApi(program2);
 registerAnalysis(program2);
@@ -11237,6 +11537,7 @@ registerWorkflow(program2);
 registerConnection(program2);
 registerTool(program2);
 registerMemory(program2);
+registerNote(program2);
 registerBusiness(program2);
 registerArtifact(program2);
 registerImage(program2);