@osfactory/har 0.43.2 → 0.44.0

package/dist/index.js

@@ -553,8 +553,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path63, errorMaps, issueData } = params;
-      const fullPath = [...path63, ...issueData.path || []];
+      const { data, path: path64, errorMaps, issueData } = params;
+      const fullPath = [...path64, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -862,11 +862,11 @@ var init_types = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path63, key) {
+      constructor(parent, value, path64, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path63;
+        this._path = path64;
         this._key = key;
       }
       get path() {
@@ -28236,11 +28236,13 @@ var init_manifest = __esm({
     path4 = __toESM(require("path"));
     init_schema2();
     init_file_ops();
-    GENERATOR_VERSION = "0.4.0";
+    GENERATOR_VERSION = "0.5.0";
     MANIFEST_VERSION = "1";
     DEFAULT_HAR_DIR = ".har";
     CHECKSUM_SKIP = /* @__PURE__ */ new Set([
       "manifest.json",
+      "AGENTS.md.proposed",
+      "AGENTS.md.proposed.meta.json",
       "AGENT.md.proposed",
       "AGENT.md.proposed.meta.json",
       "ADAPT-PROMPT.md"
@@ -33266,14 +33268,14 @@ var require_url_state_machine = __commonJS({
       return url.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url) {
-      const path63 = url.path;
-      if (path63.length === 0) {
+      const path64 = url.path;
+      if (path64.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path63.length === 1 && isNormalizedWindowsDriveLetter(path63[0])) {
+      if (url.scheme === "file" && path64.length === 1 && isNormalizedWindowsDriveLetter(path64[0])) {
         return;
       }
-      path63.pop();
+      path64.pop();
     }
     function includesCredentials(url) {
       return url.username !== "" || url.password !== "";
@@ -38852,14 +38854,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path63, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path64, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path63, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path64, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -38868,13 +38870,13 @@ function createFileFromPath(path63, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path63, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path63);
-  return createFileFromPath(path63, stats, filenameOrOptions, options);
+function fileFromPathSync(path64, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path64);
+  return createFileFromPath(path64, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path63, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path63);
-  return createFileFromPath(path63, stats, filenameOrOptions, options);
+async function fileFromPath2(path64, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path64);
+  return createFileFromPath(path64, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -38956,32 +38958,32 @@ __export(otel_hooks_exports, {
 });
 function getOtelHooksHome() {
   if (process.env.HAR_OTEL_HOOKS_HOME) {
-    return path48.resolve(process.env.HAR_OTEL_HOOKS_HOME);
+    return path49.resolve(process.env.HAR_OTEL_HOOKS_HOME);
   }
-  return path48.join(os14.homedir(), ".har", "otel-hooks");
+  return path49.join(os15.homedir(), ".har", "otel-hooks");
 }
 function getOtelHooksConfigPath(hooksHome = getOtelHooksHome()) {
-  return path48.join(hooksHome, "otel_config.json");
+  return path49.join(hooksHome, "otel_config.json");
 }
 function getOtelHooksWrapperPath(hooksHome = getOtelHooksHome()) {
-  return path48.join(hooksHome, "run-otel-hook.sh");
+  return path49.join(hooksHome, "run-otel-hook.sh");
 }
 function getOtelHooksStateDir(hooksHome = getOtelHooksHome()) {
-  return path48.join(hooksHome, "state");
+  return path49.join(hooksHome, "state");
 }
 function localOtelHookBin(hooksHome) {
-  return path48.join(hooksHome, "node_modules", ".bin", "otel-hook");
+  return path49.join(hooksHome, "node_modules", ".bin", "otel-hook");
 }
 function installedPackageVersion(hooksHome) {
   try {
-    const pkgPath = path48.join(
+    const pkgPath = path49.join(
       hooksHome,
       "node_modules",
       "@osfactory",
       "otel-hook",
       "package.json"
     );
-    const pkg = JSON.parse(fs43.readFileSync(pkgPath, "utf8"));
+    const pkg = JSON.parse(fs44.readFileSync(pkgPath, "utf8"));
     return typeof pkg.version === "string" ? pkg.version : null;
   } catch {
     return null;
@@ -39032,15 +39034,15 @@ function buildOtelHooksConfig(options) {
   };
 }
 function writeOtelHooksConfig(config2, hooksHome = getOtelHooksHome()) {
-  fs43.mkdirSync(hooksHome, { recursive: true });
+  fs44.mkdirSync(hooksHome, { recursive: true });
   const configPath = getOtelHooksConfigPath(hooksHome);
-  fs43.writeFileSync(configPath, `${JSON.stringify(config2, null, 2)}
+  fs44.writeFileSync(configPath, `${JSON.stringify(config2, null, 2)}
 `);
   return configPath;
 }
 function writeOtelHooksWrapper(otelHookCommand, hooksHome = getOtelHooksHome()) {
-  fs43.mkdirSync(hooksHome, { recursive: true });
-  fs43.mkdirSync(getOtelHooksStateDir(hooksHome), { recursive: true });
+  fs44.mkdirSync(hooksHome, { recursive: true });
+  fs44.mkdirSync(getOtelHooksStateDir(hooksHome), { recursive: true });
   const wrapperPath = getOtelHooksWrapperPath(hooksHome);
   const configPath = getOtelHooksConfigPath(hooksHome);
   const stateDir = getOtelHooksStateDir(hooksHome);
@@ -39052,9 +39054,9 @@ exec "${otelHookCommand}" run \\
   --state-dir "${stateDir}" \\
   "$@"
 `;
-  fs43.writeFileSync(wrapperPath, script, { mode: 493 });
+  fs44.writeFileSync(wrapperPath, script, { mode: 493 });
   try {
-    fs43.chmodSync(wrapperPath, 493);
+    fs44.chmodSync(wrapperPath, 493);
   } catch {
   }
   return wrapperPath;
@@ -39067,11 +39069,11 @@ function commandExists2(command2) {
 }
 function resolveOtelHookCommand(hooksHome) {
   const local = localOtelHookBin(hooksHome);
-  if (fs43.existsSync(local)) return local;
+  if (fs44.existsSync(local)) return local;
   return null;
 }
 function tryInstallPackage(hooksHome) {
-  fs43.mkdirSync(hooksHome, { recursive: true });
+  fs44.mkdirSync(hooksHome, { recursive: true });
   if (!commandExists2("npm")) {
     return {
       ok: false,
@@ -39083,7 +39085,7 @@ function tryInstallPackage(hooksHome) {
     ["install", "--prefix", hooksHome, "--no-fund", "--no-audit", OTEL_HOOKS_PACKAGE],
     { encoding: "utf8", timeout: 18e4 }
   );
-  if (result.status === 0 && fs43.existsSync(localOtelHookBin(hooksHome))) {
+  if (result.status === 0 && fs44.existsSync(localOtelHookBin(hooksHome))) {
     return { ok: true, detail: `npm install --prefix ${hooksHome} ${OTEL_HOOKS_PACKAGE}` };
   }
   return {
@@ -39109,14 +39111,14 @@ function uninstallLegacyPythonHooks(hooksHome) {
 }
 function removeLegacyPythonArtifacts(hooksHome) {
   const legacyPaths = [
-    path48.join(hooksHome, ".venv"),
-    path48.join(hooksHome, "otel_config.yaml"),
-    path48.join(hooksHome, "venv")
+    path49.join(hooksHome, ".venv"),
+    path49.join(hooksHome, "otel_config.yaml"),
+    path49.join(hooksHome, "venv")
   ];
   for (const target of legacyPaths) {
     try {
-      if (fs43.existsSync(target)) {
-        fs43.rmSync(target, { recursive: true, force: true });
+      if (fs44.existsSync(target)) {
+        fs44.rmSync(target, { recursive: true, force: true });
       }
     } catch {
     }
@@ -39157,10 +39159,10 @@ function runSetupProvider(providerId, otelHookCommand, wrapperPath) {
   };
 }
 function rewriteHookCommandsToWrapper(filePath, wrapperPath) {
-  if (!fs43.existsSync(filePath)) return false;
+  if (!fs44.existsSync(filePath)) return false;
   let raw;
   try {
-    raw = fs43.readFileSync(filePath, "utf8");
+    raw = fs44.readFileSync(filePath, "utf8");
   } catch {
     return false;
   }
@@ -39207,15 +39209,15 @@ function rewriteHookCommandsToWrapper(filePath, wrapperPath) {
     return changed;
   };
   if (!walk(parsed)) return false;
-  fs43.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
+  fs44.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
 `);
   return true;
 }
 function pruneLegacyCursorHookEvents(filePath, wrapperPath) {
-  if (!fs43.existsSync(filePath)) return false;
+  if (!fs44.existsSync(filePath)) return false;
   let raw;
   try {
-    raw = fs43.readFileSync(filePath, "utf8");
+    raw = fs44.readFileSync(filePath, "utf8");
   } catch {
     return false;
   }
@@ -39250,21 +39252,21 @@ function pruneLegacyCursorHookEvents(filePath, wrapperPath) {
     }
   }
   if (!changed) return false;
-  fs43.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
+  fs44.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
 `);
   return true;
 }
 function rewriteKnownHookRegistrations(wrapperPath) {
-  const home = os14.homedir();
+  const home = os15.homedir();
   const candidates = [
-    path48.join(home, ".cursor", "hooks.json"),
-    path48.join(home, ".claude", "settings.json"),
-    path48.join(home, ".codex", "hooks.json")
+    path49.join(home, ".cursor", "hooks.json"),
+    path49.join(home, ".claude", "settings.json"),
+    path49.join(home, ".codex", "hooks.json")
   ];
   for (const filePath of candidates) {
     try {
       rewriteHookCommandsToWrapper(filePath, wrapperPath);
-      if (filePath.endsWith(`${path48.sep}.cursor${path48.sep}hooks.json`)) {
+      if (filePath.endsWith(`${path49.sep}.cursor${path49.sep}hooks.json`)) {
         pruneLegacyCursorHookEvents(filePath, wrapperPath);
       }
     } catch {
@@ -39280,7 +39282,7 @@ function ensureOtelHooks(options) {
   const hooksHome = getOtelHooksHome();
   const errors = [];
   const providersSetup = [];
-  fs43.mkdirSync(hooksHome, { recursive: true });
+  fs44.mkdirSync(hooksHome, { recursive: true });
   let otelHookCommand = resolveOtelHookCommand(hooksHome);
   const needsInstall = !otelHookCommand || installedPackageVersion(hooksHome) !== pinnedVersion();
   if (needsInstall) {
@@ -39374,14 +39376,14 @@ function ensureOtelHooks(options) {
 function disableOtelHooksExport() {
   return writeOtelHooksConfig(buildOtelHooksConfig({ enabled: false }));
 }
-var import_child_process10, fs43, os14, path48, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_PROVIDERS, OTEL_HOOKS_AGENTS, LEGACY_CURSOR_ONLY_HOOK_EVENTS;
+var import_child_process10, fs44, os15, path49, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_PROVIDERS, OTEL_HOOKS_AGENTS, LEGACY_CURSOR_ONLY_HOOK_EVENTS;
 var init_otel_hooks = __esm({
   "src/core/otel-hooks.ts"() {
     "use strict";
     import_child_process10 = require("child_process");
-    fs43 = __toESM(require("fs"));
-    os14 = __toESM(require("os"));
-    path48 = __toESM(require("path"));
+    fs44 = __toESM(require("fs"));
+    os15 = __toESM(require("os"));
+    path49 = __toESM(require("path"));
     init_control_config();
     init_telemetry_config();
     OTEL_HOOKS_PACKAGE = "@osfactory/otel-hook@0.1.2";
@@ -40497,15 +40499,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path63 = [graph[toModel].parent, toModel];
+      const path64 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path63.unshift(graph[cur].parent);
+        path64.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path63;
+      fn.conversion = path64;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -46435,7 +46437,7 @@ var require_iso2022 = __commonJS({
 // node_modules/chardet/index.js
 var require_chardet = __commonJS({
   "node_modules/chardet/index.js"(exports2, module2) {
-    var fs50 = require("fs");
+    var fs51 = require("fs");
     var utf8 = require_utf8();
     var unicode = require_unicode();
     var mbcs = require_mbcs();
@@ -46509,28 +46511,28 @@ var require_chardet = __commonJS({
       var fd;
       var handler = function(err, buffer) {
         if (fd) {
-          fs50.closeSync(fd);
+          fs51.closeSync(fd);
         }
         if (err) return cb(err, null);
         cb(null, self.detect(buffer, opts));
       };
       if (opts && opts.sampleSize) {
-        fd = fs50.openSync(filepath, "r"), sample = Buffer.allocUnsafe(opts.sampleSize);
-        fs50.read(fd, sample, 0, opts.sampleSize, null, function(err) {
+        fd = fs51.openSync(filepath, "r"), sample = Buffer.allocUnsafe(opts.sampleSize);
+        fs51.read(fd, sample, 0, opts.sampleSize, null, function(err) {
           handler(err, sample);
         });
         return;
       }
-      fs50.readFile(filepath, handler);
+      fs51.readFile(filepath, handler);
     };
     module2.exports.detectFileSync = function(filepath, opts) {
       if (opts && opts.sampleSize) {
-        var fd = fs50.openSync(filepath, "r"), sample2 = Buffer.allocUnsafe(opts.sampleSize);
-        fs50.readSync(fd, sample2, 0, opts.sampleSize);
-        fs50.closeSync(fd);
+        var fd = fs51.openSync(filepath, "r"), sample2 = Buffer.allocUnsafe(opts.sampleSize);
+        fs51.readSync(fd, sample2, 0, opts.sampleSize);
+        fs51.closeSync(fd);
         return self.detect(sample2, opts);
       }
-      return self.detect(fs50.readFileSync(filepath), opts);
+      return self.detect(fs51.readFileSync(filepath), opts);
     };
     module2.exports.detectAll = function(buffer, opts) {
       if (typeof opts !== "object") {
@@ -49995,16 +49997,16 @@ var require_os_tmpdir = __commonJS({
     var isWindows = process.platform === "win32";
     var trailingSlashRe = isWindows ? /[^:]\\$/ : /.\/$/;
     module2.exports = function() {
-      var path63;
+      var path64;
       if (isWindows) {
-        path63 = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
+        path64 = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
       } else {
-        path63 = process.env.TMPDIR || process.env.TMP || process.env.TEMP || "/tmp";
+        path64 = process.env.TMPDIR || process.env.TMP || process.env.TEMP || "/tmp";
       }
-      if (trailingSlashRe.test(path63)) {
-        path63 = path63.slice(0, -1);
+      if (trailingSlashRe.test(path64)) {
+        path64 = path64.slice(0, -1);
       }
-      return path63;
+      return path64;
     };
   }
 });
@@ -50012,8 +50014,8 @@ var require_os_tmpdir = __commonJS({
 // node_modules/tmp/lib/tmp.js
 var require_tmp = __commonJS({
   "node_modules/tmp/lib/tmp.js"(exports2, module2) {
-    var fs50 = require("fs");
-    var path63 = require("path");
+    var fs51 = require("fs");
+    var path64 = require("path");
     var crypto6 = require("crypto");
     var osTmpDir = require_os_tmpdir();
     var _c2 = process.binding("constants");
@@ -50055,7 +50057,7 @@ var require_tmp = __commonJS({
     }
     function _generateTmpName(opts) {
       if (opts.name) {
-        return path63.join(opts.dir || tmpDir, opts.name);
+        return path64.join(opts.dir || tmpDir, opts.name);
       }
       if (opts.template) {
         return opts.template.replace(TEMPLATE_PATTERN, _randomChars(6));
@@ -50066,7 +50068,7 @@ var require_tmp = __commonJS({
         _randomChars(12),
         opts.postfix || ""
       ].join("");
-      return path63.join(opts.dir || tmpDir, name);
+      return path64.join(opts.dir || tmpDir, name);
     }
     function tmpName(options, callback) {
       var args = _parseArguments(options, callback), opts = args[0], cb = args[1], tries = opts.name ? 1 : opts.tries || DEFAULT_TRIES;
@@ -50076,7 +50078,7 @@ var require_tmp = __commonJS({
         return cb(new Error("Invalid template provided"));
       (function _getUniqueName() {
         const name = _generateTmpName(opts);
-        fs50.stat(name, function(err) {
+        fs51.stat(name, function(err) {
           if (!err) {
             if (tries-- > 0) return _getUniqueName();
             return cb(new Error("Could not get a unique tmp filename, max tries reached " + name));
@@ -50094,7 +50096,7 @@ var require_tmp = __commonJS({
       do {
         const name = _generateTmpName(opts);
         try {
-          fs50.statSync(name);
+          fs51.statSync(name);
         } catch (e2) {
           return name;
         }
@@ -50106,13 +50108,13 @@ var require_tmp = __commonJS({
       opts.postfix = _isUndefined(opts.postfix) ? ".tmp" : opts.postfix;
       tmpName(opts, function _tmpNameCreated(err, name) {
         if (err) return cb(err);
-        fs50.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
+        fs51.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
           if (err2) return cb(err2);
           if (opts.discardDescriptor) {
-            return fs50.close(fd, function _discardCallback(err3) {
+            return fs51.close(fd, function _discardCallback(err3) {
               if (err3) {
                 try {
-                  fs50.unlinkSync(name);
+                  fs51.unlinkSync(name);
                 } catch (e2) {
                   if (!isENOENT(e2)) {
                     err3 = e2;
@@ -50135,9 +50137,9 @@ var require_tmp = __commonJS({
       opts.postfix = opts.postfix || ".tmp";
       const discardOrDetachDescriptor = opts.discardDescriptor || opts.detachDescriptor;
       const name = tmpNameSync(opts);
-      var fd = fs50.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
+      var fd = fs51.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
       if (opts.discardDescriptor) {
-        fs50.closeSync(fd);
+        fs51.closeSync(fd);
         fd = void 0;
       }
       return {
@@ -50149,9 +50151,9 @@ var require_tmp = __commonJS({
     function _rmdirRecursiveSync(root) {
       const dirs = [root];
       do {
-        var dir2 = dirs.pop(), deferred = false, files = fs50.readdirSync(dir2);
+        var dir2 = dirs.pop(), deferred = false, files = fs51.readdirSync(dir2);
         for (var i2 = 0, length = files.length; i2 < length; i2++) {
-          var file2 = path63.join(dir2, files[i2]), stat = fs50.lstatSync(file2);
+          var file2 = path64.join(dir2, files[i2]), stat = fs51.lstatSync(file2);
           if (stat.isDirectory()) {
             if (!deferred) {
               deferred = true;
@@ -50159,11 +50161,11 @@ var require_tmp = __commonJS({
             }
             dirs.push(file2);
           } else {
-            fs50.unlinkSync(file2);
+            fs51.unlinkSync(file2);
           }
         }
         if (!deferred) {
-          fs50.rmdirSync(dir2);
+          fs51.rmdirSync(dir2);
         }
       } while (dirs.length !== 0);
     }
@@ -50171,7 +50173,7 @@ var require_tmp = __commonJS({
       var args = _parseArguments(options, callback), opts = args[0], cb = args[1];
       tmpName(opts, function _tmpNameCreated(err, name) {
         if (err) return cb(err);
-        fs50.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
+        fs51.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
           if (err2) return cb(err2);
           cb(null, name, _prepareTmpDirRemoveCallback(name, opts));
         });
@@ -50180,7 +50182,7 @@ var require_tmp = __commonJS({
     function dirSync(options) {
       var args = _parseArguments(options), opts = args[0];
       const name = tmpNameSync(opts);
-      fs50.mkdirSync(name, opts.mode || DIR_MODE);
+      fs51.mkdirSync(name, opts.mode || DIR_MODE);
       return {
         name,
         removeCallback: _prepareTmpDirRemoveCallback(name, opts)
@@ -50190,7 +50192,7 @@ var require_tmp = __commonJS({
       const removeCallback = _prepareRemoveCallback(function _removeCallback(fdPath) {
         try {
           if (0 <= fdPath[0]) {
-            fs50.closeSync(fdPath[0]);
+            fs51.closeSync(fdPath[0]);
           }
         } catch (e2) {
           if (!isEBADF(e2) && !isENOENT(e2)) {
@@ -50198,7 +50200,7 @@ var require_tmp = __commonJS({
           }
         }
         try {
-          fs50.unlinkSync(fdPath[1]);
+          fs51.unlinkSync(fdPath[1]);
         } catch (e2) {
           if (!isENOENT(e2)) {
             throw e2;
@@ -50211,7 +50213,7 @@ var require_tmp = __commonJS({
       return removeCallback;
     }
     function _prepareTmpDirRemoveCallback(name, opts) {
-      const removeFunction = opts.unsafeCleanup ? _rmdirRecursiveSync : fs50.rmdirSync.bind(fs50);
+      const removeFunction = opts.unsafeCleanup ? _rmdirRecursiveSync : fs51.rmdirSync.bind(fs51);
       const removeCallback = _prepareRemoveCallback(removeFunction, name);
       if (!opts.keep) {
         _removeObjects.unshift(removeCallback);
@@ -63344,8 +63346,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path63) {
-      let input = path63;
+    function removeDotSegments(path64) {
+      let input = path64;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -63597,8 +63599,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path63, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path63 && path63 !== "/" ? path63 : void 0;
+        const [path64, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path64 && path64 !== "/" ? path64 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -66991,12 +66993,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs50, exportName) {
+    function addFormats(ajv, list, fs51, exportName) {
       var _a3;
       var _b2;
       (_a3 = (_b2 = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b2.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f2 of list)
-        ajv.addFormat(f2, fs50[f2]);
+        ajv.addFormat(f2, fs51[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -68280,11 +68282,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: (path63) => {
+  require: (path64) => {
     if (typeof require !== "undefined") {
-      return require(path63);
-    } else if (path63.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path63, "utf8"));
+      return require(path64);
+    } else if (path64.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path64, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -72203,7 +72205,7 @@ function handleRemove(argv) {
 }
 
 // src/cli/commands/env.ts
-var path52 = __toESM(require("path"));
+var path53 = __toESM(require("path"));
 
 // src/cli/finish-command.ts
 init_sync_context();
@@ -72213,8 +72215,8 @@ async function finishCommand(code) {
 }
 
 // src/core/harness.ts
-var fs39 = __toESM(require("fs"));
-var path43 = __toESM(require("path"));
+var fs40 = __toESM(require("fs"));
+var path44 = __toESM(require("path"));
 
 // src/harness/generator.ts
 var fs28 = __toESM(require("fs"));
@@ -72291,15 +72293,6 @@ function pruneCliProfile(harnessDir) {
     }
   }
 }
-function scaffoldClaudeMd(repoPath, projectName, force) {
-  const templatePath = resolveTemplateFile("CLAUDE.md.template");
-  if (!templatePath) return;
-  const dest = path34.join(repoPath, "CLAUDE.md");
-  if (fs28.existsSync(dest) && !force) return;
-  const displayName = projectName.replace(/_/g, " ");
-  const content = fs28.readFileSync(templatePath, "utf8").replace(/__PROJECT_DISPLAY_NAME__/g, displayName);
-  fs28.writeFileSync(dest, content);
-}
 function scaffoldHarnessBoilerplate(repoPath, options = {}) {
   const harnessDir = path34.join(repoPath, DEFAULT_HAR_DIR);
   const projectName = path34.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
@@ -72335,7 +72328,6 @@ function scaffoldHarnessBoilerplate(repoPath, options = {}) {
     profile
   );
   writeManifest(repoPath, manifest);
-  scaffoldClaudeMd(repoPath, projectName, options.force ?? false);
   ensureRootGitignorePatterns(repoPath);
   success(`Copied harness boilerplate to .har/ (profile: ${profile})`);
   info(`Project name: ${projectName}`);
@@ -72349,8 +72341,8 @@ function finalizeHarness(repoPath, adaptationSummary, stack) {
 }
 
 // src/llm/authoring-agent.ts
-var fs32 = __toESM(require("fs"));
-var path37 = __toESM(require("path"));
+var fs33 = __toESM(require("fs"));
+var path38 = __toESM(require("path"));
 
 // node_modules/@anthropic-ai/sdk/error.mjs
 var error_exports = {};
@@ -72749,13 +72741,13 @@ var MultipartBody = class {
 // node_modules/@anthropic-ai/sdk/_shims/node-runtime.mjs
 var import_web = require("node:stream/web");
 var fileFromPathWarned = false;
-async function fileFromPath3(path63, ...args) {
+async function fileFromPath3(path64, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path63)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path64)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path63, ...args);
+  return await _fileFromPath(path64, ...args);
 }
 var defaultHttpAgent = new import_agentkeepalive.default({ keepAlive: true, timeout: 5 * 60 * 1e3 });
 var defaultHttpsAgent = new import_agentkeepalive.default.HttpsAgent({ keepAlive: true, timeout: 5 * 60 * 1e3 });
@@ -73352,29 +73344,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path63, opts) {
-    return this.methodRequest("get", path63, opts);
+  get(path64, opts) {
+    return this.methodRequest("get", path64, opts);
   }
-  post(path63, opts) {
-    return this.methodRequest("post", path63, opts);
+  post(path64, opts) {
+    return this.methodRequest("post", path64, opts);
   }
-  patch(path63, opts) {
-    return this.methodRequest("patch", path63, opts);
+  patch(path64, opts) {
+    return this.methodRequest("patch", path64, opts);
   }
-  put(path63, opts) {
-    return this.methodRequest("put", path63, opts);
+  put(path64, opts) {
+    return this.methodRequest("put", path64, opts);
   }
-  delete(path63, opts) {
-    return this.methodRequest("delete", path63, opts);
+  delete(path64, opts) {
+    return this.methodRequest("delete", path64, opts);
   }
-  methodRequest(method, path63, opts) {
+  methodRequest(method, path64, opts) {
     return this.request(Promise.resolve(opts).then(async (opts2) => {
       const body = opts2 && isBlobLike(opts2?.body) ? new DataView(await opts2.body.arrayBuffer()) : opts2?.body instanceof DataView ? opts2.body : opts2?.body instanceof ArrayBuffer ? new DataView(opts2.body) : opts2 && ArrayBuffer.isView(opts2?.body) ? new DataView(opts2.body.buffer) : opts2?.body;
-      return { method, path: path63, ...opts2, body };
+      return { method, path: path64, ...opts2, body };
     }));
   }
-  getAPIList(path63, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path63, ...opts });
+  getAPIList(path64, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path64, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -73392,10 +73384,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path63, query, headers = {} } = options;
+    const { method, path: path64, query, headers = {} } = options;
     const body = ArrayBuffer.isView(options.body) || options.__binaryRequest && typeof options.body === "string" ? options.body : isMultipartBody(options.body) ? options.body.body : options.body ? JSON.stringify(options.body, null, 2) : null;
     const contentLength = this.calculateContentLength(body);
-    const url = this.buildURL(path63, query);
+    const url = this.buildURL(path64, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -73504,8 +73496,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path63, query) {
-    const url = isAbsoluteURL(path63) ? new URL(path63) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path63.startsWith("/") ? path63.slice(1) : path63));
+  buildURL(path64, query) {
+    const url = isAbsoluteURL(path64) ? new URL(path64) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path64.startsWith("/") ? path64.slice(1) : path64));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -75328,64 +75320,368 @@ var { AnthropicError: AnthropicError2, APIError: APIError2, APIConnectionError:
 var sdk_default = Anthropic;
 
 // src/llm/tools.ts
+var fs32 = __toESM(require("fs"));
+var path37 = __toESM(require("path"));
+var readline4 = __toESM(require("readline"));
+init_file_ops();
+init_logging();
+
+// src/harness/agent-md.ts
 var fs31 = __toESM(require("fs"));
 var path36 = __toESM(require("path"));
 var readline3 = __toESM(require("readline"));
 init_file_ops();
 init_logging();
+init_manifest();
 
-// src/harness/agent-md.ts
+// src/harness/instruction-files.ts
 var fs30 = __toESM(require("fs"));
+var os13 = __toESM(require("os"));
 var path35 = __toESM(require("path"));
 var readline2 = __toESM(require("readline"));
 init_file_ops();
 init_logging();
-init_manifest();
+var AGENTS_MD = "AGENTS.md";
+var LEGACY_AGENT_MD = "AGENT.md";
+var CLAUDE_MD = "CLAUDE.md";
+var HAR_SECTION_START = "<!-- har:agent-environment:start -->";
+var HAR_SECTION_END = "<!-- har:agent-environment:end -->";
+var CLAUDE_HAR_SECTION_START = "<!-- har:claude-pointer:start -->";
+var CLAUDE_HAR_SECTION_END = "<!-- har:claude-pointer:end -->";
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function detectInstructionFiles(repoPath) {
+  return {
+    agentsMd: fs30.existsSync(path35.join(repoPath, AGENTS_MD)),
+    agentMd: fs30.existsSync(path35.join(repoPath, LEGACY_AGENT_MD)),
+    claudeMd: fs30.existsSync(path35.join(repoPath, CLAUDE_MD)),
+    cursorDir: fs30.existsSync(path35.join(repoPath, ".cursor")),
+    claudeDir: fs30.existsSync(path35.join(repoPath, ".claude")),
+    codexHome: fs30.existsSync(path35.join(os13.homedir(), ".codex"))
+  };
+}
+function formatDetectionReport(detection) {
+  const lines2 = ["Detected:"];
+  lines2.push(`  - ${AGENTS_MD} (${detection.agentsMd ? "exists" : "missing"})`);
+  if (detection.agentMd) {
+    lines2.push(`  - ${LEGACY_AGENT_MD} (legacy \u2014 will migrate into ${AGENTS_MD})`);
+  }
+  lines2.push(`  - ${CLAUDE_MD} (${detection.claudeMd ? "exists" : "missing"})`);
+  lines2.push(`  - .cursor/ (${detection.cursorDir ? "exists" : "missing"})`);
+  lines2.push(`  - .claude/ (${detection.claudeDir ? "exists" : "missing"})`);
+  lines2.push(`  - ~/.codex (${detection.codexHome ? "exists" : "missing"})`);
+  return lines2.join("\n");
+}
+function buildInstallPlan(detection, targets, options = {}) {
+  const writeAgentsMd = options.writeAgentsMd !== false;
+  const skillsEnabled = options.skillsEnabled !== false;
+  const cursorExplicit = options.cursorRule;
+  const wantsCursor = cursorExplicit === true || cursorExplicit !== false && (targets.includes("cursor") || detection.cursorDir);
+  return {
+    agentsMd: writeAgentsMd,
+    migrateLegacyAgentMd: writeAgentsMd && detection.agentMd,
+    claudeMd: skillsEnabled && targets.includes("claude"),
+    cursorRule: wantsCursor,
+    skills: skillsEnabled ? targets : []
+  };
+}
+function formatInstallPlan(plan, detection) {
+  const mark = (on) => on ? "[x]" : "[ ]";
+  const lines2 = ["After you confirm, HAR will:"];
+  const agentsAction = detection.agentsMd ? `Update ${AGENTS_MD} \u2014 refresh HAR / agent environment section` : `Create ${AGENTS_MD} \u2014 shared HAR workflow (Codex + cross-tool)`;
+  lines2.push(`  ${mark(plan.agentsMd)} ${agentsAction}`);
+  if (plan.migrateLegacyAgentMd) {
+    lines2.push(`  ${mark(true)} Migrate ${LEGACY_AGENT_MD} \u2192 ${AGENTS_MD}, then remove legacy file`);
+  }
+  lines2.push(
+    `  ${mark(plan.claudeMd)} Claude \u2014 ensure ${CLAUDE_MD} points at ${AGENTS_MD}; install .claude/skills if confirmed`
+  );
+  lines2.push(
+    `  ${mark(plan.cursorRule)} Cursor \u2014 install/refresh .cursor/rules/har-workflow.mdc + commands if confirmed`
+  );
+  lines2.push(
+    `  ${mark(plan.skills.includes("codex"))} Codex \u2014 global ~/.codex/prompts (skills); project contract is ${AGENTS_MD}`
+  );
+  return lines2.join("\n");
+}
+function loadHarAgentsSectionFromTemplate() {
+  const templatePath = resolveTemplateFile("AGENTS.md.template");
+  if (!templatePath) {
+    throw new Error("AGENTS.md.template not found. Run npm run build.");
+  }
+  const content = fs30.readFileSync(templatePath, "utf8");
+  const start = content.indexOf(HAR_SECTION_START);
+  const end = content.indexOf(HAR_SECTION_END);
+  if (start === -1 || end === -1 || end < start) {
+    throw new Error("AGENTS.md.template is missing har:agent-environment markers.");
+  }
+  return content.slice(start, end + HAR_SECTION_END.length);
+}
+function loadAgentsMdTemplate() {
+  const templatePath = resolveTemplateFile("AGENTS.md.template");
+  if (!templatePath) {
+    throw new Error("AGENTS.md.template not found. Run npm run build.");
+  }
+  return fs30.readFileSync(templatePath, "utf8");
+}
+function upsertMarkedBlock(content, block, startMarker, endMarker) {
+  if (content.includes(startMarker)) {
+    const pattern = new RegExp(
+      `${escapeRegExp(startMarker)}[\\s\\S]*?${escapeRegExp(endMarker)}`
+    );
+    return { content: content.replace(pattern, block), action: "updated" };
+  }
+  const suffix = content.endsWith("\n") ? "" : "\n";
+  return { content: `${content}${suffix}
+${block}
+`, action: "appended" };
+}
+function upsertAgentsMdHarSection(repoPath) {
+  const dest = path35.join(repoPath, AGENTS_MD);
+  const section = loadHarAgentsSectionFromTemplate();
+  if (!fs30.existsSync(dest)) {
+    writeFileSafe(dest, loadAgentsMdTemplate());
+    return "created";
+  }
+  const existing = fs30.readFileSync(dest, "utf8");
+  const { content, action } = upsertMarkedBlock(
+    existing,
+    section,
+    HAR_SECTION_START,
+    HAR_SECTION_END
+  );
+  writeFileSafe(dest, content);
+  return action;
+}
+function migrateLegacyAgentMd(repoPath) {
+  const legacyPath = path35.join(repoPath, LEGACY_AGENT_MD);
+  const agentsPath = path35.join(repoPath, AGENTS_MD);
+  if (!fs30.existsSync(legacyPath)) return false;
+  const legacy = fs30.readFileSync(legacyPath, "utf8");
+  if (!fs30.existsSync(agentsPath)) {
+    writeFileSafe(agentsPath, legacy);
+    upsertAgentsMdHarSection(repoPath);
+  } else {
+    upsertAgentsMdHarSection(repoPath);
+  }
+  fs30.unlinkSync(legacyPath);
+  info(`Migrated ${LEGACY_AGENT_MD} \u2192 ${AGENTS_MD} (removed legacy file)`);
+  return true;
+}
+function loadClaudeMdTemplate(projectName) {
+  const templatePath = resolveTemplateFile("CLAUDE.md.template");
+  if (!templatePath) {
+    throw new Error("CLAUDE.md.template not found. Run npm run build.");
+  }
+  const displayName = projectName.replace(/_/g, " ");
+  return fs30.readFileSync(templatePath, "utf8").replace(/__PROJECT_DISPLAY_NAME__/g, displayName);
+}
+function isThinClaudePointer(content) {
+  const trimmed = content.trim();
+  if (trimmed.length > 600) return false;
+  return /AGENTS\.md|AGENT\.md/.test(trimmed) && (trimmed.includes(".har/README.md") || trimmed.includes("har-workflow"));
+}
+var CLAUDE_POINTER_BLOCK = `${CLAUDE_HAR_SECTION_START}
+## HAR
+
+This repository uses a \`.har/\` harness. Read [AGENTS.md](./AGENTS.md) and
+[\`.har/README.md\`](./.har/README.md) before making changes.
+${CLAUDE_HAR_SECTION_END}`;
+function ensureClaudeMdPointer(repoPath, options = {}) {
+  const dest = path35.join(repoPath, CLAUDE_MD);
+  const projectName = path35.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
+  const thin = loadClaudeMdTemplate(projectName);
+  if (!fs30.existsSync(dest)) {
+    writeFileSafe(dest, thin);
+    return "created";
+  }
+  const existing = fs30.readFileSync(dest, "utf8");
+  if (isThinClaudePointer(existing) || options.force) {
+    writeFileSafe(dest, thin);
+    return "updated";
+  }
+  if (existing.includes(CLAUDE_HAR_SECTION_START) || /\[AGENTS\.md\]/.test(existing)) {
+    if (existing.includes(CLAUDE_HAR_SECTION_START)) {
+      const { content: content2, action: action2 } = upsertMarkedBlock(
+        existing,
+        CLAUDE_POINTER_BLOCK,
+        CLAUDE_HAR_SECTION_START,
+        CLAUDE_HAR_SECTION_END
+      );
+      writeFileSafe(dest, content2);
+      return action2;
+    }
+    return "skipped";
+  }
+  const { content, action } = upsertMarkedBlock(
+    existing,
+    CLAUDE_POINTER_BLOCK,
+    CLAUDE_HAR_SECTION_START,
+    CLAUDE_HAR_SECTION_END
+  );
+  writeFileSafe(dest, content);
+  return action;
+}
+async function askYesNo2(question, defaultYes = true) {
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve47) => {
+    process.stderr.write(`${question} `);
+    rl.once("line", (answer) => {
+      rl.close();
+      const trimmed = answer.trim();
+      if (trimmed === "") {
+        resolve47(defaultYes);
+        return;
+      }
+      resolve47(/^y(es)?$/i.test(trimmed));
+    });
+  });
+}
+async function handleInstructionFiles(options) {
+  const { repoPath, mode } = options;
+  const writeAgentsMd = options.writeAgentsMd !== false;
+  const skillsEnabled = options.enabled !== false;
+  const detection = detectInstructionFiles(repoPath);
+  let targets;
+  if (!skillsEnabled) {
+    targets = [];
+  } else if (typeof options.agents === "string") {
+    targets = parseAgentTargets(options.agents);
+  } else {
+    targets = detectAgentTargets(repoPath);
+  }
+  if (skillsEnabled && targets.length === 0 && mode === "init" && typeof options.agents !== "string" && !options.autoYes) {
+    targets = [...AGENT_SKILL_TARGETS];
+  }
+  let plan = buildInstallPlan(detection, targets, {
+    writeAgentsMd,
+    cursorRule: options.cursorRule,
+    skillsEnabled
+  });
+  divider();
+  process.stderr.write(`${formatDetectionReport(detection)}
+
+`);
+  process.stderr.write(`${formatInstallPlan(plan, detection)}
+`);
+  divider();
+  const shouldPrompt = !options.autoYes && skillsEnabled && typeof options.agents !== "string" && !(mode === "maintain" && targets.length > 0 && !detection.agentMd);
+  if (shouldPrompt && targets.length > 0) {
+    const accepted = await askYesNo2(
+      `Install HAR agent instructions for: ${targets.join(", ")}? [Y/n]`
+    );
+    if (!accepted) {
+      info("Skipped agent instruction adapters (AGENTS.md will still be updated)");
+      targets = [];
+      plan = buildInstallPlan(detection, targets, {
+        writeAgentsMd,
+        cursorRule: options.cursorRule === true ? true : false,
+        skillsEnabled: false
+      });
+    }
+  }
+  let migratedLegacy = false;
+  let agentsMdAction = null;
+  let claudeMdAction = null;
+  if (writeAgentsMd) {
+    if (detection.agentMd) {
+      migratedLegacy = migrateLegacyAgentMd(repoPath);
+    }
+    agentsMdAction = upsertAgentsMdHarSection(repoPath);
+    if (agentsMdAction === "created") {
+      success(`Wrote ${AGENTS_MD}`);
+    } else if (agentsMdAction === "updated" || agentsMdAction === "appended") {
+      info(
+        `${agentsMdAction === "updated" ? "Refreshed" : "Appended"} HAR section in ${AGENTS_MD}`
+      );
+    }
+  } else {
+    agentsMdAction = "skipped";
+  }
+  if (plan.claudeMd) {
+    claudeMdAction = ensureClaudeMdPointer(repoPath);
+    if (claudeMdAction === "created") {
+      success(`Wrote ${CLAUDE_MD} (pointer \u2192 ${AGENTS_MD})`);
+    } else if (claudeMdAction === "updated" || claudeMdAction === "appended") {
+      info(
+        `${claudeMdAction === "updated" ? "Updated" : "Appended"} ${CLAUDE_MD} pointer \u2192 ${AGENTS_MD}`
+      );
+    }
+  } else {
+    claudeMdAction = "skipped";
+  }
+  return {
+    detection,
+    plan,
+    targets,
+    agentsMdAction,
+    migratedLegacy,
+    claudeMdAction
+  };
+}
+
+// src/harness/agent-md.ts
+var AGENTS_MD_PROPOSAL = "AGENTS.md.proposed";
+var AGENTS_MD_PROPOSAL_META = "AGENTS.md.proposed.meta.json";
 var AGENT_MD_PROPOSAL = "AGENT.md.proposed";
 var AGENT_MD_PROPOSAL_META = "AGENT.md.proposed.meta.json";
 function writeAgentMdProposal(repoPath, content, rationale) {
   const harnessDir = getHarnessDir(repoPath);
-  writeFileSafe(path35.join(harnessDir, AGENT_MD_PROPOSAL), content);
+  writeFileSafe(path36.join(harnessDir, AGENTS_MD_PROPOSAL), content);
   writeFileSafe(
-    path35.join(harnessDir, AGENT_MD_PROPOSAL_META),
+    path36.join(harnessDir, AGENTS_MD_PROPOSAL_META),
     JSON.stringify({ rationale, createdAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2) + "\n"
   );
+  for (const file of [AGENT_MD_PROPOSAL, AGENT_MD_PROPOSAL_META]) {
+    const p2 = path36.join(harnessDir, file);
+    if (fs31.existsSync(p2)) fs31.unlinkSync(p2);
+  }
 }
 function readAgentMdProposal(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
-  const proposalPath = path35.join(harnessDir, AGENT_MD_PROPOSAL);
-  const metaPath = path35.join(harnessDir, AGENT_MD_PROPOSAL_META);
-  if (!fs30.existsSync(proposalPath)) return null;
-  const content = fs30.readFileSync(proposalPath, "utf8");
+  const proposalPath = path36.join(harnessDir, AGENTS_MD_PROPOSAL);
+  const metaPath = path36.join(harnessDir, AGENTS_MD_PROPOSAL_META);
+  const legacyProposalPath = path36.join(harnessDir, AGENT_MD_PROPOSAL);
+  const legacyMetaPath = path36.join(harnessDir, AGENT_MD_PROPOSAL_META);
+  const resolvedProposal = fs31.existsSync(proposalPath) ? proposalPath : fs31.existsSync(legacyProposalPath) ? legacyProposalPath : null;
+  if (!resolvedProposal) return null;
+  const resolvedMeta = resolvedProposal === proposalPath ? metaPath : legacyMetaPath;
+  const content = fs31.readFileSync(resolvedProposal, "utf8");
   let rationale = "";
-  if (fs30.existsSync(metaPath)) {
+  let createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  if (fs31.existsSync(resolvedMeta)) {
     try {
-      rationale = JSON.parse(fs30.readFileSync(metaPath, "utf8")).rationale ?? "";
+      const meta = JSON.parse(fs31.readFileSync(resolvedMeta, "utf8"));
+      rationale = meta.rationale ?? "";
+      createdAt = meta.createdAt ?? createdAt;
     } catch {
       rationale = "";
     }
   }
-  return {
-    content,
-    rationale,
-    createdAt: fs30.existsSync(metaPath) ? JSON.parse(fs30.readFileSync(metaPath, "utf8")).createdAt : (/* @__PURE__ */ new Date()).toISOString()
-  };
+  return { content, rationale, createdAt };
 }
 function clearAgentMdProposal(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
-  for (const file of [AGENT_MD_PROPOSAL, AGENT_MD_PROPOSAL_META]) {
-    const p2 = path35.join(harnessDir, file);
-    if (fs30.existsSync(p2)) fs30.unlinkSync(p2);
+  for (const file of [
+    AGENTS_MD_PROPOSAL,
+    AGENTS_MD_PROPOSAL_META,
+    AGENT_MD_PROPOSAL,
+    AGENT_MD_PROPOSAL_META
+  ]) {
+    const p2 = path36.join(harnessDir, file);
+    if (fs31.existsSync(p2)) fs31.unlinkSync(p2);
   }
 }
 async function promptApplyAgentMdProposal(repoPath) {
   const proposal = readAgentMdProposal(repoPath);
   if (!proposal) return false;
-  const agentMdPath = path35.join(repoPath, "AGENT.md");
-  const exists = fs30.existsSync(agentMdPath);
+  const agentsMdPath = path36.join(repoPath, AGENTS_MD);
+  const exists = fs31.existsSync(agentsMdPath);
   process.stderr.write("\n");
   process.stderr.write("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
-  process.stderr.write("Proposed AGENT.md (repo root)\n");
+  process.stderr.write(`Proposed ${AGENTS_MD} (repo root)
+`);
   process.stderr.write("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
   if (proposal.rationale) {
     process.stderr.write(`Why: ${proposal.rationale}
@@ -75401,29 +75697,29 @@ async function promptApplyAgentMdProposal(repoPath) {
     process.stderr.write("  ...\n");
   }
   process.stderr.write("\n");
-  process.stderr.write(`Full proposal: .har/${AGENT_MD_PROPOSAL}
+  process.stderr.write(`Full proposal: .har/${AGENTS_MD_PROPOSAL}
 `);
   if (exists) {
-    warn("AGENT.md already exists at repo root.");
-    const answer = await askYesNo2("Replace AGENT.md with this proposal? (y/n)");
+    warn(`${AGENTS_MD} already exists at repo root.`);
+    const answer = await askYesNo3(`Replace ${AGENTS_MD} with this proposal? (y/n)`);
     if (!answer) {
-      info("Skipped \u2014 proposal kept at .har/AGENT.md.proposed");
+      info(`Skipped \u2014 proposal kept at .har/${AGENTS_MD_PROPOSAL}`);
       return false;
     }
   } else {
-    const answer = await askYesNo2("Create AGENT.md at repo root? (y/n)");
+    const answer = await askYesNo3(`Create ${AGENTS_MD} at repo root? (y/n)`);
     if (!answer) {
-      info("Skipped \u2014 proposal kept at .har/AGENT.md.proposed");
+      info(`Skipped \u2014 proposal kept at .har/${AGENTS_MD_PROPOSAL}`);
       return false;
     }
   }
-  writeFileSafe(agentMdPath, proposal.content);
+  writeFileSafe(agentsMdPath, proposal.content);
   clearAgentMdProposal(repoPath);
-  info("Wrote AGENT.md");
+  info(`Wrote ${AGENTS_MD}`);
   return true;
 }
-async function askYesNo2(question) {
-  const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
+async function askYesNo3(question) {
+  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve47) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
@@ -75520,12 +75816,12 @@ function buildAuthoringTools() {
       }
     },
     {
-      name: "proposeAgentMd",
-      description: "Propose content for AGENT.md at the repo root. Does NOT write the file \u2014 the user approves after init/maintain. Include project-specific notes and pointer to .har/.",
+      name: "proposeAgentsMd",
+      description: "Propose content for AGENTS.md at the repo root. Does NOT write the file \u2014 the user approves after init/maintain. Include project-specific notes and pointer to .har/.",
       input_schema: {
         type: "object",
         properties: {
-          content: { type: "string", description: "Full proposed AGENT.md content" },
+          content: { type: "string", description: "Full proposed AGENTS.md content" },
           rationale: { type: "string", description: "Why these changes (shown to user)" }
         },
         required: ["content", "rationale"]
@@ -75570,13 +75866,13 @@ async function handleAuthoringToolCall(toolName, input, repoPath, harnessDir, ca
 async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, callbacks) {
   switch (toolName) {
     case "readRepoFile": {
-      const filePath = path36.join(repoPath, input.path);
+      const filePath = path37.join(repoPath, input.path);
       const content = readFile(filePath, input.maxChars ?? 8e3);
       info(`Read repo: ${input.path}`);
       return content;
     }
     case "listRepoDir": {
-      const dirPath = path36.join(repoPath, input.path ?? ".");
+      const dirPath = path37.join(repoPath, input.path ?? ".");
       const entries = listDir(dirPath, input.maxFiles ?? 60);
       info(`List repo: ${input.path} \u2192 ${entries.length} entries`);
       return entries.length > 0 ? entries.join("\n") : "(empty directory)";
@@ -75601,17 +75897,17 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
       const filePath = resolveSafePath(harnessDir, relPath);
       writeFileSafe(filePath, input.content);
       if (relPath.endsWith(".sh")) {
-        fs31.chmodSync(filePath, 493);
+        fs32.chmodSync(filePath, 493);
       }
       info(`Wrote harness: ${relPath}`);
       return `Written ${relPath} (${input.content.length} bytes)`;
     }
     case "editHarnessFile": {
       const filePath = resolveSafePath(harnessDir, input.path);
-      if (!fs31.existsSync(filePath)) {
+      if (!fs32.existsSync(filePath)) {
         return `Error: file not found: ${input.path}`;
       }
-      const content = fs31.readFileSync(filePath, "utf8");
+      const content = fs32.readFileSync(filePath, "utf8");
       const oldStr = input.old_string;
       const newStr = input.new_string;
       const count = content.split(oldStr).length - 1;
@@ -75628,17 +75924,17 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
     }
     case "deleteHarnessFile": {
       const filePath = resolveSafePath(harnessDir, input.path);
-      if (!fs31.existsSync(filePath)) {
+      if (!fs32.existsSync(filePath)) {
         return `File not found (already deleted): ${input.path}`;
       }
-      fs31.unlinkSync(filePath);
+      fs32.unlinkSync(filePath);
       info(`Deleted harness: ${input.path}`);
       return `Deleted ${input.path}`;
     }
-    case "proposeAgentMd": {
+    case "proposeAgentsMd": {
       writeAgentMdProposal(repoPath, input.content, input.rationale);
-      info("Proposed AGENT.md (awaiting user approval)");
-      return "AGENT.md proposal saved to .har/AGENT.md.proposed \u2014 user will be prompted to apply.";
+      info("Proposed AGENTS.md (awaiting user approval)");
+      return "AGENTS.md proposal saved to .har/AGENTS.md.proposed \u2014 user will be prompted to apply.";
     }
     case "ask": {
       return askUser(input.question, input.options ?? []);
@@ -75657,7 +75953,7 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
   }
 }
 async function askUser(question, options) {
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve47) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
@@ -75683,30 +75979,30 @@ async function authorHarness(repoPath, apiKey, options = {}) {
   const harnessDir = getHarnessDir(repoPath);
   const mode = options.mode ?? "init";
   const systemPromptPath = resolvePromptPath("system-authoring.md");
-  const agentMdTemplatePath = resolveTemplateFile("AGENT.md.template");
-  let systemPrompt = fs32.existsSync(systemPromptPath) ? fs32.readFileSync(systemPromptPath, "utf8") : "Adapt the .har/ boilerplate to match the repository. Edit files directly. Call finishAuthoring when done.";
+  const agentMdTemplatePath = resolveTemplateFile("AGENTS.md.template");
+  let systemPrompt = fs33.existsSync(systemPromptPath) ? fs33.readFileSync(systemPromptPath, "utf8") : "Adapt the .har/ boilerplate to match the repository. Edit files directly. Call finishAuthoring when done.";
   if (agentMdTemplatePath) {
     systemPrompt += `
 
-## AGENT.md template (starting point for proposeAgentMd)
+## AGENTS.md template (starting point for proposeAgentsMd)
 
-${fs32.readFileSync(agentMdTemplatePath, "utf8")}`;
+${fs33.readFileSync(agentMdTemplatePath, "utf8")}`;
   }
   const tools = buildAuthoringTools();
   const messages = [];
   let rootListing;
   try {
-    rootListing = fs32.readdirSync(repoPath).slice(0, 50).join("\n");
+    rootListing = fs33.readdirSync(repoPath).slice(0, 50).join("\n");
   } catch {
     throw new Error(`Cannot read repo at path: ${repoPath}`);
   }
   let harnessListing;
   try {
-    harnessListing = fs32.readdirSync(harnessDir).join("\n");
+    harnessListing = fs33.readdirSync(harnessDir).join("\n");
   } catch {
     throw new Error(`Cannot read harness dir at: ${harnessDir}`);
   }
-  const existingAgentMd = fs32.existsSync(path37.join(repoPath, "AGENT.md")) ? "AGENT.md exists at repo root \u2014 read it before proposing changes via proposeAgentMd." : "No AGENT.md at repo root yet \u2014 propose one via proposeAgentMd.";
+  const existingAgentMd = fs33.existsSync(path38.join(repoPath, "AGENTS.md")) ? "AGENTS.md exists at repo root \u2014 read it before proposing changes via proposeAgentsMd." : "No AGENTS.md at repo root yet \u2014 propose one via proposeAgentsMd.";
   const modeInstructions = mode === "maintain" ? `This is a MAINTENANCE run. .har/ already exists and may have been edited by humans.
 Update it to reflect current repo changes. Prefer editHarnessFile over writeHarnessFile.
 Keep README.md accurate \u2014 it is the index of the harness. ${existingAgentMd}` : `This is an INITIAL setup. A fresh boilerplate has been copied to .har/.
@@ -75786,8 +76082,8 @@ Try running with --verbose to see what the agent is doing.`
 }
 
 // src/harness/validator.ts
-var fs33 = __toESM(require("fs"));
-var path38 = __toESM(require("path"));
+var fs34 = __toESM(require("fs"));
+var path39 = __toESM(require("path"));
 init_shell();
 init_manifest();
 init_stages();
@@ -75842,22 +76138,22 @@ var SHELL_SCRIPTS = [
 function validateHarness(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
   const issues = [];
-  if (!fs33.existsSync(harnessDir)) {
+  if (!fs34.existsSync(harnessDir)) {
     return {
       pass: false,
       issues: [{ file: ".har", message: "Harness directory not found", severity: "error" }]
     };
   }
   for (const file of getRequiredFiles(repoPath)) {
-    const filePath = path38.join(harnessDir, file);
-    if (!fs33.existsSync(filePath)) {
+    const filePath = path39.join(harnessDir, file);
+    if (!fs34.existsSync(filePath)) {
       issues.push({ file, message: "Required file missing", severity: "error" });
     }
   }
   for (const script of SHELL_SCRIPTS) {
-    const scriptPath = path38.join(harnessDir, script);
-    if (!fs33.existsSync(scriptPath)) continue;
-    const stat = fs33.statSync(scriptPath);
+    const scriptPath = path39.join(harnessDir, script);
+    if (!fs34.existsSync(scriptPath)) continue;
+    const stat = fs34.statSync(scriptPath);
     if (!(stat.mode & 73)) {
       issues.push({ file: script, message: "Script is not executable", severity: "warning" });
     }
@@ -75872,9 +76168,9 @@ function validateHarness(repoPath) {
   }
   const manifest = readManifest(repoPath);
   const profile = manifest?.profile ?? "default";
-  const ecosystemPath = path38.join(harnessDir, "ecosystem.agent.template.cjs");
-  if (profile !== "cli" && fs33.existsSync(ecosystemPath)) {
-    const content = fs33.readFileSync(ecosystemPath, "utf8");
+  const ecosystemPath = path39.join(harnessDir, "ecosystem.agent.template.cjs");
+  if (profile !== "cli" && fs34.existsSync(ecosystemPath)) {
+    const content = fs34.readFileSync(ecosystemPath, "utf8");
     if (!content.includes("module.exports")) {
       issues.push({
         file: "ecosystem.agent.template.cjs",
@@ -75883,9 +76179,9 @@ function validateHarness(repoPath) {
       });
     }
   }
-  const harnessEnvPath = path38.join(harnessDir, "harness.env");
-  if (fs33.existsSync(harnessEnvPath)) {
-    const content = fs33.readFileSync(harnessEnvPath, "utf8");
+  const harnessEnvPath = path39.join(harnessDir, "harness.env");
+  if (fs34.existsSync(harnessEnvPath)) {
+    const content = fs34.readFileSync(harnessEnvPath, "utf8");
     if (content.includes("TODO: set migrate command")) {
       issues.push({ file: "harness.env", message: "Migrate command still has TODO", severity: "warning" });
     }
@@ -75893,17 +76189,17 @@ function validateHarness(repoPath) {
       issues.push({ file: "harness.env", message: "Seed command still has TODO", severity: "warning" });
     }
   }
-  const verifyPath = path38.join(harnessDir, "verify.sh");
-  if (fs33.existsSync(verifyPath)) {
-    const content = fs33.readFileSync(verifyPath, "utf8");
+  const verifyPath = path39.join(harnessDir, "verify.sh");
+  if (fs34.existsSync(verifyPath)) {
+    const content = fs34.readFileSync(verifyPath, "utf8");
     if (content.includes("echo 'TODO:")) {
       issues.push({ file: "verify.sh", message: "Verification steps still have TODO placeholders", severity: "warning" });
     }
   }
-  const stagesPath = path38.join(harnessDir, "stages.json");
-  if (fs33.existsSync(stagesPath)) {
+  const stagesPath = path39.join(harnessDir, "stages.json");
+  if (fs34.existsSync(stagesPath)) {
     try {
-      JSON.parse(fs33.readFileSync(stagesPath, "utf8"));
+      JSON.parse(fs34.readFileSync(stagesPath, "utf8"));
       const registry2 = readStageRegistry(repoPath);
       if (registry2.stages.length === 0) {
         issues.push({ file: "stages.json", message: "No harness stages declared", severity: "warning" });
@@ -75918,9 +76214,9 @@ function validateHarness(repoPath) {
   } else {
     issues.push({ file: "stages.json", message: "Stage registry missing", severity: "warning" });
   }
-  const readmePath = path38.join(harnessDir, "README.md");
-  if (fs33.existsSync(readmePath)) {
-    const content = fs33.readFileSync(readmePath, "utf8");
+  const readmePath = path39.join(harnessDir, "README.md");
+  if (fs34.existsSync(readmePath)) {
+    const content = fs34.readFileSync(readmePath, "utf8");
     if (!content.includes(".har")) {
       issues.push({ file: "README.md", message: "README should document .har/ paths", severity: "warning" });
     }
@@ -75934,8 +76230,8 @@ function validateHarness(repoPath) {
 async function smokeTestHarness(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
   const issues = [];
-  const setupScript = path38.join(harnessDir, "setup-infra.sh");
-  if (fs33.existsSync(setupScript)) {
+  const setupScript = path39.join(harnessDir, "setup-infra.sh");
+  if (fs34.existsSync(setupScript)) {
     const result = run(`bash "${setupScript}"`, { cwd: repoPath });
     if (result.code !== 0) {
       issues.push({
@@ -75950,8 +76246,8 @@ async function smokeTestHarness(repoPath) {
 }
 
 // src/harness/drift.ts
-var fs34 = __toESM(require("fs"));
-var path39 = __toESM(require("path"));
+var fs35 = __toESM(require("fs"));
+var path40 = __toESM(require("path"));
 init_env();
 init_manifest();
 init_stages();
@@ -76022,16 +76318,16 @@ function substituteProjectName(content, projectName) {
   return content.replace(/__PROJECT_NAME__/g, projectName).replace(/template___PROJECT_NAME__/g, `template_${projectName}`);
 }
 function listBoilerplateFiles(boilerplateDir) {
-  if (!fs34.existsSync(boilerplateDir)) return [];
-  return fs34.readdirSync(boilerplateDir, { withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
+  if (!fs35.existsSync(boilerplateDir)) return [];
+  return fs35.readdirSync(boilerplateDir, { withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
 }
 function compareHarnessToTemplate(repoPath) {
-  const resolved = path39.resolve(repoPath);
+  const resolved = path40.resolve(repoPath);
   const manifest = readManifest(resolved);
   const profile = manifest?.profile ?? "default";
   const harnessDir = getHarnessDir(resolved);
-  const projectName = path39.basename(resolved).toLowerCase().replace(/[^a-z0-9]/g, "_");
-  const boilerplateDir = path39.join(resolveTemplatesDir(), PROFILE_DIRS2[profile]);
+  const projectName = path40.basename(resolved).toLowerCase().replace(/[^a-z0-9]/g, "_");
+  const boilerplateDir = path40.join(resolveTemplatesDir(), PROFILE_DIRS2[profile]);
   const templateFiles = listBoilerplateFiles(boilerplateDir);
   const missing = [];
   const checksumMismatch = [];
@@ -76039,17 +76335,17 @@ function compareHarnessToTemplate(repoPath) {
   const unchanged = [];
   for (const file of templateFiles) {
     const harnessFile = harnessFileForTemplate(file);
-    const templatePath = path39.join(boilerplateDir, file);
-    const harnessPath = path39.join(harnessDir, harnessFile);
-    let templateContent = fs34.readFileSync(templatePath, "utf8");
+    const templatePath = path40.join(boilerplateDir, file);
+    const harnessPath = path40.join(harnessDir, harnessFile);
+    let templateContent = fs35.readFileSync(templatePath, "utf8");
     if (file === "harness.env") {
       templateContent = substituteProjectName(templateContent, projectName);
     }
-    if (!fs34.existsSync(harnessPath)) {
+    if (!fs35.existsSync(harnessPath)) {
       missing.push(harnessFile);
       continue;
     }
-    const harnessChecksum = computeFileChecksum(fs34.readFileSync(harnessPath, "utf8"));
+    const harnessChecksum = computeFileChecksum(fs35.readFileSync(harnessPath, "utf8"));
     const templateChecksum = computeFileChecksum(templateContent);
     if (harnessChecksum === templateChecksum) {
       unchanged.push(harnessFile);
@@ -76057,10 +76353,10 @@ function compareHarnessToTemplate(repoPath) {
       checksumMismatch.push(harnessFile);
     }
   }
-  if (fs34.existsSync(harnessDir)) {
-    for (const file of fs34.readdirSync(harnessDir)) {
-      const full = path39.join(harnessDir, file);
-      if (!fs34.statSync(full).isFile()) continue;
+  if (fs35.existsSync(harnessDir)) {
+    for (const file of fs35.readdirSync(harnessDir)) {
+      const full = path40.join(harnessDir, file);
+      if (!fs35.statSync(full).isFile()) continue;
       if (file === "manifest.json" || file.startsWith("ADAPT-PROMPT")) continue;
       if (profile === "cli" && CLI_EXPECTED_ABSENT.has(file)) {
         extra.push(file);
@@ -76091,29 +76387,29 @@ function compareHarnessToTemplate(repoPath) {
 }
 
 // src/harness/maintain-bundle.ts
-var fs38 = __toESM(require("fs"));
-var os13 = __toESM(require("os"));
-var path42 = __toESM(require("path"));
+var fs39 = __toESM(require("fs"));
+var os14 = __toESM(require("os"));
+var path43 = __toESM(require("path"));
 init_file_ops();
 init_shell();
 init_manifest();
 
 // src/harness/plugin-drift.ts
-var fs37 = __toESM(require("fs"));
-var path41 = __toESM(require("path"));
+var fs38 = __toESM(require("fs"));
+var path42 = __toESM(require("path"));
 init_manifest();
 
 // src/harness/plugins.ts
-var fs36 = __toESM(require("fs"));
-var path40 = __toESM(require("path"));
+var fs37 = __toESM(require("fs"));
+var path41 = __toESM(require("path"));
 init_zod();
 init_logging();
 
 // src/harness/parser.ts
-var fs35 = __toESM(require("fs"));
+var fs36 = __toESM(require("fs"));
 init_manifest();
 function harnessExists(repoPath) {
-  return fs35.existsSync(`${repoPath}/.har/setup-infra.sh`);
+  return fs36.existsSync(`${repoPath}/.har/setup-infra.sh`);
 }
 
 // src/harness/plugins.ts
@@ -76138,16 +76434,16 @@ var PluginManifestSchema = external_exports.object({
   docsPath: external_exports.string().min(1)
 });
 function resolvePluginDir(pluginId) {
-  const dir = path40.join(resolveTemplatesDir(), "plugins", pluginId);
-  if (!fs36.existsSync(dir)) {
+  const dir = path41.join(resolveTemplatesDir(), "plugins", pluginId);
+  if (!fs37.existsSync(dir)) {
     throw new Error(`Plugin not found: ${pluginId}. Run npm run build.`);
   }
   return dir;
 }
 function readPluginManifest(pluginId) {
-  const manifestPath = path40.join(resolvePluginDir(pluginId), "template.manifest.json");
+  const manifestPath = path41.join(resolvePluginDir(pluginId), "template.manifest.json");
   const parsed = PluginManifestSchema.safeParse(
-    JSON.parse(fs36.readFileSync(manifestPath, "utf8"))
+    JSON.parse(fs37.readFileSync(manifestPath, "utf8"))
   );
   if (!parsed.success) {
     throw new Error(`Invalid plugin manifest for ${pluginId}: ${parsed.error.message}`);
@@ -76158,40 +76454,40 @@ function readPluginManifest(pluginId) {
   return parsed.data;
 }
 function ensureParentDir(filePath) {
-  const parent = path40.dirname(filePath);
-  if (!fs36.existsSync(parent)) {
-    fs36.mkdirSync(parent, { recursive: true });
+  const parent = path41.dirname(filePath);
+  if (!fs37.existsSync(parent)) {
+    fs37.mkdirSync(parent, { recursive: true });
   }
 }
 function copyPluginFile(pluginDir, file, repoPath, force) {
-  const srcPath = path40.join(pluginDir, file.src);
-  const destPath = path40.join(repoPath, file.dest);
-  if (!fs36.existsSync(srcPath)) {
+  const srcPath = path41.join(pluginDir, file.src);
+  const destPath = path41.join(repoPath, file.dest);
+  if (!fs37.existsSync(srcPath)) {
     throw new Error(`Plugin file missing: ${file.src}`);
   }
-  if (fs36.existsSync(destPath) && !force) {
+  if (fs37.existsSync(destPath) && !force) {
     throw new Error(
       `File already exists: ${file.dest}. Use --force to overwrite or remove it first.`
     );
   }
   ensureParentDir(destPath);
-  fs36.copyFileSync(srcPath, destPath);
+  fs37.copyFileSync(srcPath, destPath);
   if (file.executable) {
-    fs36.chmodSync(destPath, 493);
+    fs37.chmodSync(destPath, 493);
   }
   return { written: true, path: file.dest };
 }
 function mergePackageJson(repoPath, pluginDir, fragmentRelPath, warnings) {
-  const packagePath = path40.join(repoPath, "package.json");
-  if (!fs36.existsSync(packagePath)) {
+  const packagePath = path41.join(repoPath, "package.json");
+  if (!fs37.existsSync(packagePath)) {
     throw new Error("No package.json in repo root. Add one before applying this plugin.");
   }
-  const fragmentPath = path40.join(pluginDir, fragmentRelPath);
-  if (!fs36.existsSync(fragmentPath)) {
+  const fragmentPath = path41.join(pluginDir, fragmentRelPath);
+  if (!fs37.existsSync(fragmentPath)) {
     throw new Error(`Package fragment missing: ${fragmentRelPath}`);
   }
-  const pkg = JSON.parse(fs36.readFileSync(packagePath, "utf8"));
-  const fragment = JSON.parse(fs36.readFileSync(fragmentPath, "utf8"));
+  const pkg = JSON.parse(fs37.readFileSync(packagePath, "utf8"));
+  const fragment = JSON.parse(fs37.readFileSync(fragmentPath, "utf8"));
   for (const section of ["scripts", "devDependencies"]) {
     const existing = pkg[section] ?? {};
     const incoming = fragment[section] ?? {};
@@ -76204,7 +76500,7 @@ function mergePackageJson(repoPath, pluginDir, fragmentRelPath, warnings) {
     }
     pkg[section] = existing;
   }
-  fs36.writeFileSync(packagePath, JSON.stringify(pkg, null, 2) + "\n");
+  fs37.writeFileSync(packagePath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function patchStageRegistry(repoPath, manifest, force) {
   const registry2 = readStageRegistry(repoPath);
@@ -76244,8 +76540,8 @@ function assertHarnessPresent(repoPath) {
 }
 function assertStageNotPresent(repoPath, stageId, force) {
   if (force) return;
-  const scriptPath = path40.join(repoPath, ".har", "stages", `${stageId}.sh`);
-  if (fs36.existsSync(scriptPath)) {
+  const scriptPath = path41.join(repoPath, ".har", "stages", `${stageId}.sh`);
+  if (fs37.existsSync(scriptPath)) {
     throw new Error(
       `Stage script already exists: .har/stages/${stageId}.sh. Use --force to overwrite.`
     );
@@ -76258,7 +76554,7 @@ function assertStageNotPresent(repoPath, stageId, force) {
   }
 }
 function applyPlugin(repoPath, pluginId, options = {}) {
-  const resolved = path40.resolve(repoPath);
+  const resolved = path41.resolve(repoPath);
   const force = options.force ?? false;
   const warnings = [];
   const filesWritten = [];
@@ -76277,7 +76573,7 @@ function applyPlugin(repoPath, pluginId, options = {}) {
       if (file.skipFlag === "skipCi" && options.skipCi) {
         continue;
       }
-      if (fs36.existsSync(path40.join(resolved, file.dest)) && !force) {
+      if (fs37.existsSync(path41.join(resolved, file.dest)) && !force) {
         warnings.push(`Skipped optional file (exists): ${file.dest}`);
         continue;
       }
@@ -76312,18 +76608,18 @@ function applyPlugin(repoPath, pluginId, options = {}) {
   };
 }
 function listPluginIds() {
-  const root = path40.join(resolveTemplatesDir(), "plugins");
-  if (!fs36.existsSync(root)) return [...PLUGIN_IDS];
-  return fs36.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => PLUGIN_IDS.includes(name));
+  const root = path41.join(resolveTemplatesDir(), "plugins");
+  if (!fs37.existsSync(root)) return [...PLUGIN_IDS];
+  return fs37.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => PLUGIN_IDS.includes(name));
 }
 
 // src/harness/plugin-drift.ts
 init_stages();
 var PACKAGE_SECTIONS = ["scripts", "devDependencies"];
 function detectInstalledPlugins(repoPath) {
-  const resolved = path41.resolve(repoPath);
-  const registryPath = path41.join(resolved, ".har", "stages.json");
-  if (!fs37.existsSync(registryPath)) return [];
+  const resolved = path42.resolve(repoPath);
+  const registryPath = path42.join(resolved, ".har", "stages.json");
+  if (!fs38.existsSync(registryPath)) return [];
   const registry2 = readStageRegistry(resolved);
   const stageIds = new Set(registry2.stages.map((stage) => stage.id));
   const installed = [];
@@ -76336,17 +76632,17 @@ function detectInstalledPlugins(repoPath) {
   return installed;
 }
 function pluginTemplatePath(pluginId, srcRel) {
-  return path41.join(resolveTemplatesDir(), "plugins", pluginId, srcRel);
+  return path42.join(resolveTemplatesDir(), "plugins", pluginId, srcRel);
 }
 function readBundledPluginFile(pluginId, srcRel) {
-  return fs37.readFileSync(pluginTemplatePath(pluginId, srcRel), "utf8");
+  return fs38.readFileSync(pluginTemplatePath(pluginId, srcRel), "utf8");
 }
 function listPluginDestPaths(pluginId, repoPath) {
   const manifest = readPluginManifest(pluginId);
   const paths = manifest.files.map((file) => file.dest);
   if (manifest.optionalFiles) {
     for (const file of manifest.optionalFiles) {
-      if (fs37.existsSync(path41.join(repoPath, file.dest))) {
+      if (fs38.existsSync(path42.join(repoPath, file.dest))) {
         paths.push(file.dest);
       }
     }
@@ -76405,9 +76701,9 @@ function readTemplatePluginFile(pluginId, dest) {
   return null;
 }
 function readInstalledPluginFile(repoPath, pluginId, dest) {
-  const installedPath = path41.join(path41.resolve(repoPath), dest);
-  if (!fs37.existsSync(installedPath)) return null;
-  const content = fs37.readFileSync(installedPath, "utf8");
+  const installedPath = path42.join(path42.resolve(repoPath), dest);
+  if (!fs38.existsSync(installedPath)) return null;
+  const content = fs38.readFileSync(installedPath, "utf8");
   const manifest = readPluginManifest(pluginId);
   const fragmentRel = manifest.merge?.[dest];
   if (fragmentRel) {
@@ -76426,7 +76722,7 @@ function pluginActionHint(pluginId, dest, kind2) {
 }
 function comparePluginToTemplate(repoPath, pluginId) {
   const manifest = readPluginManifest(pluginId);
-  const resolved = path41.resolve(repoPath);
+  const resolved = path42.resolve(repoPath);
   const destPaths = listPluginDestPaths(pluginId, resolved);
   const missing = [];
   const checksumMismatch = [];
@@ -76441,8 +76737,8 @@ function comparePluginToTemplate(repoPath, pluginId) {
     }
     if (dest === "package.json") {
       const fragmentRel = manifest.merge?.[dest];
-      const installedPath = path41.join(resolved, dest);
-      const installedRaw = fs37.readFileSync(installedPath, "utf8");
+      const installedPath = path42.join(resolved, dest);
+      const installedRaw = fs38.readFileSync(installedPath, "utf8");
       if (fragmentRel && pluginKeysMatch(installedRaw, readBundledPluginFile(pluginId, fragmentRel))) {
         unchanged.push(dest);
       } else if (computeFileChecksum(installedContent) === computeFileChecksum(templateContent)) {
@@ -76511,14 +76807,14 @@ function substituteProjectName2(content, projectName) {
   return content.replace(/__PROJECT_NAME__/g, projectName).replace(/template___PROJECT_NAME__/g, `template_${projectName}`);
 }
 function projectNameFromRepo(repoPath) {
-  return path42.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
+  return path43.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
 }
 function boilerplateDirForProfile(profile) {
-  return path42.join(resolveTemplatesDir(), PROFILE_DIRS3[profile]);
+  return path43.join(resolveTemplatesDir(), PROFILE_DIRS3[profile]);
 }
 function readBundledTemplateContent(repoPath, profile, file) {
-  const templatePath = path42.join(boilerplateDirForProfile(profile), templateFileForHarness(file));
-  let content = fs38.readFileSync(templatePath, "utf8");
+  const templatePath = path43.join(boilerplateDirForProfile(profile), templateFileForHarness(file));
+  let content = fs39.readFileSync(templatePath, "utf8");
   if (file === "harness.env") {
     content = substituteProjectName2(content, projectNameFromRepo(repoPath));
   }
@@ -76549,12 +76845,12 @@ function actionHint(file, kind2) {
   return `Read maintain/diffs/${file}.diff and merge into .har/${file}.`;
 }
 function createUnifiedDiff(installedContent, templateContent, installedLabel, templateLabel) {
-  const tmpDir = fs38.mkdtempSync(path42.join(os13.tmpdir(), "har-maintain-diff-"));
+  const tmpDir = fs39.mkdtempSync(path43.join(os14.tmpdir(), "har-maintain-diff-"));
   try {
-    const installedPath = path42.join(tmpDir, "installed");
-    const templatePath = path42.join(tmpDir, "template");
-    fs38.writeFileSync(installedPath, installedContent);
-    fs38.writeFileSync(templatePath, templateContent);
+    const installedPath = path43.join(tmpDir, "installed");
+    const templatePath = path43.join(tmpDir, "template");
+    fs39.writeFileSync(installedPath, installedContent);
+    fs39.writeFileSync(templatePath, templateContent);
     const result = run(`diff -u "${installedPath}" "${templatePath}"`);
     const body = result.stdout.trim();
     if (!body) return "";
@@ -76563,7 +76859,7 @@ function createUnifiedDiff(installedContent, templateContent, installedLabel, te
 ${body.split("\n").slice(2).join("\n")}
 `;
   } finally {
-    fs38.rmSync(tmpDir, { recursive: true, force: true });
+    fs39.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 function buildActions(repoPath, profile, drift) {
@@ -76578,7 +76874,7 @@ function buildActions(repoPath, profile, drift) {
     });
   }
   for (const file of drift.checksumMismatch) {
-    const installedPath = path42.join(harnessDir, file);
+    const installedPath = path43.join(harnessDir, file);
     const installedRel = `maintain/installed/${file}`;
     const templateRel = `maintain/templates/${file}`;
     const diffRel = `maintain/diffs/${file}.diff`;
@@ -76586,7 +76882,7 @@ function buildActions(repoPath, profile, drift) {
       file,
       kind: "drift",
       template: templateRel,
-      installed: fs38.existsSync(installedPath) ? installedRel : void 0,
+      installed: fs39.existsSync(installedPath) ? installedRel : void 0,
       diff: diffRel,
       hint: actionHint(file, "drift")
     });
@@ -76596,6 +76892,44 @@ function buildActions(repoPath, profile, drift) {
 function buildStale(drift) {
   return drift.extra.map((file) => ({ file, hint: staleFileHint(file) })).sort((a2, b3) => a2.file.localeCompare(b3.file));
 }
+function buildInstructionFileNotes(repoPath) {
+  const detection = detectInstructionFiles(repoPath);
+  const notes = [];
+  if (detection.agentMd) {
+    notes.push({
+      kind: "migrate_legacy_agent_md",
+      path: "AGENT.md",
+      message: "Legacy AGENT.md (singular) found \u2014 merge unique notes into AGENTS.md, then delete AGENT.md. Codex auto-loads AGENTS.md only."
+    });
+  }
+  if (!detection.agentsMd) {
+    notes.push({
+      kind: "create_agents_md",
+      path: "AGENTS.md",
+      message: "AGENTS.md missing \u2014 create it with a HAR / agent environment section (or let maintain\u2019s instruction-files step scaffold it, then fill project-specific notes)."
+    });
+  } else {
+    notes.push({
+      kind: "refresh_agents_md_har_section",
+      path: "AGENTS.md",
+      message: "Refresh the managed HAR / agent environment section in AGENTS.md if workflow/commands changed \u2014 do not wipe unrelated project guidance."
+    });
+  }
+  if (detection.claudeMd) {
+    notes.push({
+      kind: "claude_md_pointer",
+      path: "CLAUDE.md",
+      message: "Keep CLAUDE.md as a thin pointer to AGENTS.md (do not duplicate the full HAR workflow)."
+    });
+  } else {
+    notes.push({
+      kind: "claude_md_pointer",
+      path: "CLAUDE.md",
+      message: "Optional: add a thin CLAUDE.md pointer \u2192 AGENTS.md when Claude Code is used on this repo."
+    });
+  }
+  return notes;
+}
 function buildReadme(report) {
   const lines2 = [
     "# Harness maintenance bundle",
@@ -76663,6 +76997,16 @@ function buildReadme(report) {
       ""
     );
   }
+  if (report.instructionFiles.length > 0) {
+    lines2.push("", "## Agent instruction files (generator 0.5.0)", "");
+    lines2.push(
+      "Repo-root agent docs are **outside** `.har/` checksum drift. Apply while adapting:",
+      ""
+    );
+    for (const note of report.instructionFiles) {
+      lines2.push(`- **\`${note.path}\`** (${note.kind}): ${note.message}`);
+    }
+  }
   lines2.push("", "## Stale files (review)", "");
   if (report.stale.length === 0) {
     lines2.push("None detected.");
@@ -76686,28 +77030,28 @@ function buildReadme(report) {
 }
 function writeBundleArtifacts(repoPath, profile, drift, report) {
   const harnessDir = getHarnessDir(repoPath);
-  const bundleDir = path42.join(harnessDir, MAINTAIN_DIR);
-  if (fs38.existsSync(bundleDir)) {
-    fs38.rmSync(bundleDir, { recursive: true, force: true });
+  const bundleDir = path43.join(harnessDir, MAINTAIN_DIR);
+  if (fs39.existsSync(bundleDir)) {
+    fs39.rmSync(bundleDir, { recursive: true, force: true });
   }
   const dirs = [
     bundleDir,
-    path42.join(bundleDir, "templates"),
-    path42.join(bundleDir, "installed"),
-    path42.join(bundleDir, "diffs"),
-    path42.join(bundleDir, "stale")
+    path43.join(bundleDir, "templates"),
+    path43.join(bundleDir, "installed"),
+    path43.join(bundleDir, "diffs"),
+    path43.join(bundleDir, "stale")
   ];
   for (const dir of dirs) {
-    fs38.mkdirSync(dir, { recursive: true });
+    fs39.mkdirSync(dir, { recursive: true });
   }
   const affectedFiles = [...drift.missing, ...drift.checksumMismatch];
   for (const file of affectedFiles) {
     const templateContent = readBundledTemplateContent(repoPath, profile, file);
-    writeFileSafe(path42.join(bundleDir, "templates", file), templateContent);
-    const harnessPath = path42.join(harnessDir, file);
-    if (fs38.existsSync(harnessPath)) {
-      const installedContent = fs38.readFileSync(harnessPath, "utf8");
-      writeFileSafe(path42.join(bundleDir, "installed", file), installedContent);
+    writeFileSafe(path43.join(bundleDir, "templates", file), templateContent);
+    const harnessPath = path43.join(harnessDir, file);
+    if (fs39.existsSync(harnessPath)) {
+      const installedContent = fs39.readFileSync(harnessPath, "utf8");
+      writeFileSafe(path43.join(bundleDir, "installed", file), installedContent);
       const diff = createUnifiedDiff(
         installedContent,
         templateContent,
@@ -76715,14 +77059,14 @@ function writeBundleArtifacts(repoPath, profile, drift, report) {
         `templates/${file}`
       );
       if (diff) {
-        writeFileSafe(path42.join(bundleDir, "diffs", `${file}.diff`), diff);
+        writeFileSafe(path43.join(bundleDir, "diffs", `${file}.diff`), diff);
       }
     }
   }
-  writeFileSafe(path42.join(bundleDir, "README.md"), buildReadme(report));
-  writeFileSafe(path42.join(bundleDir, "drift-report.json"), JSON.stringify(report, null, 2) + "\n");
+  writeFileSafe(path43.join(bundleDir, "README.md"), buildReadme(report));
+  writeFileSafe(path43.join(bundleDir, "drift-report.json"), JSON.stringify(report, null, 2) + "\n");
   writeFileSafe(
-    path42.join(bundleDir, "validation.json"),
+    path43.join(bundleDir, "validation.json"),
     JSON.stringify(report.validation, null, 2) + "\n"
   );
   if (report.stale.length > 0) {
@@ -76734,34 +77078,34 @@ function writeBundleArtifacts(repoPath, profile, drift, report) {
       ...report.stale.map((s2) => `- **${s2.file}** \u2014 ${s2.hint}`),
       ""
     ];
-    writeFileSafe(path42.join(bundleDir, "stale", "MANIFEST.md"), staleLines.join("\n"));
+    writeFileSafe(path43.join(bundleDir, "stale", "MANIFEST.md"), staleLines.join("\n"));
   }
   return bundleDir;
 }
 function ensureParentDir2(filePath) {
-  const parent = path42.dirname(filePath);
-  if (!fs38.existsSync(parent)) {
-    fs38.mkdirSync(parent, { recursive: true });
+  const parent = path43.dirname(filePath);
+  if (!fs39.existsSync(parent)) {
+    fs39.mkdirSync(parent, { recursive: true });
   }
 }
 function writePluginBundleArtifacts(repoPath, bundleDir, report) {
   if (report.pluginActions.length === 0) return;
   for (const action of report.pluginActions) {
-    const pluginRoot = path42.join(bundleDir, "plugins", action.pluginId);
-    const templatesDir = path42.join(pluginRoot, "templates");
-    const installedDir = path42.join(pluginRoot, "installed");
-    const diffsDir = path42.join(pluginRoot, "diffs");
+    const pluginRoot = path43.join(bundleDir, "plugins", action.pluginId);
+    const templatesDir = path43.join(pluginRoot, "templates");
+    const installedDir = path43.join(pluginRoot, "installed");
+    const diffsDir = path43.join(pluginRoot, "diffs");
     for (const dir of [templatesDir, installedDir, diffsDir]) {
-      fs38.mkdirSync(dir, { recursive: true });
+      fs39.mkdirSync(dir, { recursive: true });
     }
     const templateContent = readTemplatePluginFile(action.pluginId, action.file);
     if (templateContent === null) continue;
-    const templatePath = path42.join(templatesDir, action.file);
+    const templatePath = path43.join(templatesDir, action.file);
     ensureParentDir2(templatePath);
     writeFileSafe(templatePath, templateContent);
     const installedContent = readInstalledPluginFile(repoPath, action.pluginId, action.file);
     if (installedContent !== null) {
-      const installedPath = path42.join(installedDir, action.file);
+      const installedPath = path43.join(installedDir, action.file);
       ensureParentDir2(installedPath);
       writeFileSafe(installedPath, installedContent);
       const diff = createUnifiedDiff(
@@ -76771,7 +77115,7 @@ function writePluginBundleArtifacts(repoPath, bundleDir, report) {
         `templates/${action.file}`
       );
       if (diff) {
-        const diffPath = path42.join(diffsDir, `${action.file}.diff`);
+        const diffPath = path43.join(diffsDir, `${action.file}.diff`);
         ensureParentDir2(diffPath);
         writeFileSafe(diffPath, diff);
       }
@@ -76795,6 +77139,7 @@ function buildMaintainBundle(repoPath, validation2, drift) {
     stale: buildStale(drift),
     missingPortVars: drift.missingPortVars,
     agentSlotMismatch: drift.agentSlotMismatch,
+    instructionFiles: buildInstructionFileNotes(repoPath),
     validation: {
       pass: validation2.pass,
       errors,
@@ -76806,9 +77151,9 @@ function buildMaintainBundle(repoPath, validation2, drift) {
   return { bundleDir, report };
 }
 function removeMaintainBundle(repoPath) {
-  const bundleDir = path42.join(getHarnessDir(repoPath), MAINTAIN_DIR);
-  if (fs38.existsSync(bundleDir)) {
-    fs38.rmSync(bundleDir, { recursive: true, force: true });
+  const bundleDir = path43.join(getHarnessDir(repoPath), MAINTAIN_DIR);
+  if (fs39.existsSync(bundleDir)) {
+    fs39.rmSync(bundleDir, { recursive: true, force: true });
   }
 }
 function formatMaintainBundlePromptSection(report) {
@@ -76874,7 +77219,19 @@ function formatMaintainBundlePromptSection(report) {
       ""
     );
   }
-  if (report.actions.length === 0 && report.pluginActions.length === 0 && report.stale.length === 0 && report.missingPortVars.length === 0 && !report.agentSlotMismatch && report.validation.errors.length === 0) {
+  if (report.instructionFiles.length > 0) {
+    lines2.push(
+      "### Agent instruction files (generator 0.5.0 \u2014 outside `.har/` drift)",
+      "",
+      "These are **not** checksum drift rows. Apply them while adapting (HAR also migrates/scaffolds on maintain):",
+      ""
+    );
+    for (const note of report.instructionFiles) {
+      lines2.push(`- **\`${note.path}\`** (${note.kind}): ${note.message}`);
+    }
+    lines2.push("");
+  }
+  if (report.actions.length === 0 && report.pluginActions.length === 0 && report.stale.length === 0 && report.missingPortVars.length === 0 && !report.agentSlotMismatch && report.validation.errors.length === 0 && report.instructionFiles.length === 0) {
     lines2.push("No template drift detected. Review repo stack changes manually if needed.", "");
   }
   return lines2.join("\n");
@@ -76886,11 +77243,11 @@ init_stages();
 init_validation();
 function listHarnessScripts(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
-  if (!fs39.existsSync(harnessDir)) return [];
-  return fs39.readdirSync(harnessDir).filter((name) => name.endsWith(".sh")).sort();
+  if (!fs40.existsSync(harnessDir)) return [];
+  return fs40.readdirSync(harnessDir).filter((name) => name.endsWith(".sh")).sort();
 }
 function describeProject(repoPath) {
-  const resolved = path43.resolve(repoPath);
+  const resolved = path44.resolve(repoPath);
   const manifest = readManifest(resolved);
   const present = harnessExists(resolved);
   return {
@@ -76910,8 +77267,8 @@ function describeProject(repoPath) {
   };
 }
 async function initHarness(options) {
-  const repoPath = path43.resolve(options.repoPath);
-  if (!fs39.existsSync(repoPath)) {
+  const repoPath = path44.resolve(options.repoPath);
+  if (!fs40.existsSync(repoPath)) {
     throw new Error(`Path not found: ${repoPath}`);
   }
   const scaffold = scaffoldHarnessBoilerplate(repoPath, {
@@ -76943,9 +77300,9 @@ async function initHarness(options) {
   };
 }
 async function maintainHarness(options) {
-  const repoPath = path43.resolve(options.repoPath);
+  const repoPath = path44.resolve(options.repoPath);
   const harnessDir = getHarnessDir(repoPath);
-  if (!fs39.existsSync(harnessDir)) {
+  if (!fs40.existsSync(harnessDir)) {
     throw new Error('No .har/ found. Run "har env init" first.');
   }
   if (options.auto) {
@@ -76997,13 +77354,13 @@ function addPlugin(repoPath, pluginId, options = {}) {
 }
 
 // src/harness/custom-stage.ts
-var fs40 = __toESM(require("fs"));
-var path44 = __toESM(require("path"));
+var fs41 = __toESM(require("fs"));
+var path45 = __toESM(require("path"));
 init_schema2();
 init_stages();
 var STAGE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
 function addCustomStage(repoPath, options) {
-  const resolved = path44.resolve(repoPath);
+  const resolved = path45.resolve(repoPath);
   if (!harnessExists(resolved)) {
     throw new Error('No .har/ harness found. Run "har env init" first.');
   }
@@ -77040,20 +77397,20 @@ function addCustomStage(repoPath, options) {
   if (options.command) {
     stage.command = options.command;
   } else {
-    const scriptRel = path44.join("stages", `${id}.sh`);
-    const scriptAbs = path44.join(resolved, ".har", scriptRel);
-    if (fs40.existsSync(scriptAbs) && !options.force) {
+    const scriptRel = path45.join("stages", `${id}.sh`);
+    const scriptAbs = path45.join(resolved, ".har", scriptRel);
+    if (fs41.existsSync(scriptAbs) && !options.force) {
       throw new Error(`Stage script already exists: .har/${scriptRel}. Use --force to overwrite.`);
     }
-    const skeletonPath = path44.join(
+    const skeletonPath = path45.join(
       resolveTemplatesDir(),
       "plugins",
       "custom-stage-skeleton.sh"
     );
-    const skeleton = fs40.readFileSync(skeletonPath, "utf8").replace(/__STAGE_ID__/g, id).replace(/__STAGE_KIND__/g, kind2).replace(/__STAGE_DESCRIPTION__/g, stage.description);
-    fs40.mkdirSync(path44.dirname(scriptAbs), { recursive: true });
-    fs40.writeFileSync(scriptAbs, skeleton);
-    fs40.chmodSync(scriptAbs, 493);
+    const skeleton = fs41.readFileSync(skeletonPath, "utf8").replace(/__STAGE_ID__/g, id).replace(/__STAGE_KIND__/g, kind2).replace(/__STAGE_DESCRIPTION__/g, stage.description);
+    fs41.mkdirSync(path45.dirname(scriptAbs), { recursive: true });
+    fs41.writeFileSync(scriptAbs, skeleton);
+    fs41.chmodSync(scriptAbs, 493);
     filesWritten.push(`.har/${scriptRel}`);
     stage.script = scriptRel;
     stage.artifacts = [
@@ -77101,9 +77458,9 @@ function addCustomStage(repoPath, options) {
 }
 
 // src/harness/adaptation-prompt.ts
-var fs41 = __toESM(require("fs"));
-var path45 = __toESM(require("path"));
-var readline4 = __toESM(require("readline"));
+var fs42 = __toESM(require("fs"));
+var path46 = __toESM(require("path"));
+var readline5 = __toESM(require("readline"));
 
 // src/utils/clipboard.ts
 var import_child_process8 = require("child_process");
@@ -77192,7 +77549,7 @@ function loadTemplate(name) {
   if (!filePath) {
     throw new Error(`Adaptation prompt template not found: ${name}. Run npm run build.`);
   }
-  return fs41.readFileSync(filePath, "utf8");
+  return fs42.readFileSync(filePath, "utf8");
 }
 function applyProfilePlaceholders(content, profile) {
   return content.replace(/\{\{PROFILE\}\}/g, profile).replace(/\{\{PROFILE_HINT\}\}/g, PROFILE_HINTS[profile]);
@@ -77214,7 +77571,7 @@ function buildMaintainAdaptationPrompt(_repoPath, bundleReport) {
 }
 function writeAdaptationPrompt(repoPath, content) {
   const harnessDir = getHarnessDir(repoPath);
-  const filePath = path45.join(harnessDir, ADAPTATION_PROMPT_FILE);
+  const filePath = path46.join(harnessDir, ADAPTATION_PROMPT_FILE);
   writeFileSafe(filePath, content);
   return filePath;
 }
@@ -77231,8 +77588,8 @@ function printAdaptationPrompt(content) {
 `);
   process.stderr.write("\n");
 }
-function askYesNo3(question) {
-  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
+function askYesNo4(question) {
+  const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve47) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
@@ -77250,7 +77607,7 @@ async function offerAdaptationPromptClipboard(content, options = {}) {
   }
   let shouldCopy = options.autoYes === true;
   if (!shouldCopy && interactive) {
-    shouldCopy = await askYesNo3("Copy adaptation prompt to clipboard for your coding agent? [Y/n]");
+    shouldCopy = await askYesNo4("Copy adaptation prompt to clipboard for your coding agent? [Y/n]");
   }
   if (!shouldCopy) {
     info("Skipped clipboard copy \u2014 prompt is in .har/ADAPT-PROMPT.md");
@@ -77269,27 +77626,27 @@ async function offerAdaptationPromptClipboard(content, options = {}) {
 }
 
 // src/harness/cursor-rule.ts
-var fs42 = __toESM(require("fs"));
-var path46 = __toESM(require("path"));
-var readline5 = __toESM(require("readline"));
+var fs43 = __toESM(require("fs"));
+var path47 = __toESM(require("path"));
+var readline6 = __toESM(require("readline"));
 init_file_ops();
 init_logging();
 var CURSOR_RULE_RELATIVE_PATH = ".cursor/rules/har-workflow.mdc";
 function getCursorRulePath(repoPath) {
-  return path46.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
+  return path47.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
 }
 function isCursorWorkspace(repoPath) {
-  return fs42.existsSync(path46.join(repoPath, ".cursor"));
+  return fs43.existsSync(path47.join(repoPath, ".cursor"));
 }
 function cursorRuleExists(repoPath) {
-  return fs42.existsSync(getCursorRulePath(repoPath));
+  return fs43.existsSync(getCursorRulePath(repoPath));
 }
 function scaffoldCursorRule(repoPath) {
   const templatePath = resolveTemplateFile("cursor-rule.mdc.template");
   if (!templatePath) {
     throw new Error("Cursor rule template not found (cursor-rule.mdc.template). Run npm run build.");
   }
-  const content = fs42.readFileSync(templatePath, "utf8");
+  const content = fs43.readFileSync(templatePath, "utf8");
   writeFileSafe(getCursorRulePath(repoPath), content);
 }
 async function handleCursorRule(options) {
@@ -77323,10 +77680,10 @@ async function handleCursorRule(options) {
 }
 async function promptScaffoldCursorRule(exists) {
   const action = exists ? "Update" : "Create";
-  return askYesNo4(`${action} ${CURSOR_RULE_RELATIVE_PATH}? [Y/n]`);
+  return askYesNo5(`${action} ${CURSOR_RULE_RELATIVE_PATH}? [Y/n]`);
 }
-async function askYesNo4(question) {
-  const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
+async function askYesNo5(question) {
+  const rl = readline6.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve47) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
@@ -77379,7 +77736,7 @@ init_control_config();
 
 // src/core/control-lifecycle.ts
 var import_child_process9 = require("child_process");
-var path47 = __toESM(require("path"));
+var path48 = __toESM(require("path"));
 
 // src/core/control-image.ts
 var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
@@ -77405,10 +77762,10 @@ var CONTROL_DATA_VOLUME = "har_control_data";
 var CONTROL_CONTAINER_PORT = 3847;
 var CONTROL_DATA_DB_URL = "file:/data/har_control.db";
 function resolveControlDir() {
-  return path47.resolve(__dirname, "..", "control");
+  return path48.resolve(__dirname, "..", "control");
 }
 function resolveControlBuildContext() {
-  return path47.resolve(resolveControlDir(), "..");
+  return path48.resolve(resolveControlDir(), "..");
 }
 function buildDockerRunArgs(options) {
   const name = options.containerName ?? CONTROL_CONTAINER_NAME;
@@ -77464,7 +77821,7 @@ async function startMissionControl(options) {
       "-t",
       imageRef,
       "-f",
-      path47.join(resolveControlDir(), "Dockerfile"),
+      path48.join(resolveControlDir(), "Dockerfile"),
       resolveControlBuildContext()
     ]);
     if (buildCode !== 0) {
@@ -77611,7 +77968,7 @@ async function ensureTelemetryInfrastructure(options) {
 // src/core/run-service.ts
 init_telemetry_config();
 init_telemetry_env();
-var path49 = __toESM(require("path"));
+var path50 = __toESM(require("path"));
 init_local_executor();
 function extractShellOutput(result) {
   const stdout = result.logs?.find((log) => log.stream === "stdout")?.content ?? result.logs?.find((log) => !log.stream)?.content ?? "";
@@ -77814,12 +78171,12 @@ Usage from Cursor / Claude / Codex (@osfactory/otel-hook) will appear under Work
           suffix: session.suffix,
           createdAt: session.createdAt
         });
-        const envFile = path49.join(session.workDir, `.env.agent.${options.agentId}`);
+        const envFile = path50.join(session.workDir, `.env.agent.${options.agentId}`);
         try {
           appendTelemetryEnvToFile(envFile, {
             sessionKey,
             agentId: options.agentId,
-            repoPath: path49.resolve(options.repoPath),
+            repoPath: path50.resolve(options.repoPath),
             workDir: session.workDir,
             branch: session.branch,
             suffix: session.suffix,
@@ -78054,12 +78411,12 @@ init_runs();
 init_slot_status();
 
 // src/core/commit-gate-onboarding.ts
-var readline6 = __toESM(require("readline"));
+var readline7 = __toESM(require("readline"));
 
 // src/core/hooks.ts
-var fs44 = __toESM(require("fs"));
-var os15 = __toESM(require("os"));
-var path50 = __toESM(require("path"));
+var fs45 = __toESM(require("fs"));
+var os16 = __toESM(require("os"));
+var path51 = __toESM(require("path"));
 init_shell();
 init_schema2();
 init_stages();
@@ -78090,7 +78447,7 @@ function resolveCheckoutRoot(cwd) {
 function resolveHooksDir(checkoutDir) {
   const hooksPath = tryGit3(checkoutDir, "rev-parse --git-path hooks");
   if (!hooksPath) throw new Error(`Not a git checkout: ${checkoutDir}`);
-  return path50.resolve(checkoutDir, hooksPath);
+  return path51.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
   return tryGit3(checkoutDir, "config core.hooksPath") || void 0;
@@ -78098,9 +78455,9 @@ function getConfiguredHooksPath(checkoutDir) {
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path50.resolve(entry)}"`;
+    return `"${process.execPath}" "${path51.resolve(entry)}"`;
   }
-  if (entry) return `"${path50.resolve(entry)}"`;
+  if (entry) return `"${path51.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -78120,45 +78477,45 @@ echo "${failOpenNotice}" >&2
 exit 0
 `;
 }
-function upsertMarkedBlock(filePath, block) {
-  if (!fs44.existsSync(filePath)) {
-    fs44.writeFileSync(filePath, `#!/bin/sh
+function upsertMarkedBlock2(filePath, block) {
+  if (!fs45.existsSync(filePath)) {
+    fs45.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs44.readFileSync(filePath, "utf8");
+  const content = fs45.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
-      `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
+      `${escapeRegExp2(MARKER_START)}[\\s\\S]*?${escapeRegExp2(MARKER_END)}`
     );
-    fs44.writeFileSync(filePath, content.replace(pattern, block));
-    fs44.chmodSync(filePath, 493);
+    fs45.writeFileSync(filePath, content.replace(pattern, block));
+    fs45.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs44.writeFileSync(filePath, `${content}${suffix}
+  fs45.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs44.chmodSync(filePath, 493);
+  fs45.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs44.existsSync(filePath)) return false;
-  const content = fs44.readFileSync(filePath, "utf8");
+  if (!fs45.existsSync(filePath)) return false;
+  const content = fs45.readFileSync(filePath, "utf8");
   if (!content.includes(MARKER_START)) return false;
   const pattern = new RegExp(
-    `\\n?${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}\\n?`
+    `\\n?${escapeRegExp2(MARKER_START)}[\\s\\S]*?${escapeRegExp2(MARKER_END)}\\n?`
   );
   const stripped = content.replace(pattern, "\n");
   if (stripped.replace(/^#!\/bin\/sh\n?/, "").trim() === "") {
-    fs44.rmSync(filePath);
+    fs45.rmSync(filePath);
   } else {
-    fs44.writeFileSync(filePath, stripped);
+    fs45.writeFileSync(filePath, stripped);
   }
   return true;
 }
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function installHooks(options) {
@@ -78176,20 +78533,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs44.mkdirSync(hooksDir, { recursive: true });
+  fs45.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs44.writeFileSync(
-    path50.join(hooksDir, "har-pre-commit"),
+  fs45.writeFileSync(
+    path51.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs44.writeFileSync(
-    path50.join(hooksDir, "har-post-commit"),
+  fs45.writeFileSync(
+    path51.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path50.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path50.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock2(path51.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock2(path51.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -78198,12 +78555,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path50.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path50.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path51.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path51.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path50.join(hooksDir, file);
-    if (fs44.existsSync(full)) {
-      fs44.rmSync(full);
+    const full = path51.join(hooksDir, file);
+    if (fs45.existsSync(full)) {
+      fs45.rmSync(full);
       removed = true;
     }
   }
@@ -78222,10 +78579,10 @@ function isAgentWorktree(checkoutDir) {
   if (branch && (/^har-agent-\d+$/.test(branch) || /-har-agent-\d+-[a-z0-9]+$/.test(branch))) {
     return true;
   }
-  const worktreesRoot = path50.join(os15.homedir(), "worktrees");
-  const resolved = path50.resolve(checkoutDir);
-  const name = path50.basename(resolved);
-  return resolved.startsWith(`${worktreesRoot}${path50.sep}`) && (/-agent-\d+$/.test(name) || /-har-agent-\d+-[a-z0-9]+$/.test(name));
+  const worktreesRoot = path51.join(os16.homedir(), "worktrees");
+  const resolved = path51.resolve(checkoutDir);
+  const name = path51.basename(resolved);
+  return resolved.startsWith(`${worktreesRoot}${path51.sep}`) && (/-agent-\d+$/.test(name) || /-har-agent-\d+-[a-z0-9]+$/.test(name));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -78238,15 +78595,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path50.join(hooksDir, name);
-    return fs44.existsSync(file) && fs44.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path51.join(hooksDir, name);
+    return fs45.existsSync(file) && fs45.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs44.existsSync(path50.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs44.existsSync(path50.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs45.existsSync(path51.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs45.existsSync(path51.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -78257,7 +78614,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs44.existsSync(path50.join(checkout, ".har", "stages.json"))) {
+  if (!fs45.existsSync(path51.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -78330,8 +78687,8 @@ async function recordCommitAssociation(cwd) {
 // src/core/commit-gate-onboarding.ts
 init_stages();
 init_logging();
-function askYesNo5(question) {
-  const rl = readline6.createInterface({ input: process.stdin, output: process.stderr });
+function askYesNo6(question) {
+  const rl = readline7.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise((resolve47) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
@@ -78362,7 +78719,7 @@ async function handleCommitGateOnboarding(options) {
   const status = getHooksStatus(options.repoPath);
   let shouldInstall = status.preCommitInstalled || status.postCommitInstalled || options.install === "always" || options.autoYes === true;
   if (!shouldInstall && options.install === "prompt" && process.stdin.isTTY && process.stdout.isTTY) {
-    shouldInstall = await askYesNo5("Install the HAR commit gate for this repository? [Y/n]");
+    shouldInstall = await askYesNo6("Install the HAR commit gate for this repository? [Y/n]");
   }
   if (!shouldInstall) {
     info("Commit gate is not installed; run `har hooks install` when ready.");
@@ -78379,21 +78736,21 @@ async function handleCommitGateOnboarding(options) {
 }
 
 // src/core/onboarding-preferences.ts
-var fs45 = __toESM(require("fs"));
-var os16 = __toESM(require("os"));
-var path51 = __toESM(require("path"));
+var fs46 = __toESM(require("fs"));
+var os17 = __toESM(require("os"));
+var path52 = __toESM(require("path"));
 init_schema2();
 function getOnboardingPreferencesPath() {
   if (process.env.HAR_PREFERENCES_PATH) {
-    return path51.resolve(process.env.HAR_PREFERENCES_PATH);
+    return path52.resolve(process.env.HAR_PREFERENCES_PATH);
   }
-  return path51.join(os16.homedir(), ".har", "preferences.json");
+  return path52.join(os17.homedir(), ".har", "preferences.json");
 }
 function readOnboardingPreferences() {
   const preferencePath = getOnboardingPreferencesPath();
   try {
-    if (!fs45.existsSync(preferencePath)) return OnboardingPreferencesSchema.parse({});
-    return OnboardingPreferencesSchema.parse(JSON.parse(fs45.readFileSync(preferencePath, "utf8")));
+    if (!fs46.existsSync(preferencePath)) return OnboardingPreferencesSchema.parse({});
+    return OnboardingPreferencesSchema.parse(JSON.parse(fs46.readFileSync(preferencePath, "utf8")));
   } catch {
     return OnboardingPreferencesSchema.parse({});
   }
@@ -78418,8 +78775,8 @@ function writeOnboardingPreferences(overrides) {
   };
   const parsed = OnboardingPreferencesSchema.parse(preference);
   const preferencePath = getOnboardingPreferencesPath();
-  fs45.mkdirSync(path51.dirname(preferencePath), { recursive: true });
-  fs45.writeFileSync(preferencePath, `${JSON.stringify(parsed, null, 2)}
+  fs46.mkdirSync(path52.dirname(preferencePath), { recursive: true });
+  fs46.writeFileSync(preferencePath, `${JSON.stringify(parsed, null, 2)}
 `);
   return parsed;
 }
@@ -78713,7 +79070,7 @@ var envCommand = {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path52.resolve(argv.repo);
+  const repoPath = path53.resolve(argv.repo);
   const onboarding = resolveOnboardingOptions(argv);
   header("har env init");
   info(`Repository: ${repoPath}`);
@@ -78756,18 +79113,13 @@ async function handleInit(argv) {
       ...onboarding.commitGate,
       autoYes: argv.yes
     });
-    await handleCursorRule({
+    await applyAgentIntegrations({
       repoPath,
-      cursorRule: onboarding.cursorRule,
-      autoYes: argv.yes,
-      mode: "init"
-    });
-    await handleAgentSkills({
-      repoPath,
-      ...onboarding.agentSkills,
+      mode: "init",
       autoYes: argv.yes,
       force: argv.force,
-      mode: "init"
+      cursorRule: onboarding.cursorRule,
+      ...onboarding.agentSkills
     });
     printNextSteps(argv.auto);
   } catch (err) {
@@ -78776,7 +79128,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path52.resolve(argv.repo);
+  const repoPath = path53.resolve(argv.repo);
   const onboarding = resolveOnboardingOptions(argv);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
@@ -78840,17 +79192,12 @@ async function handleMaintain(argv) {
       ...onboarding.commitGate,
       autoYes: argv.yes
     });
-    await handleCursorRule({
+    await applyAgentIntegrations({
       repoPath,
-      cursorRule: onboarding.cursorRule,
+      mode: "maintain",
       autoYes: argv.yes,
-      mode: "maintain"
-    });
-    await handleAgentSkills({
-      repoPath,
-      ...onboarding.agentSkills,
-      autoYes: argv.yes,
-      mode: "maintain"
+      cursorRule: onboarding.cursorRule,
+      ...onboarding.agentSkills
     });
   } catch (err) {
     error(err.message);
@@ -78898,16 +79245,43 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path52.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path53.join(repoPath, AGENTS_MD), proposal.content);
       clearAgentMdProposal(repoPath);
-      info("Applied AGENT.md proposal (--yes)");
+      info(`Applied ${AGENTS_MD} proposal (--yes)`);
     }
     return;
   }
   await promptApplyAgentMdProposal(repoPath);
 }
+async function applyAgentIntegrations(options) {
+  const instruction = await handleInstructionFiles({
+    repoPath: options.repoPath,
+    agents: options.agents,
+    enabled: options.enabled,
+    cursorRule: options.cursorRule,
+    autoYes: options.autoYes,
+    mode: options.mode
+  });
+  const cursorRuleFlag = options.cursorRule === false ? false : options.cursorRule === true || instruction.plan.cursorRule ? true : false;
+  await handleCursorRule({
+    repoPath: options.repoPath,
+    cursorRule: cursorRuleFlag,
+    autoYes: options.autoYes,
+    mode: options.mode
+  });
+  if (instruction.plan.skills.length > 0) {
+    await handleAgentSkills({
+      repoPath: options.repoPath,
+      agents: instruction.plan.skills.join(","),
+      autoYes: options.autoYes,
+      force: options.force,
+      mode: options.mode
+    });
+  } else if (options.enabled === false) {
+  }
+}
 async function handleAddPlugin(argv) {
-  const repoPath = path52.resolve(argv.repo);
+  const repoPath = path53.resolve(argv.repo);
   const available = listPluginIds();
   if (argv.list) {
     for (const id of available) {
@@ -78945,7 +79319,7 @@ async function handleAddPlugin(argv) {
   }
 }
 async function handleAddStage(argv) {
-  const repoPath = path52.resolve(argv.repo);
+  const repoPath = path53.resolve(argv.repo);
   const available = listPluginIds();
   if (argv.list) {
     warn("har env add-stage --list is deprecated; prefer: har env add-plugin --list");
@@ -79011,7 +79385,7 @@ async function handleAddStage(argv) {
   });
 }
 async function handlePreflight(argv) {
-  const repo = path52.resolve(argv.repo);
+  const repo = path53.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -79027,7 +79401,7 @@ async function handlePreflight(argv) {
   return finishCommand(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path52.resolve(argv.repo);
+  const repo = path53.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   if (!argv.resume) {
     const guard = checkLaunchGuard2(repo, agentId, {});
@@ -79082,7 +79456,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path52.resolve(argv.repo);
+  const repo = path53.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -79094,7 +79468,7 @@ async function handleVerify(argv) {
   return finishCommand(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path52.resolve(argv.repo);
+  const repo = path53.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -79105,7 +79479,7 @@ async function handleTeardown(argv) {
   return finishCommand(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path52.resolve(argv.repo);
+  const repo = path53.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -79126,7 +79500,7 @@ async function handleComplete(argv) {
   return finishCommand(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path52.resolve(argv.repo);
+  const repoPath = path53.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -79139,7 +79513,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path52.resolve(argv.repo);
+  const repoPath = path53.resolve(argv.repo);
   const runs = listRuns(repoPath, { stageId: argv.stage, limit: argv.limit });
   if (argv.json) {
     process.stdout.write(JSON.stringify({ runs }, null, 2) + "\n");
@@ -79156,7 +79530,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path52.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path53.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     return finishCommand(1);
@@ -79231,7 +79605,7 @@ function printNextSteps(auto2) {
     console.error("  Adapt:        paste clipboard / prompt above into your coding agent");
     console.error("  Prompt file:  .har/ADAPT-PROMPT.md");
   } else {
-    console.error("  Agent guide:  AGENT.md (repo root, if applied)");
+    console.error("  Agent guide:  AGENTS.md (repo root, if applied)");
   }
   console.error("  Setup infra:  ./.har/setup-infra.sh   # when Docker infra is enabled");
   console.error("  Launch:       har env launch 1        # preferred; or ./.har/launch.sh 1");
@@ -79242,7 +79616,7 @@ function printNextSteps(auto2) {
 }
 
 // src/cli/commands/control.ts
-var path56 = __toESM(require("path"));
+var path57 = __toESM(require("path"));
 
 // node_modules/@inquirer/core/dist/esm/lib/key.mjs
 var isUpKey = (key) => (
@@ -79323,7 +79697,7 @@ function getStore() {
   }
   return store;
 }
-function readline7() {
+function readline8() {
   return getStore().rl;
 }
 function withUpdates(fn) {
@@ -79368,7 +79742,7 @@ var effectScheduler = {
     const { index } = store;
     store.hooksEffect.push(() => {
       store.hooksCleanup[index]?.();
-      const cleanFn = cb(readline7());
+      const cleanFn = cb(readline8());
       if (cleanFn != null && typeof cleanFn !== "function") {
         throw new ValidationError("useEffect return value must be a cleanup function or nothing.");
       }
@@ -79844,7 +80218,7 @@ function breakLines(content, width) {
   return content.split("\n").flatMap((line) => (0, import_wrap_ansi.default)(line, width, { trim: false, hard: true }).split("\n").map((str) => str.trimEnd())).join("\n");
 }
 function readlineWidth() {
-  return (0, import_cli_width.default)({ defaultWidth: 80, output: readline7().output });
+  return (0, import_cli_width.default)({ defaultWidth: 80, output: readline8().output });
 }
 
 // node_modules/@inquirer/core/dist/esm/lib/pagination/lines.mjs
@@ -79936,7 +80310,7 @@ function usePagination({ items, active, renderItem, pageSize, loop = true }) {
 }
 
 // node_modules/@inquirer/core/dist/esm/lib/create-prompt.mjs
-var readline8 = __toESM(require("node:readline"), 1);
+var readline9 = __toESM(require("node:readline"), 1);
 var import_node_async_hooks3 = require("node:async_hooks");
 var import_mute_stream = __toESM(require_lib3(), 1);
 
@@ -80279,7 +80653,7 @@ function createPrompt(view) {
     const cleanups = /* @__PURE__ */ new Set();
     const output = new import_mute_stream.default();
     output.pipe(context.output ?? process.stdout);
-    const rl = readline8.createInterface({
+    const rl = readline9.createInterface({
       terminal: true,
       input,
       output
@@ -81296,9 +81670,9 @@ var import_run_async = __toESM(require_run_async(), 1);
 var import_mute_stream2 = __toESM(require_lib3(), 1);
 var import_ansi_escapes5 = __toESM(require_ansi_escapes(), 1);
 var _2 = {
-  set: (obj, path63 = "", value) => {
+  set: (obj, path64 = "", value) => {
     let pointer = obj;
-    path63.split(".").forEach((key, index, arr) => {
+    path64.split(".").forEach((key, index, arr) => {
       if (key === "__proto__" || key === "constructor")
         return;
       if (index === arr.length - 1) {
@@ -81309,8 +81683,8 @@ var _2 = {
       pointer = pointer[key];
     });
   },
-  get: (obj, path63 = "", defaultValue) => {
-    const travel = (regexp) => String.prototype.split.call(path63, regexp).filter(Boolean).reduce(
+  get: (obj, path64 = "", defaultValue) => {
+    const travel = (regexp) => String.prototype.split.call(path64, regexp).filter(Boolean).reduce(
       // @ts-expect-error implicit any on res[key]
       (res, key) => res !== null && res !== void 0 ? res[key] : res,
       obj
@@ -81564,21 +81938,21 @@ init_control_port();
 init_control_sync();
 
 // src/core/control-sync-selection.ts
-var fs46 = __toESM(require("fs"));
-var os17 = __toESM(require("os"));
-var path53 = __toESM(require("path"));
+var fs47 = __toESM(require("fs"));
+var os18 = __toESM(require("os"));
+var path54 = __toESM(require("path"));
 init_control_repo_path();
 function getSelectionPath() {
   if (process.env.HAR_CONTROL_SYNC_SELECTION_PATH) {
-    return path53.resolve(process.env.HAR_CONTROL_SYNC_SELECTION_PATH);
+    return path54.resolve(process.env.HAR_CONTROL_SYNC_SELECTION_PATH);
   }
-  return path53.join(os17.homedir(), ".har", "sync-selection.json");
+  return path54.join(os18.homedir(), ".har", "sync-selection.json");
 }
 function readSyncSelection() {
   const selectionPath = getSelectionPath();
   try {
-    if (!fs46.existsSync(selectionPath)) return null;
-    const parsed = JSON.parse(fs46.readFileSync(selectionPath, "utf8"));
+    if (!fs47.existsSync(selectionPath)) return null;
+    const parsed = JSON.parse(fs47.readFileSync(selectionPath, "utf8"));
     if (!Array.isArray(parsed.repos)) return null;
     return parsed.repos.map((repoPath) => canonicalizeControlRepoPath(repoPath));
   } catch {
@@ -81588,8 +81962,8 @@ function readSyncSelection() {
 function writeSyncSelection(repos) {
   const selectionPath = getSelectionPath();
   const canonical = Array.from(new Set(repos.map((repoPath) => canonicalizeControlRepoPath(repoPath))));
-  fs46.mkdirSync(path53.dirname(selectionPath), { recursive: true });
-  fs46.writeFileSync(selectionPath, JSON.stringify({ repos: canonical }, null, 2) + "\n");
+  fs47.mkdirSync(path54.dirname(selectionPath), { recursive: true });
+  fs47.writeFileSync(selectionPath, JSON.stringify({ repos: canonical }, null, 2) + "\n");
 }
 function resolveSyncSelection(input) {
   const { discovered, stored, forceSelect, isTTY } = input;
@@ -81696,8 +82070,8 @@ If your browser did not open, paste that URL.
 }
 
 // src/core/control-unregister.ts
-var fs47 = __toESM(require("fs"));
-var path54 = __toESM(require("path"));
+var fs48 = __toESM(require("fs"));
+var path55 = __toESM(require("path"));
 init_control_repo_path();
 init_control_registry();
 init_control_config();
@@ -81707,9 +82081,9 @@ function listUnregisterWorktreeCandidates(repoPath) {
   const harnessRoot = canonicalizeControlRepoPath(repoPath);
   const byPath = /* @__PURE__ */ new Map();
   const add = (partial2) => {
-    const resolved = path54.resolve(partial2.worktreePath);
+    const resolved = path55.resolve(partial2.worktreePath);
     if (!resolved || resolved === harnessRoot) return;
-    const exists = partial2.exists ?? fs47.existsSync(resolved);
+    const exists = partial2.exists ?? fs48.existsSync(resolved);
     const prev = byPath.get(resolved);
     if (prev) {
       byPath.set(resolved, {
@@ -81756,10 +82130,10 @@ function listUnregisterWorktreeCandidates(repoPath) {
   }
   return [...byPath.values()].sort((a2, b3) => a2.agentId - b3.agentId);
 }
-async function askYesNo6(question) {
+async function askYesNo7(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
-  const readline10 = await import("readline");
-  const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
+  const readline11 = await import("readline");
+  const rl = readline11.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise((resolve47) => {
     rl.question(question, resolve47);
   });
@@ -81773,7 +82147,7 @@ async function confirmUnregister(options) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("Non-interactive terminal \u2014 pass --yes (and optionally --delete-worktrees)");
   }
-  const proceed = await askYesNo6("Unregister this repository from Mission Control? [y/N] ");
+  const proceed = await askYesNo7("Unregister this repository from Mission Control? [y/N] ");
   if (!proceed) return { proceed: false, deleteWorktrees: false };
   const existing = options.worktrees.filter((w3) => w3.exists);
   if (existing.length === 0) {
@@ -81785,7 +82159,7 @@ async function confirmUnregister(options) {
     process.stderr.write(`  agent-${wt2.agentId}: ${wt2.worktreePath}${dirty}
 `);
   }
-  const deleteWorktrees = await askYesNo6(
+  const deleteWorktrees = await askYesNo7(
     `Also delete ${existing.length} session worktree(s) on disk? [y/N] `
   );
   return { proceed: true, deleteWorktrees };
@@ -81823,28 +82197,28 @@ async function teardownWorktrees(repoPath, candidates, dryRun) {
         trigger: "cli"
       });
       if (result.code !== 0) {
-        if (fs47.existsSync(candidate.worktreePath)) {
-          fs47.rmSync(candidate.worktreePath, { recursive: true, force: true });
+        if (fs48.existsSync(candidate.worktreePath)) {
+          fs48.rmSync(candidate.worktreePath, { recursive: true, force: true });
         }
       }
       outcomes.push({
         path: candidate.worktreePath,
         agentId: candidate.agentId,
-        deleted: !fs47.existsSync(candidate.worktreePath),
-        error: result.code !== 0 && fs47.existsSync(candidate.worktreePath) ? result.stderr : void 0
+        deleted: !fs48.existsSync(candidate.worktreePath),
+        error: result.code !== 0 && fs48.existsSync(candidate.worktreePath) ? result.stderr : void 0
       });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       try {
-        if (fs47.existsSync(candidate.worktreePath)) {
-          fs47.rmSync(candidate.worktreePath, { recursive: true, force: true });
+        if (fs48.existsSync(candidate.worktreePath)) {
+          fs48.rmSync(candidate.worktreePath, { recursive: true, force: true });
         }
       } catch {
       }
       outcomes.push({
         path: candidate.worktreePath,
         agentId: candidate.agentId,
-        deleted: !fs47.existsSync(candidate.worktreePath),
+        deleted: !fs48.existsSync(candidate.worktreePath),
         error: message
       });
     }
@@ -81907,16 +82281,16 @@ init_control_config();
 init_control_registry();
 
 // src/core/harness-scrub.ts
-var fs48 = __toESM(require("fs"));
-var path55 = __toESM(require("path"));
+var fs49 = __toESM(require("fs"));
+var path56 = __toESM(require("path"));
 var HARNESS_SCRUB_DIRS = ["runs", "validations", "state", "slots"];
 function scrubLocalHarnessDirs(repoPath) {
   const results = [];
-  const resolved = path55.resolve(repoPath);
-  if (!fs48.existsSync(resolved)) {
+  const resolved = path56.resolve(repoPath);
+  if (!fs49.existsSync(resolved)) {
     for (const directory of HARNESS_SCRUB_DIRS) {
       results.push({
-        path: path55.join(resolved, ".har", directory),
+        path: path56.join(resolved, ".har", directory),
         directory,
         deleted: false,
         error: "repository path does not exist"
@@ -81925,24 +82299,24 @@ function scrubLocalHarnessDirs(repoPath) {
     return results;
   }
   for (const directory of HARNESS_SCRUB_DIRS) {
-    const target = path55.join(resolved, ".har", directory);
-    if (!fs48.existsSync(target)) {
+    const target = path56.join(resolved, ".har", directory);
+    if (!fs49.existsSync(target)) {
       results.push({ path: target, directory, deleted: true });
       continue;
     }
     try {
-      fs48.rmSync(target, { recursive: true, force: true });
+      fs49.rmSync(target, { recursive: true, force: true });
       results.push({
         path: target,
         directory,
-        deleted: !fs48.existsSync(target),
-        error: fs48.existsSync(target) ? "failed to remove directory" : void 0
+        deleted: !fs49.existsSync(target),
+        error: fs49.existsSync(target) ? "failed to remove directory" : void 0
       });
     } catch (err) {
       results.push({
         path: target,
         directory,
-        deleted: !fs48.existsSync(target),
+        deleted: !fs49.existsSync(target),
         error: err instanceof Error ? err.message : String(err)
       });
     }
@@ -81953,7 +82327,7 @@ function scrubLocalHarnessForRepos(repoPaths) {
   const results = [];
   const seen = /* @__PURE__ */ new Set();
   for (const repoPath of repoPaths) {
-    const key = path55.resolve(repoPath);
+    const key = path56.resolve(repoPath);
     if (seen.has(key)) continue;
     seen.add(key);
     results.push(...scrubLocalHarnessDirs(key));
@@ -81962,10 +82336,10 @@ function scrubLocalHarnessForRepos(repoPaths) {
 }
 
 // src/core/control-reset.ts
-async function askYesNo7(question) {
+async function askYesNo8(question) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
-  const readline10 = await import("readline");
-  const rl = readline10.createInterface({ input: process.stdin, output: process.stderr });
+  const readline11 = await import("readline");
+  const rl = readline11.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise((resolve47) => {
     rl.question(question, resolve47);
   });
@@ -81977,7 +82351,7 @@ async function confirmControlReset(options) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("Non-interactive terminal \u2014 pass --yes");
   }
-  return askYesNo7(
+  return askYesNo8(
     `Clear Mission Control data for ${options.repoCount} registered repositor${options.repoCount === 1 ? "y" : "ies"} (and scrub local .har history)? [y/N] `
   );
 }
@@ -82209,7 +82583,7 @@ async function handleDown() {
   return finishCommand(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path56.resolve(argv.repo);
+  const repoPath = path57.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -82301,7 +82675,7 @@ async function handleReset(argv) {
   }
 }
 async function handleUnregister(argv) {
-  const repoPath = path56.resolve(argv.repo);
+  const repoPath = path57.resolve(argv.repo);
   const worktrees = listUnregisterWorktreeCandidates(repoPath);
   try {
     let deleteWorktrees = argv.deleteWorktrees;
@@ -82480,11 +82854,11 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path58 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 
 // src/core/claude-hooks.ts
-var fs49 = __toESM(require("fs"));
-var path57 = __toESM(require("path"));
+var fs50 = __toESM(require("fs"));
+var path58 = __toESM(require("path"));
 var CLAUDE_GUARD_RELATIVE_PATH = ".har/hooks/claude-worktree-guard.sh";
 var CLAUDE_SETTINGS_RELATIVE_PATH = ".claude/settings.json";
 var GUARD_MATCHER = "Edit|Write|MultiEdit|NotebookEdit";
@@ -82495,8 +82869,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs49.existsSync(settingsPath)) return {};
-  const raw = fs49.readFileSync(settingsPath, "utf8").trim();
+  if (!fs50.existsSync(settingsPath)) return {};
+  const raw = fs50.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -82505,19 +82879,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs49.mkdirSync(path57.dirname(settingsPath), { recursive: true });
-  fs49.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs50.mkdirSync(path58.dirname(settingsPath), { recursive: true });
+  fs50.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
 }
 function installClaudeGuard(repoPath) {
   const templatePath = resolveTemplateFile("claude-worktree-guard.sh.template");
   if (!templatePath) {
     throw new Error("Guard template not found (claude-worktree-guard.sh.template). Run npm run build.");
   }
-  const guardScript = path57.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs49.mkdirSync(path57.dirname(guardScript), { recursive: true });
-  fs49.copyFileSync(templatePath, guardScript);
-  fs49.chmodSync(guardScript, 493);
-  const settingsPath = path57.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path58.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs50.mkdirSync(path58.dirname(guardScript), { recursive: true });
+  fs50.copyFileSync(templatePath, guardScript);
+  fs50.chmodSync(guardScript, 493);
+  const settingsPath = path58.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -82531,15 +82905,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path57.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs49.existsSync(guardScript)) {
-    fs49.rmSync(guardScript);
+  const guardScript = path58.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs50.existsSync(guardScript)) {
+    fs50.rmSync(guardScript);
     removed = true;
-    const parent = path57.dirname(guardScript);
-    if (fs49.existsSync(parent) && fs49.readdirSync(parent).length === 0) fs49.rmdirSync(parent);
+    const parent = path58.dirname(guardScript);
+    if (fs50.existsSync(parent) && fs50.readdirSync(parent).length === 0) fs50.rmdirSync(parent);
   }
-  const settingsPath = path57.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs49.existsSync(settingsPath)) {
+  const settingsPath = path58.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs50.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -82564,8 +82938,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path57.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs49.existsSync(settingsPath)) return false;
+  const settingsPath = path58.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs50.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -82582,7 +82956,7 @@ function repoOption(y2) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path58.resolve(argv.repo));
+      const result2 = installClaudeGuard(path59.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -82590,7 +82964,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path58.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path59.resolve(argv.repo), force: argv.force });
     success(`Commit gate installed in ${result.hooksDir}`);
     info(`pre-commit: ${result.preCommit}, post-commit: ${result.postCommit}`);
     info("Commits of unverified change batches will be blocked in agent worktrees.");
@@ -82603,7 +82977,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path58.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path59.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -82611,7 +82985,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path58.resolve(argv.repo));
+    const result = uninstallHooks(path59.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -82624,7 +82998,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path58.resolve(argv.repo));
+    const status = getHooksStatus(path59.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -82642,7 +83016,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path58.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path59.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -82903,10 +83277,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path63) {
-  if (!path63)
+function getElementAtPath(obj, path64) {
+  if (!path64)
     return obj;
-  return path63.reduce((acc, key) => acc?.[key], obj);
+  return path64.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -83226,11 +83600,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path63, issues) {
+function prefixIssues(path64, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path63);
+    iss.path.unshift(path64);
     return iss;
   });
 }
@@ -89704,7 +90078,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path59 = __toESM(require("path"));
+var path60 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process3 = __toESM(require("node:process"), 1);
@@ -90345,7 +90719,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path59.resolve(input.repo)
+        cwd: path60.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -90409,11 +90783,11 @@ var mcpCommand = {
 };
 
 // src/cli/commands/onboard.ts
-var path61 = __toESM(require("path"));
+var path62 = __toESM(require("path"));
 init_stages();
 
 // src/core/onboarding.ts
-var path60 = __toESM(require("path"));
+var path61 = __toESM(require("path"));
 init_control_config();
 init_control_sync();
 init_otel_hooks();
@@ -90548,7 +90922,7 @@ async function defaultEnsureControl(options) {
   return { started: true, apiUrl: result.apiUrl };
 }
 async function runOnboarding(options, deps = {}) {
-  const repoPath = path60.resolve(options.repoPath);
+  const repoPath = path61.resolve(options.repoPath);
   const applyTelemetry = deps.applyTelemetry ?? applyOnboardingTelemetry;
   const ensureControl = deps.ensureControl ?? defaultEnsureControl;
   const init = deps.initHarness ?? initHarness;
@@ -90737,7 +91111,7 @@ async function promptChoices(args) {
     };
   }
   const pluginChoices = listPluginChoices();
-  const repoPath = path61.resolve(args.repo);
+  const repoPath = path62.resolve(args.repo);
   const alreadyPresent = harnessExists(repoPath);
   const needProfile = !alreadyPresent && !args.skipInit && args.profile === void 0;
   const needAgentSlots = shouldConfigureSlots && flaggedSlots === void 0;
@@ -90854,7 +91228,7 @@ function printSummary(result) {
   console.error("");
 }
 async function handleOnboard(argv) {
-  const repoPath = path61.resolve(argv.repo);
+  const repoPath = path62.resolve(argv.repo);
   header("har onboard");
   info(`Repository: ${repoPath}`);
   try {
@@ -90884,18 +91258,13 @@ async function handleOnboard(argv) {
         ...onboarding.commitGate,
         autoYes: argv.yes
       });
-      await handleCursorRule({
+      await applyAgentIntegrations({
         repoPath,
-        cursorRule: onboarding.cursorRule,
-        autoYes: argv.yes,
-        mode: result.harnessInitialized ? "init" : "maintain"
-      });
-      await handleAgentSkills({
-        repoPath,
-        ...onboarding.agentSkills,
+        mode: result.harnessInitialized ? "init" : "maintain",
         autoYes: argv.yes,
         force: argv.force,
-        mode: result.harnessInitialized ? "init" : "maintain"
+        cursorRule: onboarding.cursorRule,
+        ...onboarding.agentSkills
       });
     }
     if (harnessExists(repoPath)) {
@@ -91090,7 +91459,7 @@ var preferencesCommand = {
 };
 
 // src/cli/commands/telemetry.ts
-var path62 = __toESM(require("path"));
+var path63 = __toESM(require("path"));
 init_control_config();
 init_control_sync();
 init_manifest();
@@ -91183,7 +91552,7 @@ async function handleOff() {
   info("Mission Control will not auto-start. Existing usage rows are kept.");
 }
 async function handleWriteEnv(argv) {
-  const repoPath = path62.resolve(argv.repo);
+  const repoPath = path63.resolve(argv.repo);
   const harnessRoot = resolveHarnessRoot(repoPath);
   const session = readSlotRegistry(harnessRoot, argv.agentId);
   const workDir = argv.workDir ?? session?.workDir ?? repoPath;
@@ -91195,7 +91564,7 @@ async function handleWriteEnv(argv) {
     suffix,
     createdAt: session?.createdAt
   });
-  const envFile = argv.envFile ?? path62.join(workDir, `.env.agent.${argv.agentId}`);
+  const envFile = argv.envFile ?? path63.join(workDir, `.env.agent.${argv.agentId}`);
   const attrs = {
     sessionKey,
     agentId: argv.agentId,
@@ -91211,7 +91580,7 @@ async function handleWriteEnv(argv) {
   success(`Wrote session attribution to ${envFile}`);
 }
 function handlePrintEnv(argv) {
-  const repoPath = path62.resolve(argv.repo);
+  const repoPath = path63.resolve(argv.repo);
   const workDir = argv.workDir ?? repoPath;
   const sessionKey = buildSessionKey({
     branch: argv.branch,