@klaudworks/rmr 0.4.2 → 0.4.3

package/README.md

@@ -7,14 +7,9 @@ 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:
-
-```bash
-npm install -g @klaudworks/rmr@latest
+npm install -g @klaudworks/rmr
+rmr install feature-dev
+rmr run .rmr/workflows/feature-dev/workflow.yaml --task "Implement feature X"
 ```
 
 ## Sample Workflows

package/dist/index.js

@@ -8865,15 +8865,6 @@ 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)
@@ -8893,23 +8884,6 @@ ${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 {
@@ -9415,208 +9389,19 @@ VersionCommand.paths = [[`-v`], [`--version`]];
 var exports_options = {};
 __export(exports_options, {
   rerouteArguments: () => rerouteArguments,
-  makeCommandOption: () => makeCommandOption,
-  isOptionSymbol: () => isOptionSymbol,
-  formatError: () => formatError,
-  cleanValidationError: () => cleanValidationError,
+  makeCommandOption: () => makeCommandOption2,
+  isOptionSymbol: () => isOptionSymbol2,
+  formatError: () => formatError2,
+  cleanValidationError: () => cleanValidationError2,
   applyValidator: () => applyValidator,
   String: () => String2,
   Rest: () => Rest,
-  Proxy: () => Proxy,
+  Proxy: () => Proxy2,
   Counter: () => Counter,
   Boolean: () => Boolean2,
   Array: () => Array2
 });
 
-// node_modules/clipanion/lib/advanced/options/Array.mjs
-function Array2(descriptor, initialValueBase, optsBase) {
-  const [initialValue, opts] = rerouteArguments(initialValueBase, optsBase !== null && optsBase !== undefined ? optsBase : {});
-  const { arity = 1 } = opts;
-  const optNames = descriptor.split(`,`);
-  const nameSet = new Set(optNames);
-  return makeCommandOption({
-    definition(builder) {
-      builder.addOption({
-        names: optNames,
-        arity,
-        hidden: opts === null || opts === undefined ? undefined : opts.hidden,
-        description: opts === null || opts === undefined ? undefined : opts.description,
-        required: opts.required
-      });
-    },
-    transformer(builder, key, state) {
-      let usedName;
-      let currentValue = typeof initialValue !== `undefined` ? [...initialValue] : undefined;
-      for (const { name, value } of state.options) {
-        if (!nameSet.has(name))
-          continue;
-        usedName = name;
-        currentValue = currentValue !== null && currentValue !== undefined ? currentValue : [];
-        currentValue.push(value);
-      }
-      if (typeof currentValue !== `undefined`) {
-        return applyValidator(usedName !== null && usedName !== undefined ? usedName : key, currentValue, opts.validator);
-      } else {
-        return currentValue;
-      }
-    }
-  });
-}
-// node_modules/clipanion/lib/advanced/options/Boolean.mjs
-function Boolean2(descriptor, initialValueBase, optsBase) {
-  const [initialValue, opts] = rerouteArguments(initialValueBase, optsBase !== null && optsBase !== undefined ? optsBase : {});
-  const optNames = descriptor.split(`,`);
-  const nameSet = new Set(optNames);
-  return makeCommandOption({
-    definition(builder) {
-      builder.addOption({
-        names: optNames,
-        allowBinding: false,
-        arity: 0,
-        hidden: opts.hidden,
-        description: opts.description,
-        required: opts.required
-      });
-    },
-    transformer(builer, key, state) {
-      let currentValue = initialValue;
-      for (const { name, value } of state.options) {
-        if (!nameSet.has(name))
-          continue;
-        currentValue = value;
-      }
-      return currentValue;
-    }
-  });
-}
-// node_modules/clipanion/lib/advanced/options/Counter.mjs
-function Counter(descriptor, initialValueBase, optsBase) {
-  const [initialValue, opts] = rerouteArguments(initialValueBase, optsBase !== null && optsBase !== undefined ? optsBase : {});
-  const optNames = descriptor.split(`,`);
-  const nameSet = new Set(optNames);
-  return makeCommandOption({
-    definition(builder) {
-      builder.addOption({
-        names: optNames,
-        allowBinding: false,
-        arity: 0,
-        hidden: opts.hidden,
-        description: opts.description,
-        required: opts.required
-      });
-    },
-    transformer(builder, key, state) {
-      let currentValue = initialValue;
-      for (const { name, value } of state.options) {
-        if (!nameSet.has(name))
-          continue;
-        currentValue !== null && currentValue !== undefined || (currentValue = 0);
-        if (!value) {
-          currentValue = 0;
-        } else {
-          currentValue += 1;
-        }
-      }
-      return currentValue;
-    }
-  });
-}
-// node_modules/clipanion/lib/advanced/options/Rest.mjs
-function Rest(opts = {}) {
-  return makeCommandOption({
-    definition(builder, key) {
-      var _a;
-      builder.addRest({
-        name: (_a = opts.name) !== null && _a !== undefined ? _a : key,
-        required: opts.required
-      });
-    },
-    transformer(builder, key, state) {
-      const isRestPositional = (index) => {
-        const positional = state.positionals[index];
-        if (positional.extra === NoLimits)
-          return true;
-        if (positional.extra === false && index < builder.arity.leading.length)
-          return true;
-        return false;
-      };
-      let count = 0;
-      while (count < state.positionals.length && isRestPositional(count))
-        count += 1;
-      return state.positionals.splice(0, count).map(({ value }) => value);
-    }
-  });
-}
-// node_modules/clipanion/lib/advanced/options/String.mjs
-function StringOption(descriptor, initialValueBase, optsBase) {
-  const [initialValue, opts] = rerouteArguments(initialValueBase, optsBase !== null && optsBase !== undefined ? optsBase : {});
-  const { arity = 1 } = opts;
-  const optNames = descriptor.split(`,`);
-  const nameSet = new Set(optNames);
-  return makeCommandOption({
-    definition(builder) {
-      builder.addOption({
-        names: optNames,
-        arity: opts.tolerateBoolean ? 0 : arity,
-        hidden: opts.hidden,
-        description: opts.description,
-        required: opts.required
-      });
-    },
-    transformer(builder, key, state, context) {
-      let usedName;
-      let currentValue = initialValue;
-      if (typeof opts.env !== `undefined` && context.env[opts.env]) {
-        usedName = opts.env;
-        currentValue = context.env[opts.env];
-      }
-      for (const { name, value } of state.options) {
-        if (!nameSet.has(name))
-          continue;
-        usedName = name;
-        currentValue = value;
-      }
-      if (typeof currentValue === `string`) {
-        return applyValidator(usedName !== null && usedName !== undefined ? usedName : key, currentValue, opts.validator);
-      } else {
-        return currentValue;
-      }
-    }
-  });
-}
-function StringPositional(opts = {}) {
-  const { required = true } = opts;
-  return makeCommandOption({
-    definition(builder, key) {
-      var _a;
-      builder.addPositional({
-        name: (_a = opts.name) !== null && _a !== undefined ? _a : key,
-        required: opts.required
-      });
-    },
-    transformer(builder, key, state) {
-      var _a;
-      for (let i = 0;i < state.positionals.length; ++i) {
-        if (state.positionals[i].extra === NoLimits)
-          continue;
-        if (required && state.positionals[i].extra === true)
-          continue;
-        if (!required && state.positionals[i].extra === false)
-          continue;
-        const [positional] = state.positionals.splice(i, 1);
-        return applyValidator((_a = opts.name) !== null && _a !== undefined ? _a : key, positional.value, opts.validator);
-      }
-      return;
-    }
-  });
-}
-function String2(descriptor, ...args) {
-  if (typeof descriptor === `string`) {
-    return StringOption(descriptor, ...args);
-  } else {
-    return StringPositional(descriptor);
-  }
-}
 // src/lib/config.ts
 import { mkdir } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -11162,9 +10947,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 +11113,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 +11235,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 +11273,7 @@ class ContinueCommand extends Command {
       allowAll: true,
       overrides
     });
+    showUpdateNotice();
     return 0;
   }
 }
@@ -11412,12 +11281,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 +11311,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 +11332,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) {
@@ -11691,6 +11532,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,6 +11574,7 @@ class RunCommand extends Command {
       allowAll: effectiveAllowAll,
       ...Object.keys(overrides).length > 0 && { overrides }
     });
+    showUpdateNotice();
     return 0;
   }
 }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@klaudworks/rex",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@klaudworks/rex",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "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.3",
   "description": "Define multi-step coding workflows for AI agents",
   "repository": {
     "type": "git",