@workser/cli 0.2.6 → 0.3.0

package/dist/index.js

@@ -4404,6 +4404,156 @@ workser storage get <key> [dest]    # download an object (or print its URL)
 infrastructure on the project's own Neon branch, available only on dedicated tenancy
 in a supported region. They are different stores \u2014 a file put in one is not visible
 in the other. See \`reference/neon-backend.md\`.
+`
+  },
+  {
+    topic: "tasks",
+    title: "Project tasks & subtasks",
+    summary: "The ticket you are working inside: read it, break it into steps, and ask before starting.",
+    commands: ["task"],
+    source: "skills/workser/reference/tasks.md",
+    body: `# Project tasks & subtasks
+
+A **project task** is a ticket the owner filed. You are usually running inside
+one \u2014 Orbit sets \`WORKSER_PROJECT_TASK_ID\` on your process, so every command
+below defaults to it and you rarely pass an id at all.
+
+\`\`\`
+workser task list [--status <value>] [--label <value>] [--limit <n>]
+workser task show [id]                  # the task you are in, with its steps
+
+workser task subtask add <title> [--role <value>] [--kind <value>]
+                                 [--note <text>] [--app <id...>]
+                                 [--infra <ref...>] [--scope <path...>]
+                                 [--depends-on <key...>]
+workser task subtask list [taskId]
+workser task subtask update <id> [--title|--note|--role|--kind|--scope]
+workser task subtask remove <id>
+
+workser task can-start [id]             # may work begin? refuses until approved
+workser task approval request           # tell the owner the plan is ready
+workser task move <id> <status>
+workser task done [id] --summary <text>
+\`\`\`
+
+## This is not \`workser board\`
+
+\`board\` is the Orbit Board \u2014 a human's list of work items. \`task\` is the AI Tech
+Team's own table. Filing your plan on the Board puts it somewhere the owner's
+task page never reads: they see "created work item" and an empty plan. Use
+\`task subtask add\`.
+
+## Planning a task
+
+Read the project first, then propose. One \`subtask add\` per step:
+
+\`\`\`
+workser task subtask add "Build the upload endpoint" \\
+  --role api --kind service \\
+  --note "Accept a file, work out its type, hand it to the right analyzer." \\
+  --scope src/app/api/analyze/route.ts
+
+workser task subtask add "Check every supported file type end to end" \\
+  --role qa --depends-on RIZZ-15
+\`\`\`
+
+\`--role\` is one of: pm, architect, web, api, automation, qa.
+\`--kind\` is what the step produces: data_reports, web, mobile, service,
+automation, docs. It is not the same fact as the role \u2014 the same engineer
+writing a screen, the docs for it and the service behind it is three kinds of
+work.
+
+\`--scope\` is what that step OWNS. Two steps naming the same file cannot run at
+the same time, so keeping scopes apart is what lets the team work in parallel.
+\`--depends-on\` takes the keys you read off \`task show\`.
+
+Between three and six steps. If it needs more, say the task is too big instead.
+The step that CHECKS work must not be the same role as the one that built it.
+
+## Nothing runs until the owner approves
+
+\`\`\`
+workser task can-start
+\`\`\`
+
+This exits non-zero, with the reason, until they have approved the plan \u2014 that
+refusal is the product working, not an error to route around. Ask with
+\`workser task approval request\`; only a person can answer.
+
+## Finishing a step
+
+\`\`\`
+workser task done --summary "The report now shows cost per KOL, with six months of history."
+\`\`\`
+
+Write the summary for someone who runs a business and does not read code.
+`
+  },
+  {
+    topic: "version-control",
+    title: "Saving, undoing & syncing your work",
+    summary: "Checkpoint before risky edits, restore when they go wrong, sync with Workser.",
+    commands: ["checkpoint", "restore", "sync"],
+    source: "skills/workser/reference/version-control.md",
+    body: `# Saving, undoing & syncing your work
+
+\`\`\`
+workser checkpoint ["what you're about to try"]  # save the folder as it stands now
+workser restore                                  # go back to the newest checkpoint
+workser restore --list                           # see the checkpoints you can go back to
+workser restore <ref>                            # go back to a specific one
+workser sync [--branch dev] [--app <id>]         # reconcile this folder with Workser
+\`\`\`
+
+## Why these exist instead of git
+
+This folder is a git repository, but **the history is Workser's**. There is no
+remote: code moves to and from Workser over its API as git bundles, using the
+same session everything else here uses. No credential is read, and the user's
+own git keys and identity are never touched.
+
+That is what makes any of this work on a computer with no access to the
+Workser-managed repository \u2014 which is every computer. Nobody has repo access;
+the API does.
+
+So the ordinary git verbs are wrong here, and these three replace them:
+
+| Instead of | Run |
+|---|---|
+| \`git stash\` | \`workser checkpoint\` |
+| \`git commit\` | \`workser checkpoint\` |
+| \`git reset --hard\` / \`git checkout .\` | \`workser restore\` |
+| \`git pull\` / \`git push\` | \`workser sync\` |
+
+Reading is always fine: \`git log\`, \`git diff\`, \`git show\`, \`git status\`.
+
+## Notes that matter
+
+- **Checkpoint before anything you might want to take back** \u2014 a refactor across
+  many files, a dependency upgrade, deleting something large. It costs a second.
+- **\`git stash\` is the one that actually loses work.** Workser publishes what is
+  on disk, so a deploy while your changes are stashed ships the version *without
+  them* \u2014 and if the run is stopped between \`stash\` and \`stash pop\`, the user
+  opens their folder and their work is gone. \`workser checkpoint\` has neither
+  failure mode.
+- **Restoring never discards anything.** The current state is saved first, then
+  the older state is restored on top. If you restore the wrong thing, restore
+  again. Say this to the user \u2014 it is the reason they can afford to say yes.
+- **These are the same checkpoints as the app's Undo button.** One history, not
+  two: a checkpoint you take here appears in Workser, and vice versa.
+- **\`sync\` pulls before it pushes.** If it reports \`diverged\`, both sides changed
+  and it stops rather than picking a winner \u2014 tell the user to resolve it in
+  Workser instead of forcing it.
+- **These three need the Workser app running on this computer**, because they
+  work with files. If you get \`needs_local_app\`, you are on a machine that only
+  has the CLI and a token \u2014 say so rather than looking for a workaround. Every
+  read-only command (\`projects\`, \`env\`, \`db\`, \`logs\`, \`status\`) still works.
+
+## Shipping is separate
+
+\`workser sync\` reconciles the folder. \`workser deploy\` puts it in front of
+users. Syncing does not deploy, and deploying does not require you to sync
+first \u2014 deploy publishes what is on disk. See \`reference/deploy.md\`.
 `
   }
 ];
@@ -4565,11 +4715,37 @@ function buildContext(opts) {
   const projectId = opts.project || process.env.WORKSER_PROJECT_ID || link?.projectId || session.defaultProjectId;
   const runId = process.env.WORKSER_RUN_ID || void 0;
   const conversationId = process.env.WORKSER_CONVERSATION_ID || void 0;
-  return { endpoint, socketPath, token, mode: mode2, cwd, projectId, runId, conversationId };
+  const projectTaskId = process.env.WORKSER_PROJECT_TASK_ID || void 0;
+  return {
+    endpoint,
+    socketPath,
+    token,
+    mode: mode2,
+    cwd,
+    projectId,
+    runId,
+    conversationId,
+    projectTaskId
+  };
 }
 function runTarget(ctx) {
   return ctx.runId || "current";
 }
+function requireLocalApp(ctx, what) {
+  if (ctx.mode === "daemon") return;
+  throw new WorkserError(
+    `\`workser ${what}\` works with the code in this folder, so it needs the Workser app running on this computer.
+
+This shell is talking to ${ctx.endpoint} instead of a local app.
+
+  \u2022 On your own computer: open Workser and try again.
+  \u2022 On a computer without Workser: install it from https://workser.ai/download,
+    sign in, and open this project \u2014 that is what puts the code here.
+
+Commands that only read your account (projects, env, db, logs, status) work as normal.`,
+    { code: "needs_local_app" }
+  );
+}
 function requireProject(ctx) {
   if (!ctx.projectId) {
     throw new WorkserError(
@@ -5521,6 +5697,7 @@ function registerDeploy(program3) {
     "which app to publish (default: the app this folder is linked to)"
   ).action(
     action(async ({ ctx, opts }) => {
+      requireLocalApp(ctx, "deploy");
       const projectId = requireProject(ctx);
       const dep = await api(ctx, `/v1/projects/${projectId}/deploy`, {
         body: {
@@ -5675,6 +5852,7 @@ function openUrl(url) {
 
 // src/commands/doctor.ts
 var import_picocolors13 = __toESM(require_picocolors(), 1);
+import { spawnSync } from "child_process";
 function registerDoctor(program3) {
   program3.command("doctor").description("Print the resolved endpoint, mode, token presence (masked), and current project").action(
     action(({ ctx, opts }) => {
@@ -5685,12 +5863,14 @@ function registerDoctor(program3) {
       const tokenSource = opts.token ? "--token" : process.env.WORKSER_TOKEN ? "$WORKSER_TOKEN" : session.token ? "session" : void 0;
       const endpointSource = opts.endpoint ? "--endpoint" : process.env.WORKSER_DAEMON_URL ? "$WORKSER_DAEMON_URL" : session.endpoint ? "session" : process.env.WORKSER_API_URL ? "$WORKSER_API_URL" : `cloud-default: ${env}`;
       const projectSource = opts.project ? "--project" : link?.projectId ? ".workser link" : session.defaultProjectId ? "session" : void 0;
+      const git = gitVersion();
       const report = {
         endpoint: ctx.endpoint,
         endpointSource,
         env,
         envIgnored,
         mode: ctx.mode,
+        git: { present: git !== null, version: git },
         token: {
           present: Boolean(ctx.token),
           masked: ctx.token ? maskToken(ctx.token) : null,
@@ -5718,6 +5898,20 @@ function registerDoctor(program3) {
           `  project:   ${ctx.projectId ?? import_picocolors13.default.dim("none")}` + (link?.name ? `  ${import_picocolors13.default.dim(`(${link.name})`)}` : "") + (projectSource ? import_picocolors13.default.dim(`  [${projectSource}]`) : "")
         );
         line(`  cwd:       ${ctx.cwd}`);
+        line(`  git:       ${git ?? import_picocolors13.default.dim("not on this shell's PATH")}`);
+        if (!git) {
+          line("");
+          line(
+            import_picocolors13.default.dim(
+              "  Workser brings its own git, so syncing and publishing still work."
+            )
+          );
+          line(
+            import_picocolors13.default.dim(
+              `  Only needed if you want to run git yourself here. ${GIT_INSTALL_HINT}`
+            )
+          );
+        }
         if (envIgnored) {
           line("");
           line(
@@ -5736,6 +5930,24 @@ function registerDoctor(program3) {
     })
   );
 }
+function gitVersion() {
+  try {
+    const res = spawnSync("git", ["--version"], {
+      encoding: "utf8",
+      timeout: 5e3,
+      // A macOS box with no Command Line Tools has a `git` SHIM that pops a GUI
+      // installer when run. Inheriting stdio would surface that dialog from a
+      // command the user expects to just print a report.
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    if (res.error || res.status !== 0) return null;
+    const out = (res.stdout || "").toString().trim();
+    return out || null;
+  } catch {
+    return null;
+  }
+}
+var GIT_INSTALL_HINT = process.platform === "darwin" ? "Install it with: xcode-select --install" : process.platform === "win32" ? "Install it from: https://git-scm.com/download/win" : "Install it with your package manager, e.g. apt install git";
 function maskToken(token) {
   if (token.length <= 8) return "\u2022".repeat(token.length);
   return `${token.slice(0, 3)}${"\u2022".repeat(Math.min(token.length - 6, 12))}${token.slice(-3)}`;
@@ -5863,6 +6075,7 @@ function registerVerify(program3) {
     "comma-separated subset, e.g. --only typecheck,build"
   ).action(
     action(async ({ ctx, opts }) => {
+      requireLocalApp(ctx, "verify");
       const only = opts.only ? String(opts.only).split(",").map((s) => s.trim()).filter(Boolean) : void 0;
       const res = await api(ctx, `/v1/verify`, {
         body: { cwd: ctx.cwd, ...only ? { only } : {} }
@@ -5890,8 +6103,139 @@ function printVerify(res) {
     );
 }
 
-// src/commands/workflow.ts
+// src/commands/checkpoint.ts
 var import_picocolors16 = __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"
+  ).addHelpText(
+    "after",
+    "\nUse this before a risky change. To come back: `workser restore`.\nNever use `git stash` or `git commit` here \u2014 Workser owns this history.\n"
+  ).action(
+    action(async ({ ctx, args }) => {
+      requireLocalApp(ctx, "checkpoint");
+      const label = typeof args[0] === "string" ? args[0] : "";
+      const res = await api(ctx, `/v1/checkpoints`, {
+        body: { cwd: ctx.cwd, ...label ? { label } : {} }
+      });
+      ok(res, () => {
+        const p = res?.point;
+        success(`Saved a checkpoint${p?.label ? `: ${p.label}` : ""}`);
+        if (p?.ref) line(import_picocolors16.default.dim(`  ${p.ref.slice(0, 7)}`));
+        line(import_picocolors16.default.dim("  Come back to it with `workser restore`."));
+      });
+    })
+  );
+  const restore = program3.command("restore [ref]").description(
+    "Put this folder back to a saved checkpoint (default: the most recent)"
+  ).option("--list", "show the checkpoints you can go back to", false).action(
+    action(async ({ ctx, args, opts }) => {
+      requireLocalApp(ctx, "restore");
+      if (opts.list) {
+        const res2 = await api(ctx, `/v1/checkpoints`, {
+          query: { cwd: ctx.cwd }
+        });
+        const points = res2?.points ?? [];
+        return ok(res2, () => printPoints(points));
+      }
+      const ref = typeof args[0] === "string" ? args[0].trim() : "";
+      const res = await api(ctx, `/v1/undo`, {
+        body: { cwd: ctx.cwd, ...ref ? { ref } : {} }
+      });
+      ok(res, () => {
+        success(
+          `Put the folder back${res?.restoredTo ? ` to ${String(res.restoredTo).slice(0, 7)}` : ""}`
+        );
+        if (res?.filesChanged) {
+          line(
+            import_picocolors16.default.dim(
+              `  ${res.filesChanged} file${res.filesChanged === 1 ? "" : "s"} changed`
+            )
+          );
+        }
+        line(import_picocolors16.default.dim("  This is reversible: `workser restore` again."));
+      });
+    })
+  );
+  restore.command("list").description("Show the checkpoints you can go back to").action(
+    action(async ({ ctx }) => {
+      requireLocalApp(ctx, "restore list");
+      const res = await api(ctx, `/v1/checkpoints`, {
+        query: { cwd: ctx.cwd }
+      });
+      ok(res, () => printPoints(res?.points ?? []));
+    })
+  );
+}
+function printPoints(points) {
+  if (!points.length) {
+    info("No checkpoints yet for this folder.");
+    line(import_picocolors16.default.dim("  Take one with `workser checkpoint`."));
+    return;
+  }
+  line(import_picocolors16.default.bold("Checkpoints"));
+  for (const p of points) {
+    const when = p.at ? new Date(p.at).toLocaleString() : "";
+    line(
+      `  ${import_picocolors16.default.dim(p.ref.slice(0, 7))}  ${p.label}${when ? import_picocolors16.default.dim(`  ${when}`) : ""}`
+    );
+  }
+  line(
+    import_picocolors16.default.dim(
+      "\nGo back with `workser restore <ref>`, or just `workser restore` for the newest."
+    )
+  );
+}
+
+// src/commands/sync.ts
+var import_picocolors17 = __toESM(require_picocolors(), 1);
+function registerSync(program3) {
+  program3.command("sync").description(
+    "Reconcile this folder with the copy Workser holds (pull, then push)"
+  ).option("--branch <name>", "which branch to sync (default: this folder's)").option(
+    "--app <webAppId>",
+    "which app's code this folder holds (default: resolved from the folder)"
+  ).addHelpText(
+    "after",
+    "\nUse this instead of `git pull` / `git push` \u2014 this folder has no remote.\n"
+  ).action(
+    action(async ({ ctx, opts }) => {
+      requireLocalApp(ctx, "sync");
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, `/v1/projects/${projectId}/git/sync`, {
+        body: {
+          cwd: ctx.cwd,
+          ...opts.branch ? { branch: opts.branch } : {},
+          ...opts.app ? { webAppId: opts.app } : {}
+        }
+      });
+      const refused = res?.ok === false || res?.state === "diverged";
+      ok(res, () => {
+        if (refused) {
+          warn(res?.message ?? "Couldn't sync this folder.");
+          if (res?.state === "diverged") {
+            line(
+              import_picocolors17.default.dim(
+                "  This folder and Workser's copy have both changed. Open Workser to resolve it."
+              )
+            );
+          }
+          return;
+        }
+        if (res?.state === "empty") {
+          line("Nothing to sync yet \u2014 there's no code here or on Workser.");
+          return;
+        }
+        success("Synced");
+        if (res?.ref) line(import_picocolors17.default.dim(`  ${String(res.ref).slice(0, 7)}`));
+      });
+      if (refused) process.exitCode = 1;
+    })
+  );
+}
+
+// src/commands/workflow.ts
+var import_picocolors18 = __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(
@@ -5899,10 +6243,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_picocolors16.default.dim("No workflows yet. `workser workflow create`."));
+        if (!items?.length) return line(import_picocolors18.default.dim("No workflows yet. `workser workflow create`."));
         for (const w of items) {
-          const status = w.is_active ? import_picocolors16.default.green("active") : import_picocolors16.default.dim("inactive");
-          line(`${w.id}  ${import_picocolors16.default.bold(w.name ?? "Untitled")}  ${status}`);
+          const status = w.is_active ? import_picocolors18.default.green("active") : import_picocolors18.default.dim("inactive");
+          line(`${w.id}  ${import_picocolors18.default.bold(w.name ?? "Untitled")}  ${status}`);
         }
       });
     })
@@ -5914,7 +6258,7 @@ function registerWorkflow(program3) {
       const res = await api(ctx, `/v1/projects/${projectId}/workflows`, {
         body: { name: args[0], ...extra }
       });
-      ok(res, () => line(`Created workflow ${import_picocolors16.default.bold(res.id)}.`));
+      ok(res, () => line(`Created workflow ${import_picocolors18.default.bold(res.id)}.`));
     })
   );
   wf.command("get <id>").description("Show a workflow's full definition").action(
@@ -5949,8 +6293,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_picocolors16.default.dim("No runs yet."));
-        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors16.default.dim(e.started_at ?? "")}`);
+        if (!items?.length) return line(import_picocolors18.default.dim("No runs yet."));
+        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors18.default.dim(e.started_at ?? "")}`);
       });
     })
   );
@@ -5958,15 +6302,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_picocolors16.default.dim("No matching node types."));
-        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors16.default.dim(n.category ?? "")}`);
+        if (!items?.length) return line(import_picocolors18.default.dim("No matching node types."));
+        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors18.default.dim(n.category ?? "")}`);
       });
     })
   );
 }
 
 // src/commands/app.ts
-var import_picocolors17 = __toESM(require_picocolors(), 1);
+var import_picocolors19 = __toESM(require_picocolors(), 1);
 function registerApp(program3) {
   const appCmd = program3.command("app").description("Connect and use third-party app integrations (Gmail, Slack, Stripe, ...)");
   appCmd.command("list").description("List connectable toolkits and this project's existing connections").option("--toolkit <slug>", "filter connections to one toolkit").action(
@@ -5979,8 +6323,8 @@ function registerApp(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_picocolors17.default.green("connected") : import_picocolors17.default.dim("not connected");
-          line(`${t.slug}  ${import_picocolors17.default.bold(t.name ?? t.slug)}  ${status}`);
+          const status = connected.has(t.slug) ? import_picocolors19.default.green("connected") : import_picocolors19.default.dim("not connected");
+          line(`${t.slug}  ${import_picocolors19.default.bold(t.name ?? t.slug)}  ${status}`);
         }
       });
     })
@@ -5997,7 +6341,7 @@ function registerApp(program3) {
       });
       ok(
         res,
-        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors17.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
+        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors19.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
       );
     })
   );
@@ -6015,8 +6359,8 @@ function registerApp(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_picocolors17.default.dim("No tools found."));
-        for (const t of items) line(`${t.slug}  ${import_picocolors17.default.dim(t.description ?? "")}`);
+        if (!items?.length) return line(import_picocolors19.default.dim("No tools found."));
+        for (const t of items) line(`${t.slug}  ${import_picocolors19.default.dim(t.description ?? "")}`);
       });
     })
   );
@@ -6032,7 +6376,7 @@ function registerApp(program3) {
 }
 
 // src/commands/tool.ts
-var import_picocolors18 = __toESM(require_picocolors(), 1);
+var import_picocolors20 = __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"
@@ -6041,7 +6385,7 @@ function registerTool(program3) {
     action(async ({ ctx }) => {
       const tools = await api(ctx, "/v1/tool/list");
       ok(tools, () => {
-        if (!tools?.length) return line(import_picocolors18.default.dim("No tools available."));
+        if (!tools?.length) return line(import_picocolors20.default.dim("No tools available."));
         const byCategory = /* @__PURE__ */ new Map();
         for (const t of tools) {
           const list = byCategory.get(t.category) ?? [];
@@ -6049,9 +6393,9 @@ function registerTool(program3) {
           byCategory.set(t.category, list);
         }
         for (const [category, items] of byCategory) {
-          line(import_picocolors18.default.bold(category) + ":");
+          line(import_picocolors20.default.bold(category) + ":");
           for (const t of items) {
-            line(`  ${t.name}  ${import_picocolors18.default.dim(t.description ?? "")}`);
+            line(`  ${t.name}  ${import_picocolors20.default.dim(t.description ?? "")}`);
           }
         }
       });
@@ -6069,7 +6413,7 @@ function registerTool(program3) {
 }
 
 // src/commands/memory.ts
-var import_picocolors19 = __toESM(require_picocolors(), 1);
+var import_picocolors21 = __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(
@@ -6093,9 +6437,9 @@ function registerMemory(program3) {
       });
       ok(res, () => {
         const results = res?.results ?? res ?? [];
-        if (!results?.length) return line(import_picocolors19.default.dim("No matching memories."));
+        if (!results?.length) return line(import_picocolors21.default.dim("No matching memories."));
         for (const r of results) {
-          line(`${import_picocolors19.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
+          line(`${import_picocolors21.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
         }
       });
     })
@@ -6112,7 +6456,7 @@ function registerMemory(program3) {
 }
 
 // src/commands/business.ts
-var import_picocolors20 = __toESM(require_picocolors(), 1);
+var import_picocolors22 = __toESM(require_picocolors(), 1);
 var RESOURCE_PATHS = {
   "business-config": "business-config",
   "business-settings": "business-settings",
@@ -6172,7 +6516,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_picocolors20.default.bold(res?.id ?? "")}.`));
+      ok(res, () => line(`Created ${resource} ${import_picocolors22.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(
@@ -6214,7 +6558,7 @@ function businessPath(projectId, resource, subpath) {
 }
 
 // src/commands/artifact.ts
-var import_picocolors21 = __toESM(require_picocolors(), 1);
+var import_picocolors23 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve2, basename as basename3 } from "path";
 var KINDS = [
@@ -6280,7 +6624,7 @@ function registerArtifact(program3) {
       ok(
         res,
         () => success(
-          `Recorded ${import_picocolors21.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors21.default.dim(` (${res.kind})`) : ""}`
+          `Recorded ${import_picocolors23.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors23.default.dim(` (${res.kind})`) : ""}`
         )
       );
     })
@@ -6294,11 +6638,11 @@ function registerArtifact(program3) {
 }
 function printRun(run) {
   if (!run) return;
-  line(`  run      ${import_picocolors21.default.bold(run.runId)}`);
+  line(`  run      ${import_picocolors23.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_picocolors21.default.dim(run.cwd)}`);
+  if (run.cwd) line(`  folder   ${import_picocolors23.default.dim(run.cwd)}`);
 }
 
 // src/commands/image.ts
@@ -6372,7 +6716,7 @@ async function download(url, output) {
 }
 
 // src/commands/ask.ts
-var import_picocolors22 = __toESM(require_picocolors(), 1);
+var import_picocolors24 = __toESM(require_picocolors(), 1);
 var TYPES = [
   "input",
   "choice",
@@ -6423,7 +6767,7 @@ function registerAsk(program3) {
           code: "bad_request"
         });
       }
-      info(import_picocolors22.default.dim("Waiting for the user to answer\u2026"));
+      info(import_picocolors24.default.dim("Waiting for the user to answer\u2026"));
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}/ask`, {
         body: {
           type,
@@ -6449,12 +6793,12 @@ function deriveTitle(message) {
 function printAnswer(res) {
   if (!res) return;
   if (res.status === "answered") {
-    line(`  ${import_picocolors22.default.green("answered")}`);
+    line(`  ${import_picocolors24.default.green("answered")}`);
     const value = extract(res.response);
     if (value) line(`  ${value}`);
     return;
   }
-  line(`  ${import_picocolors22.default.yellow(res.status)}  ${import_picocolors22.default.dim(res.reason ?? "")}`);
+  line(`  ${import_picocolors24.default.yellow(res.status)}  ${import_picocolors24.default.dim(res.reason ?? "")}`);
 }
 function extract(response) {
   if (response == null) return "";
@@ -6473,7 +6817,7 @@ function extract(response) {
 }
 
 // src/commands/search.ts
-var import_picocolors23 = __toESM(require_picocolors(), 1);
+var import_picocolors25 = __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 }) => {
@@ -6486,9 +6830,9 @@ function registerSearch(program3) {
           line("");
         }
         const results = res?.results ?? [];
-        if (!results.length) return line(import_picocolors23.default.dim("No results."));
+        if (!results.length) return line(import_picocolors25.default.dim("No results."));
         for (const r of results) {
-          line(`${r.title || import_picocolors23.default.dim("(untitled)")}  ${import_picocolors23.default.dim(r.url)}`);
+          line(`${r.title || import_picocolors25.default.dim("(untitled)")}  ${import_picocolors25.default.dim(r.url)}`);
         }
       });
     })
@@ -6496,7 +6840,7 @@ function registerSearch(program3) {
 }
 
 // src/commands/board.ts
-var import_picocolors24 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 
 // src/commands/record-step.ts
 async function recordEntityStep(ctx, opts) {
@@ -6535,7 +6879,7 @@ function registerBoard(program3) {
       }
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors24.default.dim("No cards on the Board yet."));
+          line(import_picocolors26.default.dim("No cards on the Board yet."));
           return;
         }
         for (const r of rows) line(formatRow(r));
@@ -6550,7 +6894,7 @@ function registerBoard(program3) {
         `/v1/projects/${projectId}/work-items/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors24.default.bold(row.title)}  ${import_picocolors24.default.dim(row.id)}`);
+        line(`${import_picocolors26.default.bold(row.title)}  ${import_picocolors26.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(", ")}`);
@@ -6591,7 +6935,7 @@ ${row.description}`);
         refId: row?.id,
         output: { workItem: row }
       });
-      ok(row, () => line(`Created work item ${import_picocolors24.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created work item ${import_picocolors26.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(
@@ -6625,7 +6969,7 @@ ${row.description}`);
         );
       }
       const row = await patchItem(ctx, projectId, String(args[0]), body);
-      ok(row, () => line(`Updated ${import_picocolors24.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
+      ok(row, () => line(`Updated ${import_picocolors26.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
     })
   );
   board.command("move <id> <status>").description(
@@ -6636,14 +6980,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_picocolors24.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
+      ok(row, () => line(`Moved ${import_picocolors26.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_picocolors24.default.bold(row.title)} ${statusTag(row.status)}`));
+      ok(row, () => line(`Closed ${import_picocolors26.default.bold(row.title)} ${statusTag(row.status)}`));
     })
   );
 }
@@ -6676,23 +7020,293 @@ function assertPriority(value) {
   }
 }
 function formatRow(r) {
-  const labels = r.labels?.length ? import_picocolors24.default.dim(` [${r.labels.join(", ")}]`) : "";
-  const owner = r.ownerHuman ? import_picocolors24.default.dim(` @${r.ownerHuman}`) : "";
-  return `${import_picocolors24.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
+  const labels = r.labels?.length ? import_picocolors26.default.dim(` [${r.labels.join(", ")}]`) : "";
+  const owner = r.ownerHuman ? import_picocolors26.default.dim(` @${r.ownerHuman}`) : "";
+  return `${import_picocolors26.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
 }
 function statusTag(status) {
   const label = status.padEnd(11);
-  if (status === "done") return import_picocolors24.default.green(label);
-  if (status === "in-progress") return import_picocolors24.default.yellow(label);
-  if (status === "in-review") return import_picocolors24.default.cyan(label);
-  return import_picocolors24.default.dim(label);
+  if (status === "done") return import_picocolors26.default.green(label);
+  if (status === "in-progress") return import_picocolors26.default.yellow(label);
+  if (status === "in-review") return import_picocolors26.default.cyan(label);
+  return import_picocolors26.default.dim(label);
 }
 function collect2(value, previous) {
   return [...previous, value];
 }
 
+// src/commands/task.ts
+var import_picocolors27 = __toESM(require_picocolors(), 1);
+var STATUSES2 = ["todo", "working", "checking", "ready", "accepted", "archived"];
+var ROLES = ["pm", "architect", "web", "api", "automation", "qa"];
+var KINDS2 = ["data_reports", "web", "mobile", "service", "automation", "docs"];
+function registerTask(program3) {
+  const task = program3.command("task").description("The project's tasks and their subtasks (AI Tech Team)");
+  task.command("list").description("List the board's tasks \u2014 run this before starting anything").option("--status <value>", `only tasks in this status (${STATUSES2.join(" | ")})`).option("--label <value>", "only tasks carrying this label").option("--limit <n>", "cap the number of tasks returned").action(
+    action(async ({ ctx, opts }) => {
+      requireProject(ctx);
+      if (opts.status !== void 0) assertOneOf("--status", opts.status, STATUSES2);
+      const rows = await api(ctx, "/v1/project-tasks", {
+        query: {
+          status: opts.status,
+          label: opts.label,
+          limit: opts.limit
+        }
+      }) ?? [];
+      ok(rows, () => {
+        if (!rows.length) {
+          line(import_picocolors27.default.dim("No tasks on the board yet."));
+          return;
+        }
+        for (const r of rows) line(formatRow2(r));
+      });
+    })
+  );
+  task.command("show [id]").description(
+    "Show one task with its subtasks. Defaults to the task this run is inside."
+  ).action(
+    action(async ({ ctx, args }) => {
+      const id = resolveTaskId(ctx, args[0]);
+      const row = await api(ctx, `/v1/project-tasks/${encodeURIComponent(id)}`);
+      ok(row, () => printTask(row));
+    })
+  );
+  const subtask = task.command("subtask").description("The steps a task is broken into");
+  subtask.command("add <title>").description(
+    'Add one step, e.g. `workser task subtask add "Build the upload screen" --role web`'
+  ).option("--task <id>", "the parent task (defaults to the task this run is inside)").option("--role <value>", `who does it (${ROLES.join(" | ")})`).option("--kind <value>", `what it produces (${KINDS2.join(" | ")})`).option("--note <text>", "one sentence on what this step does").option("--app <id...>", "app ids this step touches").option("--infra <ref...>", "shared setup it touches (database | storage | auth | hosting | jobs)").option("--scope <path...>", "files or folders THIS step owns").option("--depends-on <id...>", "steps that must finish first (key or id)").action(
+    action(async ({ ctx, args, opts }) => {
+      const parent = resolveTaskId(ctx, opts.task);
+      if (opts.role !== void 0) assertOneOf("--role", opts.role, ROLES);
+      if (opts.kind !== void 0) assertOneOf("--kind", opts.kind, KINDS2);
+      const dependsOn = await resolveDeps(ctx, parent, opts.dependsOn ?? []);
+      const row = await api(ctx, "/v1/project-tasks", {
+        body: {
+          parentTaskId: parent,
+          title: args[0],
+          summary: opts.note,
+          role: opts.role,
+          category: opts.kind,
+          scopePaths: opts.scope,
+          dependsOn,
+          targets: [
+            ...(opts.app ?? []).map((appId) => ({ kind: "app", appId })),
+            ...(opts.infra ?? []).map((ref) => ({ kind: "infra", ref }))
+          ]
+        }
+      });
+      ok(row, () => {
+        line(`${import_picocolors27.default.green("added")} ${import_picocolors27.default.bold(row.title)}  ${import_picocolors27.default.dim(row.key ?? row.id)}`);
+        if (row.role) line(import_picocolors27.default.dim(`role: ${row.role}`));
+      });
+    })
+  );
+  subtask.command("list [taskId]").description("The steps of a task, in order").action(
+    action(async ({ ctx, args }) => {
+      const id = resolveTaskId(ctx, args[0]);
+      const row = await api(ctx, `/v1/project-tasks/${encodeURIComponent(id)}`);
+      const rows = row.subtasks ?? [];
+      ok(rows, () => {
+        if (!rows.length) {
+          line(import_picocolors27.default.dim("No steps yet."));
+          return;
+        }
+        rows.forEach((r, i) => line(formatSubtask(r, i + 1)));
+      });
+    })
+  );
+  subtask.command("update <id>").description("Change a step \u2014 its title, its role, what it touches").option("--title <text>").option("--note <text>").option("--role <value>", ROLES.join(" | ")).option("--kind <value>", KINDS2.join(" | ")).option("--scope <path...>", "replaces the step's scope entirely").action(
+    action(async ({ ctx, args, opts }) => {
+      if (opts.role !== void 0) assertOneOf("--role", opts.role, ROLES);
+      if (opts.kind !== void 0) assertOneOf("--kind", opts.kind, KINDS2);
+      const row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(args[0])}`,
+        {
+          method: "PATCH",
+          body: {
+            title: opts.title,
+            summary: opts.note,
+            role: opts.role,
+            category: opts.kind,
+            scopePaths: opts.scope
+          }
+        }
+      );
+      ok(row, () => line(`${import_picocolors27.default.green("updated")} ${import_picocolors27.default.bold(row.title)}`));
+    })
+  );
+  subtask.command("remove <id>").description("Drop a step from the plan (only before the work starts)").action(
+    action(async ({ ctx, args }) => {
+      await api(ctx, `/v1/project-tasks/${encodeURIComponent(args[0])}`, {
+        method: "DELETE"
+      });
+      ok({ removed: args[0] }, () => line(import_picocolors27.default.green("removed")));
+    })
+  );
+  task.command("move <id> <status>").description(`Move a task or step along the board (${STATUSES2.join(" | ")})`).action(
+    action(async ({ ctx, args }) => {
+      assertOneOf("<status>", args[1], STATUSES2);
+      const row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(args[0])}/move`,
+        { body: { status: args[1] } }
+      );
+      ok(row, () => line(`${import_picocolors27.default.green("moved")} ${import_picocolors27.default.bold(row.title)} \u2192 ${args[1]}`));
+    })
+  );
+  task.command("can-start [id]").description("Ask whether work on this task may begin. Refuses until the owner approves.").action(
+    action(async ({ ctx, args }) => {
+      const id = resolveTaskId(ctx, args[0]);
+      const row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(id)}/dispatch-check`,
+        { method: "POST" }
+      );
+      ok(row, () => line(import_picocolors27.default.green("approved \u2014 you may start")));
+    })
+  );
+  task.command("approval").description("Ask the owner to approve the plan, or record their decision").argument("<request|approve|decline>").option("--task <id>", "defaults to the task this run is inside").option("--note <text>", "why").action(
+    action(async ({ ctx, args, opts }) => {
+      const id = resolveTaskId(ctx, opts.task);
+      const what = args[0];
+      if (what === "request") {
+        const row2 = await api(
+          ctx,
+          `/v1/project-tasks/${encodeURIComponent(id)}`
+        );
+        ok({ awaiting: row2.approval_state === "awaiting", task: row2 }, () => {
+          line(
+            row2.approval_state === "awaiting" ? import_picocolors27.default.yellow("The plan is waiting on the owner. They see it in the task.") : `Already ${row2.approval_state}.`
+          );
+        });
+        return;
+      }
+      if (what !== "approve" && what !== "decline") {
+        throw new WorkserError(
+          `Expected "request", "approve" or "decline", got "${what}".`,
+          { code: "bad_request" }
+        );
+      }
+      const row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(id)}/approval`,
+        {
+          body: {
+            decision: what === "approve" ? "approved" : "declined",
+            note: opts.note
+          }
+        }
+      );
+      ok(row, () => line(`${import_picocolors27.default.green(row.approval_state)} ${import_picocolors27.default.bold(row.title)}`));
+    })
+  );
+  task.command("done [id]").description("Record what a step produced, and move it to ready").option("--summary <text>", "what changed, in the owner's words").action(
+    action(async ({ ctx, args, opts }) => {
+      const id = resolveTaskId(ctx, args[0]);
+      await api(ctx, `/v1/project-tasks/${encodeURIComponent(id)}`, {
+        method: "PATCH",
+        body: { resultSummary: opts.summary }
+      });
+      const row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(id)}/move`,
+        { body: { status: "ready" } }
+      );
+      ok(row, () => line(`${import_picocolors27.default.green("ready")} ${import_picocolors27.default.bold(row.title)}`));
+    })
+  );
+}
+function resolveTaskId(ctx, given) {
+  const id = given || ctx.projectTaskId;
+  if (!id) {
+    throw new WorkserError(
+      "No task. This run isn't inside one (WORKSER_PROJECT_TASK_ID is unset), so pass --task <id or key>.",
+      { code: "no_task" }
+    );
+  }
+  return id;
+}
+async function resolveDeps(ctx, parentId, given) {
+  if (!given.length) return void 0;
+  const parent = await api(
+    ctx,
+    `/v1/project-tasks/${encodeURIComponent(parentId)}`
+  );
+  const byKey = /* @__PURE__ */ new Map();
+  for (const s of parent.subtasks ?? []) {
+    byKey.set(s.id, s.id);
+    if (s.key) byKey.set(s.key, s.id);
+  }
+  return given.map((g) => {
+    const id = byKey.get(g);
+    if (!id) {
+      throw new WorkserError(
+        `"${g}" is not a step of this task. Run \`workser task subtask list\` to see them.`,
+        { code: "bad_request" }
+      );
+    }
+    return id;
+  });
+}
+function assertOneOf(flag, value, allowed) {
+  if (!allowed.includes(value)) {
+    throw new WorkserError(
+      `${flag} must be one of: ${allowed.join(", ")} \u2014 got "${value}".`,
+      { code: "bad_request" }
+    );
+  }
+}
+function formatRow2(r) {
+  const key = import_picocolors27.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
+  const steps = r.subtaskTotal ? import_picocolors27.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
+  const gate = r.approval_state === "awaiting" ? import_picocolors27.default.yellow(" awaiting approval") : "";
+  return `${key} ${statusTag2(r.status)} ${r.title}${steps}${gate}`;
+}
+function formatSubtask(r, index) {
+  const n = import_picocolors27.default.dim(String(index).padStart(2, "0"));
+  const role = r.role ? import_picocolors27.default.dim(` [${r.role}]`) : "";
+  const scope = r.scope_paths?.length ? import_picocolors27.default.dim(`  owns: ${r.scope_paths.join(", ")}`) : "";
+  return `${n} ${statusTag2(r.status)} ${r.title}${role}${scope}`;
+}
+function printTask(row) {
+  line(`${import_picocolors27.default.bold(row.title)}  ${import_picocolors27.default.dim(row.key ?? row.id)}`);
+  line(`${statusTag2(row.status)}  approval: ${row.approval_state}`);
+  if (row.summary) line(`
+${row.summary}`);
+  if (row.targets?.length) {
+    line(
+      `
+touches: ${row.targets.map((t) => t.appName ?? t.ref ?? t.kind).join(", ")}`
+    );
+  }
+  if (row.subtasks?.length) {
+    line(`
+${import_picocolors27.default.bold("steps")}`);
+    row.subtasks.forEach((s, i) => line(formatSubtask(s, i + 1)));
+  } else {
+    line(import_picocolors27.default.dim("\nNo steps yet."));
+  }
+}
+function statusTag2(status) {
+  switch (status) {
+    case "ready":
+      return import_picocolors27.default.green("[ready]");
+    case "working":
+      return import_picocolors27.default.blue("[working]");
+    case "checking":
+      return import_picocolors27.default.cyan("[checking]");
+    case "accepted":
+      return import_picocolors27.default.green("[accepted]");
+    case "archived":
+      return import_picocolors27.default.dim("[archived]");
+    default:
+      return import_picocolors27.default.dim("[todo]");
+  }
+}
+
 // src/commands/decision.ts
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __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(
@@ -6705,11 +7319,11 @@ function registerDecision(program3) {
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors25.default.dim("No decisions recorded yet."));
+          line(import_picocolors28.default.dim("No decisions recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors25.default.dim(r.id)}  ${import_picocolors25.default.dim(shortDate(r.createdAt))}  ${r.title}`);
+          line(`${import_picocolors28.default.dim(r.id)}  ${import_picocolors28.default.dim(shortDate(r.createdAt))}  ${r.title}`);
           line(`    ${truncate(r.decision, 100)}`);
         }
       });
@@ -6723,16 +7337,16 @@ function registerDecision(program3) {
         `/v1/projects/${projectId}/architecture-decisions/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors25.default.bold(row.title)}  ${import_picocolors25.default.dim(row.id)}`);
-        line(import_picocolors25.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.id)}`);
+        line(import_picocolors28.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
-${import_picocolors25.default.bold("Context")}
+${import_picocolors28.default.bold("Context")}
 ${row.context}`);
         line(`
-${import_picocolors25.default.bold("Decision")}
+${import_picocolors28.default.bold("Decision")}
 ${row.decision}`);
         if (row.consequences) line(`
-${import_picocolors25.default.bold("Consequences")}
+${import_picocolors28.default.bold("Consequences")}
 ${row.consequences}`);
       });
     })
@@ -6761,7 +7375,7 @@ ${row.consequences}`);
         refId: row?.id,
         output: { decision: row }
       });
-      ok(row, () => line(`Recorded decision ${import_picocolors25.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded decision ${import_picocolors28.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   const requirement = program3.command("requirement").description("Read and record the project's requirements");
@@ -6773,11 +7387,11 @@ ${row.consequences}`);
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors25.default.dim("No requirements recorded yet."));
+          line(import_picocolors28.default.dim("No requirements recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors25.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
+          line(`${import_picocolors28.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
         }
       });
     })
@@ -6790,8 +7404,8 @@ ${row.consequences}`);
         `/v1/projects/${projectId}/requirements/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors25.default.bold(row.title)}  ${import_picocolors25.default.dim(row.id)}`);
-        line(import_picocolors25.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.id)}`);
+        line(import_picocolors28.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
 ${row.body}`);
       });
@@ -6817,7 +7431,7 @@ ${row.body}`);
         refId: row?.id,
         output: { requirement: row }
       });
-      ok(row, () => line(`Recorded requirement ${import_picocolors25.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded requirement ${import_picocolors28.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   requirement.command("update <id>").description(
@@ -6846,7 +7460,7 @@ ${row.body}`);
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated requirement ${import_picocolors25.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
+      ok(row, () => line(`Updated requirement ${import_picocolors28.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
     })
   );
 }
@@ -6869,7 +7483,7 @@ function shortDate(iso) {
 }
 
 // src/commands/doc.ts
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 function registerDoc(program3) {
   const doc = program3.command("doc").description("Read and write project documents");
   doc.command("list").description("List the project's documents \u2014 check here before writing a new one").option("--work-item <id>", "the document linked to this card, if there is one").action(
@@ -6880,13 +7494,13 @@ function registerDoc(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors26.default.dim("No documents yet."));
+          line(import_picocolors29.default.dim("No documents yet."));
           return;
         }
         for (const r of rows) {
-          const link = r.workItemId ? import_picocolors26.default.dim(` \u21B3 ${r.workItemId}`) : "";
-          const file = r.filePath ? import_picocolors26.default.dim(`  ${r.filePath}`) : "";
-          line(`${import_picocolors26.default.dim(r.id)}  ${r.title}${link}${file}`);
+          const link = r.workItemId ? import_picocolors29.default.dim(` \u21B3 ${r.workItemId}`) : "";
+          const file = r.filePath ? import_picocolors29.default.dim(`  ${r.filePath}`) : "";
+          line(`${import_picocolors29.default.dim(r.id)}  ${r.title}${link}${file}`);
         }
       });
     })
@@ -6900,17 +7514,17 @@ function registerDoc(program3) {
       );
       if (opts.markdown) {
         ok({ id: row.id, title: row.title, filePath: row.filePath }, () => {
-          line(`${import_picocolors26.default.bold(row.title)}  ${import_picocolors26.default.dim(row.id)}`);
+          line(`${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.id)}`);
           line(
-            row.filePath ? `Read it at ${import_picocolors26.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors26.default.dim("This document has no markdown mirror on disk yet.")
+            row.filePath ? `Read it at ${import_picocolors29.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors29.default.dim("This document has no markdown mirror on disk yet.")
           );
         });
         return;
       }
       ok(row, () => {
-        line(`${import_picocolors26.default.bold(row.title)}  ${import_picocolors26.default.dim(row.id)}`);
-        if (row.workItemId) line(import_picocolors26.default.dim(`linked to work item ${row.workItemId}`));
-        if (row.filePath) line(import_picocolors26.default.dim(`markdown mirror: ${row.filePath}`));
+        line(`${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.id)}`);
+        if (row.workItemId) line(import_picocolors29.default.dim(`linked to work item ${row.workItemId}`));
+        if (row.filePath) line(import_picocolors29.default.dim(`markdown mirror: ${row.filePath}`));
         line("");
         line(row.contentJson);
       });
@@ -6939,7 +7553,7 @@ function registerDoc(program3) {
         refId: row?.id,
         output: { document: row }
       });
-      ok(row, () => line(`Created document ${import_picocolors26.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created document ${import_picocolors29.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   doc.command("update <id>").description("Revise an existing document rather than creating a second copy of it").option("--title <text>", "new title").option("--markdown <text>", "replace the body with this markdown").option("--content-json <json>", "replace the body with this rich-text content JSON").action(
@@ -6966,13 +7580,13 @@ function registerDoc(program3) {
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated document ${import_picocolors26.default.bold(row.id)} \u2014 ${row.title}`));
+      ok(row, () => line(`Updated document ${import_picocolors29.default.bold(row.id)} \u2014 ${row.title}`));
     })
   );
 }
 
 // src/commands/design.ts
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __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(
@@ -6986,11 +7600,11 @@ function registerDesign(program3) {
       if (opts.raw) {
         ok(files, () => {
           if (!files.length) {
-            line(import_picocolors27.default.dim("No brand set for this project."));
+            line(import_picocolors30.default.dim("No brand set for this project."));
             return;
           }
           for (const f of files) {
-            line(import_picocolors27.default.bold(f.path));
+            line(import_picocolors30.default.bold(f.path));
             line(f.contents);
             line("");
           }
@@ -7007,21 +7621,21 @@ function registerDesign(program3) {
       } : { hasBrand: false, colors: {}, fonts: {}, brand: {}, files: [] };
       ok(summary, () => {
         if (!tokens) {
-          line(import_picocolors27.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
+          line(import_picocolors30.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_picocolors27.default.dim(name.padEnd(12))} ${value}`);
+          line(`${import_picocolors30.default.dim(name.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.color)) {
-          line(`${import_picocolors27.default.dim(`color.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors30.default.dim(`color.${name}`.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.font)) {
-          line(`${import_picocolors27.default.dim(`font.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors30.default.dim(`font.${name}`.padEnd(12))} ${value}`);
         }
         line("");
         line(
-          import_picocolors27.default.dim(
+          import_picocolors30.default.dim(
             `Generated into the working tree as ${files.map((f) => f.path).join(", ")} \u2014 wire those in, never edit them.`
           )
         );
@@ -7053,7 +7667,7 @@ function unwrap(group) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.2.6" : "0.0.0-dev"
+  version: true ? "0.3.0" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(
@@ -7086,6 +7700,8 @@ registerOpen(program2);
 registerDoctor(program2);
 registerAgent(program2);
 registerVerify(program2);
+registerCheckpoint(program2);
+registerSync(program2);
 registerWorkflow(program2);
 registerApp(program2);
 registerTool(program2);
@@ -7096,6 +7712,7 @@ registerImage(program2);
 registerAsk(program2);
 registerSearch(program2);
 registerBoard(program2);
+registerTask(program2);
 registerDecision(program2);
 registerDoc(program2);
 registerDesign(program2);