@flumecode/runner 0.3.0 → 0.3.2

package/dist/cli.js

@@ -39,8 +39,48 @@ function readVersion() {
 }
 var RUNNER_VERSION = readVersion();
 var RUNNER_VERSION_HEADER = "x-flumecode-runner-version";
+var RUNNER_MIN_VERSION_HEADER = "x-flumecode-min-runner-version";
+var RUNNER_LATEST_VERSION_HEADER = "x-flumecode-latest-runner-version";
+function compareVersions(a, b) {
+  const parse = (v) => (v.split("-")[0] ?? v).split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const pa = parse(a);
+  const pb = parse(b);
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
 
 // src/api.ts
+var OUTDATED_WARN_INTERVAL_MS = 60 * 6e4;
+var lastOutdatedWarnAt = 0;
+var UPDATE_NUDGE_INTERVAL_MS = 60 * 6e4;
+var lastUpdateNudgeAt = 0;
+function noteServerVersion(res) {
+  const min = res.headers.get(RUNNER_MIN_VERSION_HEADER)?.trim();
+  if (min && RUNNER_VERSION !== "unknown" && compareVersions(RUNNER_VERSION, min) < 0) {
+    const now2 = Date.now();
+    if (now2 - lastOutdatedWarnAt >= OUTDATED_WARN_INTERVAL_MS) {
+      lastOutdatedWarnAt = now2;
+      console.warn(
+        `\u26A0\uFE0F  This runner (v${RUNNER_VERSION}) is outdated \u2014 the server expects v${min} or newer.
+   Update with: npm install -g @flumecode/runner@latest`
+      );
+    }
+    return;
+  }
+  const latest = res.headers.get(RUNNER_LATEST_VERSION_HEADER)?.trim();
+  if (!latest || RUNNER_VERSION === "unknown") return;
+  if (compareVersions(RUNNER_VERSION, latest) >= 0) return;
+  const now = Date.now();
+  if (now - lastUpdateNudgeAt < UPDATE_NUDGE_INTERVAL_MS) return;
+  lastUpdateNudgeAt = now;
+  console.log(
+    `\u2139\uFE0F  A newer runner is available (v${latest}; you have v${RUNNER_VERSION}). Update with: npm install -g @flumecode/runner@latest`
+  );
+}
 async function claimJob(config) {
   const res = await fetch(`${config.serverUrl}/api/runner/jobs/claim`, {
     method: "POST",
@@ -49,6 +89,7 @@ async function claimJob(config) {
       [RUNNER_VERSION_HEADER]: RUNNER_VERSION
     }
   });
+  noteServerVersion(res);
   if (res.status === 204) return null;
   if (res.status === 401) {
     throw new Error("Runner token rejected (401). Re-run `login` with a fresh token.");
@@ -66,6 +107,7 @@ async function reportJob(config, jobId, result) {
     },
     body: JSON.stringify(result)
   });
+  noteServerVersion(res);
   if (!res.ok) throw new Error(`complete failed: ${res.status} ${await safeText(res)}`);
 }
 async function reportHeartbeat(config, claudeCode) {
@@ -78,6 +120,7 @@ async function reportHeartbeat(config, claudeCode) {
     },
     body: JSON.stringify({ claudeCode })
   });
