@osfactory/har 1.10.0 → 1.11.0

package/dist/index.js

@@ -593,8 +593,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path100, errorMaps, issueData } = params;
-      const fullPath = [...path100, ...issueData.path || []];
+      const { data, path: path101, errorMaps, issueData } = params;
+      const fullPath = [...path101, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -902,11 +902,11 @@ var init_types = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path100, key) {
+      constructor(parent, value, path101, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path100;
+        this._path = path101;
         this._key = key;
       }
       get path() {
@@ -4332,8 +4332,15 @@ var init_schema = __esm({
        * Harness runtime-contract version (#241) — the shape of the installed
        * `.har/` surface (thin shims + pure config = '1.0.0'). Absent on pre-1.0
        * harnesses; the migration registry (src/harness/migrations.ts) keys on it.
+       * Not the CLI that wrote the harness — that is `cliVersion`.
        */
       runtimeVersion: external_exports.string().optional(),
+      /**
+       * @osfactory/har version that last wrote this harness (#344).
+       * Stamped by init / maintain / add-plugin / line add. Doctor compares it
+       * to the running CLI and stops with an upgrade error when the CLI is older.
+       */
+      cliVersion: external_exports.string().optional(),
       /** Shape this harness was migrated from ('pre-1.0'), stamped at migration (#241). */
       migratedFrom: external_exports.string().optional(),
       migratedAt: external_exports.string().optional(),
@@ -35421,8 +35428,20 @@ function readManifest(repoPath) {
   return result.success ? result.data : null;
 }
 function writeManifest(repoPath, manifest) {
+  const stamped = {
+    ...manifest,
+    cliVersion: getHarPackageVersion()
+  };
   const manifestPath = getManifestPath(repoPath);
-  writeFileSafe(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+  writeFileSafe(manifestPath, JSON.stringify(stamped, null, 2) + "\n");
+}
+function stampManifestWriter(repoPath) {
+  const existing = readManifest(repoPath);
+  if (!existing) return;
+  writeManifest(repoPath, {
+    ...existing,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
 }
 function computeFileChecksum(content) {
   return crypto.createHash("sha256").update(content).digest("hex").slice(0, 16);
@@ -35452,6 +35471,7 @@ function createManifest(repoPath, adaptationSummary, stack, profile, templateChe
   return {
     version: MANIFEST_VERSION,
     runtimeVersion: HARNESS_RUNTIME_VERSION,
+    cliVersion: getHarPackageVersion(),
     outputDir: DEFAULT_HAR_DIR,
     createdAt: now,
     updatedAt: now,
@@ -35482,6 +35502,7 @@ var init_manifest = __esm({
     crypto = __toESM(require("crypto"));
     fs4 = __toESM(require("fs"));
     path4 = __toESM(require("path"));
+    init_package_version();
     init_schema2();
     init_file_ops();
     MANIFEST_VERSION = "1";
@@ -35776,7 +35797,7 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const echoStdout = stream && (options.streamStdout ?? true);
   const { stream: _stream, streamStdout: _streamStdout, ...spawnOptions } = options;
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -35791,14 +35812,14 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d;
       if (stream) process.stderr.write(d);
     });
-    proc.on("close", (code) => resolve69({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve70({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const echoStdout = stream && (options.streamStdout ?? true);
   const { stream: _stream, streamStdout: _streamStdout, ...spawnOptions } = options;
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -35813,7 +35834,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d;
       if (stream) process.stderr.write(d);
     });
-    proc.on("close", (code) => resolve69({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve70({ stdout, stderr, code: code ?? 0 }));
   });
 }
 var import_child_process;
@@ -37247,14 +37268,14 @@ function ensureWorkEvidenceIgnored(harnessRoot) {
   fs17.writeFileSync(gitignorePath, `${content}${separator}${missing.join("\n")}
 `);
 }
-function listRecords(harnessRoot, dir, parse4) {
+function listRecords(harnessRoot, dir, parse5) {
   const recordDir = harEvidenceDir(harnessRoot, dir);
   if (!fs17.existsSync(recordDir)) return [];
   const records = [];
   for (const name of fs17.readdirSync(recordDir)) {
     if (!name.endsWith(".json")) continue;
     try {
-      records.push(parse4(JSON.parse(fs17.readFileSync(path17.join(recordDir, name), "utf8"))));
+      records.push(parse5(JSON.parse(fs17.readFileSync(path17.join(recordDir, name), "utf8"))));
     } catch {
     }
   }
@@ -37652,7 +37673,7 @@ var init_results = __esm({
 
 // src/runtime/exec.ts
 function spawnResult(cmd, args, opts, shell) {
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     const stream = opts.stream ?? false;
     const proc = (0, import_child_process4.spawn)(cmd, args, {
       cwd: opts.cwd,
@@ -37664,8 +37685,8 @@ function spawnResult(cmd, args, opts, shell) {
     let stderr = "";
     proc.stdout?.on("data", (c) => stdout += c.toString());
     proc.stderr?.on("data", (c) => stderr += c.toString());
-    proc.on("error", (err) => resolve69({ code: 127, stdout, stderr: stderr || String(err) }));
-    proc.on("close", (code) => resolve69({ code: code ?? 1, stdout, stderr }));
+    proc.on("error", (err) => resolve70({ code: 127, stdout, stderr: stderr || String(err) }));
+    proc.on("close", (code) => resolve70({ code: code ?? 1, stdout, stderr }));
   });
 }
 var import_child_process4, fs18, path19, realSystemOps, defaultExec, stderrLog, realSleep;
@@ -37728,7 +37749,7 @@ var init_exec = __esm({
       process.stderr.write(`==> ${message}
 `);
     };
-    realSleep = (seconds) => new Promise((resolve69) => setTimeout(resolve69, seconds * 1e3));
+    realSleep = (seconds) => new Promise((resolve70) => setTimeout(resolve70, seconds * 1e3));
   }
 });
 
@@ -43702,7 +43723,7 @@ async function attempt(url) {
 async function readControlJson(url) {
   const first = await attempt(url);
   if (first.read.ok || !first.retryable) return first.read;
-  await new Promise((resolve69) => setTimeout(resolve69, RETRY_DELAY_MS));
+  await new Promise((resolve70) => setTimeout(resolve70, RETRY_DELAY_MS));
   return (await attempt(url)).read;
 }
 async function readControlPages(options) {
@@ -44193,7 +44214,7 @@ async function postForResponse(url, headers, payload) {
     } catch (err) {
       lastErr = err;
       if (attempt2 < MAX_FETCH_ATTEMPTS) {
-        await new Promise((resolve69) => setTimeout(resolve69, attempt2 * 100));
+        await new Promise((resolve70) => setTimeout(resolve70, attempt2 * 100));
       }
     }
   }
@@ -44450,7 +44471,7 @@ async function waitForControlApi(apiUrl = getControlApiUrl(), timeoutMs = 6e4, i
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await isControlApiReachable(apiUrl)) return true;
-    await new Promise((resolve69) => setTimeout(resolve69, intervalMs));
+    await new Promise((resolve70) => setTimeout(resolve70, intervalMs));
   }
   return false;
 }
@@ -46141,15 +46162,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path100 = [graph[toModel].parent, toModel];
+      const path101 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path100.unshift(graph[cur].parent);
+        path101.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path100;
+      fn.conversion = path101;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -52643,26 +52664,26 @@ var require_lib2 = __commonJS({
       return matches;
     };
     exports2.analyse = analyse;
-    var detectFile = (filepath, opts = {}) => new Promise((resolve69, reject) => {
+    var detectFile = (filepath, opts = {}) => new Promise((resolve70, reject) => {
       let fd;
-      const fs80 = (0, node_1.default)();
+      const fs81 = (0, node_1.default)();
       const handler = (err, buffer) => {
         if (fd) {
-          fs80.closeSync(fd);
+          fs81.closeSync(fd);
         }
         if (err) {
           reject(err);
         } else if (buffer) {
-          resolve69((0, exports2.detect)(buffer));
+          resolve70((0, exports2.detect)(buffer));
         } else {
           reject(new Error("No error and no buffer received"));
         }
       };
       const sampleSize = (opts === null || opts === void 0 ? void 0 : opts.sampleSize) || 0;
       if (sampleSize > 0) {
-        fd = fs80.openSync(filepath, "r");
+        fd = fs81.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(sampleSize);
-        fs80.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
+        fs81.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
           if (err) {
             handler(err, null);
           } else {
@@ -52674,22 +52695,22 @@ var require_lib2 = __commonJS({
         });
         return;
       }
-      fs80.readFile(filepath, handler);
+      fs81.readFile(filepath, handler);
     });
     exports2.detectFile = detectFile;
     var detectFileSync = (filepath, opts = {}) => {
-      const fs80 = (0, node_1.default)();
+      const fs81 = (0, node_1.default)();
       if (opts && opts.sampleSize) {
-        const fd = fs80.openSync(filepath, "r");
+        const fd = fs81.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(opts.sampleSize);
-        const bytesRead = fs80.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
+        const bytesRead = fs81.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
         if (bytesRead < opts.sampleSize) {
           sample = sample.subarray(0, bytesRead);
         }
-        fs80.closeSync(fd);
+        fs81.closeSync(fd);
         return (0, exports2.detect)(sample);
       }
-      return (0, exports2.detect)(fs80.readFileSync(filepath));
+      return (0, exports2.detect)(fs81.readFileSync(filepath));
     };
     exports2.detectFileSync = detectFileSync;
     exports2.default = {
@@ -57202,7 +57223,7 @@ var require_Observable = __commonJS({
       Observable2.prototype.forEach = function(next, promiseCtor) {
         var _this = this;
         promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve69, reject) {
+        return new promiseCtor(function(resolve70, reject) {
           var subscriber = new Subscriber_1.SafeSubscriber({
             next: function(value) {
               try {
@@ -57213,7 +57234,7 @@ var require_Observable = __commonJS({
               }
             },
             error: reject,
-            complete: resolve69
+            complete: resolve70
           });
           _this.subscribe(subscriber);
         });
@@ -57235,14 +57256,14 @@ var require_Observable = __commonJS({
       Observable2.prototype.toPromise = function(promiseCtor) {
         var _this = this;
         promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve69, reject) {
+        return new promiseCtor(function(resolve70, reject) {
           var value;
           _this.subscribe(function(x) {
             return value = x;
           }, function(err) {
             return reject(err);
           }, function() {
-            return resolve69(value);
+            return resolve70(value);
           });
         });
       };
@@ -59338,11 +59359,11 @@ var require_innerFrom = __commonJS({
     "use strict";
     var __awaiter = exports2 && exports2.__awaiter || function(thisArg, _arguments, P2, generator) {
       function adopt(value) {
-        return value instanceof P2 ? value : new P2(function(resolve69) {
-          resolve69(value);
+        return value instanceof P2 ? value : new P2(function(resolve70) {
+          resolve70(value);
         });
       }
-      return new (P2 || (P2 = Promise))(function(resolve69, reject) {
+      return new (P2 || (P2 = Promise))(function(resolve70, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -59358,7 +59379,7 @@ var require_innerFrom = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve69(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve70(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -59440,14 +59461,14 @@ var require_innerFrom = __commonJS({
       }, i);
       function verb(n) {
         i[n] = o[n] && function(v2) {
-          return new Promise(function(resolve69, reject) {
-            v2 = o[n](v2), settle(resolve69, reject, v2.done, v2.value);
+          return new Promise(function(resolve70, reject) {
+            v2 = o[n](v2), settle(resolve70, reject, v2.done, v2.value);
           });
         };
       }
-      function settle(resolve69, reject, d, v2) {
+      function settle(resolve70, reject, d, v2) {
         Promise.resolve(v2).then(function(v3) {
-          resolve69({ value: v3, done: d });
+          resolve70({ value: v3, done: d });
         }, reject);
       }
     };
@@ -60066,7 +60087,7 @@ var require_lastValueFrom = __commonJS({
     var EmptyError_1 = require_EmptyError();
     function lastValueFrom2(source, config2) {
       var hasConfig = typeof config2 === "object";
-      return new Promise(function(resolve69, reject) {
+      return new Promise(function(resolve70, reject) {
         var _hasValue = false;
         var _value;
         source.subscribe({
@@ -60077,9 +60098,9 @@ var require_lastValueFrom = __commonJS({
           error: reject,
           complete: function() {
             if (_hasValue) {
-              resolve69(_value);
+              resolve70(_value);
             } else if (hasConfig) {
-              resolve69(config2.defaultValue);
+              resolve70(config2.defaultValue);
             } else {
               reject(new EmptyError_1.EmptyError());
             }
@@ -60101,16 +60122,16 @@ var require_firstValueFrom = __commonJS({
     var Subscriber_1 = require_Subscriber();
     function firstValueFrom(source, config2) {
       var hasConfig = typeof config2 === "object";
-      return new Promise(function(resolve69, reject) {
+      return new Promise(function(resolve70, reject) {
         var subscriber = new Subscriber_1.SafeSubscriber({
           next: function(value) {
-            resolve69(value);
+            resolve70(value);
             subscriber.unsubscribe();
           },
           error: reject,
           complete: function() {
             if (hasConfig) {
-              resolve69(config2.defaultValue);
+              resolve70(config2.defaultValue);
             } else {
               reject(new EmptyError_1.EmptyError());
             }
@@ -65902,14 +65923,14 @@ var require_run_async = __commonJS({
       return function() {
         var args = arguments;
         var originalThis = this;
-        var promise = new Promise(function(resolve69, reject) {
+        var promise = new Promise(function(resolve70, reject) {
           var resolved = false;
           const wrappedResolve = function(value) {
             if (resolved) {
               console.warn("Run-async promise already resolved.");
             }
             resolved = true;
-            resolve69(value);
+            resolve70(value);
           };
           var rejected = false;
           const wrappedReject = function(value) {
@@ -69452,7 +69473,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve69.call(this, root, ref);
+      let _sch = resolve70.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a2 = root.localRefs) === null || _a2 === void 0 ? void 0 : _a2[ref];
         const { schemaId } = this.opts;
@@ -69479,7 +69500,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve69(root, ref) {
+    function resolve70(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -69697,8 +69718,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path100) {
-      let input = path100;
+    function removeDotSegments(path101) {
+      let input = path101;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -69950,8 +69971,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path100, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path100 && path100 !== "/" ? path100 : void 0;
+        const [path101, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path101 && path101 !== "/" ? path101 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -70106,21 +70127,21 @@ var require_fast_uri = __commonJS({
         normalizeString(uri, options);
       } else if (typeof uri === "object") {
         uri = /** @type {T} */
-        parse4(serialize(uri, options), options);
+        parse5(serialize(uri, options), options);
       }
       return uri;
     }
-    function resolve69(baseURI, relativeURI, options) {
+    function resolve70(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
-      const resolved = resolveComponent(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true);
+      const resolved = resolveComponent(parse5(baseURI, schemelessOptions), parse5(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
     function resolveComponent(base, relative6, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
-        base = parse4(serialize(base, options), options);
-        relative6 = parse4(serialize(relative6, options), options);
+        base = parse5(serialize(base, options), options);
+        relative6 = parse5(serialize(relative6, options), options);
       }
       options = options || {};
       if (!options.tolerant && relative6.scheme) {
@@ -70343,7 +70364,7 @@ var require_fast_uri = __commonJS({
       }
       return { parsed, malformedAuthorityOrPort };
     }
-    function parse4(uri, opts) {
+    function parse5(uri, opts) {
       return parseWithStatus(uri, opts).parsed;
     }
     function normalizeString(uri, opts) {
@@ -70368,11 +70389,11 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve69,
+      resolve: resolve70,
       resolveComponent,
       equal,
       serialize,
-      parse: parse4
+      parse: parse5
     };
     module2.exports = fastUri;
     module2.exports.default = fastUri;
@@ -73344,12 +73365,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs80, exportName) {
+    function addFormats(ajv, list, fs81, exportName) {
       var _a2;
       var _b2;
       (_a2 = (_b2 = ajv.opts.code).formats) !== null && _a2 !== void 0 ? _a2 : _b2.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f2 of list)
-        ajv.addFormat(f2, fs80[f2]);
+        ajv.addFormat(f2, fs81[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -74633,11 +74654,11 @@ var parser = new YargsParser({
   resolve: import_path2.resolve,
   // TODO: figure  out a  way to combine ESM and CJS coverage, such  that
   // we can exercise all the lines below:
-  require: (path100) => {
+  require: (path101) => {
     if (typeof require !== "undefined") {
-      return require(path100);
-    } else if (path100.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path100, "utf8"));
+      return require(path101);
+    } else if (path101.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path101, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -77163,12 +77184,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve69, reject) => {
+      return new Promise((resolve70, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve69(completions);
+            resolve70(completions);
         });
       });
     } else {
@@ -77200,9 +77221,9 @@ var YargsInstance = class {
     __classPrivateFieldSet(this, _YargsInstance_hasOutput, true, "f");
     if (!__classPrivateFieldGet(this, _YargsInstance_usage, "f").hasCachedHelpMessage()) {
       if (!this.parsed) {
-        const parse4 = this[kRunYargsParserAndExecuteCommands](__classPrivateFieldGet(this, _YargsInstance_processArgs, "f"), void 0, void 0, 0, true);
-        if (isPromise(parse4)) {
-          return parse4.then(() => {
+        const parse5 = this[kRunYargsParserAndExecuteCommands](__classPrivateFieldGet(this, _YargsInstance_processArgs, "f"), void 0, void 0, 0, true);
+        if (isPromise(parse5)) {
+          return parse5.then(() => {
             return __classPrivateFieldGet(this, _YargsInstance_usage, "f").help();
           });
         }
@@ -77546,9 +77567,9 @@ var YargsInstance = class {
     __classPrivateFieldSet(this, _YargsInstance_hasOutput, true, "f");
     if (!__classPrivateFieldGet(this, _YargsInstance_usage, "f").hasCachedHelpMessage()) {
       if (!this.parsed) {
-        const parse4 = this[kRunYargsParserAndExecuteCommands](__classPrivateFieldGet(this, _YargsInstance_processArgs, "f"), void 0, void 0, 0, true);
-        if (isPromise(parse4)) {
-          parse4.then(() => {
+        const parse5 = this[kRunYargsParserAndExecuteCommands](__classPrivateFieldGet(this, _YargsInstance_processArgs, "f"), void 0, void 0, 0, true);
+        if (isPromise(parse5)) {
+          parse5.then(() => {
             __classPrivateFieldGet(this, _YargsInstance_usage, "f").showHelp(level);
           });
           return this;
@@ -78418,16 +78439,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve69(true);
+        resolve70(true);
         return;
       }
-      resolve69(/^y(es)?$/i.test(trimmed));
+      resolve70(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -80028,13 +80049,13 @@ var PromisePolyfill = class extends Promise {
   // Available starting from Node 22
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
   static withResolver() {
-    let resolve69;
+    let resolve70;
     let reject;
     const promise = new Promise((res, rej) => {
-      resolve69 = res;
+      resolve70 = res;
       reject = rej;
     });
-    return { promise, resolve: resolve69, reject };
+    return { promise, resolve: resolve70, reject };
   }
 };
 
@@ -80068,7 +80089,7 @@ function createPrompt(view) {
       output
     });
     const screen = new ScreenManager(rl);
-    const { promise, resolve: resolve69, reject } = PromisePolyfill.withResolver();
+    const { promise, resolve: resolve70, reject } = PromisePolyfill.withResolver();
     const cancel = () => reject(new CancelPromptError());
     if (signal) {
       const abort = () => reject(new AbortPromptError({ cause: signal.reason }));
@@ -80095,7 +80116,7 @@ function createPrompt(view) {
       cycle(() => {
         try {
           const nextView = view(config2, (value) => {
-            setImmediate(() => resolve69(value));
+            setImmediate(() => resolve70(value));
           });
           if (nextView === void 0) {
             const callerFilename = callSites[1]?.getFileName();
@@ -81404,9 +81425,9 @@ var import_rxjs = __toESM(require_cjs(), 1);
 var import_run_async = __toESM(require_run_async(), 1);
 var import_mute_stream2 = __toESM(require_lib(), 1);
 var _ = {
-  set: (obj, path100 = "", value) => {
+  set: (obj, path101 = "", value) => {
     let pointer = obj;
-    path100.split(".").forEach((key, index, arr) => {
+    path101.split(".").forEach((key, index, arr) => {
       if (key === "__proto__" || key === "constructor")
         return;
       if (index === arr.length - 1) {
@@ -81417,8 +81438,8 @@ var _ = {
       pointer = pointer[key];
     });
   },
-  get: (obj, path100 = "", defaultValue) => {
-    const travel = (regexp) => String.prototype.split.call(path100, regexp).filter(Boolean).reduce(
+  get: (obj, path101 = "", defaultValue) => {
+    const travel = (regexp) => String.prototype.split.call(path101, regexp).filter(Boolean).reduce(
       // @ts-expect-error implicit any on res[key]
       (res, key) => res == null ? res : res[key],
       obj
@@ -81536,7 +81557,7 @@ var PromptsRunner = class {
       throw new Error(`Prompt for type ${question.type} not found`);
     }
     let cleanupSignal;
-    const promptFn = isPromptConstructor(prompt2) ? (q2, opt) => new Promise((resolve69, reject) => {
+    const promptFn = isPromptConstructor(prompt2) ? (q2, opt) => new Promise((resolve70, reject) => {
       const { signal: signal2 } = opt;
       if (signal2.aborted) {
         reject(new AbortPromptError({ cause: signal2.reason }));
@@ -81573,7 +81594,7 @@ var PromptsRunner = class {
         signal2.removeEventListener("abort", abort);
         cleanupSignal = void 0;
       };
-      activePrompt.run().then(resolve69, reject).finally(cleanup);
+      activePrompt.run().then(resolve70, reject).finally(cleanup);
     }) : prompt2;
     let cleanupModuleSignal;
     const { signal: moduleSignal } = this.opt;
@@ -82879,6 +82900,7 @@ function writePluginAdaptationPrompt(repoPath, pluginId, content) {
 
 // src/harness/plugins.ts
 init_schema2();
+init_manifest();
 init_stages();
 var PluginManifestFileSchema = external_exports.object({
   src: external_exports.string().min(1),
@@ -83113,6 +83135,7 @@ function applyPluginFromDir(repoPath, pluginDir, options, meta) {
   });
   const promptAbsPath = writePluginAdaptationPrompt(resolved, manifest.id, promptContent);
   const adaptPromptPath = path65.relative(resolved, promptAbsPath);
+  stampManifestWriter(resolved);
   success(`Applied plugin: ${manifest.id}`);
   info(`Registered stage(s): ${stageIds.join(", ")}`);
   for (const file of filesWritten) {
@@ -83846,8 +83869,20 @@ init_stages();
 // src/harness/doctor.ts
 var fs64 = __toESM(require("fs"));
 var path73 = __toESM(require("path"));
+init_package_version();
 init_slot_registry();
 
+// src/utils/semver.ts
+function compareSemver(a, b2) {
+  const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+  const pb = b2.split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (d !== 0) return d < 0 ? -1 : 1;
+  }
+  return 0;
+}
+
 // src/harness/eject.ts
 var fs60 = __toESM(require("fs"));
 var path68 = __toESM(require("path"));
@@ -84120,6 +84155,7 @@ function cleanupResolvedLine(source) {
 // src/harness/lines.ts
 init_schema2();
 init_schema2();
+init_manifest();
 init_stages();
 function lineDirRel(lineId) {
   return `${LOCAL_LINES_DIR}/${lineId}`;
@@ -84308,6 +84344,7 @@ function applyLineFromDir(repoPath, bundleDir, options, meta) {
     buildLineAdaptationPrompt(resolved, program, { ...partial2, adaptPromptPath: "" })
   );
   const adaptPromptPath = path71.relative(resolved, promptAbsPath);
+  stampManifestWriter(resolved);
   success(`Applied line: ${manifest.id}`);
   info(`Stations: ${partial2.stationIds.join(" \u2192 ")}`);
   info(
@@ -84816,6 +84853,7 @@ function listHarnessShellScripts(harnessDir) {
   return out;
 }
 var CHECK_LABELS = {
+  "cli-version": "CLI vs harness writer",
   "harness-env": "harness.env schema",
   "stages-registry": "stages.json registry",
   "stage-files": "stage scripts & commands",
@@ -84888,6 +84926,28 @@ function runDoctor(repoPath) {
   }
   const contract = detectContract(harnessDir);
   const contractSeverity = contract === "1.0" ? "error" : "warning";
+  const writerVersion = readManifest(repoPath)?.cliVersion;
+  const runningVersion = getHarPackageVersion();
+  if (!writerVersion) {
+    skipped.add("cli-version");
+  }
+  if (writerVersion && compareSemver(runningVersion, writerVersion) < 0) {
+    const finding = {
+      check: "cli-version",
+      severity: "error",
+      file: "manifest.json",
+      message: `This harness was written by @osfactory/har ${writerVersion}; you are running ${runningVersion}.`,
+      remedy: "npm install -g @osfactory/har@latest   (or run the repo's local build: node dist/index.js)"
+    };
+    return {
+      ok: false,
+      contract,
+      checks: Object.keys(CHECK_LABELS).map(
+        (id) => id === "cli-version" ? { id, label: CHECK_LABELS[id], status: "fail" } : { id, label: CHECK_LABELS[id], status: "skip" }
+      ),
+      findings: [finding]
+    };
+  }
   const envValidation = readValidatedHarnessEnv(repoPath);
   let portLanes = {};
   if (!envValidation) {
@@ -85411,6 +85471,7 @@ async function maintainHarness(options) {
   }
   retireLifecycleShims(repoPath);
   ensureEcosystemVerificationStages(repoPath);
+  stampManifestWriter(repoPath);
   const drift = compareHarnessToTemplate(repoPath);
   const validation2 = validateHarness(repoPath);
   if (options.finalize) {
@@ -85582,12 +85643,12 @@ function printAdaptationPrompt(content) {
 }
 function askYesNo2(question) {
   const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
-      resolve69(trimmed === "" || /^y(es)?$/i.test(trimmed));
+      resolve70(trimmed === "" || /^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -85678,16 +85739,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline6.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve69(true);
+        resolve70(true);
         return;
       }
-      resolve69(/^y(es)?$/i.test(trimmed));
+      resolve70(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -86664,8 +86725,8 @@ async function askYesNo4(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline8 = await import("readline");
   const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve69) => {
-    rl.question(question, resolve69);
+  const answer = await new Promise((resolve70) => {
+    rl.question(question, resolve70);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -86762,12 +86823,12 @@ init_stages();
 init_logging();
 function askYesNo5(question) {
   const rl = readline7.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve69) => {
+  return new Promise((resolve70) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
-      resolve69(trimmed === "" || /^y(es)?$/i.test(trimmed));
+      resolve70(trimmed === "" || /^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -87769,7 +87830,7 @@ async function confirm(question) {
   if (!process.stdin.isTTY) return false;
   const readline8 = await import("readline");
   const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve69) => rl.question(question, resolve69));
+  const answer = await new Promise((resolve70) => rl.question(question, resolve70));
   rl.close();
   return /^y(es)?$/i.test(answer.trim());
 }
@@ -88128,7 +88189,7 @@ async function loginViaBrowser(portalUrl, openUrlOrOptions = openBrowser) {
   const options = typeof openUrlOrOptions === "function" ? { openUrl: openUrlOrOptions } : openUrlOrOptions;
   const openUrl = options.openUrl ?? openBrowser;
   const state = (0, import_crypto.randomUUID)();
-  return new Promise((resolve69, reject) => {
+  return new Promise((resolve70, reject) => {
     let timer;
     const server = http.createServer((req, res) => {
       const requestUrl = new URL(req.url ?? "", "http://127.0.0.1");
@@ -88156,7 +88217,7 @@ async function loginViaBrowser(portalUrl, openUrlOrOptions = openBrowser) {
       res.end("<h1>Logged in</h1><p>You can close this tab and return to the terminal.</p>");
       cleanup();
       const targets = parseCliTargetsParam(requestUrl.searchParams.get("targets"));
-      resolve69({
+      resolve70({
         portalUrl,
         token,
         workspace: workspaceSlug ?? workspace,
@@ -88752,8 +88813,8 @@ async function askYesNo6(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline8 = await import("readline");
   const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve69) => {
-    rl.question(question, resolve69);
+  const answer = await new Promise((resolve70) => {
+    rl.question(question, resolve70);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -88958,8 +89019,8 @@ async function askYesNo7(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const readline8 = await import("readline");
   const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve69) => {
-    rl.question(question, resolve69);
+  const answer = await new Promise((resolve70) => {
+    rl.question(question, resolve70);
   });
   rl.close();
   return /^[Yy]$/.test(answer.trim());
@@ -90042,10 +90103,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path100) {
-  if (!path100)
+function getElementAtPath(obj, path101) {
+  if (!path101)
     return obj;
-  return path100.reduce((acc, key) => acc?.[key], obj);
+  return path101.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -90365,11 +90426,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path100, issues) {
+function prefixIssues(path101, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path100);
+    iss.path.unshift(path101);
     return iss;
   });
 }
@@ -95692,7 +95753,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve69) => setTimeout(resolve69, pollInterval));
+        await new Promise((resolve70) => setTimeout(resolve70, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -95709,7 +95770,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve69, reject) => {
+    return new Promise((resolve70, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -95787,7 +95848,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve69(parseResult.data);
+            resolve70(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -96048,12 +96109,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve69, reject) => {
+    return new Promise((resolve70, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve69, interval);
+      const timeoutId = setTimeout(resolve70, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -96926,12 +96987,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve69) => {
+    return new Promise((resolve70) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve69();
+        resolve70();
       } else {
-        this._stdout.once("drain", resolve69);
+        this._stdout.once("drain", resolve70);
       }
     });
   }
@@ -99695,8 +99756,108 @@ async function runCli() {
   await syncDirtyRepos();
 }
 
+// src/core/prefer-local-runtime.ts
+var fs80 = __toESM(require("fs"));
+var path100 = __toESM(require("path"));
+var import_child_process22 = require("child_process");
+init_package_version();
+var PACKAGE_NAME = "@osfactory/har";
+function readPackageJson(dir) {
+  const pkgPath = path100.join(dir, "package.json");
+  if (!fs80.existsSync(pkgPath)) return null;
+  try {
+    return JSON.parse(fs80.readFileSync(pkgPath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function resolveHarEntry(pkgDir, pkg) {
+  let rel = "dist/index.js";
+  if (pkg.bin && typeof pkg.bin === "object" && pkg.bin !== null && "har" in pkg.bin) {
+    const bin = pkg.bin.har;
+    if (typeof bin === "string" && bin.length > 0) rel = bin;
+  } else if (typeof pkg.bin === "string" && pkg.bin.length > 0) {
+    rel = pkg.bin;
+  }
+  const entry = path100.resolve(pkgDir, rel);
+  return fs80.existsSync(entry) ? entry : null;
+}
+function sameFile(a, b2) {
+  try {
+    return fs80.realpathSync(a) === fs80.realpathSync(b2);
+  } catch {
+    return path100.resolve(a) === path100.resolve(b2);
+  }
+}
+function considerCandidate(candidate, currentVersion, currentEntry) {
+  if (!candidate) return null;
+  if (currentEntry && sameFile(candidate.entryPath, currentEntry)) return null;
+  if (compareSemver(candidate.version, currentVersion) <= 0) return null;
+  return candidate;
+}
+function inspectDir(dir) {
+  const pkg = readPackageJson(dir);
+  if (pkg?.name === PACKAGE_NAME && pkg.version) {
+    const entry = resolveHarEntry(dir, pkg);
+    if (entry) return { entryPath: entry, version: pkg.version, reason: "har-repo" };
+  }
+  const nestedDir = path100.join(dir, "node_modules", PACKAGE_NAME);
+  const nested = readPackageJson(nestedDir);
+  if (nested?.name === PACKAGE_NAME && nested.version) {
+    const entry = resolveHarEntry(nestedDir, nested);
+    if (entry) return { entryPath: entry, version: nested.version, reason: "node_modules" };
+  }
+  return null;
+}
+function walkParents(start) {
+  const out = [];
+  let current = path100.resolve(start);
+  const { root } = path100.parse(current);
+  for (; ; ) {
+    out.push(current);
+    if (current === root) break;
+    current = path100.dirname(current);
+  }
+  return out;
+}
+function findPreferredLocalRuntime(options) {
+  const seen = /* @__PURE__ */ new Set();
+  const roots = [...(options.extraRoots ?? []).map((r) => path100.resolve(r)), ...walkParents(options.cwd)];
+  for (const dir of roots) {
+    if (seen.has(dir)) continue;
+    seen.add(dir);
+    const found = considerCandidate(inspectDir(dir), options.currentVersion, options.currentEntry);
+    if (found) return found;
+  }
+  return null;
+}
+function maybeReexecPreferredRuntime() {
+  if (process.env.HAR_USING_LOCAL_RUNTIME || process.env.HAR_SKIP_LOCAL_RUNTIME) {
+    return;
+  }
+  const currentVersion = getHarPackageVersion();
+  const extraRoots = process.env.HAR_ROOT ? [process.env.HAR_ROOT] : [];
+  const found = findPreferredLocalRuntime({
+    cwd: process.cwd(),
+    currentVersion,
+    currentEntry: process.argv[1],
+    extraRoots
+  });
+  if (!found) return;
+  process.stderr.write(
+    `Using repo-local @osfactory/har ${found.version} (this CLI is ${currentVersion})
+`
+  );
+  const result = (0, import_child_process22.spawnSync)(process.execPath, [found.entryPath, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    env: { ...process.env, HAR_USING_LOCAL_RUNTIME: "1" }
+  });
+  process.exit(result.status ?? 1);
+}
+
 // src/index.ts
 init_sync_context();
+maybeReexecPreferredRuntime();
 runCli().catch(async (err) => {
   console.error(err.message);
   await syncDirtyRepos();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "HAR: open agent harness CLI and MCP server for coding agents, isolated worktrees, and software-factory workflows",
   "keywords": [
     "har",