@flumecode/runner 0.3.0 → 0.3.1

package/dist/cli.js

@@ -39,8 +39,34 @@ function readVersion() {
 }
 var RUNNER_VERSION = readVersion();
 var RUNNER_VERSION_HEADER = "x-flumecode-runner-version";
+var RUNNER_MIN_VERSION_HEADER = "x-flumecode-min-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;
+function noteServerVersion(res) {
+  const min = res.headers.get(RUNNER_MIN_VERSION_HEADER)?.trim();
+  if (!min || RUNNER_VERSION === "unknown") return;
+  if (compareVersions(RUNNER_VERSION, min) >= 0) return;
+  const now = Date.now();
+  if (now - lastOutdatedWarnAt < OUTDATED_WARN_INTERVAL_MS) return;
+  lastOutdatedWarnAt = now;
+  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`
+  );
+}
 async function claimJob(config) {
   const res = await fetch(`${config.serverUrl}/api/runner/jobs/claim`, {
     method: "POST",
@@ -49,6 +75,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 +93,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 +106,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) {
@@ -1042,14 +1071,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.1",
   "type": "module",
   "description": "FlumeCode local runner — claims jobs and drives your local Claude Code against a real checkout.",
   "bin": {