+  noteServerVersion(res);
   if (!res.ok) throw new Error(`heartbeat failed: ${res.status} ${await safeText(res)}`);
 }
 async function safeText(res) {
@@ -236,19 +279,30 @@ function renderPlan(plan) {
   lines.push(PLAN_MARKER);
   return lines.join("\n");
 }
+var submitPlanInputSchema = {
+  plans: z2.array(z2.object(planInputSchema)).min(1).refine(
+    (arr) => {
+      const titles = arr.map((p) => p.title.trim()).filter((t) => t.length > 0);
+      return new Set(titles).size === titles.length;
+    },
+    { message: "Each plan must have a distinct non-empty title" }
+  )
+};
+var submitPlanSchema = z2.object(submitPlanInputSchema);
 function createPlanTooling() {
-  let renderedPlan = null;
+  let renderedPlans = null;
   const submitPlan = tool2(
     SUBMIT_PLAN,
-    "Submit the finished plan. Call this \u2014 and only this \u2014 when the plan is complete and ready to post. The runner renders your structured fields into the canonical plan markdown and posts it as your comment. acceptanceCriteria is required and must contain at least 2 observable, verifiable conditions (behaviors, tests, or states you could check) that together define 'done'. After calling this, end your turn. The `title` field names this specific plan \u2014 make it concise and distinct from the request title.",
-    planInputSchema,
+    "Submit ALL your plans in a single call \u2014 one entry per plan; each becomes its own independently-acceptable Accept-as-plan draft. Do NOT call submit_plan more than once. acceptanceCriteria is required in each plan and must contain at least 2 observable, verifiable conditions. The 'title' field names each specific plan \u2014 make it concise and distinct from the request title and from sibling plan titles.",
+    submitPlanInputSchema,
     async (args) => {
-      renderedPlan = renderPlan(planSchema.parse(args));
+      const parsed = submitPlanSchema.parse(args);
+      renderedPlans = parsed.plans.map(renderPlan);
       return {
         content: [
           {
             type: "text",
-            text: "Plan submitted. The runner will render and post it as your comment. End your turn now."
+            text: "Plan(s) submitted. The runner will render and post them as your comment(s). End your turn now."
           }
         ]
       };
@@ -258,7 +312,7 @@ function createPlanTooling() {
     name: SERVER_NAME2,
     tools: [submitPlan]
   });
-  return { mcpServer, getPlan: () => renderedPlan };
+  return { mcpServer, getPlans: () => renderedPlans };
 }
 
 // src/executor.ts
@@ -266,7 +320,7 @@ var FLUME_PLUGIN_DIR = fileURLToPath2(new URL("../skills-plugin", import.meta.ur
 async function runClaudeCode(opts) {
   let finalText = "";
   const { mcpServer, collected } = createWidgetTooling();
-  const { mcpServer: planServer, getPlan } = createPlanTooling();
+  const { mcpServer: planServer, getPlans } = createPlanTooling();
   for await (const message of query({
     prompt: opts.prompt,
     options: {
@@ -304,7 +358,7 @@ async function runClaudeCode(opts) {
     }
   }
   process.stdout.write("\n");
-  return { text: finalText, widgets: collected, plan: getPlan() };
+  return { text: finalText, widgets: collected, plans: getPlans() };
 }
 
 // src/health.ts
@@ -828,14 +882,14 @@ async function processChatJob(ctx, dir) {
   });
   const summary = result.text.trim();
   let reply = summary || "(the agent produced no summary)";
-  if (result.plan) {
-    reply = result.plan;
-  }
   if (installResult?.status === "failed") {
     reply += `
 
 > \u26A0\uFE0F Dependencies failed to install (\`${installResult.manager}\`); tests may not have run.`;
   }
+  if (result.plans?.length) {
+    return { text: result.text.trim(), widgets: [], plans: result.plans };
+  }
   if (result.widgets.length > 0) {
     console.log(`  \u2026job ${ctx.jobId} posted ${result.widgets.length} widget(s); awaiting reply`);
     return { text: reply, widgets: result.widgets };
@@ -908,7 +962,7 @@ async function processReviseJob(ctx, dir, resumed) {
   });
   const summary = result.text.trim();
   let reply = summary || "(the agent produced no reply)";
-  if (result.plan) reply = result.plan;
+  if (result.plans?.length) reply = result.plans[0] ?? reply;
   if (installResult.status === "failed") {
     reply += `
 
@@ -937,7 +991,12 @@ async function processReviseJob(ctx, dir, resumed) {
   if (outcome.kind !== "none") {
     reply += outcomeBanner(outcome, { branch: ctx.repo.checkoutBranch, documented });
   }
-  return { text: reply, widgets: [], ...outcome.kind === "pr" ? { pr: outcome.pr } : {} };
+  return {
+    text: reply,
+    widgets: [],
+    ...outcome.kind === "pr" ? { pr: outcome.pr } : {},
+    ...result.plans?.length ? { plans: result.plans } : {}
+  };
 }
 async function heartbeat(config) {
   const health = await checkClaudeCode();
@@ -976,8 +1035,14 @@ async function pollLoop(config) {
       continue;
     }
     try {
-      const { text, widgets, pr } = await processJob(ctx);
-      await reportJob(config, ctx.jobId, { status: "done", text, widgets, pr });
+      const { text, widgets, pr, plans } = await processJob(ctx);
+      await reportJob(config, ctx.jobId, {
+        status: "done",
+        text,
+        widgets,
+        pr,
+        ...plans?.length ? { plans } : {}
+      });
       console.log(`\u2713 Job ${ctx.jobId} done`);
     } catch (err) {
       const message = errorMessage2(err);
@@ -1042,14 +1107,18 @@ function parseFlags(args) {
 }
 var command = process.argv[2];
 var rest = process.argv.slice(3);
-if (command === "login") {
+if (command === "--version" || command === "-v" || command === "version") {
+  console.log(RUNNER_VERSION);
+  process.exit(0);
+} else if (command === "login") {
   void login(rest);
 } else if (command === "start") {
   void start();
 } else {
-  console.log("FlumeCode runner");
+  console.log(`FlumeCode runner v${RUNNER_VERSION}`);
   console.log("Usage:");
-  console.log("  flumecode login   # save server URL + token");
-  console.log("  flumecode start   # poll for and run jobs");
+  console.log("  flumecode login     # save server URL + token");
+  console.log("  flumecode start     # poll for and run jobs");
+  console.log("  flumecode --version # print the runner version");
   process.exit(command ? 1 : 0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flumecode/runner",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "FlumeCode local runner — claims jobs and drives your local Claude Code against a real checkout.",
   "bin": {

package/skills-plugin/skills/request-to-plan/SKILL.md

@@ -84,13 +84,13 @@ plan without re-deriving it.
 
 ### Multiple plans per request
 
-A single request can yield **several** plans — one thread can be accepted into
-many. If the work naturally splits into independent pieces, or the user asks for
-more than one plan, call `submit_plan` once for each finished plan so each can
-be accepted into its own GitHub issue. Give each plan its own distinct `title`
-so sibling plans don't collide. After a plan is accepted the user may keep
-commenting to refine it; treat a later turn as a fresh **Plan** phase and call
-`submit_plan` again with the revised fields.
+A single request can yield **several** plans — one thread can be accepted into many. If the
+work naturally splits into independent pieces, or the user asks for more than one plan, make
+**ONE `submit_plan` call** with all of them in the `plans[]` array (one entry per plan, each
+with a distinct title). Do **not** call `submit_plan` more than once. Each entry becomes its
+own independently-acceptable "Accept as plan" draft. After a plan is accepted the user may
+keep commenting to refine it; treat a later turn as a fresh **Plan** phase and call
+`submit_plan` again with a `plans[]` array containing the revised fields.
 
 ## Always
 

package/skills-plugin/skills/revise-implementation/SKILL.md

@@ -39,11 +39,11 @@ actual code. Pick exactly one:
   Explain why in plain prose, offer an alternative if you have one, and end your
   turn. Make no code changes.
 - **Re-plan** — the request meaningfully changes scope or direction, enough that a
-  fresh plan should be agreed before building. Call **`submit_plan`** with the
-  revised structured fields (same shape as the request-to-plan skill: `scope`,
-  `goal`, `assumptions`, `steps`, `acceptanceCriteria` — at least 2 —, `risks`,
-  `outOfScope`). The runner posts it as a revision the user can accept; make no
-  code changes this turn.
+  fresh plan should be agreed before building. Call **`submit_plan`** with a `plans[]` array
+  containing the revised structured fields (same per-plan shape as the request-to-plan skill:
+  `scope`, `goal`, `assumptions`, `steps`, `acceptanceCriteria` — at least 2 —, `risks`,
+  `outOfScope`). Include only one entry for a revise turn. The runner posts it as a revision
+  the user can accept; make no code changes this turn.
 - **Implement** — the request is clear and reasonable. Make the change (via
   subagents — see Step 2). This is the common case for small fine-tuning.