@workser/cli 0.6.7 → 0.6.8

package/AGENTS.md

@@ -100,6 +100,15 @@ workser audio understand "<query>" [--url <u>|--file <p>] [-t <task>]  # transcr
 
 workser ask "<question>" [--type <t>] [--option <o>] # ask the user, WAIT for the answer
 
+# Tasks and subtasks (the plan shown in Orbit)
+workser task show [id]                              # inspect the task and its current plan
+workser task subtask list [taskId]                  # list the task's subtasks
+workser task subtask add "<title>" --role <role>    # add one proposed subtask
+workser task subtask update <id> --role <role>      # fix its teammate after creation
+workser task subtask update <id> --title "…" --note "…" --scope <paths...>
+workser task subtask remove <id>                    # remove it before work starts
+workser task start [id]                             # starts only an already-approved plan
+
 # owner-only (will return owner_only / exit 6 — ask the user to do these in Orbit):
 #   project create, project use, env rm, domain set
 ```
@@ -119,12 +128,12 @@ workser doc create "<title>" --markdown <text> | doc update <id> --markdown <tex
 already doing and what this project chose on purpose, so you don't re-file work or
 quietly reverse a decision.
 
-**A plan with phases goes on the Board before you build it.** The moment you split a
-task into more than one phase: one `board create` card per phase (only the one you're
-doing goes to `in-progress`), the plan itself as one `doc create --markdown` — with
-**no `--work-item`**, because a linked doc is shown on its card and hidden from the
-Docs panel — and a `decision create` if the plan settled a real tradeoff. A plan that
-lives only in your reply is gone as soon as the conversation scrolls.
+**A plan with phases goes on this task's Subtasks list, not the Board.** Use one
+`task subtask add` per phase. If you spot a bad title, role, note, or file scope after
+creation, correct that existing row with `task subtask update <id>`; do not say it is
+locked, create a replacement, or duplicate the plan. Write the plan narrative once
+as `doc create --markdown` with no `--work-item`, and record a real tradeoff with
+`decision create`.
 
 **Keep it true as you work.** `board move <id> in-progress` when you pick it up,
 `in-review` when it's ready to look at, `board close <id>` when it's done and

package/dist/index.js

@@ -8494,15 +8494,33 @@ function collect2(value, previous) {
 
 // src/commands/task.ts
 var import_picocolors28 = __toESM(require_picocolors(), 1);
-var STATUSES2 = ["todo", "working", "checking", "ready", "accepted", "archived"];
+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"];
+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(
+  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);
+      if (opts.status !== void 0)
+        assertOneOf("--status", opts.status, STATUSES2);
       const rows = await api(ctx, "/v1/project-tasks", {
         query: {
           status: opts.status,
@@ -8524,7 +8542,10 @@ function registerTask(program3) {
   ).action(
     action(async ({ ctx, args }) => {
       const id = args[0] || ctx.parentTaskId || resolveTaskId(ctx);
-      const row = await api(ctx, `/v1/project-tasks/${encodeURIComponent(id)}`);
+      const row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(id)}`
+      );
       const goalId = row.goal_id;
       const goal = goalId ? await api(
         ctx,
@@ -8554,8 +8575,14 @@ function registerTask(program3) {
           goalId: opts.goal,
           phase: opts.phase,
           targets: [
-            ...(opts.app ?? []).map((appId) => ({ kind: "app", appId })),
-            ...(opts.infra ?? []).map((ref) => ({ kind: "infra", ref }))
+            ...(opts.app ?? []).map((appId) => ({
+              kind: "app",
+              appId
+            })),
+            ...(opts.infra ?? []).map((ref) => ({
+              kind: "infra",
+              ref
+            }))
           ],
           ...hasChannelOrigin ? {
             channelId: ctx.projectChannelId,
@@ -8595,8 +8622,11 @@ function registerTask(program3) {
         ...channelMessageError ? { channelMessageError } : {}
       };
       ok(result, () => {
-        line(`${import_picocolors28.default.green("opened")} ${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.key ?? row.id)}`);
-        if (channelMessage) line(import_picocolors28.default.dim("posted to the channel as Project Manager"));
+        line(
+          `${import_picocolors28.default.green("opened")} ${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.key ?? row.id)}`
+        );
+        if (channelMessage)
+          line(import_picocolors28.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}`
@@ -8608,10 +8638,19 @@ function registerTask(program3) {
   const subtask = task.command("subtask").description("The subtasks a task is broken into");
   subtask.command("add <title>").description(
     'Add one subtask, 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 subtask does").option(
+  ).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 subtask does").option(
     "--app <id...>",
     "the app this subtask is for \u2014 one id runs it inside that app's folder; leave it off and it runs at the project, seeing every app"
-  ).option("--infra <ref...>", "shared setup it touches (database | storage | auth | hosting | jobs)").option("--scope <path...>", "files or folders THIS subtask owns").option("--depends-on <id...>", "subtasks that must finish first (key or id)").action(
+  ).option(
+    "--infra <ref...>",
+    "shared setup it touches (database | storage | auth | hosting | jobs)"
+  ).option("--scope <path...>", "files or folders THIS subtask owns").option(
+    "--depends-on <id...>",
+    "subtasks 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);
@@ -8627,13 +8666,21 @@ function registerTask(program3) {
           scopePaths: opts.scope,
           dependsOn,
           targets: [
-            ...(opts.app ?? []).map((appId) => ({ kind: "app", appId })),
-            ...(opts.infra ?? []).map((ref) => ({ kind: "infra", ref }))
+            ...(opts.app ?? []).map((appId) => ({
+              kind: "app",
+              appId
+            })),
+            ...(opts.infra ?? []).map((ref) => ({
+              kind: "infra",
+              ref
+            }))
           ]
         }
       });
       ok(row, () => {
-        line(`${import_picocolors28.default.green("added")} ${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.key ?? row.id)}`);
+        line(
+          `${import_picocolors28.default.green("added")} ${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.key ?? row.id)}`
+        );
         if (row.role) line(import_picocolors28.default.dim(`role: ${row.role}`));
       });
     })
@@ -8641,7 +8688,10 @@ function registerTask(program3) {
   subtask.command("list [taskId]").description("The subtasks 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 row = await api(
+        ctx,
+        `/v1/project-tasks/${encodeURIComponent(id)}`
+      );
       const rows = row.subtasks ?? [];
       ok(rows, () => {
         if (!rows.length) {
@@ -8681,7 +8731,9 @@ function registerTask(program3) {
       ok({ removed: args[0] }, () => line(import_picocolors28.default.green("removed")));
     })
   );
-  task.command("move <id> <status>").description(`Move a task or step along the board (${STATUSES2.join(" | ")})`).action(
+  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(
@@ -8689,7 +8741,10 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(args[0])}/move`,
         { body: { status: args[1] } }
       );
-      ok(row, () => line(`${import_picocolors28.default.green("moved")} ${import_picocolors28.default.bold(row.title)} \u2192 ${args[1]}`));
+      ok(
+        row,
+        () => line(`${import_picocolors28.default.green("moved")} ${import_picocolors28.default.bold(row.title)} \u2192 ${args[1]}`)
+      );
     })
   );
   task.command("resume [id]").description(
@@ -8740,7 +8795,9 @@ function registerTask(program3) {
       });
     })
   );
