@klaudworks/rmr 0.4.2 → 0.4.4

package/README.md

@@ -7,14 +7,11 @@ Define multi-step coding workflows that match how you actually work. `rmr` orche
 ## Quick Start
 
 ```bash
-npx @klaudworks/rmr@latest install feature-dev  # add the feature-dev workflow
-npx @klaudworks/rmr@latest run .rmr/workflows/feature-dev/workflow.yaml --task "Implement feature X"  # run it
-```
-
-Using `npx` with `@latest` always runs the newest version. To avoid the prefix, install globally:
+npm install -g @klaudworks/rmr
 
-```bash
-npm install -g @klaudworks/rmr@latest
+# run from the root of your project
+rmr install feature-dev
+rmr run .rmr/workflows/feature-dev/workflow.yaml --task "Implement feature X"
 ```
 
 ## Sample Workflows

package/dist/index.js

@@ -1,5 +1,4 @@
-#!/usr/bin/env bun
-// @bun
+#!/usr/bin/env node
 import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -7944,46 +7943,6 @@ var require_public_api = __commonJS((exports) => {
   exports.parseDocument = parseDocument;
   exports.stringify = stringify;
 });
-// node_modules/clipanion/lib/platform/node.mjs
-import tty from "tty";
-function getDefaultColorDepth() {
-  if (tty && `getColorDepth` in tty.WriteStream.prototype)
-    return tty.WriteStream.prototype.getColorDepth();
-  if (process.env.FORCE_COLOR === `0`)
-    return 1;
-  if (process.env.FORCE_COLOR === `1`)
-    return 8;
-  if (typeof process.stdout !== `undefined` && process.stdout.isTTY)
-    return 8;
-  return 1;
-}
-var gContextStorage;
-function getCaptureActivator(context) {
-  let contextStorage = gContextStorage;
-  if (typeof contextStorage === `undefined`) {
-    if (context.stdout === process.stdout && context.stderr === process.stderr)
-      return null;
-    const { AsyncLocalStorage: LazyAsyncLocalStorage } = __require("async_hooks");
-    contextStorage = gContextStorage = new LazyAsyncLocalStorage;
-    const origStdoutWrite = process.stdout._write;
-    process.stdout._write = function(chunk, encoding, cb) {
-      const context2 = contextStorage.getStore();
-      if (typeof context2 === `undefined`)
-        return origStdoutWrite.call(this, chunk, encoding, cb);
-      return context2.stdout.write(chunk, encoding, cb);
-    };
-    const origStderrWrite = process.stderr._write;
-    process.stderr._write = function(chunk, encoding, cb) {
-      const context2 = contextStorage.getStore();
-      if (typeof context2 === `undefined`)
-        return origStderrWrite.call(this, chunk, encoding, cb);
-      return context2.stderr.write(chunk, encoding, cb);
-    };
-  }
-  return (fn) => {
-    return contextStorage.run(context, fn);
-  };
-}
 
 // node_modules/clipanion/lib/constants.mjs
 var SpecialToken;
@@ -8077,6 +8036,136 @@ var whileRunning = (input) => `While running ${input.filter((token) => {
   }
 }).join(` `)}`;
 
+// node_modules/clipanion/lib/advanced/options/utils.mjs
+var isOptionSymbol = Symbol(`clipanion/isOption`);
+function makeCommandOption(spec) {
+  return { ...spec, [isOptionSymbol]: true };
+}
+function rerouteArguments(a, b) {
+  if (typeof a === `undefined`)
+    return [a, b];
+  if (typeof a === `object` && a !== null && !Array.isArray(a)) {
+    return [undefined, a];
+  } else {
+    return [a, b];
+  }
+}
+function cleanValidationError(message, { mergeName = false } = {}) {
+  const match = message.match(/^([^:]+): (.*)$/m);
+  if (!match)
+    return `validation failed`;
+  let [, path, line] = match;
+  if (mergeName)
+    line = line[0].toLowerCase() + line.slice(1);
+  line = path !== `.` || !mergeName ? `${path.replace(/^\.(\[|$)/, `$1`)}: ${line}` : `: ${line}`;
+  return line;
+}
+function formatError(message, errors) {
+  if (errors.length === 1) {
+    return new UsageError(`${message}${cleanValidationError(errors[0], { mergeName: true })}`);
+  } else {
+    return new UsageError(`${message}:
+${errors.map((error) => `
+- ${cleanValidationError(error)}`).join(``)}`);
+  }
+}
+function applyValidator(name, value, validator) {
+  if (typeof validator === `undefined`)
+    return value;
+  const errors = [];
+  const coercions = [];
+  const coercion = (v) => {
+    const orig = value;
+    value = v;
+    return coercion.bind(null, orig);
+  };
+  const check = validator(value, { errors, coercions, coercion });
+  if (!check)
+    throw formatError(`Invalid value for ${name}`, errors);
+  for (const [, op] of coercions)
+    op();
+  return value;
+}
+
+// node_modules/clipanion/lib/advanced/Command.mjs
+class Command {
+  constructor() {
+    this.help = false;
+  }
+  static Usage(usage) {
+    return usage;
+  }
+  async catch(error) {
+    throw error;
+  }
+  async validateAndExecute() {
+    const commandClass = this.constructor;
+    const cascade = commandClass.schema;
+    if (Array.isArray(cascade)) {
+      const { isDict, isUnknown, applyCascade } = await Promise.resolve().then(() => __toESM(require_lib(), 1));
+      const schema = applyCascade(isDict(isUnknown()), cascade);
+      const errors = [];
+      const coercions = [];
+      const check = schema(this, { errors, coercions });
+      if (!check)
+        throw formatError(`Invalid option schema`, errors);
+      for (const [, op] of coercions) {
+        op();
+      }
+    } else if (cascade != null) {
+      throw new Error(`Invalid command schema`);
+    }
+    const exitCode = await this.execute();
+    if (typeof exitCode !== `undefined`) {
+      return exitCode;
+    } else {
+      return 0;
+    }
+  }
+}
+Command.isOption = isOptionSymbol;
+Command.Default = [];
+// node_modules/clipanion/lib/platform/node.mjs
+import tty from "tty";
+function getDefaultColorDepth() {
+  if (tty && `getColorDepth` in tty.WriteStream.prototype)
+    return tty.WriteStream.prototype.getColorDepth();
+  if (process.env.FORCE_COLOR === `0`)
+    return 1;
+  if (process.env.FORCE_COLOR === `1`)
+    return 8;
+  if (typeof process.stdout !== `undefined` && process.stdout.isTTY)
+    return 8;
+  return 1;
+}
+var gContextStorage;
+function getCaptureActivator(context) {
+  let contextStorage = gContextStorage;
+  if (typeof contextStorage === `undefined`) {
+    if (context.stdout === process.stdout && context.stderr === process.stderr)
+      return null;
+    const { AsyncLocalStorage: LazyAsyncLocalStorage } = __require("async_hooks");
+    contextStorage = gContextStorage = new LazyAsyncLocalStorage;
+    const origStdoutWrite = process.stdout._write;
+    process.stdout._write = function(chunk, encoding, cb) {
+      const context2 = contextStorage.getStore();
+      if (typeof context2 === `undefined`)
+        return origStdoutWrite.call(this, chunk, encoding, cb);
+      return context2.stdout.write(chunk, encoding, cb);
+    };
+    const origStderrWrite = process.stderr._write;
+    process.stderr._write = function(chunk, encoding, cb) {
+      const context2 = contextStorage.getStore();
+      if (typeof context2 === `undefined`)
+        return origStderrWrite.call(this, chunk, encoding, cb);
+      return context2.stderr.write(chunk, encoding, cb);
+    };
+  }
+  return (fn) => {
+    return contextStorage.run(context, fn);
+  };
+}
+
 // node_modules/clipanion/lib/core.mjs
 function debug(str) {
   if (IS_DEBUG) {
@@ -8860,96 +8949,6 @@ function formatMarkdownish(text, { format, paragraphs }) {
 ` : ``;
 }
 
-// node_modules/clipanion/lib/advanced/options/utils.mjs
-var isOptionSymbol = Symbol(`clipanion/isOption`);
-function makeCommandOption(spec) {
-  return { ...spec, [isOptionSymbol]: true };
-}
-function rerouteArguments(a, b) {
-  if (typeof a === `undefined`)
-    return [a, b];
-  if (typeof a === `object` && a !== null && !Array.isArray(a)) {
-    return [undefined, a];
-  } else {
-    return [a, b];
-  }
-}
-function cleanValidationError(message, { mergeName = false } = {}) {
-  const match = message.match(/^([^:]+): (.*)$/m);
-  if (!match)
-    return `validation failed`;
-  let [, path, line] = match;
-  if (mergeName)
-    line = line[0].toLowerCase() + line.slice(1);
-  line = path !== `.` || !mergeName ? `${path.replace(/^\.(\[|$)/, `$1`)}: ${line}` : `: ${line}`;
-  return line;
-}
-function formatError(message, errors) {
-  if (errors.length === 1) {
-    return new UsageError(`${message}${cleanValidationError(errors[0], { mergeName: true })}`);
-  } else {
-    return new UsageError(`${message}:
-${errors.map((error) => `
-- ${cleanValidationError(error)}`).join(``)}`);
-  }
-}
-function applyValidator(name, value, validator) {
-  if (typeof validator === `undefined`)
-    return value;
-  const errors = [];
-  const coercions = [];
-  const coercion = (v) => {
-    const orig = value;
-    value = v;
-    return coercion.bind(null, orig);
-  };
-  const check = validator(value, { errors, coercions, coercion });
-  if (!check)
-    throw formatError(`Invalid value for ${name}`, errors);
-  for (const [, op] of coercions)
-    op();
-  return value;
-}
-
-// node_modules/clipanion/lib/advanced/Command.mjs
-class Command {
-  constructor() {
-    this.help = false;
-  }
-  static Usage(usage) {
-    return usage;
-  }
-  async catch(error) {
-    throw error;
-  }
-  async validateAndExecute() {
-    const commandClass = this.constructor;
-    const cascade = commandClass.schema;
-    if (Array.isArray(cascade)) {
-      const { isDict, isUnknown, applyCascade } = await Promise.resolve().then(() => __toESM(require_lib(), 1));
-      const schema = applyCascade(isDict(isUnknown()), cascade);
-      const errors = [];
-      const coercions = [];
-      const check = schema(this, { errors, coercions });
-      if (!check)
-        throw formatError(`Invalid option schema`, errors);
-      for (const [, op] of coercions) {
-        op();
-      }
-    } else if (cascade != null) {
-      throw new Error(`Invalid command schema`);
-    }
-    const exitCode = await this.execute();
-    if (typeof exitCode !== `undefined`) {
-      return exitCode;
-    } else {
-      return 0;
-    }
-  }
-}
-Command.isOption = isOptionSymbol;
-Command.Default = [];
-
 // node_modules/clipanion/lib/advanced/HelpCommand.mjs
 class HelpCommand extends Command {
   static from(state, contexts) {
@@ -11162,9 +11161,91 @@ function parseHarnessOverride(value) {
   return value;
 }
 
+// src/lib/version.ts
+import { readFileSync } from "node:fs";
+import { dirname as dirname2, resolve as resolve5 } from "node:path";
+import { fileURLToPath } from "node:url";
+var cached;
+function getVersion() {
+  if (cached)
+    return cached;
+  const thisDir = dirname2(fileURLToPath(import.meta.url));
+  const candidates = [
+    resolve5(thisDir, "..", "package.json"),
+    resolve5(thisDir, "..", "..", "package.json")
+  ];
+  for (const candidate of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync(candidate, "utf8"));
+      if (pkg.version) {
+        cached = pkg.version;
+        return cached;
+      }
+    } catch {}
+  }
+  cached = "0.0.0";
+  return cached;
+}
+
+// src/lib/update-check.ts
+var PACKAGE_NAME = "@klaudworks/rmr";
+var REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+var FETCH_TIMEOUT_MS = 3000;
+function isNewer(latest, current) {
+  const l = latest.split(".").map(Number);
+  const c = current.split(".").map(Number);
+  for (let i = 0;i < 3; i++) {
+    const lv = l[i] ?? 0;
+    const cv = c[i] ?? 0;
+    if (lv > cv)
+      return true;
+    if (lv < cv)
+      return false;
+  }
+  return false;
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    const response = await fetch(REGISTRY_URL, {
+      signal: controller.signal,
+      headers: { accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok)
+      return null;
+    const data = await response.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function startUpdateCheck() {
+  const currentVersion = getVersion();
+  let result = null;
+  const check = fetchLatestVersion().then((latestVersion) => {
+    if (latestVersion && isNewer(latestVersion, currentVersion)) {
+      result = { latestVersion };
+    }
+  }).catch(() => {});
+  return () => {
+    check.then(() => {
+      if (result) {
+        process.stderr.write(`
+`);
+        ui.dim(`Update available: ${currentVersion} → ${result.latestVersion}
+`);
+        ui.dim(`Run: npm install -g ${PACKAGE_NAME}@${result.latestVersion}
+`);
+      }
+    }).catch(() => {});
+  };
+}
+
 // src/lib/workflow-loader.ts
 import { readFile as readFile3 } from "node:fs/promises";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve6 } from "node:path";
 
 // node_modules/yaml/dist/index.js
 var composer = require_composer();
@@ -11246,7 +11327,7 @@ function validateUniqueness(items, kind) {
   }
 }
 async function loadWorkflowDefinition(workflowPath) {
-  const absolutePath = resolve5(workflowPath);
+  const absolutePath = resolve6(workflowPath);
   const raw = await readFile3(absolutePath, "utf8");
   const parsed = $parse(raw);
   if (!parsed || typeof parsed !== "object") {
@@ -11368,6 +11449,7 @@ class ContinueCommand extends Command {
     description: "Inject a one-time hint into the resumed harness prompt."
   });
   async execute() {
+    const showUpdateNotice = startUpdateCheck();
     const config = await loadConfig();
     const runState = await loadRunState(config, this.runId);
     const workflow = await loadWorkflowDefinition(runState.workflow_path);
@@ -11405,6 +11487,7 @@ class ContinueCommand extends Command {
       allowAll: true,
       overrides
     });
+    showUpdateNotice();
     return 0;
   }
 }
@@ -11412,12 +11495,12 @@ class ContinueCommand extends Command {
 // src/commands/install.ts
 import { cp, readdir as readdir2 } from "node:fs/promises";
 import { existsSync } from "node:fs";
-import { dirname as dirname2, resolve as resolve6 } from "node:path";
-import { fileURLToPath } from "node:url";
+import { dirname as dirname3, resolve as resolve7 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 function getExamplesWorkflowsDir() {
-  const thisDir = dirname2(fileURLToPath(import.meta.url));
-  const fromDist = resolve6(thisDir, "..", "examples", "workflows");
-  const fromSrc = resolve6(thisDir, "..", "..", "examples", "workflows");
+  const thisDir = dirname3(fileURLToPath2(import.meta.url));
+  const fromDist = resolve7(thisDir, "..", "examples", "workflows");
+  const fromSrc = resolve7(thisDir, "..", "..", "examples", "workflows");
   if (existsSync(fromDist))
     return fromDist;
   if (existsSync(fromSrc))
@@ -11442,8 +11525,8 @@ class InstallCommand extends Command {
     if (!existsSync(examplesDir)) {
       throw new UserInputError(`Bundled workflows directory not found: ${examplesDir}`);
     }
-    const sourceDir = resolve6(examplesDir, this.workflowName);
-    const destinationDir = resolve6(config.workflowsDir, this.workflowName);
+    const sourceDir = resolve7(examplesDir, this.workflowName);
+    const destinationDir = resolve7(config.workflowsDir, this.workflowName);
     if (!existsSync(sourceDir)) {
       const available = (await readdir2(examplesDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
       const hint = available.length > 0 ? ` Available: ${available.join(", ")}.` : " No bundled workflows found.";
@@ -11463,34 +11546,6 @@ class InstallCommand extends Command {
 
 // src/commands/root.ts
 import { basename } from "node:path";
-
-// src/lib/version.ts
-import { readFileSync } from "node:fs";
-import { dirname as dirname3, resolve as resolve7 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-var cached;
-function getVersion() {
-  if (cached)
-    return cached;
-  const thisDir = dirname3(fileURLToPath2(import.meta.url));
-  const candidates = [
-    resolve7(thisDir, "..", "package.json"),
-    resolve7(thisDir, "..", "..", "package.json")
-  ];
-  for (const candidate of candidates) {
-    try {
-      const pkg = JSON.parse(readFileSync(candidate, "utf8"));
-      if (pkg.version) {
-        cached = pkg.version;
-        return cached;
-      }
-    } catch {}
-  }
-  cached = "0.0.0";
-  return cached;
-}
-
-// src/commands/root.ts
 function detectShell() {
   const raw = process.env.SHELL;
   if (!raw) {
@@ -11554,16 +11609,6 @@ class RootCommand extends Command {
   }
 }
 
-// src/lib/errors.ts
-class RmrError2 extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "RmrError";
-    this.code = code;
-  }
-}
-
 // src/lib/logger.ts
 var colors = {
   reset: "\x1B[0m",
@@ -11691,6 +11736,7 @@ class RunCommand extends Command {
     throw new UserInputError("No task provided. Use --task/-t or --task-file/-f.");
   }
   async execute() {
+    const showUpdateNotice = startUpdateCheck();
     const config = await loadConfig();
     const { task, displayTask } = await this.resolveTask();
     const harnessOverride = parseHarnessOverride(this.harness);
@@ -11732,41 +11778,16 @@ class RunCommand extends Command {
       allowAll: effectiveAllowAll,
       ...Object.keys(overrides).length > 0 && { overrides }
     });
+    showUpdateNotice();
     return 0;
   }
 }
 
-// src/lib/version.ts
-import { readFileSync as readFileSync2 } from "node:fs";
-import { dirname as dirname4, resolve as resolve9 } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
-var cached2;
-function getVersion2() {
-  if (cached2)
-    return cached2;
-  const thisDir = dirname4(fileURLToPath3(import.meta.url));
-  const candidates = [
-    resolve9(thisDir, "..", "package.json"),
-    resolve9(thisDir, "..", "..", "package.json")
-  ];
-  for (const candidate of candidates) {
-    try {
-      const pkg = JSON.parse(readFileSync2(candidate, "utf8"));
-      if (pkg.version) {
-        cached2 = pkg.version;
-        return cached2;
-      }
-    } catch {}
-  }
-  cached2 = "0.0.0";
-  return cached2;
-}
-
 // src/index.ts
 var [, , ...args] = process.argv;
 var cli = new Cli({
   binaryName: "rmr",
-  binaryVersion: getVersion2(),
+  binaryVersion: getVersion(),
   enableColors: false
 });
 cli.register(exports_builtins.HelpCommand);
@@ -11781,7 +11802,7 @@ try {
   const exitCode = await cli.run(args);
   process.exitCode = exitCode;
 } catch (error) {
-  if (error instanceof RmrError2) {
+  if (error instanceof RmrError) {
     logger.error(`${error.code}: ${error.message}`);
     process.exitCode = 1;
   } else if (error instanceof Error) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@klaudworks/rex",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@klaudworks/rex",
-      "version": "0.4.2",
+      "version": "0.4.4",
       "dependencies": {
         "clipanion": "^4.0.0-rc.4",
         "yaml": "^2.8.2"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klaudworks/rmr",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Define multi-step coding workflows for AI agents",
   "repository": {
     "type": "git",