@workser/cli 0.6.9 → 0.6.11

package/dist/index.js

@@ -8639,6 +8639,50 @@ 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 = [
   "todo",
   "working",
@@ -8817,6 +8861,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 +8887,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 +8949,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 +8979,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)
@@ -11066,7 +11124,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.9" : "0.0.0-dev"
+  version: true ? "0.6.11" : "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.9",
+  "version": "0.6.11",
   "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",