-  task.command("can-start [id]").description("Ask whether work on this task may begin. Refuses until the owner approves.").action(
+  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(
@@ -8756,11 +8813,9 @@ function registerTask(program3) {
   ).action(
     action(async ({ ctx, args }) => {
       const id = resolveTaskId(ctx, args[0]);
-      const row = await api(
-        ctx,
-        `/v1/project-tasks/${encodeURIComponent(id)}/start`,
-        { method: "POST" }
-      );
+      const row = await api(ctx, `/v1/project-tasks/${encodeURIComponent(id)}/start`, {
+        method: "POST"
+      });
       ok(row, () => {
         const started = row?.started ?? null;
         if (started && started > 0) {
@@ -8786,7 +8841,9 @@ function registerTask(program3) {
         );
         ok({ awaiting: row2.approval_state === "awaiting", task: row2 }, () => {
           line(
-            row2.approval_state === "awaiting" ? import_picocolors28.default.yellow("The plan is waiting on the owner. They see it in the task.") : `Already ${row2.approval_state}.`
+            row2.approval_state === "awaiting" ? import_picocolors28.default.yellow(
+              "The plan is waiting on the owner. They see it in the task."
+            ) : `Already ${row2.approval_state}.`
           );
         });
         return;
@@ -8807,7 +8864,10 @@ function registerTask(program3) {
           }
         }
       );
-      ok(row, () => line(`${import_picocolors28.default.green(row.approval_state)} ${import_picocolors28.default.bold(row.title)}`));
+      ok(
+        row,
+        () => line(`${import_picocolors28.default.green(row.approval_state)} ${import_picocolors28.default.bold(row.title)}`)
+      );
     })
   );
   task.command("done [id]").description("Record what a subtask produced, and move it to ready").option("--summary <text>", "what changed, in the owner's words").action(
@@ -8936,7 +8996,11 @@ Nothing is running. The next part waiting is "${next.name}" \u2014 offer it to t
       )
     );
   } else if (!next) {
-    line(import_picocolors28.default.dim("\nEvery part of this plan is done. Say so, and offer to wrap it up."));
+    line(
+      import_picocolors28.default.dim(
+        "\nEvery part of this plan is done. Say so, and offer to wrap it up."
+      )
+    );
   }
   line(
     import_picocolors28.default.dim(
@@ -10791,7 +10855,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.7" : "0.0.0-dev"
+  version: true ? "0.6.8" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workser/cli",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "Workser CLI — give your local AI agent native DevOps & infrastructure on Workser. The agent runs `workser …` to provision, deploy, and manage real apps.",
   "license": "MIT",
   "type": "module",

package/skills/workser/SKILL.md

@@ -77,6 +77,9 @@ pick or switch it.
 3. **A phased plan goes on the subtask list, never the Board.** Phases are
    `workser task subtask add` (`workser help tasks`) — not `board create`,
    which makes a second, driftable "the plan" the task page never reads.
+   If a subtask's title, teammate, note, or scope is wrong after creation, fix
+   that same row with `workser task subtask update <id> --title … --role …
+   --note … --scope …`; never claim it is locked or create a duplicate.
    Write the narrative once as `doc create` (no `--work-item`, or it's hidden
    from the Docs panel), plus `decision create` for a real tradeoff. A plan
    in your reply alone is gone when the conversation scrolls. Details: