@workser/cli 0.6.11 → 0.6.13

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;
 }
 
@@ -5624,6 +5632,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 +5720,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 +5938,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 +5947,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."
+          )
+        );
       });
     })
   );
@@ -7841,8 +7863,52 @@ function registerMemory(program3) {
   );
 }
 
-// src/commands/business.ts
+// src/commands/note.ts
 var import_picocolors24 = __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_picocolors24.default.dim(`  ${text}`));
+      });
+    })
+  );
+}
+
+// src/commands/business.ts
+var import_picocolors25 = __toESM(require_picocolors(), 1);
 var RESOURCE_PATHS = {
   "business-config": "business-config",
   "business-settings": "business-settings",
@@ -7902,7 +7968,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_picocolors25.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 +8010,7 @@ function businessPath(projectId, resource, subpath) {
 }
 
 // src/commands/artifact.ts
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve3, basename as basename3 } from "path";
 var KINDS = [
@@ -8041,7 +8107,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_picocolors26.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors26.default.dim(` (${res.kind})`) : ""}`
         )
       );
     })
@@ -8079,7 +8145,7 @@ function registerArtifact(program3) {
 }
 function printArtifacts(rows) {
   if (!rows.length) {
-    line(import_picocolors25.default.dim("Nothing produced yet."));
+    line(import_picocolors26.default.dim("Nothing produced yet."));
     return;
   }
   const byStep = /* @__PURE__ */ new Map();
@@ -8089,26 +8155,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_picocolors26.default.bold(`step ${stepId}`));
     for (const a of items) {
-      const flag = a.promoted_at ? import_picocolors25.default.green(" *") : "  ";
+      const flag = a.promoted_at ? import_picocolors26.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_picocolors26.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors26.default.dim(`  ${where}`) : "")
       );
-      if (a.description) line(import_picocolors25.default.dim(`     ${a.description}`));
+      if (a.description) line(import_picocolors26.default.dim(`     ${a.description}`));
     }
     line("");
   }
-  line(import_picocolors25.default.dim("* = handed over as a deliverable; the rest is working material."));
+  line(import_picocolors26.default.dim("* = handed over as a deliverable; the rest is working material."));
 }
 function printRun(run) {
   if (!run) return;
-  line(`  run      ${import_picocolors25.default.bold(run.runId)}`);
+  line(`  run      ${import_picocolors26.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_picocolors26.default.dim(run.cwd)}`);
 }
 
 // src/commands/image.ts
@@ -8289,7 +8355,7 @@ function registerAudio(program3) {
 }
 
 // src/commands/ask.ts
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors27 = __toESM(require_picocolors(), 1);
 var TYPES = [
   "input",
   "choice",
@@ -8367,7 +8433,7 @@ function registerAsk(program3) {
           code: "bad_request"
         });
       }
-      info(import_picocolors26.default.dim("Waiting for the user to answer\u2026"));
+      info(import_picocolors27.default.dim("Waiting for the user to answer\u2026"));
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}/ask`, {
         body: {
           type,
@@ -8395,12 +8461,12 @@ function deriveTitle(message) {
 function printAnswer(res) {
   if (!res) return;
   if (res.status === "answered") {
-    line(`  ${import_picocolors26.default.green("answered")}`);
+    line(`  ${import_picocolors27.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_picocolors27.default.yellow(res.status)}  ${import_picocolors27.default.dim(res.reason ?? "")}`);
 }
 function extract(response) {
   if (response == null) return "";
@@ -8419,7 +8485,7 @@ function extract(response) {
 }
 
 // src/commands/search.ts
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __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 +8498,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_picocolors28.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_picocolors28.default.dim("(untitled)")}  ${import_picocolors28.default.dim(r.url)}`);
         }
       });
     })
@@ -8442,7 +8508,7 @@ function registerSearch(program3) {
 }
 
 // src/commands/board.ts
-var import_picocolors28 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 
 // src/commands/record-step.ts
 async function recordEntityStep(ctx, opts) {
@@ -8481,7 +8547,7 @@ function registerBoard(program3) {
       }
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors28.default.dim("No cards on the Board yet."));
+          line(import_picocolors29.default.dim("No cards on the Board yet."));
           return;
         }
         for (const r of rows) line(formatRow(r));
@@ -8496,7 +8562,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_picocolors29.default.bold(row.title)}  ${import_picocolors29.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 +8603,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_picocolors29.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 +8637,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_picocolors29.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
     })
   );
   board.command("move <id> <status>").description(
@@ -8582,14 +8648,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_picocolors29.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_picocolors29.default.bold(row.title)} ${statusTag(row.status)}`));
     })
   );
 }
