@workser/cli 0.6.10 → 0.6.12

package/dist/index.js

@@ -8639,7 +8639,58 @@ function collect2(value, previous) {
 
 // src/commands/task.ts
 var import_picocolors29 = __toESM(require_picocolors(), 1);
+
+// src/subtask-attachments.ts
+var MAX_REF_NOTE = 500;
+var MAX_REFS = 20;
+var URL_SCHEME = /^https?:\/\//i;
+function labelFor(type, value) {
+  if (type === "url") {
+    try {
+      return new URL(value).hostname.replace(/^www\./, "");
+    } catch {
+      return value;
+    }
+  }
+  const parts = value.split(/[\\/]/).filter(Boolean);
+  return parts[parts.length - 1] || value;
+}
+function parseRef(raw) {
+  const at = raw.indexOf("::");
+  const value = (at === -1 ? raw : raw.slice(0, at)).trim();
+  if (!value) return null;
+  const note = at === -1 ? "" : raw.slice(at + 2).trim().slice(0, MAX_REF_NOTE);
+  const type = URL_SCHEME.test(value) ? "url" : "file";
+  return {
+    type,
+    value,
+    label: labelFor(type, value),
+    ...note ? { note } : {}
+  };
+}
+function parseRefs(raw) {
+  if (!raw?.length) return [];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of raw) {
+    const parsed = parseRef(item);
+    if (!parsed) continue;
+    if (seen.has(parsed.value)) continue;
+    seen.add(parsed.value);
+    out.push(parsed);
+  }
+  return out.slice(0, MAX_REFS);
+}
+
+// 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",
@@ -8647,6 +8698,8 @@ var STATUSES2 = [
   "accepted",
   "archived"
 ];
+var PRIORITIES2 = ["urgent", "high", "normal", "low"];
+var SIZES = ["small", "standard"];
 var ROLES = [
   "pm",
   "architect",
@@ -8726,10 +8779,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
       );
@@ -8743,6 +8807,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",
@@ -8817,6 +8886,9 @@ function registerTask(program3) {
     "--infra <ref...>",
     "shared setup it touches (database | storage | auth | hosting | jobs)"
   ).option("--scope <path...>", "files or folders THIS subtask owns").option(
+    "--ref <spec...>",
+    'what this step should READ first \u2014 a path or URL, optionally "::why it matters" (repeatable)'
+  ).option(
     "--depends-on <id...>",
     "subtasks that must finish first (key or id)"
   ).option(
@@ -8840,6 +8912,10 @@ function registerTask(program3) {
           role: opts.role,
           category: opts.kind,
           scopePaths: opts.scope,
+          // What to read before doing it. Parsed here rather than pushed at
+          // the API so a malformed pointer is dropped where the agent can
+          // still be told, not stored and drawn as an empty chip.
+          attachments: parseRefs(opts.ref),
           dependsOn,
           targets: [
             ...(opts.app ?? []).map((appId) => ({
@@ -8898,6 +8974,9 @@ function registerTask(program3) {
     })
   );
   subtask.command("update <id>").description("Change a subtask \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 subtask's scope entirely").option(
+    "--ref <spec...>",
+    "replaces what this step should READ first \u2014 same form as `subtask add --ref`"
+  ).option(
     "--agent <id>",
     `run this step on a specific CLI (${AGENTS.join(" | ")}); "default" hands it back to the role's own`
   ).option("--model <id>", 'the model that CLI should use; "default" clears it').option(
@@ -8925,6 +9004,10 @@ function registerTask(program3) {
             role: opts.role,
             category: opts.kind,
             scopePaths: opts.scope,
+            // Only sent when `--ref` was actually given: the PATCH replaces
+            // the whole list, so passing `[]` for an untouched flag would
+            // clear a brief the manager set on a previous call.
+            attachments: opts.ref ? parseRefs(opts.ref) : void 0,
             agentOverride: clearable(opts.agent),
             agentModelOverride: clearable(opts.model),
             agentEffortOverride: clearable(opts.effort)
@@ -9365,6 +9448,47 @@ function registerGoal(program3) {
       );
     })
   );
+  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_picocolors30.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)) {
@@ -11066,7 +11190,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.10" : "0.0.0-dev"
+  version: true ? "0.6.12" : "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.10",
+  "version": "0.6.12",
   "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",