@@ -8622,23 +8688,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_picocolors29.default.dim(` [${r.labels.join(", ")}]`) : "";
+  const owner = r.ownerHuman ? import_picocolors29.default.dim(` @${r.ownerHuman}`) : "";
+  return `${import_picocolors29.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_picocolors29.default.green(label);
+  if (status === "in-progress") return import_picocolors29.default.yellow(label);
+  if (status === "in-review") return import_picocolors29.default.cyan(label);
+  return import_picocolors29.default.dim(label);
 }
 function collect2(value, previous) {
   return [...previous, value];
 }
 
 // src/commands/task.ts
-var import_picocolors29 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __toESM(require_picocolors(), 1);
 
 // src/subtask-attachments.ts
 var MAX_REF_NOTE = 500;
@@ -8684,6 +8750,13 @@ function parseRefs(raw) {
 
 // src/commands/task.ts
 var STATUSES2 = [
+  /**
+   * LISTED, NOT PLANNED. A goal's later phases get their tasks written down
+   * when the plan is agreed, so the owner can read the whole shape — but those
+   * rows have no subtasks and the runner must never pick them up. `todo` keeps
+   * its meaning: the team may start this now.
+   */
+  "backlog",
   "todo",
   "working",
   "checking",
@@ -8691,6 +8764,8 @@ var STATUSES2 = [
   "accepted",
   "archived"
 ];
+var PRIORITIES2 = ["urgent", "high", "normal", "low"];
+var SIZES = ["small", "standard"];
 var ROLES = [
   "pm",
   "architect",
@@ -8743,7 +8818,7 @@ function registerTask(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors29.default.dim("No tasks on the board yet."));
+          line(import_picocolors30.default.dim("No tasks on the board yet."));
           return;
         }
         for (const r of rows) line(formatRow2(r));
@@ -8770,10 +8845,21 @@ function registerTask(program3) {
   task.command("create <title>").description("Open a new root task for the project team").option("--note <text>", "context, constraints and expected outcome").option("--kind <value>", KIND_HELP).option("--label <value...>", "labels to put on the task").option("--app <id...>", "apps the task touches").option("--infra <ref...>", "shared setup it touches").option("--goal <id>", "the business goal this delivers part of").option(
     "--phase <name>",
     "which slice of that goal \u2014 must match one of its phase names"
+  ).option("--priority <value>", `how urgent (${PRIORITIES2.join(" | ")})`).option(
+    "--size <value>",
+    `small lets the channel start it without asking; standard asks (${SIZES.join(" | ")})`
+  ).option(
+    "--status <value>",
+    `start it somewhere other than 'todo' \u2014 use 'backlog' for a later phase's work (${STATUSES2.join(" | ")})`
   ).action(
     action(async ({ ctx, args, opts }) => {
       requireProject(ctx);
       if (opts.kind !== void 0) assertOneOf("--kind", opts.kind, KINDS2);
+      if (opts.priority !== void 0)
+        assertOneOf("--priority", opts.priority, PRIORITIES2);
+      if (opts.size !== void 0) assertOneOf("--size", opts.size, SIZES);
+      if (opts.status !== void 0)
+        assertOneOf("--status", opts.status, STATUSES2);
       const hasChannelOrigin = Boolean(
         ctx.projectChannelId && ctx.projectChannelMessageId
       );
@@ -8787,6 +8873,11 @@ function registerTask(program3) {
           // a goal has to be argued for, never assumed.
           goalId: opts.goal,
           phase: opts.phase,
+          priority: opts.priority,
+          size: opts.size,
+          // `backlog` for a later phase's work: written down so the owner can
+          // read the whole plan, with nothing for the runner to pick up.
+          status: opts.status,
           targets: [
             ...(opts.app ?? []).map((appId) => ({
               kind: "app",
@@ -8836,10 +8927,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_picocolors30.default.green("opened")} ${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.key ?? row.id)}`
         );
         if (channelMessage)
-          line(import_picocolors29.default.dim("posted to the channel as Project Manager"));
+          line(import_picocolors30.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}`
@@ -8918,12 +9009,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_picocolors30.default.green("added")} ${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.key ?? row.id)}`
         );
-        if (row.role) line(import_picocolors29.default.dim(`role: ${row.role}`));
+        if (row.role) line(import_picocolors30.default.dim(`role: ${row.role}`));
         if (runner) {
           line(
-            import_picocolors29.default.dim(
+            import_picocolors30.default.dim(
               `runs on: ${[opts.agent, opts.model, opts.effort].filter(Boolean).join(" \xB7 ")}`
             )
           );
@@ -8941,7 +9032,7 @@ function registerTask(program3) {
       const rows = row.subtasks ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors29.default.dim("No subtasks yet."));
+          line(import_picocolors30.default.dim("No subtasks yet."));
           return;
         }
         rows.forEach((r, i) => line(formatSubtask(r, i + 1)));
@@ -8989,7 +9080,7 @@ function registerTask(program3) {
           }
         }
       );
-      ok(row, () => line(`${import_picocolors29.default.green("updated")} ${import_picocolors29.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors30.default.green("updated")} ${import_picocolors30.default.bold(row.title)}`));
     })
   );
   subtask.command("remove <id>").description("Remove a subtask (only before the work starts)").action(
@@ -8997,7 +9088,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_picocolors30.default.green("removed")));
     })
   );
   task.command("move <id> <status>").description(
@@ -9012,7 +9103,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors29.default.green("moved")} ${import_picocolors29.default.bold(row.title)} \u2192 ${args[1]}`)
+        () => line(`${import_picocolors30.default.green("moved")} ${import_picocolors30.default.bold(row.title)} \u2192 ${args[1]}`)
       );
     })
   );
@@ -9028,18 +9119,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_picocolors30.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_picocolors30.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_picocolors30.default.green("resumed")} \u2014 it is queued, but nothing started yet. Check the plan is approved and that no step is blocking the rest.`
         );
       });
     })
@@ -9053,11 +9144,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_picocolors30.default.green("sent back")} \u2014 it will be picked up again`);
           return;
         }
         line(
-          import_picocolors29.default.yellow(
+          import_picocolors30.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"
           )
         );
@@ -9074,7 +9165,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_picocolors30.default.green("approved \u2014 you may start")));
     })
   );
   task.command("start [id]").description(
@@ -9089,13 +9180,13 @@ function registerTask(program3) {
         const started = row?.started ?? null;
         if (started && started > 0) {
           line(
-            import_picocolors29.default.green(
+            import_picocolors30.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_picocolors30.default.yellow(row?.note ?? "Nothing started."));
       });
     })
   );
@@ -9110,7 +9201,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_picocolors30.default.yellow(
               "The plan is waiting on the owner. They see it in the task."
             ) : `Already ${row2.approval_state}.`
           );
@@ -9135,7 +9226,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors29.default.green(row.approval_state)} ${import_picocolors29.default.bold(row.title)}`)
+        () => line(`${import_picocolors30.default.green(row.approval_state)} ${import_picocolors30.default.bold(row.title)}`)
       );
     })
   );
@@ -9151,7 +9242,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_picocolors30.default.green("ready")} ${import_picocolors30.default.bold(row.title)}`));
     })
   );
 }
@@ -9196,24 +9287,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_picocolors30.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
+  const steps = r.subtaskTotal ? import_picocolors30.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
+  const gate = r.approval_state === "awaiting" ? import_picocolors30.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_picocolors30.default.dim(String(index).padStart(2, "0"));
+  const role = r.role ? import_picocolors30.default.dim(` [${r.role}]`) : "";
+  const scope = r.scope_paths?.length ? import_picocolors30.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_picocolors30.default.dim(wrapped)}`;
 }
 function printTask(row, goal) {
-  line(`${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.key ?? row.id)}`);
+  line(`${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.key ?? row.id)}`);
   line(`${statusTag2(row.status)}  approval: ${row.approval_state}`);
   if (row.summary) line(`
 ${row.summary}`);
@@ -9226,53 +9317,53 @@ touches: ${row.targets.map((t) => t.appName ?? t.ref ?? t.kind).join(", ")}`
   }
   if (row.subtasks?.length) {
     line(`
-${import_picocolors29.default.bold("subtasks")}`);
+${import_picocolors30.default.bold("subtasks")}`);
     row.subtasks.forEach((s, i) => line(formatSubtask(s, i + 1)));
     line(
-      import_picocolors29.default.dim(
+      import_picocolors30.default.dim(
         `
 Run \`workser artifact list\` to see what these subtasks produced,`
       )
     );
     line(
-      import_picocolors29.default.dim(
+      import_picocolors30.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_picocolors30.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_picocolors30.default.bold("part of")}: ${goal.title}`);
+  if (goal.outcome) line(import_picocolors30.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_picocolors30.default.cyan("  <- this task") : "";
+    const mark = p.state === "done" ? import_picocolors30.default.green("*") : import_picocolors30.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_picocolors30.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_picocolors30.default.dim(
         "\nEvery part of this plan is done. Say so, and offer to wrap it up."
       )
     );
   }
   line(
-    import_picocolors29.default.dim(
+    import_picocolors30.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."
     )
   );
@@ -9280,22 +9371,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_picocolors30.default.green("[ready]");
     case "working":
-      return import_picocolors29.default.blue("[working]");
+      return import_picocolors30.default.blue("[working]");
     case "checking":
-      return import_picocolors29.default.cyan("[checking]");
+      return import_picocolors30.default.cyan("[checking]");
     case "accepted":
-      return import_picocolors29.default.green("[accepted]");
+      return import_picocolors30.default.green("[accepted]");
     case "archived":
-      return import_picocolors29.default.dim("[archived]");
+      return import_picocolors30.default.dim("[archived]");
     default:
-      return import_picocolors29.default.dim("[todo]");
+      return import_picocolors30.default.dim("[todo]");
   }
 }
 
 // src/commands/goal.ts
-var import_picocolors30 = __toESM(require_picocolors(), 1);
+var import_picocolors31 = __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");
@@ -9307,7 +9398,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_picocolors31.default.dim("No goals yet \u2014 every task here stands on its own."));
           return;
         }
         for (const g of rows) line(formatGoal(g));
@@ -9384,10 +9475,10 @@ function registerGoal(program3) {
         }
       });
       ok(row, () => {
-        success(`Proposed ${import_picocolors30.default.bold(row?.title ?? "goal")}`);
+        success(`Proposed ${import_picocolors31.default.bold(row?.title ?? "goal")}`);
         printGoal(row);
         line(
-          import_picocolors30.default.dim(
+          import_picocolors31.default.dim(
             "\nNothing has been created yet. The owner agrees the shape first."
           )
         );
@@ -9416,13 +9507,54 @@ 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_picocolors31.default.green("recorded \u2014 met") : met === false ? import_picocolors31.default.yellow("recorded \u2014 not met") : import_picocolors31.default.dim("recorded \u2014 back to unchecked") : import_picocolors31.default.yellow(
             "couldn't record it \u2014 check the goal id, the phase name and the criterion id"
           )
         )
       );
     })
   );
+  goal.command("adopt <id>").description(
+    "File tasks that already exist under a part of this plan \u2014 for work done before the plan was written"
+  ).option("--task <id...>", "the tasks to file under it").option("--phase <name>", "which part of the plan they belong to").action(
+    action(async ({ ctx, args, opts }) => {
+      requireProject(ctx);
+      const goalId = String(args[0]);
+      const taskIds = opts.task ?? [];
+      if (!taskIds.length) {
+        throw new WorkserError(
+          "Name the tasks to file, e.g. `--task WORK-12 WORK-13`."
+        );
+      }
+      const goal2 = await api(
+        ctx,
+        `/v1/project-goals/${encodeURIComponent(goalId)}`
+      );
+      if (!goal2) throw new WorkserError(`No goal ${goalId}.`);
+      const names = (goal2.phases ?? []).map(
+        (p) => typeof p === "string" ? p : p.name
+      );
+      const phase = String(opts.phase ?? "").trim();
+      if (!phase || !names.includes(phase)) {
+        throw new WorkserError(
+          `--phase must be one of this goal's parts: ${names.join(", ")}.`
+        );
+      }
+      const filed = [];
+      for (const taskId of taskIds) {
+        await api(ctx, `/v1/project-tasks/${encodeURIComponent(taskId)}`, {
+          method: "PATCH",
+          body: { goalId, phase }
+        });
+        filed.push(taskId);
+      }
+      ok({ goalId, phase, filed }, () => {
+        success(
+          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors31.default.bold(phase)}`
+        );
+      });
+    })
+  );
   goal.command("update <id>").description("Change the shape, or move the goal along").option("--title <text>", "the owner's words for what they want").option("--outcome <text>", "what 'done' means").option("--phase <name...>", "replace the ordered phase list").option("--status <value>", `one of: ${STATUSES3.join(" | ")}`).action(
     action(async ({ ctx, args, opts }) => {
       if (opts.status && !STATUSES3.includes(opts.status)) {
@@ -9450,42 +9582,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_picocolors31.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_picocolors31.default.dim(`  now: ${g.currentPhase}`) : "";
+  const count = g.taskTotal != null ? import_picocolors31.default.dim(`  ${g.taskDone}/${g.taskTotal} done`) : "";
+  return `${statusTag3(g.status)} ${g.title}${appScope(g)}${where}${count}  ${import_picocolors31.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_picocolors31.default.bold(g.title)}  ${import_picocolors31.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_picocolors31.default.dim("\nNo phases agreed yet."));
     return;
   }
   line(`
-${import_picocolors30.default.bold("phases")}`);
+${import_picocolors31.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_picocolors31.default.dim("nothing filed yet");
+    const mark = p.state === "done" ? import_picocolors31.default.green("done") : p.state === "working" ? import_picocolors31.default.blue("working") : import_picocolors31.default.dim("waiting");
     line(
-      `  ${import_picocolors30.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors30.default.dim(bar2)}`
+      `  ${import_picocolors31.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors31.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_picocolors31.default.green("\u2713") : c.met === false ? import_picocolors31.default.red("\u2717") : import_picocolors31.default.dim("\xB7");
+      line(`       ${tick} ${c.text}  ${import_picocolors31.default.dim(c.id)}`);
+      if (c.note) line(import_picocolors31.default.dim(`         ${c.note}`));
     }
   }
   const current = progress.find((p) => p.name === g.currentPhase);
   if (current) {
     line(
-      import_picocolors30.default.dim(
+      import_picocolors31.default.dim(
         `
 ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current.index} of ${progress.length}).`
       )
@@ -9495,15 +9627,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_picocolors31.default.cyan("[agreed]");
     case "working":
-      return import_picocolors30.default.blue("[working]");
+      return import_picocolors31.default.blue("[working]");
     case "delivered":
-      return import_picocolors30.default.green("[delivered]");
+      return import_picocolors31.default.green("[delivered]");
     case "abandoned":
-      return import_picocolors30.default.dim("[abandoned]");
+      return import_picocolors31.default.dim("[abandoned]");
     default:
-      return import_picocolors30.default.yellow("[proposed]");
+      return import_picocolors31.default.yellow("[proposed]");
   }
 }
 
@@ -9556,7 +9688,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,
@@ -9576,6 +9716,7 @@ var BUILDS = [
 ];
 var ROLE_VERBS = {
   pm: [...READS, "ask", "app"],
+  // `note` reaches this via READS.
   architect: [...BUILDS, "versions"],
   web: BUILDS,
   api: BUILDS,
@@ -9678,7 +9819,7 @@ function stripLeadingGlobalOptions(argv) {
 }
 
 // src/commands/decision.ts
-var import_picocolors31 = __toESM(require_picocolors(), 1);
+var import_picocolors32 = __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(
@@ -9691,11 +9832,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_picocolors32.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_picocolors32.default.dim(r.id)}  ${import_picocolors32.default.dim(shortDate(r.createdAt))}  ${r.title}`);
           line(`    ${truncate(r.decision, 100)}`);
         }
       });
@@ -9709,16 +9850,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_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
+        line(import_picocolors32.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
-${import_picocolors31.default.bold("Context")}
+${import_picocolors32.default.bold("Context")}
 ${row.context}`);
         line(`
-${import_picocolors31.default.bold("Decision")}
+${import_picocolors32.default.bold("Decision")}
 ${row.decision}`);
         if (row.consequences) line(`
-${import_picocolors31.default.bold("Consequences")}
+${import_picocolors32.default.bold("Consequences")}
 ${row.consequences}`);
       });
     })
@@ -9747,7 +9888,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_picocolors32.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   const requirement = program3.command("requirement").description("Read and record the project's requirements");
@@ -9759,11 +9900,11 @@ ${row.consequences}`);
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors31.default.dim("No requirements recorded yet."));
+          line(import_picocolors32.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_picocolors32.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
         }
       });
     })
@@ -9776,8 +9917,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_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
+        line(import_picocolors32.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
 ${row.body}`);
       });
@@ -9803,7 +9944,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_picocolors32.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   requirement.command("update <id>").description(
@@ -9832,7 +9973,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_picocolors32.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
     })
   );
 }
@@ -9855,7 +9996,7 @@ function shortDate(iso) {
 }
 
 // src/commands/doc.ts
-var import_picocolors32 = __toESM(require_picocolors(), 1);
+var import_picocolors33 = __toESM(require_picocolors(), 1);
 
 // src/mermaid-fences.ts
 function hasDiagram(code) {
@@ -9900,13 +10041,13 @@ function registerDoc(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors32.default.dim("No documents yet."));
+          line(import_picocolors33.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_picocolors33.default.dim(` \u21B3 ${r.workItemId}`) : "";
+          const file = r.filePath ? import_picocolors33.default.dim(`  ${r.filePath}`) : "";
+          line(`${import_picocolors33.default.dim(r.id)}  ${r.title}${link}${file}`);
         }
       });
     })
@@ -9920,17 +10061,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_picocolors33.default.bold(row.title)}  ${import_picocolors33.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_picocolors33.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors33.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_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+        if (row.workItemId) line(import_picocolors33.default.dim(`linked to work item ${row.workItemId}`));
+        if (row.filePath) line(import_picocolors33.default.dim(`markdown mirror: ${row.filePath}`));
         line("");
         line(row.contentJson);
       });
@@ -9959,7 +10100,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_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   doc.command("diagram <id>").description(
@@ -9985,19 +10126,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_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
         if (markdown === null) {
           line(
-            import_picocolors32.default.dim(
+            import_picocolors33.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_picocolors33.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_picocolors33.default.dim(String(i + 1))}  ${kind}  ${import_picocolors33.default.dim(`${code.split("\n").length} lines`)}`);
           }
         }
       });
@@ -10033,7 +10174,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_picocolors33.default.bold(row.id)} \u2014 ${row.title}`));
     })
   );
 }
@@ -10047,7 +10188,7 @@ function readMirror(cwd, filePath) {
 }
 
 // src/commands/design.ts
-var import_picocolors33 = __toESM(require_picocolors(), 1);
+var import_picocolors34 = __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(
@@ -10061,11 +10202,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_picocolors34.default.dim("No brand set for this project."));
             return;
           }
           for (const f of files) {
-            line(import_picocolors33.default.bold(f.path));
+            line(import_picocolors34.default.bold(f.path));
             line(f.contents);
             line("");
           }
@@ -10082,21 +10223,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_picocolors34.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_picocolors34.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_picocolors34.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_picocolors34.default.dim(`font.${name}`.padEnd(12))} ${value}`);
         }
         line("");
         line(
-          import_picocolors33.default.dim(
+          import_picocolors34.default.dim(
             `Generated into the working tree as ${files.map((f) => f.path).join(", ")} \u2014 wire those in, never edit them.`
           )
         );
@@ -10127,7 +10268,7 @@ function unwrap(group) {
 }
 
 // src/commands/api.ts
-var import_picocolors34 = __toESM(require_picocolors(), 1);
+var import_picocolors35 = __toESM(require_picocolors(), 1);
 import { readdirSync, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { join as join3, relative, sep } from "path";
 
@@ -10241,10 +10382,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_picocolors35.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_picocolors35.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors35.default.dim(`  ${r.note}`) : ""}`
           );
         }
       });
@@ -10278,14 +10419,14 @@ function registerApi(program3) {
       );
       ok(res, () => {
         if (!res?.ok) {
-          line(import_picocolors34.default.red(res?.error ?? "The service did not answer."));
+          line(import_picocolors35.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_picocolors35.default.green : res.status && res.status < 500 ? import_picocolors35.default.yellow : import_picocolors35.default.red;
+        line(`${colour2(code)}  ${import_picocolors35.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_picocolors35.default.dim("(answer truncated)"));
       });
       if (!res?.ok) process.exitCode = 1;
     })
@@ -10305,15 +10446,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_picocolors35.default.yellow("undocumented") : import_picocolors35.default.green("documented  ")}  ${r.path}${import_picocolors35.default.dim(`  ${r.file}`)}`
           );
         }
         for (const p of report.stale) {
-          line(`${import_picocolors34.default.dim("in spec only ")}  ${p}`);
+          line(`${import_picocolors35.default.dim("in spec only ")}  ${p}`);
         }
         line("");
         if (report.ok && specFile) success(summary);
-        else line(import_picocolors34.default.yellow(summary));
+        else line(import_picocolors35.default.yellow(summary));
       });
       if (opts.check && !report.ok) {
         throw new WorkserError(summary, { code: "bad_request" });
@@ -10384,7 +10525,7 @@ function listRepoFiles(root, maxDepth = 8) {
 }
 
 // src/commands/analysis.ts
-var import_picocolors35 = __toESM(require_picocolors(), 1);
+var import_picocolors36 = __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");
@@ -10394,14 +10535,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_picocolors36.default.green("python") : import_picocolors36.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors36.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_picocolors36.default.green(lib.name) : import_picocolors36.default.yellow(lib.name)}${import_picocolors36.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_picocolors36.default.dim(note));
       });
       if (!res?.available) process.exitCode = 1;
     })
@@ -10423,15 +10564,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_picocolors36.default.dim(res.stderr.replace(/\n$/, "")));
+        if (res?.truncated) line(import_picocolors36.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_picocolors36.default.green(`\u2713 ${res.summary ?? "It finished."}`) + import_picocolors36.default.dim(`  ${took}`) : import_picocolors36.default.yellow(res?.summary ?? "It did not finish.") + import_picocolors36.default.dim(`  ${took}`)
         );
         if (res && !res.sandboxed) {
           line(
-            import_picocolors35.default.dim(
+            import_picocolors36.default.dim(
               "This platform has no OS sandbox, so the script ran with your own file access."
             )
           );
@@ -10459,7 +10600,7 @@ function readCode(file, inline) {
 }
 
 // src/commands/scan.ts
-var import_picocolors36 = __toESM(require_picocolors(), 1);
+var import_picocolors37 = __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";
@@ -10743,22 +10884,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_picocolors37.default.yellow("not checked")}  ${s.check}${import_picocolors37.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_picocolors37.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
     line(`${severityTag(f.severity)}  ${f.title}${where}`);
-    line(`             ${import_picocolors36.default.dim(f.fix)}`);
+    line(`             ${import_picocolors37.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_picocolors37.default.yellow(summary));
+  else line(import_picocolors37.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_picocolors37.default.red("serious    ");
+  if (severity === "medium") return import_picocolors37.default.yellow("worth fixing");
+  return import_picocolors37.default.dim("minor      ");
 }
 function git(cwd, args) {
   try {
@@ -10819,7 +10960,7 @@ function listRepoFiles2(root, maxDepth = 8) {
 }
 
 // src/commands/health.ts
-var import_picocolors37 = __toESM(require_picocolors(), 1);
+var import_picocolors38 = __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 }) => {
@@ -10833,16 +10974,16 @@ function registerHealth(program3) {
 }
 function print3(res) {
   if (!res?.checks?.length) {
-    line(import_picocolors37.default.dim(res?.note ?? "Nothing to check."));
+    line(import_picocolors38.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_picocolors38.default.green("up  ") : import_picocolors38.default.red("down");
+    const timing = import_picocolors38.default.dim(`${c.ms}ms`);
+    const detail = c.ok ? timing : import_picocolors38.default.dim(`${c.error ?? "no answer"}${c.failures > 1 ? ` \xB7 ${c.failures} in a row` : ""}`);
+    line(`  ${mark}  ${c.appName} ${import_picocolors38.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_picocolors38.default.yellow(`        An incident has been opened on the board for this.`));
     }
   }
   const down = res.checks.filter((c) => !c.ok);
@@ -10855,14 +10996,14 @@ function print3(res) {
   }
   const production = down.filter((c) => c.environment === "production").length;
   line(
-    import_picocolors37.default.red(
+    import_picocolors38.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_picocolors39 = __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 }) => {
@@ -10876,20 +11017,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_picocolors39.default.dim(row.environment.padEnd(10));
+          const value = row.url ? import_picocolors39.default.cyan(row.url) : import_picocolors39.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_picocolors39.default.yellow(summary));
       });
     })
   );
 }
 
 // src/commands/deployments.ts
-var import_picocolors39 = __toESM(require_picocolors(), 1);
+var import_picocolors40 = __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(
@@ -10907,7 +11048,7 @@ function registerDeployments(program3) {
       ok(res, () => {
         if (!items.length) {
           return line(
-            import_picocolors39.default.dim(
+            import_picocolors40.default.dim(
               environment ? `Nothing has been deployed to ${environment} yet.` : "Nothing has been deployed yet. `workser deploy` builds the first one."
             )
           );
@@ -10927,13 +11068,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_picocolors40.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_picocolors40.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_picocolors40.default.dim("  That build produced no output."));
         }
       });
     })
@@ -10977,16 +11118,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_picocolors40.default.dim(`It will be at ${url}`));
+  line(import_picocolors40.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_picocolors40.default.yellow(`v${d.version}`) : import_picocolors40.default.dim("v?");
+  const env = import_picocolors40.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_picocolors40.default.dim(formatTime2(d.created_at));
+  const url = d.url ? "  " + import_picocolors40.default.cyan(d.url) : "";
   return `${version}  ${env} ${colorStatus(d.status ?? "")}  ${app}${when}${url}`;
 }
 function formatTime2(t) {
@@ -10996,7 +11137,7 @@ function formatTime2(t) {
 }
 
 // src/commands/usage.ts
-var import_picocolors40 = __toESM(require_picocolors(), 1);
+var import_picocolors41 = __toESM(require_picocolors(), 1);
 
 // src/usage.ts
 var NEAR_LIMIT_FRACTION = 0.8;
@@ -11091,7 +11232,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_picocolors41.default.dim("Nothing to measure for this project yet."));
   }
   const width = Math.max(...dims.map((d) => d.label.length));
   for (const d of dims) {
@@ -11100,23 +11241,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_picocolors41.default.red(summary));
   else if (worst.includes("near") || worst.includes("unknown"))
-    line(import_picocolors40.default.yellow(summary));
+    line(import_picocolors41.default.yellow(summary));
   else success(summary);
 }
 function gauge(d, _labelWidth) {
   const drawn = bar(d);
-  return drawn ? `  ${import_picocolors40.default.dim(drawn)}` : "";
+  return drawn ? `  ${import_picocolors41.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_picocolors41.default.red : import_picocolors41.default.yellow;
     case "near":
-      return import_picocolors40.default.yellow;
+      return import_picocolors41.default.yellow;
     case "unknown":
-      return import_picocolors40.default.dim;
+      return import_picocolors41.default.dim;
     default:
       return (s) => s;
   }
@@ -11124,7 +11265,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.11" : "0.0.0-dev"
+  version: true ? "0.6.13" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(
@@ -11171,6 +11312,7 @@ registerWorkflow(program2);
 registerConnection(program2);
 registerTool(program2);
 registerMemory(program2);
+registerNote(program2);
 registerBusiness(program2);
 registerArtifact(program2);
 registerImage(program2);