@osfactory/har 0.9.0 → 0.11.0

package/dist/index.js

@@ -765,14 +765,14 @@ var require_url_state_machine = __commonJS({
       return url.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url) {
-      const path37 = url.path;
-      if (path37.length === 0) {
+      const path41 = url.path;
+      if (path41.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path37.length === 1 && isNormalizedWindowsDriveLetter(path37[0])) {
+      if (url.scheme === "file" && path41.length === 1 && isNormalizedWindowsDriveLetter(path41[0])) {
         return;
       }
-      path37.pop();
+      path41.pop();
     }
     function includesCredentials(url) {
       return url.username !== "" || url.password !== "";
@@ -2092,7 +2092,7 @@ var require_lib2 = __commonJS({
       let accum = [];
       let accumBytes = 0;
       let abort = false;
-      return new Body.Promise(function(resolve26, reject) {
+      return new Body.Promise(function(resolve28, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2126,7 +2126,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve26(Buffer.concat(accum, accumBytes));
+            resolve28(Buffer.concat(accum, accumBytes));
           } catch (err) {
             reject(new FetchError(`Could not create Buffer from response body for ${_this4.url}: ${err.message}`, "system", err));
           }
@@ -2801,7 +2801,7 @@ var require_lib2 = __commonJS({
         throw new Error("native promise missing, set fetch.Promise to your favorite alternative");
       }
       Body.Promise = fetch3.Promise;
-      return new fetch3.Promise(function(resolve26, reject) {
+      return new fetch3.Promise(function(resolve28, reject) {
         const request = new Request3(url, opts);
         const options = getNodeRequestOptions(request);
         const send = (options.protocol === "https:" ? https : http).request;
@@ -2934,7 +2934,7 @@ var require_lib2 = __commonJS({
                   requestOpts.body = void 0;
                   requestOpts.headers.delete("content-length");
                 }
-                resolve26(fetch3(new Request3(locationURL, requestOpts)));
+                resolve28(fetch3(new Request3(locationURL, requestOpts)));
                 finalize();
                 return;
             }
@@ -2955,7 +2955,7 @@ var require_lib2 = __commonJS({
           const codings = headers.get("Content-Encoding");
           if (!request.compress || request.method === "HEAD" || codings === null || res.statusCode === 204 || res.statusCode === 304) {
             response = new Response3(body, response_options);
-            resolve26(response);
+            resolve28(response);
             return;
           }
           const zlibOptions = {
@@ -2965,7 +2965,7 @@ var require_lib2 = __commonJS({
           if (codings == "gzip" || codings == "x-gzip") {
             body = body.pipe(zlib.createGunzip(zlibOptions));
             response = new Response3(body, response_options);
-            resolve26(response);
+            resolve28(response);
             return;
           }
           if (codings == "deflate" || codings == "x-deflate") {
@@ -2977,12 +2977,12 @@ var require_lib2 = __commonJS({
                 body = body.pipe(zlib.createInflateRaw());
               }
               response = new Response3(body, response_options);
-              resolve26(response);
+              resolve28(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve26(response);
+                resolve28(response);
               }
             });
             return;
@@ -2990,11 +2990,11 @@ var require_lib2 = __commonJS({
           if (codings == "br" && typeof zlib.createBrotliDecompress === "function") {
             body = body.pipe(zlib.createBrotliDecompress());
             response = new Response3(body, response_options);
-            resolve26(response);
+            resolve28(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve26(response);
+          resolve28(response);
         });
         writeToStream(req, request);
       });
@@ -6351,14 +6351,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path37, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path41, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path37, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path41, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6367,13 +6367,13 @@ function createFileFromPath(path37, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path37, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path37);
-  return createFileFromPath(path37, stats, filenameOrOptions, options);
+function fileFromPathSync(path41, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path41);
+  return createFileFromPath(path41, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path37, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path37);
-  return createFileFromPath(path37, stats, filenameOrOptions, options);
+async function fileFromPath2(path41, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path41);
+  return createFileFromPath(path41, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -9384,7 +9384,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve26.call(this, root, ref);
+      let _sch = resolve28.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -9411,7 +9411,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve26(root, ref) {
+    function resolve28(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -9629,8 +9629,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path37) {
-      let input = path37;
+    function removeDotSegments(path41) {
+      let input = path41;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -9882,8 +9882,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path37, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path37 && path37 !== "/" ? path37 : void 0;
+        const [path41, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path41 && path41 !== "/" ? path41 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10042,7 +10042,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve26(baseURI, relativeURI, options) {
+    function resolve28(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -10300,7 +10300,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve26,
+      resolve: resolve28,
       resolveComponent,
       equal,
       serialize,
@@ -13276,12 +13276,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs32, exportName) {
+    function addFormats(ajv, list, fs35, 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, fs32[f2]);
+        ajv.addFormat(f2, fs35[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -14565,11 +14565,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: (path37) => {
+  require: (path41) => {
     if (typeof require !== "undefined") {
-      return require(path37);
-    } else if (path37.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path37, "utf8"));
+      return require(path41);
+    } else if (path41.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path41, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -17095,12 +17095,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve26, reject) => {
+      return new Promise((resolve28, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve26(completions);
+            resolve28(completions);
         });
       });
     } else {
@@ -18158,17 +18158,15 @@ function getHarPackageVersion() {
   throw new Error("Could not resolve @osfactory/har package.json for version lookup");
 }
 
-// src/cli/commands/env.ts
-var path31 = __toESM(require("path"));
-
-// src/core/harness.ts
-var fs18 = __toESM(require("fs"));
-var path16 = __toESM(require("path"));
-
-// src/harness/generator.ts
-var fs6 = __toESM(require("fs"));
+// src/cli/commands/agents.ts
 var path6 = __toESM(require("path"));
 
+// src/harness/agent-skills.ts
+var fs5 = __toESM(require("fs"));
+var os2 = __toESM(require("os"));
+var path5 = __toESM(require("path"));
+var readline = __toESM(require("readline"));
+
 // src/utils/file-ops.ts
 var fs2 = __toESM(require("fs"));
 var path2 = __toESM(require("path"));
@@ -18769,31 +18767,10 @@ function resolveTemplateFile(name) {
   return fs3.existsSync(filePath) ? filePath : null;
 }
 
-// src/core/gitignore.ts
-var fs4 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
-var HARNESS_ROOT_GITIGNORE_PATTERNS = [
-  ".env.agent.*",
-  "ecosystem.agent.*.config.cjs"
-];
-function ensureRootGitignorePatterns(checkoutDir) {
-  const gitignorePath = path4.join(checkoutDir, ".gitignore");
-  const content = fs4.existsSync(gitignorePath) ? fs4.readFileSync(gitignorePath, "utf8") : "";
-  const lines = content.split("\n").map((line) => line.trim());
-  const missing = HARNESS_ROOT_GITIGNORE_PATTERNS.filter((pattern) => !lines.includes(pattern));
-  if (missing.length === 0) return;
-  const header2 = lines.length === 0 || content.trim().length === 0 ? "# HAR agent slot artifacts (generated by .har/launch.sh)\n" : "";
-  const suffix = content.length === 0 || content.endsWith("\n") ? "" : "\n";
-  const block = lines.some((line) => line.includes("HAR agent slot artifacts")) || header2.length === 0 ? `${missing.join("\n")}
-` : `${header2}${missing.join("\n")}
-`;
-  fs4.writeFileSync(gitignorePath, `${content}${suffix}${block}`);
-}
-
 // src/harness/manifest.ts
 var crypto = __toESM(require("crypto"));
-var fs5 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
+var fs4 = __toESM(require("fs"));
+var path4 = __toESM(require("path"));
 
 // node_modules/zod/v3/external.js
 var external_exports = {};
@@ -19273,8 +19250,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path37, errorMaps, issueData } = params;
-  const fullPath = [...path37, ...issueData.path || []];
+  const { data, path: path41, errorMaps, issueData } = params;
+  const fullPath = [...path41, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -19390,11 +19367,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path37, key) {
+  constructor(parent, value, path41, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path37;
+    this._path = path41;
     this._key = key;
   }
   get path() {
@@ -22848,6 +22825,15 @@ var HAR_STAGE_KINDS = [
   "custom"
 ];
 var HAR_AGENT_SLOT_MIN = 1;
+var AgentSkillTargetSchema = external_exports.enum(["claude", "cursor", "codex"]);
+var ScaffoldedAgentFileSchema = external_exports.object({
+  /** Repo-relative path, or '~/…' when scope is 'global'. */
+  path: external_exports.string(),
+  agent: AgentSkillTargetSchema,
+  skill: external_exports.string(),
+  checksum: external_exports.string(),
+  scope: external_exports.enum(["repo", "global"]).default("repo")
+});
 var HarnessManifestSchema = external_exports.object({
   version: external_exports.string(),
   generatorVersion: external_exports.string(),
@@ -22861,7 +22847,8 @@ var HarnessManifestSchema = external_exports.object({
   }).optional(),
   adaptationSummary: external_exports.string().optional(),
   profile: external_exports.enum(["default", "cli", "ios"]).optional(),
-  fileChecksums: external_exports.record(external_exports.string()).optional()
+  fileChecksums: external_exports.record(external_exports.string()).optional(),
+  scaffoldedAgentFiles: external_exports.array(ScaffoldedAgentFileSchema).optional()
 });
 var HarnessStageKindSchema = external_exports.enum(HAR_STAGE_KINDS);
 var HarnessArtifactKindSchema = external_exports.enum([
@@ -23131,15 +23118,15 @@ var CHECKSUM_SKIP = /* @__PURE__ */ new Set([
   "ADAPT-PROMPT.md"
 ]);
 function getHarnessDir(repoPath) {
-  return path5.join(repoPath, DEFAULT_HAR_DIR);
+  return path4.join(repoPath, DEFAULT_HAR_DIR);
 }
 function getManifestPath(repoPath) {
-  return path5.join(getHarnessDir(repoPath), "manifest.json");
+  return path4.join(getHarnessDir(repoPath), "manifest.json");
 }
 function readManifest(repoPath) {
   const manifestPath = getManifestPath(repoPath);
-  if (!fs5.existsSync(manifestPath)) return null;
-  const raw = JSON.parse(fs5.readFileSync(manifestPath, "utf8"));
+  if (!fs4.existsSync(manifestPath)) return null;
+  const raw = JSON.parse(fs4.readFileSync(manifestPath, "utf8"));
   const result = HarnessManifestSchema.safeParse(raw);
   return result.success ? result.data : null;
 }
@@ -23152,11 +23139,11 @@ function computeFileChecksum(content) {
 }
 function computeHarnessChecksums(harnessDir) {
   const checksums = {};
-  if (!fs5.existsSync(harnessDir)) return checksums;
-  for (const entry of fs5.readdirSync(harnessDir, { withFileTypes: true })) {
+  if (!fs4.existsSync(harnessDir)) return checksums;
+  for (const entry of fs4.readdirSync(harnessDir, { withFileTypes: true })) {
     if (!entry.isFile() || CHECKSUM_SKIP.has(entry.name)) continue;
-    const full = path5.join(harnessDir, entry.name);
-    checksums[entry.name] = computeFileChecksum(fs5.readFileSync(full, "utf8"));
+    const full = path4.join(harnessDir, entry.name);
+    checksums[entry.name] = computeFileChecksum(fs4.readFileSync(full, "utf8"));
   }
   return checksums;
 }
@@ -23176,17 +23163,331 @@ function createManifest(repoPath, adaptationSummary, stack, profile) {
   };
 }
 function resolveHarnessRoot(inputPath) {
-  let current = path5.resolve(inputPath);
-  const { root } = path5.parse(current);
+  let current = path4.resolve(inputPath);
+  const { root } = path4.parse(current);
   for (; ; ) {
-    const manifestPath = path5.join(current, DEFAULT_HAR_DIR, "manifest.json");
-    if (fs5.existsSync(manifestPath)) {
+    const manifestPath = path4.join(current, DEFAULT_HAR_DIR, "manifest.json");
+    if (fs4.existsSync(manifestPath)) {
       return current;
     }
     if (current === root) break;
-    current = path5.dirname(current);
+    current = path4.dirname(current);
+  }
+  return path4.resolve(inputPath);
+}
+
+// src/harness/agent-skills.ts
+var AGENT_SKILL_TARGETS = ["claude", "cursor", "codex"];
+var MANAGED_HEADER = "<!-- managed by har \u2014 regenerated by `har agents install` / `har env maintain`; edit at your own risk -->";
+function agentSkillsTemplateDir() {
+  const dir = path5.join(resolveTemplatesDir(), "agent-skills");
+  if (!fs5.existsSync(dir)) {
+    throw new Error("Agent skills templates not found (templates/agent-skills). Run npm run build.");
   }
-  return path5.resolve(inputPath);
+  return dir;
+}
+function readSkillsManifest() {
+  const manifestPath = path5.join(agentSkillsTemplateDir(), "skills.manifest.json");
+  return JSON.parse(fs5.readFileSync(manifestPath, "utf8"));
+}
+function readSkillBody(entry) {
+  return fs5.readFileSync(path5.join(agentSkillsTemplateDir(), entry.body), "utf8");
+}
+function renderYamlValue(value) {
+  if (typeof value === "string") return JSON.stringify(value);
+  return String(value);
+}
+function renderClaudeSkill(entry, body) {
+  const frontmatter = entry.claude?.frontmatter ?? { name: entry.id, description: entry.title };
+  const lines = Object.entries(frontmatter).map(([key, value]) => `${key}: ${renderYamlValue(value)}`);
+  return `---
+${lines.join("\n")}
+---
+
+${MANAGED_HEADER}
+
+${body}`;
+}
+function renderPlainSkill(body) {
+  return `${MANAGED_HEADER}
+
+${body}`;
+}
+function renderSkillFiles(agents) {
+  const manifest = readSkillsManifest();
+  const files = [];
+  for (const entry of manifest.skills) {
+    const body = readSkillBody(entry);
+    if (agents.includes("claude")) {
+      files.push({
+        agent: "claude",
+        skill: entry.id,
+        scope: "repo",
+        relPath: path5.join(".claude", "skills", entry.id, "SKILL.md"),
+        content: renderClaudeSkill(entry, body)
+      });
+    }
+    if (agents.includes("cursor") && entry.cursor?.command) {
+      files.push({
+        agent: "cursor",
+        skill: entry.id,
+        scope: "repo",
+        relPath: path5.join(".cursor", "commands", `${entry.id}.md`),
+        content: renderPlainSkill(body)
+      });
+    }
+    if (agents.includes("codex") && entry.codex?.promptName) {
+      files.push({
+        agent: "codex",
+        skill: entry.id,
+        scope: "global",
+        relPath: path5.posix.join("~", ".codex", "prompts", `${entry.codex.promptName}.md`),
+        content: renderPlainSkill(body)
+      });
+    }
+  }
+  return files;
+}
+function resolveScaffoldPath(repoPath, file) {
+  if (file.scope === "global") {
+    return path5.join(os2.homedir(), file.relPath.replace(/^~\//, ""));
+  }
+  return path5.join(repoPath, file.relPath);
+}
+function isHarManaged(filePath) {
+  return fs5.readFileSync(filePath, "utf8").includes(MANAGED_HEADER);
+}
+function scaffoldAgentSkills(repoPath, agents, options = {}) {
+  const written = [];
+  const skipped = [];
+  const records = [];
+  for (const file of renderSkillFiles(agents)) {
+    const destPath = resolveScaffoldPath(repoPath, file);
+    if (fs5.existsSync(destPath) && !options.force && !isHarManaged(destPath)) {
+      warn(`Skipped ${file.relPath} \u2014 exists with user modifications (use --force to overwrite)`);
+      skipped.push(file.relPath);
+      continue;
+    }
+    writeFileSafe(destPath, file.content);
+    written.push(file.relPath);
+    records.push({
+      path: file.relPath,
+      agent: file.agent,
+      skill: file.skill,
+      checksum: computeFileChecksum(file.content),
+      scope: file.scope
+    });
+  }
+  recordScaffoldedFiles(repoPath, agents, records);
+  return { written, skipped };
+}
+function recordScaffoldedFiles(repoPath, agents, records) {
+  const manifest = readManifest(repoPath);
+  if (!manifest) return;
+  const kept = (manifest.scaffoldedAgentFiles ?? []).filter(
+    (entry) => !agents.includes(entry.agent)
+  );
+  writeManifest(repoPath, {
+    ...manifest,
+    scaffoldedAgentFiles: [...kept, ...records],
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+function removeAgentSkills(repoPath, agents) {
+  const removed = [];
+  for (const file of renderSkillFiles(agents)) {
+    const destPath = resolveScaffoldPath(repoPath, file);
+    if (!fs5.existsSync(destPath)) continue;
+    if (!isHarManaged(destPath)) {
+      warn(`Kept ${file.relPath} \u2014 has user modifications`);
+      continue;
+    }
+    fs5.rmSync(destPath);
+    removed.push(file.relPath);
+    const parent = path5.dirname(destPath);
+    if (fs5.existsSync(parent) && fs5.readdirSync(parent).length === 0) {
+      fs5.rmdirSync(parent);
+    }
+  }
+  const manifest = readManifest(repoPath);
+  if (manifest?.scaffoldedAgentFiles) {
+    writeManifest(repoPath, {
+      ...manifest,
+      scaffoldedAgentFiles: manifest.scaffoldedAgentFiles.filter(
+        (entry) => !agents.includes(entry.agent)
+      ),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  return removed;
+}
+function detectAgentTargets(repoPath) {
+  const manifest = readManifest(repoPath);
+  const scaffolded = new Set((manifest?.scaffoldedAgentFiles ?? []).map((entry) => entry.agent));
+  const detected = new Set(scaffolded);
+  if (fs5.existsSync(path5.join(repoPath, ".claude"))) detected.add("claude");
+  if (fs5.existsSync(path5.join(repoPath, ".cursor"))) detected.add("cursor");
+  if (fs5.existsSync(path5.join(os2.homedir(), ".codex"))) detected.add("codex");
+  return AGENT_SKILL_TARGETS.filter((agent) => detected.has(agent));
+}
+function parseAgentTargets(raw) {
+  const parts = raw.split(",").map((part) => part.trim().toLowerCase()).filter(Boolean);
+  const invalid = parts.filter((part) => !AGENT_SKILL_TARGETS.includes(part));
+  if (invalid.length > 0) {
+    throw new Error(
+      `Unknown agent target(s): ${invalid.join(", ")}. Valid: ${AGENT_SKILL_TARGETS.join(", ")}`
+    );
+  }
+  return AGENT_SKILL_TARGETS.filter((agent) => parts.includes(agent));
+}
+async function handleAgentSkills(options) {
+  const { repoPath, mode } = options;
+  if (options.enabled === false) return false;
+  let targets;
+  if (options.agents !== void 0) {
+    targets = parseAgentTargets(options.agents);
+  } else {
+    targets = detectAgentTargets(repoPath);
+    if (targets.length === 0) return false;
+    const manifest = readManifest(repoPath);
+    const alreadyScaffolded = (manifest?.scaffoldedAgentFiles ?? []).length > 0;
+    const shouldPrompt = !options.autoYes && !(mode === "maintain" && alreadyScaffolded);
+    if (shouldPrompt) {
+      const accepted = await askYesNo(
+        `Scaffold agent skills (/setup-har, /har-wt, /har-maintain) for: ${targets.join(", ")}? [Y/n]`
+      );
+      if (!accepted) {
+        info("Skipped agent skills");
+        return false;
+      }
+    }
+  }
+  if (targets.length === 0) return false;
+  const result = scaffoldAgentSkills(repoPath, targets, { force: options.force });
+  for (const file of result.written) {
+    info(`${mode === "maintain" ? "Refreshed" : "Wrote"} ${file}`);
+  }
+  return result.written.length > 0;
+}
+async function askYesNo(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve28) => {
+    process.stderr.write(`${question} `);
+    rl.once("line", (answer) => {
+      rl.close();
+      const trimmed = answer.trim();
+      if (trimmed === "") {
+        resolve28(true);
+        return;
+      }
+      resolve28(/^y(es)?$/i.test(trimmed));
+    });
+  });
+}
+
+// src/cli/commands/agents.ts
+var targetsOption = (y2) => y2.option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("claude", { type: "boolean", default: false, describe: "Target Claude Code (.claude/skills/)" }).option("cursor", { type: "boolean", default: false, describe: "Target Cursor (.cursor/commands/)" }).option("codex", { type: "boolean", default: false, describe: "Target Codex CLI (~/.codex/prompts/, global)" }).option("agents", {
+  type: "string",
+  describe: `Comma-separated targets (${AGENT_SKILL_TARGETS.join(",")}); alternative to the per-agent flags`
+});
+function resolveTargets(argv, repoPath) {
+  if (argv.agents) return parseAgentTargets(argv.agents);
+  const flagged = AGENT_SKILL_TARGETS.filter((agent) => argv[agent]);
+  if (flagged.length > 0) return flagged;
+  return detectAgentTargets(repoPath);
+}
+var agentsCommand = {
+  command: "agents <subcommand>",
+  describe: "Manage scaffolded agent skills (/setup-har, /har-wt, /har-maintain)",
+  builder: (yargs) => yargs.command(
+    "install",
+    "Scaffold agent skills into this repo (Claude/Cursor) and globally (Codex)",
+    (y2) => targetsOption(y2).option("force", {
+      type: "boolean",
+      default: false,
+      describe: "Overwrite files that have user modifications"
+    }),
+    handleInstall
+  ).command("remove", "Remove har-managed agent skill files", targetsOption, handleRemove).demandCommand(1, "Specify a subcommand: install | remove"),
+  handler: () => {
+  }
+};
+function handleInstall(argv) {
+  const repoPath = path6.resolve(argv.repo);
+  header("har agents install");
+  try {
+    const targets = resolveTargets(argv, repoPath);
+    if (targets.length === 0) {
+      warn("No agent targets detected. Pass --claude, --cursor, --codex, or --agents=\u2026");
+      process.exit(1);
+    }
+    const result = scaffoldAgentSkills(repoPath, targets, { force: argv.force });
+    for (const file of result.written) {
+      info(`  + ${file}`);
+    }
+    if (result.written.length === 0 && result.skipped.length > 0) {
+      warn("Nothing written \u2014 all target files have user modifications (use --force).");
+      process.exit(1);
+    }
+    success(`Agent skills installed for: ${targets.join(", ")}`);
+    if (targets.includes("codex")) {
+      info("Codex prompts are global (~/.codex/prompts/) \u2014 Codex has no per-repo prompt support.");
+    }
+  } catch (err) {
+    error(err.message);
+    process.exit(1);
+  }
+}
+function handleRemove(argv) {
+  const repoPath = path6.resolve(argv.repo);
+  header("har agents remove");
+  try {
+    const targets = resolveTargets(argv, repoPath);
+    if (targets.length === 0) {
+      warn("No agent targets detected or specified.");
+      return;
+    }
+    const removed = removeAgentSkills(repoPath, targets);
+    for (const file of removed) {
+      info(`  - ${file}`);
+    }
+    success(removed.length > 0 ? "Agent skills removed." : "Nothing to remove.");
+  } catch (err) {
+    error(err.message);
+    process.exit(1);
+  }
+}
+
+// src/cli/commands/env.ts
+var path34 = __toESM(require("path"));
+
+// src/core/harness.ts
+var fs19 = __toESM(require("fs"));
+var path18 = __toESM(require("path"));
+
+// src/harness/generator.ts
+var fs7 = __toESM(require("fs"));
+var path8 = __toESM(require("path"));
+
+// src/core/gitignore.ts
+var fs6 = __toESM(require("fs"));
+var path7 = __toESM(require("path"));
+var HARNESS_ROOT_GITIGNORE_PATTERNS = [
+  ".env.agent.*",
+  "ecosystem.agent.*.config.cjs"
+];
+function ensureRootGitignorePatterns(checkoutDir) {
+  const gitignorePath = path7.join(checkoutDir, ".gitignore");
+  const content = fs6.existsSync(gitignorePath) ? fs6.readFileSync(gitignorePath, "utf8") : "";
+  const lines = content.split("\n").map((line) => line.trim());
+  const missing = HARNESS_ROOT_GITIGNORE_PATTERNS.filter((pattern) => !lines.includes(pattern));
+  if (missing.length === 0) return;
+  const header2 = lines.length === 0 || content.trim().length === 0 ? "# HAR agent slot artifacts (generated by .har/launch.sh)\n" : "";
+  const suffix = content.length === 0 || content.endsWith("\n") ? "" : "\n";
+  const block = lines.some((line) => line.includes("HAR agent slot artifacts")) || header2.length === 0 ? `${missing.join("\n")}
+` : `${header2}${missing.join("\n")}
+`;
+  fs6.writeFileSync(gitignorePath, `${content}${suffix}${block}`);
 }
 
 // src/harness/generator.ts
@@ -23202,46 +23503,46 @@ var CLI_PRUNE_FILES = [
 ];
 function pruneCliProfile(harnessDir) {
   for (const file of CLI_PRUNE_FILES) {
-    const filePath = path6.join(harnessDir, file);
-    if (fs6.existsSync(filePath)) {
-      fs6.unlinkSync(filePath);
+    const filePath = path8.join(harnessDir, file);
+    if (fs7.existsSync(filePath)) {
+      fs7.unlinkSync(filePath);
     }
   }
 }
 function scaffoldClaudeMd(repoPath, projectName, force) {
   const templatePath = resolveTemplateFile("CLAUDE.md.template");
   if (!templatePath) return;
-  const dest = path6.join(repoPath, "CLAUDE.md");
-  if (fs6.existsSync(dest) && !force) return;
+  const dest = path8.join(repoPath, "CLAUDE.md");
+  if (fs7.existsSync(dest) && !force) return;
   const displayName = projectName.replace(/_/g, " ");
-  const content = fs6.readFileSync(templatePath, "utf8").replace(/__PROJECT_DISPLAY_NAME__/g, displayName);
-  fs6.writeFileSync(dest, content);
+  const content = fs7.readFileSync(templatePath, "utf8").replace(/__PROJECT_DISPLAY_NAME__/g, displayName);
+  fs7.writeFileSync(dest, content);
 }
 function scaffoldHarnessBoilerplate(repoPath, options = {}) {
-  const harnessDir = path6.join(repoPath, DEFAULT_HAR_DIR);
-  const projectName = path6.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
+  const harnessDir = path8.join(repoPath, DEFAULT_HAR_DIR);
+  const projectName = path8.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
   const profile = options.profile ?? "default";
-  const boilerplateDir = path6.join(resolveTemplatesDir(), PROFILE_DIRS[profile]);
-  if (fs6.existsSync(harnessDir) && !options.force) {
+  const boilerplateDir = path8.join(resolveTemplatesDir(), PROFILE_DIRS[profile]);
+  if (fs7.existsSync(harnessDir) && !options.force) {
     throw new Error(
       '.har/ already exists. Use --force to overwrite or run "har env maintain" to update in place.'
     );
   }
-  if (!fs6.existsSync(boilerplateDir)) {
+  if (!fs7.existsSync(boilerplateDir)) {
     throw new Error(`Boilerplate template not found at ${boilerplateDir}`);
   }
-  if (options.force && fs6.existsSync(harnessDir)) {
-    fs6.rmSync(harnessDir, { recursive: true, force: true });
+  if (options.force && fs7.existsSync(harnessDir)) {
+    fs7.rmSync(harnessDir, { recursive: true, force: true });
   }
   copyDirRecursive(boilerplateDir, harnessDir);
   if (profile === "cli") {
     pruneCliProfile(harnessDir);
   }
-  const harnessEnvPath = path6.join(harnessDir, "harness.env");
-  if (fs6.existsSync(harnessEnvPath)) {
-    let content = fs6.readFileSync(harnessEnvPath, "utf8");
+  const harnessEnvPath = path8.join(harnessDir, "harness.env");
+  if (fs7.existsSync(harnessEnvPath)) {
+    let content = fs7.readFileSync(harnessEnvPath, "utf8");
     content = content.replace(/__PROJECT_NAME__/g, projectName).replace(/template___PROJECT_NAME__/g, `template_${projectName}`);
-    fs6.writeFileSync(harnessEnvPath, content);
+    fs7.writeFileSync(harnessEnvPath, content);
   }
   const manifest = createManifest(
     repoPath,
@@ -23264,8 +23565,8 @@ function finalizeHarness(repoPath, adaptationSummary, stack) {
 }
 
 // src/llm/authoring-agent.ts
-var fs10 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
+var fs11 = __toESM(require("fs"));
+var path11 = __toESM(require("path"));
 
 // node_modules/@anthropic-ai/sdk/error.mjs
 var error_exports = {};
@@ -23664,13 +23965,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(path37, ...args) {
+async function fileFromPath3(path41, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path37)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path41)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path37, ...args);
+  return await _fileFromPath(path41, ...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 });
@@ -24166,8 +24467,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve26) => {
-      resolve26(null);
+    super((resolve28) => {
+      resolve28(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -24267,29 +24568,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path37, opts) {
-    return this.methodRequest("get", path37, opts);
+  get(path41, opts) {
+    return this.methodRequest("get", path41, opts);
   }
-  post(path37, opts) {
-    return this.methodRequest("post", path37, opts);
+  post(path41, opts) {
+    return this.methodRequest("post", path41, opts);
   }
-  patch(path37, opts) {
-    return this.methodRequest("patch", path37, opts);
+  patch(path41, opts) {
+    return this.methodRequest("patch", path41, opts);
   }
-  put(path37, opts) {
-    return this.methodRequest("put", path37, opts);
+  put(path41, opts) {
+    return this.methodRequest("put", path41, opts);
   }
-  delete(path37, opts) {
-    return this.methodRequest("delete", path37, opts);
+  delete(path41, opts) {
+    return this.methodRequest("delete", path41, opts);
   }
-  methodRequest(method, path37, opts) {
+  methodRequest(method, path41, 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: path37, ...opts2, body };
+      return { method, path: path41, ...opts2, body };
     }));
   }
-  getAPIList(path37, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path37, ...opts });
+  getAPIList(path41, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path41, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -24307,10 +24608,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path37, query, headers = {} } = options;
+    const { method, path: path41, 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(path37, query);
+    const url = this.buildURL(path41, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -24419,8 +24720,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path37, query) {
-    const url = isAbsoluteURL(path37) ? new URL(path37) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path37.startsWith("/") ? path37.slice(1) : path37));
+  buildURL(path41, query) {
+    const url = isAbsoluteURL(path41) ? new URL(path41) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path41.startsWith("/") ? path41.slice(1) : path41));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -24705,7 +25006,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve26) => setTimeout(resolve26, ms));
+var sleep = (ms) => new Promise((resolve28) => setTimeout(resolve28, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -25196,12 +25497,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve26, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve26, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve28, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve28, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve26, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve26, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve28, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve28, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -25330,11 +25631,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve26, reject) => {
+    return new Promise((resolve28, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve26);
+      this.once(event, resolve28);
     });
   }
   async done() {
@@ -25561,7 +25862,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve26, reject) => readQueue.push({ resolve: resolve26, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve28, reject) => readQueue.push({ resolve: resolve28, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -25709,12 +26010,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve26, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve26, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve28, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve28, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve26, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve26, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve28, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve28, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -25843,11 +26144,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve26, reject) => {
+    return new Promise((resolve28, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve26);
+      this.once(event, resolve28);
     });
   }
   async done() {
@@ -26074,7 +26375,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve26, reject) => readQueue.push({ resolve: resolve26, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve28, reject) => readQueue.push({ resolve: resolve28, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26243,34 +26544,34 @@ var { AnthropicError: AnthropicError2, APIError: APIError2, APIConnectionError:
 var sdk_default = Anthropic;
 
 // src/llm/tools.ts
-var fs9 = __toESM(require("fs"));
-var path8 = __toESM(require("path"));
-var readline2 = __toESM(require("readline"));
+var fs10 = __toESM(require("fs"));
+var path10 = __toESM(require("path"));
+var readline3 = __toESM(require("readline"));
 
 // src/harness/agent-md.ts
-var fs8 = __toESM(require("fs"));
-var path7 = __toESM(require("path"));
-var readline = __toESM(require("readline"));
+var fs9 = __toESM(require("fs"));
+var path9 = __toESM(require("path"));
+var readline2 = __toESM(require("readline"));
 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(path7.join(harnessDir, AGENT_MD_PROPOSAL), content);
+  writeFileSafe(path9.join(harnessDir, AGENT_MD_PROPOSAL), content);
   writeFileSafe(
-    path7.join(harnessDir, AGENT_MD_PROPOSAL_META),
+    path9.join(harnessDir, AGENT_MD_PROPOSAL_META),
     JSON.stringify({ rationale, createdAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2) + "\n"
   );
 }
 function readAgentMdProposal(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
-  const proposalPath = path7.join(harnessDir, AGENT_MD_PROPOSAL);
-  const metaPath = path7.join(harnessDir, AGENT_MD_PROPOSAL_META);
-  if (!fs8.existsSync(proposalPath)) return null;
-  const content = fs8.readFileSync(proposalPath, "utf8");
+  const proposalPath = path9.join(harnessDir, AGENT_MD_PROPOSAL);
+  const metaPath = path9.join(harnessDir, AGENT_MD_PROPOSAL_META);
+  if (!fs9.existsSync(proposalPath)) return null;
+  const content = fs9.readFileSync(proposalPath, "utf8");
   let rationale = "";
-  if (fs8.existsSync(metaPath)) {
+  if (fs9.existsSync(metaPath)) {
     try {
-      rationale = JSON.parse(fs8.readFileSync(metaPath, "utf8")).rationale ?? "";
+      rationale = JSON.parse(fs9.readFileSync(metaPath, "utf8")).rationale ?? "";
     } catch {
       rationale = "";
     }
@@ -26278,21 +26579,21 @@ function readAgentMdProposal(repoPath) {
   return {
     content,
     rationale,
-    createdAt: fs8.existsSync(metaPath) ? JSON.parse(fs8.readFileSync(metaPath, "utf8")).createdAt : (/* @__PURE__ */ new Date()).toISOString()
+    createdAt: fs9.existsSync(metaPath) ? JSON.parse(fs9.readFileSync(metaPath, "utf8")).createdAt : (/* @__PURE__ */ new Date()).toISOString()
   };
 }
 function clearAgentMdProposal(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
   for (const file of [AGENT_MD_PROPOSAL, AGENT_MD_PROPOSAL_META]) {
-    const p2 = path7.join(harnessDir, file);
-    if (fs8.existsSync(p2)) fs8.unlinkSync(p2);
+    const p2 = path9.join(harnessDir, file);
+    if (fs9.existsSync(p2)) fs9.unlinkSync(p2);
   }
 }
 async function promptApplyAgentMdProposal(repoPath) {
   const proposal = readAgentMdProposal(repoPath);
   if (!proposal) return false;
-  const agentMdPath = path7.join(repoPath, "AGENT.md");
-  const exists = fs8.existsSync(agentMdPath);
+  const agentMdPath = path9.join(repoPath, "AGENT.md");
+  const exists = fs9.existsSync(agentMdPath);
   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");
@@ -26315,13 +26616,13 @@ async function promptApplyAgentMdProposal(repoPath) {
 `);
   if (exists) {
     warn("AGENT.md already exists at repo root.");
-    const answer = await askYesNo("Replace AGENT.md with this proposal? (y/n)");
+    const answer = await askYesNo2("Replace AGENT.md with this proposal? (y/n)");
     if (!answer) {
       info("Skipped \u2014 proposal kept at .har/AGENT.md.proposed");
       return false;
     }
   } else {
-    const answer = await askYesNo("Create AGENT.md at repo root? (y/n)");
+    const answer = await askYesNo2("Create AGENT.md at repo root? (y/n)");
     if (!answer) {
       info("Skipped \u2014 proposal kept at .har/AGENT.md.proposed");
       return false;
@@ -26332,13 +26633,13 @@ async function promptApplyAgentMdProposal(repoPath) {
   info("Wrote AGENT.md");
   return true;
 }
-async function askYesNo(question) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve26) => {
+async function askYesNo2(question) {
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve28) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve26(/^y(es)?$/i.test(answer.trim()));
+      resolve28(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -26480,13 +26781,13 @@ async function handleAuthoringToolCall(toolName, input, repoPath, harnessDir, ca
 async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, callbacks) {
   switch (toolName) {
     case "readRepoFile": {
-      const filePath = path8.join(repoPath, input.path);
+      const filePath = path10.join(repoPath, input.path);
       const content = readFile(filePath, input.maxChars ?? 8e3);
       info(`Read repo: ${input.path}`);
       return content;
     }
     case "listRepoDir": {
-      const dirPath = path8.join(repoPath, input.path ?? ".");
+      const dirPath = path10.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)";
@@ -26511,17 +26812,17 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
       const filePath = resolveSafePath(harnessDir, relPath);
       writeFileSafe(filePath, input.content);
       if (relPath.endsWith(".sh")) {
-        fs9.chmodSync(filePath, 493);
+        fs10.chmodSync(filePath, 493);
       }
       info(`Wrote harness: ${relPath}`);
       return `Written ${relPath} (${input.content.length} bytes)`;
     }
     case "editHarnessFile": {
       const filePath = resolveSafePath(harnessDir, input.path);
-      if (!fs9.existsSync(filePath)) {
+      if (!fs10.existsSync(filePath)) {
         return `Error: file not found: ${input.path}`;
       }
-      const content = fs9.readFileSync(filePath, "utf8");
+      const content = fs10.readFileSync(filePath, "utf8");
       const oldStr = input.old_string;
       const newStr = input.new_string;
       const count = content.split(oldStr).length - 1;
@@ -26538,10 +26839,10 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
     }
     case "deleteHarnessFile": {
       const filePath = resolveSafePath(harnessDir, input.path);
-      if (!fs9.existsSync(filePath)) {
+      if (!fs10.existsSync(filePath)) {
         return `File not found (already deleted): ${input.path}`;
       }
-      fs9.unlinkSync(filePath);
+      fs10.unlinkSync(filePath);
       info(`Deleted harness: ${input.path}`);
       return `Deleted ${input.path}`;
     }
@@ -26567,8 +26868,8 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
   }
 }
 async function askUser(question, options) {
-  const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve26) => {
+  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve28) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -26579,7 +26880,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve26(answer.trim());
+      resolve28(answer.trim());
     });
   });
 }
@@ -26592,29 +26893,29 @@ async function authorHarness(repoPath, apiKey, options = {}) {
   const mode = options.mode ?? "init";
   const systemPromptPath = resolvePromptPath("system-authoring.md");
   const agentMdTemplatePath = resolveTemplateFile("AGENT.md.template");
-  let systemPrompt = fs10.existsSync(systemPromptPath) ? fs10.readFileSync(systemPromptPath, "utf8") : "Adapt the .har/ boilerplate to match the repository. Edit files directly. Call finishAuthoring when done.";
+  let systemPrompt = fs11.existsSync(systemPromptPath) ? fs11.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)
 
-${fs10.readFileSync(agentMdTemplatePath, "utf8")}`;
+${fs11.readFileSync(agentMdTemplatePath, "utf8")}`;
   }
   const tools = buildAuthoringTools();
   const messages = [];
   let rootListing;
   try {
-    rootListing = fs10.readdirSync(repoPath).slice(0, 50).join("\n");
+    rootListing = fs11.readdirSync(repoPath).slice(0, 50).join("\n");
   } catch {
     throw new Error(`Cannot read repo at path: ${repoPath}`);
   }
   let harnessListing;
   try {
-    harnessListing = fs10.readdirSync(harnessDir).join("\n");
+    harnessListing = fs11.readdirSync(harnessDir).join("\n");
   } catch {
     throw new Error(`Cannot read harness dir at: ${harnessDir}`);
   }
-  const existingAgentMd = fs10.existsSync(path9.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 = fs11.existsSync(path11.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 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/.
@@ -26694,8 +26995,8 @@ Try running with --verbose to see what the agent is doing.`
 }
 
 // src/harness/validator.ts
-var fs13 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
+var fs14 = __toESM(require("fs"));
+var path14 = __toESM(require("path"));
 
 // src/utils/shell.ts
 var import_child_process = require("child_process");
@@ -26723,7 +27024,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve26) => {
+  return new Promise((resolve28) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -26738,13 +27039,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve26({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve28({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve26) => {
+  return new Promise((resolve28) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -26759,22 +27060,22 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve26({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve28({ stdout, stderr, code: code ?? 0 }));
   });
 }
 
 // src/harness/stages.ts
-var fs12 = __toESM(require("fs"));
-var path11 = __toESM(require("path"));
+var fs13 = __toESM(require("fs"));
+var path13 = __toESM(require("path"));
 
 // src/harness/env.ts
-var fs11 = __toESM(require("fs"));
-var path10 = __toESM(require("path"));
+var fs12 = __toESM(require("fs"));
+var path12 = __toESM(require("path"));
 function readHarnessEnv(repoPath) {
-  const envPath = path10.join(getHarnessDir(repoPath), "harness.env");
-  if (!fs11.existsSync(envPath)) return {};
+  const envPath = path12.join(getHarnessDir(repoPath), "harness.env");
+  if (!fs12.existsSync(envPath)) return {};
   const values = {};
-  for (const line of fs11.readFileSync(envPath, "utf8").split("\n")) {
+  for (const line of fs12.readFileSync(envPath, "utf8").split("\n")) {
     const match = line.match(/^export\s+([A-Z0-9_]+)=(.*)$/);
     if (!match) continue;
     values[match[1]] = match[2].replace(/^"|"$/g, "");
@@ -26801,7 +27102,7 @@ var AGENT_REQUIRED_KINDS = /* @__PURE__ */ new Set([
   "custom"
 ]);
 function getStageRegistryPath(repoPath) {
-  return path11.join(getHarnessDir(repoPath), STAGE_REGISTRY_FILE);
+  return path13.join(getHarnessDir(repoPath), STAGE_REGISTRY_FILE);
 }
 function synthesizeStageRegistry(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
@@ -26876,13 +27177,13 @@ function readAgentSlotsFromHarnessEnv(harnessEnv) {
 }
 function stageScriptExists(harnessDir, stage) {
   if (stage.script) {
-    return fs12.existsSync(path11.join(harnessDir, stage.script));
+    return fs13.existsSync(path13.join(harnessDir, stage.script));
   }
   if (stage.command) {
     const scriptName = stage.command.split(/\s+/)[0].replace(/^\.\/\.har\//, "").replace(/^\.\//, "");
-    return fs12.existsSync(path11.join(harnessDir, scriptName));
+    return fs13.existsSync(path13.join(harnessDir, scriptName));
   }
-  return fs12.existsSync(path11.join(harnessDir, "stages", `${stage.id}.sh`));
+  return fs13.existsSync(path13.join(harnessDir, "stages", `${stage.id}.sh`));
 }
 function addStageIfRunnable(stages, harnessDir, stage) {
   const parsed = HarnessStageSchema.parse(stage);
@@ -26892,10 +27193,10 @@ function addStageIfRunnable(stages, harnessDir, stage) {
 }
 function readStageRegistry(repoPath) {
   const registryPath = getStageRegistryPath(repoPath);
-  if (!fs12.existsSync(registryPath)) {
+  if (!fs13.existsSync(registryPath)) {
     return synthesizeStageRegistry(repoPath);
   }
-  const raw = JSON.parse(fs12.readFileSync(registryPath, "utf8"));
+  const raw = JSON.parse(fs13.readFileSync(registryPath, "utf8"));
   const parsed = HarnessStageRegistrySchema.safeParse(raw);
   if (!parsed.success) {
     throw new Error(`Invalid .har/${STAGE_REGISTRY_FILE}: ${parsed.error.message}`);
@@ -26908,7 +27209,7 @@ function writeStageRegistry(repoPath, registry2) {
   if (!parsed.success) {
     throw new Error(`Invalid stage registry: ${parsed.error.message}`);
   }
-  fs12.writeFileSync(registryPath, JSON.stringify(parsed.data, null, 2) + "\n");
+  fs13.writeFileSync(registryPath, JSON.stringify(parsed.data, null, 2) + "\n");
 }
 function listStages(repoPath) {
   return readStageRegistry(repoPath).stages;
@@ -27014,22 +27315,22 @@ var SHELL_SCRIPTS = [
 function validateHarness(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
   const issues = [];
-  if (!fs13.existsSync(harnessDir)) {
+  if (!fs14.existsSync(harnessDir)) {
     return {
       pass: false,
       issues: [{ file: ".har", message: "Harness directory not found", severity: "error" }]
     };
   }
   for (const file of getRequiredFiles(repoPath)) {
-    const filePath = path12.join(harnessDir, file);
-    if (!fs13.existsSync(filePath)) {
+    const filePath = path14.join(harnessDir, file);
+    if (!fs14.existsSync(filePath)) {
       issues.push({ file, message: "Required file missing", severity: "error" });
     }
   }
   for (const script of SHELL_SCRIPTS) {
-    const scriptPath = path12.join(harnessDir, script);
-    if (!fs13.existsSync(scriptPath)) continue;
-    const stat = fs13.statSync(scriptPath);
+    const scriptPath = path14.join(harnessDir, script);
+    if (!fs14.existsSync(scriptPath)) continue;
+    const stat = fs14.statSync(scriptPath);
     if (!(stat.mode & 73)) {
       issues.push({ file: script, message: "Script is not executable", severity: "warning" });
     }
@@ -27044,9 +27345,9 @@ function validateHarness(repoPath) {
   }
   const manifest = readManifest(repoPath);
   const profile = manifest?.profile ?? "default";
-  const ecosystemPath = path12.join(harnessDir, "ecosystem.agent.template.cjs");
-  if (profile !== "cli" && fs13.existsSync(ecosystemPath)) {
-    const content = fs13.readFileSync(ecosystemPath, "utf8");
+  const ecosystemPath = path14.join(harnessDir, "ecosystem.agent.template.cjs");
+  if (profile !== "cli" && fs14.existsSync(ecosystemPath)) {
+    const content = fs14.readFileSync(ecosystemPath, "utf8");
     if (!content.includes("module.exports")) {
       issues.push({
         file: "ecosystem.agent.template.cjs",
@@ -27055,9 +27356,9 @@ function validateHarness(repoPath) {
       });
     }
   }
-  const harnessEnvPath = path12.join(harnessDir, "harness.env");
-  if (fs13.existsSync(harnessEnvPath)) {
-    const content = fs13.readFileSync(harnessEnvPath, "utf8");
+  const harnessEnvPath = path14.join(harnessDir, "harness.env");
+  if (fs14.existsSync(harnessEnvPath)) {
+    const content = fs14.readFileSync(harnessEnvPath, "utf8");
     if (content.includes("TODO: set migrate command")) {
       issues.push({ file: "harness.env", message: "Migrate command still has TODO", severity: "warning" });
     }
@@ -27065,17 +27366,17 @@ function validateHarness(repoPath) {
       issues.push({ file: "harness.env", message: "Seed command still has TODO", severity: "warning" });
     }
   }
-  const verifyPath = path12.join(harnessDir, "verify.sh");
-  if (fs13.existsSync(verifyPath)) {
-    const content = fs13.readFileSync(verifyPath, "utf8");
+  const verifyPath = path14.join(harnessDir, "verify.sh");
+  if (fs14.existsSync(verifyPath)) {
+    const content = fs14.readFileSync(verifyPath, "utf8");
     if (content.includes("echo 'TODO:")) {
       issues.push({ file: "verify.sh", message: "Verification steps still have TODO placeholders", severity: "warning" });
     }
   }
-  const stagesPath = path12.join(harnessDir, "stages.json");
-  if (fs13.existsSync(stagesPath)) {
+  const stagesPath = path14.join(harnessDir, "stages.json");
+  if (fs14.existsSync(stagesPath)) {
     try {
-      JSON.parse(fs13.readFileSync(stagesPath, "utf8"));
+      JSON.parse(fs14.readFileSync(stagesPath, "utf8"));
       const registry2 = readStageRegistry(repoPath);
       if (registry2.stages.length === 0) {
         issues.push({ file: "stages.json", message: "No harness stages declared", severity: "warning" });
@@ -27090,9 +27391,9 @@ function validateHarness(repoPath) {
   } else {
     issues.push({ file: "stages.json", message: "Stage registry missing", severity: "warning" });
   }
-  const readmePath = path12.join(harnessDir, "README.md");
-  if (fs13.existsSync(readmePath)) {
-    const content = fs13.readFileSync(readmePath, "utf8");
+  const readmePath = path14.join(harnessDir, "README.md");
+  if (fs14.existsSync(readmePath)) {
+    const content = fs14.readFileSync(readmePath, "utf8");
     if (!content.includes(".har")) {
       issues.push({ file: "README.md", message: "README should document .har/ paths", severity: "warning" });
     }
@@ -27106,8 +27407,8 @@ function validateHarness(repoPath) {
 async function smokeTestHarness(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
   const issues = [];
-  const setupScript = path12.join(harnessDir, "setup-infra.sh");
-  if (fs13.existsSync(setupScript)) {
+  const setupScript = path14.join(harnessDir, "setup-infra.sh");
+  if (fs14.existsSync(setupScript)) {
     const result = run(`bash "${setupScript}"`, { cwd: repoPath });
     if (result.code !== 0) {
       issues.push({
@@ -27122,8 +27423,8 @@ async function smokeTestHarness(repoPath) {
 }
 
 // src/harness/drift.ts
-var fs14 = __toESM(require("fs"));
-var path13 = __toESM(require("path"));
+var fs15 = __toESM(require("fs"));
+var path15 = __toESM(require("path"));
 var PROFILE_DIRS2 = {
   default: "har-boilerplate",
   cli: "har-boilerplate-cli",
@@ -27191,33 +27492,33 @@ function substituteProjectName(content, projectName) {
   return content.replace(/__PROJECT_NAME__/g, projectName).replace(/template___PROJECT_NAME__/g, `template_${projectName}`);
 }
 function listBoilerplateFiles(boilerplateDir) {
-  if (!fs14.existsSync(boilerplateDir)) return [];
-  return fs14.readdirSync(boilerplateDir, { withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
+  if (!fs15.existsSync(boilerplateDir)) return [];
+  return fs15.readdirSync(boilerplateDir, { withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
 }
 function compareHarnessToTemplate(repoPath) {
-  const resolved = path13.resolve(repoPath);
+  const resolved = path15.resolve(repoPath);
   const manifest = readManifest(resolved);
   const profile = manifest?.profile ?? "default";
   const harnessDir = getHarnessDir(resolved);
-  const projectName = path13.basename(resolved).toLowerCase().replace(/[^a-z0-9]/g, "_");
-  const boilerplateDir = path13.join(resolveTemplatesDir(), PROFILE_DIRS2[profile]);
+  const projectName = path15.basename(resolved).toLowerCase().replace(/[^a-z0-9]/g, "_");
+  const boilerplateDir = path15.join(resolveTemplatesDir(), PROFILE_DIRS2[profile]);
   const templateFiles = listBoilerplateFiles(boilerplateDir);
   const missing = [];
   const checksumMismatch = [];
   const extra = [];
   const unchanged = [];
   for (const file of templateFiles) {
-    const templatePath = path13.join(boilerplateDir, file);
-    const harnessPath = path13.join(harnessDir, file);
-    let templateContent = fs14.readFileSync(templatePath, "utf8");
+    const templatePath = path15.join(boilerplateDir, file);
+    const harnessPath = path15.join(harnessDir, file);
+    let templateContent = fs15.readFileSync(templatePath, "utf8");
     if (file === "harness.env") {
       templateContent = substituteProjectName(templateContent, projectName);
     }
-    if (!fs14.existsSync(harnessPath)) {
+    if (!fs15.existsSync(harnessPath)) {
       missing.push(file);
       continue;
     }
-    const harnessChecksum = computeFileChecksum(fs14.readFileSync(harnessPath, "utf8"));
+    const harnessChecksum = computeFileChecksum(fs15.readFileSync(harnessPath, "utf8"));
     const templateChecksum = computeFileChecksum(templateContent);
     if (harnessChecksum === templateChecksum) {
       unchanged.push(file);
@@ -27225,10 +27526,10 @@ function compareHarnessToTemplate(repoPath) {
       checksumMismatch.push(file);
     }
   }
-  if (fs14.existsSync(harnessDir)) {
-    for (const file of fs14.readdirSync(harnessDir)) {
-      const full = path13.join(harnessDir, file);
-      if (!fs14.statSync(full).isFile()) continue;
+  if (fs15.existsSync(harnessDir)) {
+    for (const file of fs15.readdirSync(harnessDir)) {
+      const full = path15.join(harnessDir, file);
+      if (!fs15.statSync(full).isFile()) continue;
       if (file === "manifest.json" || file.startsWith("ADAPT-PROMPT")) continue;
       if (profile === "cli" && CLI_EXPECTED_ABSENT.has(file)) {
         extra.push(file);
@@ -27255,9 +27556,9 @@ function compareHarnessToTemplate(repoPath) {
 }
 
 // src/harness/maintain-bundle.ts
-var fs15 = __toESM(require("fs"));
-var os2 = __toESM(require("os"));
-var path14 = __toESM(require("path"));
+var fs16 = __toESM(require("fs"));
+var os3 = __toESM(require("os"));
+var path16 = __toESM(require("path"));
 var MAINTAIN_DIR = "maintain";
 var PROFILE_DIRS3 = {
   default: "har-boilerplate",
@@ -27268,14 +27569,14 @@ function substituteProjectName2(content, projectName) {
   return content.replace(/__PROJECT_NAME__/g, projectName).replace(/template___PROJECT_NAME__/g, `template_${projectName}`);
 }
 function projectNameFromRepo(repoPath) {
-  return path14.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
+  return path16.basename(repoPath).toLowerCase().replace(/[^a-z0-9]/g, "_");
 }
 function boilerplateDirForProfile(profile) {
-  return path14.join(resolveTemplatesDir(), PROFILE_DIRS3[profile]);
+  return path16.join(resolveTemplatesDir(), PROFILE_DIRS3[profile]);
 }
 function readBundledTemplateContent(repoPath, profile, file) {
-  const templatePath = path14.join(boilerplateDirForProfile(profile), file);
-  let content = fs15.readFileSync(templatePath, "utf8");
+  const templatePath = path16.join(boilerplateDirForProfile(profile), file);
+  let content = fs16.readFileSync(templatePath, "utf8");
   if (file === "harness.env") {
     content = substituteProjectName2(content, projectNameFromRepo(repoPath));
   }
@@ -27306,12 +27607,12 @@ function actionHint(file, kind2) {
   return `Read maintain/diffs/${file}.diff and merge into .har/${file}.`;
 }
 function createUnifiedDiff(installedContent, templateContent, installedLabel, templateLabel) {
-  const tmpDir = fs15.mkdtempSync(path14.join(os2.tmpdir(), "har-maintain-diff-"));
+  const tmpDir = fs16.mkdtempSync(path16.join(os3.tmpdir(), "har-maintain-diff-"));
   try {
-    const installedPath = path14.join(tmpDir, "installed");
-    const templatePath = path14.join(tmpDir, "template");
-    fs15.writeFileSync(installedPath, installedContent);
-    fs15.writeFileSync(templatePath, templateContent);
+    const installedPath = path16.join(tmpDir, "installed");
+    const templatePath = path16.join(tmpDir, "template");
+    fs16.writeFileSync(installedPath, installedContent);
+    fs16.writeFileSync(templatePath, templateContent);
     const result = run(`diff -u "${installedPath}" "${templatePath}"`);
     const body = result.stdout.trim();
     if (!body) return "";
@@ -27320,7 +27621,7 @@ function createUnifiedDiff(installedContent, templateContent, installedLabel, te
 ${body.split("\n").slice(2).join("\n")}
 `;
   } finally {
-    fs15.rmSync(tmpDir, { recursive: true, force: true });
+    fs16.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 function buildActions(repoPath, profile, drift) {
@@ -27335,7 +27636,7 @@ function buildActions(repoPath, profile, drift) {
     });
   }
   for (const file of drift.checksumMismatch) {
-    const installedPath = path14.join(harnessDir, file);
+    const installedPath = path16.join(harnessDir, file);
     const installedRel = `maintain/installed/${file}`;
     const templateRel = `maintain/templates/${file}`;
     const diffRel = `maintain/diffs/${file}.diff`;
@@ -27343,7 +27644,7 @@ function buildActions(repoPath, profile, drift) {
       file,
       kind: "drift",
       template: templateRel,
-      installed: fs15.existsSync(installedPath) ? installedRel : void 0,
+      installed: fs16.existsSync(installedPath) ? installedRel : void 0,
       diff: diffRel,
       hint: actionHint(file, "drift")
     });
@@ -27414,28 +27715,28 @@ function buildReadme(report) {
 }
 function writeBundleArtifacts(repoPath, profile, drift, report) {
   const harnessDir = getHarnessDir(repoPath);
-  const bundleDir = path14.join(harnessDir, MAINTAIN_DIR);
-  if (fs15.existsSync(bundleDir)) {
-    fs15.rmSync(bundleDir, { recursive: true, force: true });
+  const bundleDir = path16.join(harnessDir, MAINTAIN_DIR);
+  if (fs16.existsSync(bundleDir)) {
+    fs16.rmSync(bundleDir, { recursive: true, force: true });
   }
   const dirs = [
     bundleDir,
-    path14.join(bundleDir, "templates"),
-    path14.join(bundleDir, "installed"),
-    path14.join(bundleDir, "diffs"),
-    path14.join(bundleDir, "stale")
+    path16.join(bundleDir, "templates"),
+    path16.join(bundleDir, "installed"),
+    path16.join(bundleDir, "diffs"),
+    path16.join(bundleDir, "stale")
   ];
   for (const dir of dirs) {
-    fs15.mkdirSync(dir, { recursive: true });
+    fs16.mkdirSync(dir, { recursive: true });
   }
   const affectedFiles = [...drift.missing, ...drift.checksumMismatch];
   for (const file of affectedFiles) {
     const templateContent = readBundledTemplateContent(repoPath, profile, file);
-    writeFileSafe(path14.join(bundleDir, "templates", file), templateContent);
-    const harnessPath = path14.join(harnessDir, file);
-    if (fs15.existsSync(harnessPath)) {
-      const installedContent = fs15.readFileSync(harnessPath, "utf8");
-      writeFileSafe(path14.join(bundleDir, "installed", file), installedContent);
+    writeFileSafe(path16.join(bundleDir, "templates", file), templateContent);
+    const harnessPath = path16.join(harnessDir, file);
+    if (fs16.existsSync(harnessPath)) {
+      const installedContent = fs16.readFileSync(harnessPath, "utf8");
+      writeFileSafe(path16.join(bundleDir, "installed", file), installedContent);
       const diff = createUnifiedDiff(
         installedContent,
         templateContent,
@@ -27443,14 +27744,14 @@ function writeBundleArtifacts(repoPath, profile, drift, report) {
         `templates/${file}`
       );
       if (diff) {
-        writeFileSafe(path14.join(bundleDir, "diffs", `${file}.diff`), diff);
+        writeFileSafe(path16.join(bundleDir, "diffs", `${file}.diff`), diff);
       }
     }
   }
-  writeFileSafe(path14.join(bundleDir, "README.md"), buildReadme(report));
-  writeFileSafe(path14.join(bundleDir, "drift-report.json"), JSON.stringify(report, null, 2) + "\n");
+  writeFileSafe(path16.join(bundleDir, "README.md"), buildReadme(report));
+  writeFileSafe(path16.join(bundleDir, "drift-report.json"), JSON.stringify(report, null, 2) + "\n");
   writeFileSafe(
-    path14.join(bundleDir, "validation.json"),
+    path16.join(bundleDir, "validation.json"),
     JSON.stringify(report.validation, null, 2) + "\n"
   );
   if (report.stale.length > 0) {
@@ -27462,7 +27763,7 @@ function writeBundleArtifacts(repoPath, profile, drift, report) {
       ...report.stale.map((s2) => `- **${s2.file}** \u2014 ${s2.hint}`),
       ""
     ];
-    writeFileSafe(path14.join(bundleDir, "stale", "MANIFEST.md"), staleLines.join("\n"));
+    writeFileSafe(path16.join(bundleDir, "stale", "MANIFEST.md"), staleLines.join("\n"));
   }
   return bundleDir;
 }
@@ -27488,9 +27789,9 @@ function buildMaintainBundle(repoPath, validation2, drift) {
   return { bundleDir, report };
 }
 function removeMaintainBundle(repoPath) {
-  const bundleDir = path14.join(getHarnessDir(repoPath), MAINTAIN_DIR);
-  if (fs15.existsSync(bundleDir)) {
-    fs15.rmSync(bundleDir, { recursive: true, force: true });
+  const bundleDir = path16.join(getHarnessDir(repoPath), MAINTAIN_DIR);
+  if (fs16.existsSync(bundleDir)) {
+    fs16.rmSync(bundleDir, { recursive: true, force: true });
   }
 }
 function formatMaintainBundlePromptSection(report) {
@@ -27538,66 +27839,89 @@ function formatMaintainBundlePromptSection(report) {
 }
 
 // src/harness/stage-templates.ts
-var fs17 = __toESM(require("fs"));
-var path15 = __toESM(require("path"));
+var fs18 = __toESM(require("fs"));
+var path17 = __toESM(require("path"));
 
 // src/harness/parser.ts
-var fs16 = __toESM(require("fs"));
+var fs17 = __toESM(require("fs"));
 function harnessExists(repoPath) {
-  return fs16.existsSync(`${repoPath}/.har/setup-infra.sh`);
+  return fs17.existsSync(`${repoPath}/.har/setup-infra.sh`);
 }
 
 // src/harness/stage-templates.ts
+var STAGE_TEMPLATE_IDS = ["playwright", "rocketsim"];
+var TemplateManifestFileSchema = external_exports.object({
+  src: external_exports.string().min(1),
+  dest: external_exports.string().min(1),
+  executable: external_exports.boolean().optional(),
+  skipFlag: external_exports.string().optional()
+});
+var StageTemplateManifestSchema = external_exports.object({
+  id: external_exports.enum(STAGE_TEMPLATE_IDS),
+  stageId: external_exports.string().min(1),
+  verificationStages: external_exports.array(external_exports.string().min(1)).min(1),
+  stage: external_exports.record(external_exports.unknown()),
+  files: external_exports.array(TemplateManifestFileSchema).min(1),
+  optionalFiles: external_exports.array(TemplateManifestFileSchema).optional(),
+  merge: external_exports.record(external_exports.string()).optional(),
+  nextSteps: external_exports.array(external_exports.string().min(1)).min(1),
+  docsPath: external_exports.string().min(1)
+});
 function resolveTemplateDir(templateId) {
-  const dir = path15.join(resolveTemplatesDir(), "stage-templates", templateId);
-  if (!fs17.existsSync(dir)) {
+  const dir = path17.join(resolveTemplatesDir(), "stage-templates", templateId);
+  if (!fs18.existsSync(dir)) {
     throw new Error(`Stage template not found: ${templateId}. Run npm run build.`);
   }
   return dir;
 }
 function readTemplateManifest(templateId) {
-  const manifestPath = path15.join(resolveTemplateDir(templateId), "template.manifest.json");
-  const raw = JSON.parse(fs17.readFileSync(manifestPath, "utf8"));
-  if (raw.id !== templateId) {
-    throw new Error(`Template manifest id mismatch: expected ${templateId}, got ${raw.id}`);
+  const manifestPath = path17.join(resolveTemplateDir(templateId), "template.manifest.json");
+  const parsed = StageTemplateManifestSchema.safeParse(
+    JSON.parse(fs18.readFileSync(manifestPath, "utf8"))
+  );
+  if (!parsed.success) {
+    throw new Error(`Invalid template manifest for ${templateId}: ${parsed.error.message}`);
+  }
+  if (parsed.data.id !== templateId) {
+    throw new Error(`Template manifest id mismatch: expected ${templateId}, got ${parsed.data.id}`);
   }
-  return raw;
+  return parsed.data;
 }
 function ensureParentDir(filePath) {
-  const parent = path15.dirname(filePath);
-  if (!fs17.existsSync(parent)) {
-    fs17.mkdirSync(parent, { recursive: true });
+  const parent = path17.dirname(filePath);
+  if (!fs18.existsSync(parent)) {
+    fs18.mkdirSync(parent, { recursive: true });
   }
 }
 function copyTemplateFile(templateDir, file, repoPath, force) {
-  const srcPath = path15.join(templateDir, file.src);
-  const destPath = path15.join(repoPath, file.dest);
-  if (!fs17.existsSync(srcPath)) {
+  const srcPath = path17.join(templateDir, file.src);
+  const destPath = path17.join(repoPath, file.dest);
+  if (!fs18.existsSync(srcPath)) {
     throw new Error(`Template file missing: ${file.src}`);
   }
-  if (fs17.existsSync(destPath) && !force) {
+  if (fs18.existsSync(destPath) && !force) {
     throw new Error(
       `File already exists: ${file.dest}. Use --force to overwrite or remove it first.`
     );
   }
   ensureParentDir(destPath);
-  fs17.copyFileSync(srcPath, destPath);
+  fs18.copyFileSync(srcPath, destPath);
   if (file.executable) {
-    fs17.chmodSync(destPath, 493);
+    fs18.chmodSync(destPath, 493);
   }
   return { written: true, path: file.dest };
 }
 function mergePackageJson(repoPath, templateDir, fragmentRelPath, warnings) {
-  const packagePath = path15.join(repoPath, "package.json");
-  if (!fs17.existsSync(packagePath)) {
-    throw new Error("No package.json in repo root. Add one before applying the Playwright template.");
+  const packagePath = path17.join(repoPath, "package.json");
+  if (!fs18.existsSync(packagePath)) {
+    throw new Error("No package.json in repo root. Add one before applying this stage template.");
   }
-  const fragmentPath = path15.join(templateDir, fragmentRelPath);
-  if (!fs17.existsSync(fragmentPath)) {
+  const fragmentPath = path17.join(templateDir, fragmentRelPath);
+  if (!fs18.existsSync(fragmentPath)) {
     throw new Error(`Package fragment missing: ${fragmentRelPath}`);
   }
-  const pkg = JSON.parse(fs17.readFileSync(packagePath, "utf8"));
-  const fragment = JSON.parse(fs17.readFileSync(fragmentPath, "utf8"));
+  const pkg = JSON.parse(fs18.readFileSync(packagePath, "utf8"));
+  const fragment = JSON.parse(fs18.readFileSync(fragmentPath, "utf8"));
   for (const section of ["scripts", "devDependencies"]) {
     const existing = pkg[section] ?? {};
     const incoming = fragment[section] ?? {};
@@ -27610,7 +27934,7 @@ function mergePackageJson(repoPath, templateDir, fragmentRelPath, warnings) {
     }
     pkg[section] = existing;
   }
-  fs17.writeFileSync(packagePath, JSON.stringify(pkg, null, 2) + "\n");
+  fs18.writeFileSync(packagePath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function patchStageRegistry(repoPath, manifest, force) {
   const registry2 = readStageRegistry(repoPath);
@@ -27623,8 +27947,7 @@ function patchStageRegistry(repoPath, manifest, force) {
   }
   const stages = existing ? registry2.stages.map((s2) => s2.id === stage.id ? stage : s2) : [...registry2.stages, stage];
   const verificationStages = [...registry2.verificationStages ?? []];
-  const toAdd = manifest.verificationStages ?? (manifest.verificationStageId ? [manifest.verificationStageId] : [manifest.stageId]);
-  for (const id of toAdd) {
+  for (const id of manifest.verificationStages) {
     if (!verificationStages.includes(id)) {
       verificationStages.push(id);
     }
@@ -27633,7 +27956,7 @@ function patchStageRegistry(repoPath, manifest, force) {
   if (verifyIdx >= 0) {
     stages[verifyIdx] = {
       ...stages[verifyIdx],
-      description: "Verification pipeline (quick smoke by default; --full adds tests, lint, and browser-e2e when installed)",
+      description: `Verification pipeline (quick smoke by default; --full runs the registry's verificationStages: ${verificationStages.join(", ")})`,
       acceptsArgs: ["--full"]
     };
   }
@@ -27651,8 +27974,8 @@ function assertHarnessPresent(repoPath) {
 }
 function assertStageNotPresent(repoPath, stageId, force) {
   if (force) return;
-  const scriptPath = path15.join(repoPath, ".har", "stages", `${stageId}.sh`);
-  if (fs17.existsSync(scriptPath)) {
+  const scriptPath = path17.join(repoPath, ".har", "stages", `${stageId}.sh`);
+  if (fs18.existsSync(scriptPath)) {
     throw new Error(
       `Stage script already exists: .har/stages/${stageId}.sh. Use --force to overwrite.`
     );
@@ -27665,7 +27988,7 @@ function assertStageNotPresent(repoPath, stageId, force) {
   }
 }
 function applyStageTemplate(repoPath, templateId, options = {}) {
-  const resolved = path15.resolve(repoPath);
+  const resolved = path17.resolve(repoPath);
   const force = options.force ?? false;
   const warnings = [];
   const filesWritten = [];
@@ -27684,7 +28007,7 @@ function applyStageTemplate(repoPath, templateId, options = {}) {
       if (file.skipFlag === "skipCi" && options.skipCi) {
         continue;
       }
-      if (fs17.existsSync(path15.join(resolved, file.dest)) && !force) {
+      if (fs18.existsSync(path17.join(resolved, file.dest)) && !force) {
         warnings.push(`Skipped optional file (exists): ${file.dest}`);
         continue;
       }
@@ -27709,21 +28032,22 @@ function applyStageTemplate(repoPath, templateId, options = {}) {
   for (const warning of warnings) {
     warn(`  \u26A0 ${warning}`);
   }
-  const nextSteps = manifest.nextSteps ?? [
-    "npm install",
-    "npx playwright install",
-    "./.har/launch.sh 1",
-    `./.har/stages/${manifest.stageId}.sh 1`,
-    "npx playwright show-report .har/artifacts/browser-e2e/playwright-report"
-  ];
   return {
     templateId,
     stageId: manifest.stageId,
     filesWritten,
     warnings,
-    nextSteps
+    nextSteps: manifest.nextSteps,
+    docsPath: manifest.docsPath
   };
 }
+function listStageTemplateIds() {
+  const root = path17.join(resolveTemplatesDir(), "stage-templates");
+  if (!fs18.existsSync(root)) return [...STAGE_TEMPLATE_IDS];
+  return fs18.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter(
+    (name) => STAGE_TEMPLATE_IDS.includes(name)
+  );
+}
 
 // src/utils/validation.ts
 function requireApiKey() {
@@ -27747,11 +28071,11 @@ function validateAgentId(id, repoPath) {
 // src/core/harness.ts
 function listHarnessScripts(repoPath) {
   const harnessDir = getHarnessDir(repoPath);
-  if (!fs18.existsSync(harnessDir)) return [];
-  return fs18.readdirSync(harnessDir).filter((name) => name.endsWith(".sh")).sort();
+  if (!fs19.existsSync(harnessDir)) return [];
+  return fs19.readdirSync(harnessDir).filter((name) => name.endsWith(".sh")).sort();
 }
 function describeProject(repoPath) {
-  const resolved = path16.resolve(repoPath);
+  const resolved = path18.resolve(repoPath);
   const manifest = readManifest(resolved);
   const present = harnessExists(resolved);
   return {
@@ -27771,8 +28095,8 @@ function describeProject(repoPath) {
   };
 }
 async function initHarness(options) {
-  const repoPath = path16.resolve(options.repoPath);
-  if (!fs18.existsSync(repoPath)) {
+  const repoPath = path18.resolve(options.repoPath);
+  if (!fs19.existsSync(repoPath)) {
     throw new Error(`Path not found: ${repoPath}`);
   }
   const scaffold = scaffoldHarnessBoilerplate(repoPath, {
@@ -27803,9 +28127,9 @@ async function initHarness(options) {
   };
 }
 async function maintainHarness(options) {
-  const repoPath = path16.resolve(options.repoPath);
+  const repoPath = path18.resolve(options.repoPath);
   const harnessDir = getHarnessDir(repoPath);
-  if (!fs18.existsSync(harnessDir)) {
+  if (!fs19.existsSync(harnessDir)) {
     throw new Error('No .har/ found. Run "har env init" first.');
   }
   if (options.auto) {
@@ -27855,9 +28179,111 @@ function addStageTemplate(repoPath, templateId, options = {}) {
   return applyStageTemplate(repoPath, templateId, options);
 }
 
+// src/harness/custom-stage.ts
+var fs20 = __toESM(require("fs"));
+var path19 = __toESM(require("path"));
+var STAGE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+function addCustomStage(repoPath, options) {
+  const resolved = path19.resolve(repoPath);
+  if (!harnessExists(resolved)) {
+    throw new Error('No .har/ harness found. Run "har env init" first.');
+  }
+  const id = options.id.trim();
+  if (!STAGE_ID_PATTERN.test(id)) {
+    throw new Error(
+      `Invalid stage id "${id}". Use lowercase letters, digits, dots, dashes (e.g. "unit-tests").`
+    );
+  }
+  const kind2 = options.kind ?? "custom";
+  if (!HarnessStageKindSchema.options.includes(kind2)) {
+    throw new Error(
+      `Invalid stage kind "${kind2}". Available: ${HarnessStageKindSchema.options.join(", ")}`
+    );
+  }
+  if (Boolean(options.command) === Boolean(options.script)) {
+    throw new Error(
+      'Choose exactly one execution mode: --command "<shell command>" for a one-liner, or --script to scaffold .har/stages/<id>.sh.'
+    );
+  }
+  const registry2 = readStageRegistry(resolved);
+  const existing = registry2.stages.find((s2) => s2.id === id);
+  if (existing && !options.force) {
+    throw new Error(`Stage "${id}" already registered in .har/stages.json. Use --force to replace.`);
+  }
+  const filesWritten = [];
+  const stage = {
+    id,
+    kind: kind2,
+    description: options.description ?? `Custom ${kind2} stage`,
+    requiresAgentId: true,
+    artifacts: []
+  };
+  if (options.command) {
+    stage.command = options.command;
+  } else {
+    const scriptRel = path19.join("stages", `${id}.sh`);
+    const scriptAbs = path19.join(resolved, ".har", scriptRel);
+    if (fs20.existsSync(scriptAbs) && !options.force) {
+      throw new Error(`Stage script already exists: .har/${scriptRel}. Use --force to overwrite.`);
+    }
+    const skeletonPath = path19.join(
+      resolveTemplatesDir(),
+      "stage-templates",
+      "custom-stage-skeleton.sh"
+    );
+    const skeleton = fs20.readFileSync(skeletonPath, "utf8").replace(/__STAGE_ID__/g, id).replace(/__STAGE_KIND__/g, kind2).replace(/__STAGE_DESCRIPTION__/g, stage.description);
+    fs20.mkdirSync(path19.dirname(scriptAbs), { recursive: true });
+    fs20.writeFileSync(scriptAbs, skeleton);
+    fs20.chmodSync(scriptAbs, 493);
+    filesWritten.push(`.har/${scriptRel}`);
+    stage.script = scriptRel;
+    stage.artifacts = [
+      {
+        path: `.har/artifacts/${id}`,
+        kind: "directory",
+        description: `Artifacts for the ${id} stage`
+      }
+    ];
+  }
+  const parsedStage = HarnessStageSchema.parse(stage);
+  const stages = existing ? registry2.stages.map((s2) => s2.id === id ? parsedStage : s2) : [...registry2.stages, parsedStage];
+  const verification = options.verification ?? false;
+  const verificationStages = [...registry2.verificationStages ?? []];
+  if (verification && !verificationStages.includes(id)) {
+    verificationStages.push(id);
+    const verifyIdx = stages.findIndex((s2) => s2.id === "verify");
+    if (verifyIdx >= 0) {
+      stages[verifyIdx] = {
+        ...stages[verifyIdx],
+        description: `Verification pipeline (quick smoke by default; --full runs the registry's verificationStages: ${verificationStages.join(", ")})`
+      };
+    }
+  }
+  writeStageRegistry(resolved, { ...registry2, stages, verificationStages });
+  filesWritten.push(".har/stages.json");
+  const nextSteps = options.command ? [
+    `Try it: ${options.command.replace(/\{agentId\}/g, "1")}`,
+    `Agents run it via the MCP tool har_run_stage (stageId: "${id}")`,
+    ...verification ? ["./.har/verify.sh 1 --full   # runs it as part of full verification"] : []
+  ] : [
+    `Edit .har/stages/${id}.sh \u2014 replace the TODO block with the real check`,
+    "./.har/launch.sh 1",
+    `./.har/stages/${id}.sh 1`,
+    ...verification ? ["./.har/verify.sh 1 --full   # runs it as part of full verification"] : []
+  ];
+  return {
+    stageId: id,
+    kind: kind2,
+    mode: options.command ? "command" : "script",
+    filesWritten,
+    verification,
+    nextSteps
+  };
+}
+
 // src/harness/adaptation-prompt.ts
-var fs19 = __toESM(require("fs"));
-var path17 = __toESM(require("path"));
+var fs21 = __toESM(require("fs"));
+var path20 = __toESM(require("path"));
 var ADAPTATION_PROMPT_FILE = "ADAPT-PROMPT.md";
 var PROFILE_HINTS = {
   default: "Web app profile (SaaS/full-stack) \u2014 Docker Compose for shared infra (HARNESS_INFRA_SERVICES), PM2 for the primary application only, git worktree per agent slot by default. Launch provisions toolchain via harness.env (HARNESS_ECOSYSTEM, HARNESS_INSTALL_CMD) and writes paths to .env.agent.<id>. Identify the primary app agents modify; run supporting services shared.",
@@ -27869,7 +28295,7 @@ function loadTemplate(name) {
   if (!filePath) {
     throw new Error(`Adaptation prompt template not found: ${name}. Run npm run build.`);
   }
-  return fs19.readFileSync(filePath, "utf8");
+  return fs21.readFileSync(filePath, "utf8");
 }
 function applyProfilePlaceholders(content, profile) {
   return content.replace(/\{\{PROFILE\}\}/g, profile).replace(/\{\{PROFILE_HINT\}\}/g, PROFILE_HINTS[profile]);
@@ -27891,7 +28317,7 @@ function buildMaintainAdaptationPrompt(_repoPath, bundleReport) {
 }
 function writeAdaptationPrompt(repoPath, content) {
   const harnessDir = getHarnessDir(repoPath);
-  const filePath = path17.join(harnessDir, ADAPTATION_PROMPT_FILE);
+  const filePath = path20.join(harnessDir, ADAPTATION_PROMPT_FILE);
   writeFileSafe(filePath, content);
   return filePath;
 }
@@ -27910,25 +28336,25 @@ function printAdaptationPrompt(content) {
 }
 
 // src/harness/cursor-rule.ts
-var fs20 = __toESM(require("fs"));
-var path18 = __toESM(require("path"));
-var readline3 = __toESM(require("readline"));
+var fs22 = __toESM(require("fs"));
+var path21 = __toESM(require("path"));
+var readline4 = __toESM(require("readline"));
 var CURSOR_RULE_RELATIVE_PATH = ".cursor/rules/har-workflow.mdc";
 function getCursorRulePath(repoPath) {
-  return path18.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
+  return path21.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
 }
 function isCursorWorkspace(repoPath) {
-  return fs20.existsSync(path18.join(repoPath, ".cursor"));
+  return fs22.existsSync(path21.join(repoPath, ".cursor"));
 }
 function cursorRuleExists(repoPath) {
-  return fs20.existsSync(getCursorRulePath(repoPath));
+  return fs22.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 = fs20.readFileSync(templatePath, "utf8");
+  const content = fs22.readFileSync(templatePath, "utf8");
   writeFileSafe(getCursorRulePath(repoPath), content);
 }
 async function handleCursorRule(options) {
@@ -27962,20 +28388,20 @@ async function handleCursorRule(options) {
 }
 async function promptScaffoldCursorRule(exists) {
   const action = exists ? "Update" : "Create";
-  return askYesNo2(`${action} ${CURSOR_RULE_RELATIVE_PATH}? [Y/n]`);
+  return askYesNo3(`${action} ${CURSOR_RULE_RELATIVE_PATH}? [Y/n]`);
 }
-async function askYesNo2(question) {
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve26) => {
+async function askYesNo3(question) {
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve28) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve26(true);
+        resolve28(true);
         return;
       }
-      resolve26(/^y(es)?$/i.test(trimmed));
+      resolve28(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -28054,26 +28480,26 @@ function buildStageResult(input) {
 }
 
 // src/core/local-executor.ts
-var fs22 = __toESM(require("fs"));
-var path20 = __toESM(require("path"));
+var fs24 = __toESM(require("fs"));
+var path23 = __toESM(require("path"));
 
 // src/core/slot-registry.ts
-var fs21 = __toESM(require("fs"));
-var path19 = __toESM(require("path"));
+var fs23 = __toESM(require("fs"));
+var path22 = __toESM(require("path"));
 function getSlotRegistryDir(repoPath) {
-  return path19.join(getHarnessDir(repoPath), "slots");
+  return path22.join(getHarnessDir(repoPath), "slots");
 }
 function getSlotRegistryPath(repoPath, agentId) {
-  return path19.join(getSlotRegistryDir(repoPath), `agent-${agentId}.json`);
+  return path22.join(getSlotRegistryDir(repoPath), `agent-${agentId}.json`);
 }
 function isSlotResumable(session) {
   return session?.status === "failed" || session?.status === "starting";
 }
 function readSlotRegistry(repoPath, agentId) {
   const file = getSlotRegistryPath(repoPath, agentId);
-  if (!fs21.existsSync(file)) return void 0;
+  if (!fs23.existsSync(file)) return void 0;
   try {
-    const raw = JSON.parse(fs21.readFileSync(file, "utf8"));
+    const raw = JSON.parse(fs23.readFileSync(file, "utf8"));
     const result = SlotRegistryEntrySchema.safeParse(raw);
     return result.success ? result.data : void 0;
   } catch {
@@ -28083,7 +28509,7 @@ function readSlotRegistry(repoPath, agentId) {
 
 // src/core/local-executor.ts
 function resolveRepoPath(repoPath) {
-  return path20.resolve(repoPath);
+  return path23.resolve(repoPath);
 }
 function buildPreviewUrlsFromPorts(ports, env3) {
   const urls = {};
@@ -28135,14 +28561,14 @@ function substituteAgentId(value, agentId) {
 function resolveStageScriptPath(repoPath, stage) {
   const harnessDir = getHarnessDir(repoPath);
   if (stage.script) {
-    return path20.join(harnessDir, stage.script);
+    return path23.join(harnessDir, stage.script);
   }
   if (stage.command) {
     const scriptName = stage.command.split(/\s+/)[0].replace(/^\.\/\.har\//, "").replace(/^\.\//, "");
-    return path20.join(harnessDir, scriptName);
+    return path23.join(harnessDir, scriptName);
   }
-  const stageScript = path20.join(harnessDir, "stages", `${stage.id}.sh`);
-  if (fs22.existsSync(stageScript)) {
+  const stageScript = path23.join(harnessDir, "stages", `${stage.id}.sh`);
+  if (fs24.existsSync(stageScript)) {
     return stageScript;
   }
   throw new Error(
@@ -28157,7 +28583,7 @@ function buildExecutionPlan(repoPath, stage, options) {
     ...harnessEnv,
     ...stage.env ?? {}
   };
-  const cwd = stage.cwd ? path20.resolve(resolvedRepo, stage.cwd) : resolvedRepo;
+  const cwd = stage.cwd ? path23.resolve(resolvedRepo, stage.cwd) : resolvedRepo;
   const extraArgs = options.args ?? [];
   const launchFlagArgs = [];
   if (stage.kind === "launch" && options.launchFlags) {
@@ -28234,19 +28660,19 @@ var LocalScriptExecutor = class {
     const repoPath = resolveRepoPath(ctx.repoPath);
     const harnessDir = getHarnessDir(repoPath);
     const artifactsDirName = getArtifactsDir(repoPath);
-    const artifactsDir = path20.join(harnessDir, artifactsDirName);
-    if (!fs22.existsSync(artifactsDir)) return [];
+    const artifactsDir = path23.join(harnessDir, artifactsDirName);
+    if (!fs24.existsSync(artifactsDir)) return [];
     const entries = [];
     const walk = (dir, prefix) => {
-      for (const entry of fs22.readdirSync(dir, { withFileTypes: true })) {
-        const full = path20.join(dir, entry.name);
-        const relative2 = path20.join(prefix, entry.name);
+      for (const entry of fs24.readdirSync(dir, { withFileTypes: true })) {
+        const full = path23.join(dir, entry.name);
+        const relative2 = path23.join(prefix, entry.name);
         if (entry.isDirectory()) {
           walk(full, relative2);
           continue;
         }
         if (filter?.stageId && !relative2.includes(filter.stageId)) continue;
-        const stat = fs22.statSync(full);
+        const stat = fs24.statSync(full);
         entries.push({
           path: full,
           relativePath: relative2,
@@ -28262,7 +28688,7 @@ var LocalScriptExecutor = class {
 var localScriptExecutor = new LocalScriptExecutor();
 
 // src/core/control-sync.ts
-var path30 = __toESM(require("path"));
+var path33 = __toESM(require("path"));
 
 // src/core/control-config.ts
 var DEFAULT_CONTROL_API_URL = "http://localhost:3847";
@@ -28274,32 +28700,32 @@ function isControlEnabled() {
 }
 
 // src/core/control-registry.ts
-var fs23 = __toESM(require("fs"));
-var os3 = __toESM(require("os"));
-var path21 = __toESM(require("path"));
+var fs25 = __toESM(require("fs"));
+var os4 = __toESM(require("os"));
+var path24 = __toESM(require("path"));
 function getRegistryPath() {
   if (process.env.HAR_CONTROL_REGISTRY_PATH) {
-    return path21.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
+    return path24.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
   }
-  return path21.join(os3.homedir(), ".har", "repos.json");
+  return path24.join(os4.homedir(), ".har", "repos.json");
 }
 function readRegistry() {
   const registryPath = getRegistryPath();
   try {
-    if (!fs23.existsSync(registryPath)) return { repos: [] };
-    return JSON.parse(fs23.readFileSync(registryPath, "utf8"));
+    if (!fs25.existsSync(registryPath)) return { repos: [] };
+    return JSON.parse(fs25.readFileSync(registryPath, "utf8"));
   } catch {
     return { repos: [] };
   }
 }
 function writeRegistry(registry2) {
   const registryPath = getRegistryPath();
-  fs23.mkdirSync(path21.dirname(registryPath), { recursive: true });
-  fs23.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
+  fs25.mkdirSync(path24.dirname(registryPath), { recursive: true });
+  fs25.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
 }
 function recordRepoForControlSync(repoPath) {
   if (process.env.HAR_CONTROL_DISABLED === "true") return;
-  const resolved = path21.resolve(repoPath);
+  const resolved = path24.resolve(repoPath);
   if (!readManifest(resolved)) return;
   const registry2 = readRegistry();
   if (registry2.repos.includes(resolved)) return;
@@ -28308,7 +28734,7 @@ function recordRepoForControlSync(repoPath) {
 }
 function listRegisteredRepos() {
   const registry2 = readRegistry();
-  const kept = registry2.repos.filter((repoPath) => fs23.existsSync(repoPath) && readManifest(repoPath));
+  const kept = registry2.repos.filter((repoPath) => fs25.existsSync(repoPath) && readManifest(repoPath));
   if (kept.length !== registry2.repos.length) {
     writeRegistry({ repos: kept });
   }
@@ -28316,17 +28742,17 @@ function listRegisteredRepos() {
 }
 
 // src/core/slot-status.ts
-var fs28 = __toESM(require("fs"));
-var os6 = __toESM(require("os"));
-var path27 = __toESM(require("path"));
+var fs30 = __toESM(require("fs"));
+var os7 = __toESM(require("os"));
+var path30 = __toESM(require("path"));
 var import_child_process7 = require("child_process");
 
 // src/core/runs.ts
 var crypto2 = __toESM(require("crypto"));
 var import_child_process2 = require("child_process");
-var fs24 = __toESM(require("fs"));
-var os4 = __toESM(require("os"));
-var path22 = __toESM(require("path"));
+var fs26 = __toESM(require("fs"));
+var os5 = __toESM(require("os"));
+var path25 = __toESM(require("path"));
 var RUNS_DIR = "runs";
 function gitCommonDir(cwd) {
   try {
@@ -28335,7 +28761,7 @@ function gitCommonDir(cwd) {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
     }).trim();
-    return out ? path22.resolve(cwd, out) : void 0;
+    return out ? path25.resolve(cwd, out) : void 0;
   } catch {
     return void 0;
   }
@@ -28357,7 +28783,7 @@ function gitPrefix(cwd) {
   }
 }
 function getRunsDir(harnessRoot) {
-  return path22.join(getHarnessDir(harnessRoot), RUNS_DIR);
+  return path25.join(getHarnessDir(harnessRoot), RUNS_DIR);
 }
 function formatLocalDate(d2) {
   const y2 = d2.getFullYear();
@@ -28377,24 +28803,24 @@ function buildRunRelativePath(stageId, agentId, startedAt, runId, runsDir) {
   const timePart = formatLocalTime(started);
   const agentPart = agentId !== void 0 ? `_agent-${agentId}` : "";
   let filename = `${timePart}_${stageId}${agentPart}.json`;
-  const fullPath = path22.join(runsDir, dateFolder, filename);
-  if (fs24.existsSync(fullPath)) {
+  const fullPath = path25.join(runsDir, dateFolder, filename);
+  if (fs26.existsSync(fullPath)) {
     filename = `${timePart}_${stageId}${agentPart}-${runId.slice(0, 8)}.json`;
   }
-  return path22.join(dateFolder, filename);
+  return path25.join(dateFolder, filename);
 }
 function resolveRunFilePath(harnessRoot, run2) {
   if (run2.relativePath) {
-    return path22.join(getRunsDir(harnessRoot), run2.relativePath);
+    return path25.join(getRunsDir(harnessRoot), run2.relativePath);
   }
-  return path22.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
+  return path25.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
 }
 function collectRunFiles(runsDir) {
-  if (!fs24.existsSync(runsDir)) return [];
+  if (!fs26.existsSync(runsDir)) return [];
   const files = [];
   const walk = (dir) => {
-    for (const entry of fs24.readdirSync(dir, { withFileTypes: true })) {
-      const full = path22.join(dir, entry.name);
+    for (const entry of fs26.readdirSync(dir, { withFileTypes: true })) {
+      const full = path25.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(full);
       } else if (entry.name.endsWith(".json")) {
@@ -28408,30 +28834,30 @@ function collectRunFiles(runsDir) {
 function resolveAgentWorkDir(harnessRoot, agentId) {
   if (agentId === void 0) return void 0;
   const entry = readSlotRegistry(harnessRoot, agentId);
-  if (entry?.workDir && fs24.existsSync(entry.workDir)) return entry.workDir;
+  if (entry?.workDir && fs26.existsSync(entry.workDir)) return entry.workDir;
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path22.basename(harnessRoot);
-  const worktreeDir = path22.join(os4.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path25.basename(harnessRoot);
+  const worktreeDir = path25.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
   const relPrefix = gitPrefix(harnessRoot);
   const sessionEnvFiles = [];
-  const worktreesRoot = path22.join(os4.homedir(), "worktrees");
-  if (fs24.existsSync(worktreesRoot)) {
+  const worktreesRoot = path25.join(os5.homedir(), "worktrees");
+  if (fs26.existsSync(worktreesRoot)) {
     const suffix = `-har-agent-${agentId}-`;
-    for (const entry2 of fs24.readdirSync(worktreesRoot, { withFileTypes: true })) {
+    for (const entry2 of fs26.readdirSync(worktreesRoot, { withFileTypes: true })) {
       if (!entry2.isDirectory() || !entry2.name.includes(suffix)) continue;
-      const sessionDir = path22.join(worktreesRoot, entry2.name);
+      const sessionDir = path25.join(worktreesRoot, entry2.name);
       if (!sameGitCheckout(harnessRoot, sessionDir)) continue;
-      sessionEnvFiles.push(path22.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
+      sessionEnvFiles.push(path25.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
     }
   }
   const candidates = [
-    path22.join(worktreeDir, `.env.agent.${agentId}`),
-    path22.join(harnessRoot, `.env.agent.${agentId}`),
+    path25.join(worktreeDir, `.env.agent.${agentId}`),
+    path25.join(harnessRoot, `.env.agent.${agentId}`),
     ...sessionEnvFiles.sort()
   ];
   for (const envFile of candidates) {
-    if (!fs24.existsSync(envFile)) continue;
-    const content = fs24.readFileSync(envFile, "utf8");
+    if (!fs26.existsSync(envFile)) continue;
+    const content = fs26.readFileSync(envFile, "utf8");
     const match = content.match(/^REPO_ROOT=(.+)$/m);
     if (match) return match[1].trim();
   }
@@ -28443,11 +28869,11 @@ function createRun(ctx, meta) {
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const runId = crypto2.randomUUID();
   const relativePath = buildRunRelativePath(meta.stageId, meta.agentId, startedAt, runId, runsDir);
-  const runFilePath = path22.join(runsDir, relativePath);
-  fs24.mkdirSync(path22.dirname(runFilePath), { recursive: true });
+  const runFilePath = path25.join(runsDir, relativePath);
+  fs26.mkdirSync(path25.dirname(runFilePath), { recursive: true });
   const run2 = RunRecordSchema.parse({
     runId,
-    repoPath: path22.resolve(ctx.repoPath),
+    repoPath: path25.resolve(ctx.repoPath),
     harnessRoot,
     stageId: meta.stageId,
     kind: meta.kind,
@@ -28458,7 +28884,7 @@ function createRun(ctx, meta) {
     relativePath,
     trigger: ctx.trigger ?? "cli"
   });
-  fs24.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
+  fs26.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
   return run2;
 }
 function finishRun(repoPath, runId, update) {
@@ -28477,13 +28903,13 @@ function finishRun(repoPath, runId, update) {
     finishedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   const runPath = resolveRunFilePath(harnessRoot, finished);
-  fs24.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
+  fs26.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
   return finished;
 }
 function findRunRecord(harnessRoot, runId) {
   const runsDir = getRunsDir(harnessRoot);
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs24.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs26.readFileSync(filePath, "utf8")));
     if (parsed.success && parsed.data.runId === runId) {
       return parsed.data;
     }
@@ -28495,10 +28921,10 @@ function getRun(repoPath, runId) {
 }
 function listRuns(repoPath, filter = {}) {
   const runsDir = getRunsDir(resolveHarnessRoot(repoPath));
-  if (!fs24.existsSync(runsDir)) return [];
+  if (!fs26.existsSync(runsDir)) return [];
   const runs = [];
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs24.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs26.readFileSync(filePath, "utf8")));
     if (!parsed.success) continue;
     if (filter.stageId && parsed.data.stageId !== filter.stageId) continue;
     runs.push(parsed.data);
@@ -28511,17 +28937,17 @@ function listRuns(repoPath, filter = {}) {
 }
 
 // src/core/slot-preflight.ts
-var path26 = __toESM(require("path"));
+var path29 = __toESM(require("path"));
 
 // src/core/control-port.ts
 var import_child_process4 = require("child_process");
-var fs26 = __toESM(require("fs"));
-var path24 = __toESM(require("path"));
+var fs28 = __toESM(require("fs"));
+var path27 = __toESM(require("path"));
 
 // src/core/slot-ports.ts
 var import_child_process3 = require("child_process");
-var fs25 = __toESM(require("fs"));
-var path23 = __toESM(require("path"));
+var fs27 = __toESM(require("fs"));
+var path26 = __toESM(require("path"));
 function portStep(env3) {
   return Number(env3.HARNESS_PORT_STEP ?? 10);
 }
@@ -28577,7 +29003,7 @@ function allocateAppPorts(repoPath, agentId) {
 }
 function harnessUsesPm2(repoPath) {
   const harnessRoot = resolveHarnessRoot(repoPath);
-  return fs25.existsSync(path23.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
+  return fs27.existsSync(path26.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
 }
 
 // src/core/control-port.ts
@@ -28632,13 +29058,13 @@ function controlDefaultPortWarnings(containers, defaultFrontendPort, allocatedFr
   return [formatControlDefaultPortWarning(control.name, defaultFrontendPort, allocatedFrontend)];
 }
 function inspectControlUpReadiness(repoPath) {
-  const resolved = path24.resolve(repoPath);
+  const resolved = path27.resolve(repoPath);
   const port = parseControlHostPort();
   const containers = listDockerContainers();
   const control = controlContainerOnPort(containers, port);
   const warnings = [];
-  const controlHarnessDir = path24.join(resolved, "control", ".har");
-  const harnessSlot1Active = fs26.existsSync(controlHarnessDir) && readSlotRegistry(path24.join(resolved, "control"), 1)?.status === "active";
+  const controlHarnessDir = path27.join(resolved, "control", ".har");
+  const harnessSlot1Active = fs28.existsSync(controlHarnessDir) && readSlotRegistry(path27.join(resolved, "control"), 1)?.status === "active";
   if (control) {
     return {
       warnings,
@@ -28669,9 +29095,9 @@ function inspectControlUpReadiness(repoPath) {
 }
 
 // src/core/slot-launch-guard-occupied.ts
-var fs27 = __toESM(require("fs"));
-var os5 = __toESM(require("os"));
-var path25 = __toESM(require("path"));
+var fs29 = __toESM(require("fs"));
+var os6 = __toESM(require("os"));
+var path28 = __toESM(require("path"));
 var import_child_process5 = require("child_process");
 function runGit(cwd, args) {
   try {
@@ -28690,7 +29116,7 @@ function worktreeDirty(worktreePath) {
 }
 function gitCommonDir2(cwd) {
   const out = runGit(cwd, "rev-parse --git-common-dir");
-  return out ? path25.resolve(cwd, out) : void 0;
+  return out ? path28.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout2(a2, b2) {
   const left2 = gitCommonDir2(a2);
@@ -28699,20 +29125,20 @@ function sameGitCheckout2(a2, b2) {
 }
 function discoverWorktree(harnessRoot, agentId, projectName) {
   const session = readSlotRegistry(harnessRoot, agentId);
-  if (session?.worktreePath && fs27.existsSync(session.worktreePath)) {
+  if (session?.worktreePath && fs29.existsSync(session.worktreePath)) {
     return session.worktreePath;
   }
-  const legacy = path25.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
-  if (fs27.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
-  const worktreesRoot = path25.join(os5.homedir(), "worktrees");
-  if (!fs27.existsSync(worktreesRoot)) return void 0;
+  const legacy = path28.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  if (fs29.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
+  const worktreesRoot = path28.join(os6.homedir(), "worktrees");
+  if (!fs29.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = runGit(harnessRoot, "rev-parse --show-prefix") ?? "";
-  for (const name of fs27.readdirSync(worktreesRoot)) {
+  for (const name of fs29.readdirSync(worktreesRoot)) {
     if (!name.includes(suffix)) continue;
-    const candidate = path25.join(worktreesRoot, name);
+    const candidate = path28.join(worktreesRoot, name);
     if (!sameGitCheckout2(harnessRoot, candidate)) continue;
-    if (!fs27.existsSync(path25.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
+    if (!fs29.existsSync(path28.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
     return candidate;
   }
   return void 0;
@@ -28720,13 +29146,13 @@ function discoverWorktree(harnessRoot, agentId, projectName) {
 function collectOccupiedSlot(repoPath, agentId) {
   const harnessRoot = resolveHarnessRoot(repoPath);
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path25.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path28.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
   const worktreePath = discoverWorktree(harnessRoot, agentId, projectName);
   const workDir = session?.workDir;
-  const envInWorkDir = workDir ? fs27.existsSync(path25.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs27.existsSync(path25.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs27.existsSync(path25.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs29.existsSync(path28.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs29.existsSync(path28.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs29.existsSync(path28.join(worktreePath, `.env.agent.${agentId}`)) : false;
   const active = session !== void 0 && session.status !== "completed" || envInWorkDir || envInRoot || envInWorktree;
   if (!active) return void 0;
   const dirty = worktreePath ? worktreeDirty(worktreePath) : void 0;
@@ -28879,7 +29305,7 @@ function checkInfraPort(env3, varName, defaultPort, scanStart, scanEnd) {
 function inspectSlotReadiness(repoPath, agentId, options = {}) {
   const harnessRoot = resolveHarnessRoot(repoPath);
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path26.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path29.basename(harnessRoot);
   const usesPm2 = harnessUsesPm2(repoPath);
   const blockers = [];
   const remediations = [];
@@ -29081,7 +29507,7 @@ function readWorktreeBranch(worktreePath) {
 }
 function gitCommonDir3(cwd) {
   const out = runGit2(cwd, "rev-parse --git-common-dir");
-  return out ? path27.resolve(cwd, out) : void 0;
+  return out ? path30.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout3(a2, b2) {
   const left2 = gitCommonDir3(a2);
@@ -29093,12 +29519,12 @@ function gitPrefix2(cwd) {
   return out ?? "";
 }
 function discoverSessionWorktreePath(harnessRoot, agentId) {
-  const worktreesRoot = path27.join(os6.homedir(), "worktrees");
-  if (!fs28.existsSync(worktreesRoot)) return void 0;
+  const worktreesRoot = path30.join(os7.homedir(), "worktrees");
+  if (!fs30.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = gitPrefix2(harnessRoot);
-  const matches = fs28.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path27.join(worktreesRoot, entry.name)).filter(
-    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs28.existsSync(path27.join(candidate, relPrefix, `.env.agent.${agentId}`))
+  const matches = fs30.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path30.join(worktreesRoot, entry.name)).filter(
+    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs30.existsSync(path30.join(candidate, relPrefix, `.env.agent.${agentId}`))
   );
   return matches.sort()[0];
 }
@@ -29173,18 +29599,18 @@ function detectPm2Issue(projectName, agentId, session, procs) {
 }
 function collectSlotStatus(harnessRoot, agentId, runs, pm2Procs) {
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path27.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path30.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
-  const legacyWorktreePath = path27.join(
-    os6.homedir(),
+  const legacyWorktreePath = path30.join(
+    os7.homedir(),
     "worktrees",
     `${projectName}-agent-${agentId}`
   );
-  const worktreePath = session?.worktreePath && fs28.existsSync(session.worktreePath) ? session.worktreePath : fs28.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
+  const worktreePath = session?.worktreePath && fs30.existsSync(session.worktreePath) ? session.worktreePath : fs30.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
   const workDir = resolveAgentWorkDir(harnessRoot, agentId);
-  const envInWorkDir = workDir ? fs28.existsSync(path27.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs28.existsSync(path27.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs28.existsSync(path27.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs30.existsSync(path30.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs30.existsSync(path30.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs30.existsSync(path30.join(worktreePath, `.env.agent.${agentId}`)) : false;
   const active = session !== void 0 && session.status !== "completed" || envInWorkDir || envInRoot || envInWorktree;
   const latest = latestRunForAgent(runs, agentId);
   const verifyRun = runs.find((r2) => r2.agentId === agentId && r2.stageId === "verify");
@@ -29237,7 +29663,7 @@ function collectEnvironmentStatus(repoPath) {
   const slotIds = getAgentSlotIds(harnessRoot);
   const pm2Procs = listPm2Processes2();
   return {
-    repoPath: path27.resolve(repoPath),
+    repoPath: path30.resolve(repoPath),
     harnessRoot,
     gitRemote: readGitRemote(harnessRoot),
     profile: manifest?.profile,
@@ -29248,13 +29674,13 @@ function collectEnvironmentStatus(repoPath) {
 
 // src/core/validations.ts
 var crypto3 = __toESM(require("crypto"));
-var fs30 = __toESM(require("fs"));
-var path29 = __toESM(require("path"));
+var fs32 = __toESM(require("fs"));
+var path32 = __toESM(require("path"));
 
 // src/core/change-batch.ts
-var fs29 = __toESM(require("fs"));
-var os7 = __toESM(require("os"));
-var path28 = __toESM(require("path"));
+var fs31 = __toESM(require("fs"));
+var os8 = __toESM(require("os"));
+var path31 = __toESM(require("path"));
 function git(checkoutDir, args, env3) {
   const result = run(`git ${args}`, { cwd: checkoutDir, env: env3 });
   if (result.code !== 0) {
@@ -29270,7 +29696,7 @@ function isCheckoutRoot(checkoutDir) {
   const toplevel = tryGit(checkoutDir, "rev-parse --show-toplevel");
   if (!toplevel) return false;
   try {
-    return fs29.realpathSync(toplevel) === fs29.realpathSync(checkoutDir);
+    return fs31.realpathSync(toplevel) === fs31.realpathSync(checkoutDir);
   } catch {
     return false;
   }
@@ -29292,7 +29718,7 @@ function isMergeOrRebaseInProgress(checkoutDir) {
   if (tryGit(checkoutDir, "rev-parse -q --verify MERGE_HEAD") !== void 0) return true;
   for (const dir of ["rebase-merge", "rebase-apply"]) {
     const gitPath = tryGit(checkoutDir, `rev-parse --git-path ${dir}`);
-    if (gitPath && fs29.existsSync(path28.resolve(checkoutDir, gitPath))) return true;
+    if (gitPath && fs31.existsSync(path31.resolve(checkoutDir, gitPath))) return true;
   }
   return false;
 }
@@ -29315,8 +29741,8 @@ function parseNameStatus(output) {
   return files;
 }
 function computeWorktreeSnapshot(checkoutDir) {
-  const tmpDir = fs29.mkdtempSync(path28.join(os7.tmpdir(), "har-idx-"));
-  const tmpIndex = path28.join(tmpDir, "index");
+  const tmpDir = fs31.mkdtempSync(path31.join(os8.tmpdir(), "har-idx-"));
+  const tmpIndex = path31.join(tmpDir, "index");
   const env3 = { GIT_INDEX_FILE: tmpIndex };
   try {
     const headTree = getHeadTree(checkoutDir);
@@ -29339,35 +29765,35 @@ function computeWorktreeSnapshot(checkoutDir) {
       changedFiles: parseNameStatus(diffOutput)
     };
   } finally {
-    fs29.rmSync(tmpDir, { recursive: true, force: true });
+    fs31.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 
 // src/core/validations.ts
 var VALIDATIONS_DIR = "validations";
 function getValidationsDir(checkoutDir) {
-  return path29.join(checkoutDir, ".har", VALIDATIONS_DIR);
+  return path32.join(checkoutDir, ".har", VALIDATIONS_DIR);
 }
 function validationPath(checkoutDir, treeHash) {
-  return path29.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
+  return path32.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
 }
 function writeRecord(checkoutDir, record2) {
   const dir = getValidationsDir(checkoutDir);
-  fs30.mkdirSync(dir, { recursive: true });
-  fs30.writeFileSync(
+  fs32.mkdirSync(dir, { recursive: true });
+  fs32.writeFileSync(
     validationPath(checkoutDir, record2.treeHash),
     `${JSON.stringify(record2, null, 2)}
 `
   );
 }
 function ensureValidationsIgnored(checkoutDir) {
-  const harDir = path29.join(checkoutDir, ".har");
-  if (!fs30.existsSync(harDir)) return;
-  const gitignorePath = path29.join(harDir, ".gitignore");
-  const content = fs30.existsSync(gitignorePath) ? fs30.readFileSync(gitignorePath, "utf8") : "";
+  const harDir = path32.join(checkoutDir, ".har");
+  if (!fs32.existsSync(harDir)) return;
+  const gitignorePath = path32.join(harDir, ".gitignore");
+  const content = fs32.existsSync(gitignorePath) ? fs32.readFileSync(gitignorePath, "utf8") : "";
   if (content.split("\n").some((line) => line.trim() === `${VALIDATIONS_DIR}/`)) return;
   const suffix = content.length === 0 || content.endsWith("\n") ? "" : "\n";
-  fs30.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
+  fs32.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
 `);
 }
 function recordValidation(input) {
@@ -29384,8 +29810,8 @@ function recordValidation(input) {
     treeHash: snapshot.treeHash,
     headSha: snapshot.headSha,
     branch: snapshot.branch,
-    workDir: path29.resolve(input.checkoutDir),
-    harnessRoot: path29.resolve(input.harnessRoot),
+    workDir: path32.resolve(input.checkoutDir),
+    harnessRoot: path32.resolve(input.harnessRoot),
     agentId: input.agentId,
     status: input.status,
     full: input.full,
@@ -29397,16 +29823,16 @@ function recordValidation(input) {
     committedAt: existing?.committedAt
   });
   writeRecord(input.checkoutDir, record2);
-  if (path29.resolve(input.harnessRoot) !== path29.resolve(input.checkoutDir)) {
+  if (path32.resolve(input.harnessRoot) !== path32.resolve(input.checkoutDir)) {
     writeRecord(input.harnessRoot, record2);
   }
   return record2;
 }
 function findValidation(checkoutDir, treeHash) {
   const file = validationPath(checkoutDir, treeHash);
-  if (!fs30.existsSync(file)) return void 0;
+  if (!fs32.existsSync(file)) return void 0;
   try {
-    return ValidationRecordSchema.parse(JSON.parse(fs30.readFileSync(file, "utf8")));
+    return ValidationRecordSchema.parse(JSON.parse(fs32.readFileSync(file, "utf8")));
   } catch {
     return void 0;
   }
@@ -29421,19 +29847,19 @@ function attachCommit(checkoutDir, treeHash, commitSha) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   writeRecord(checkoutDir, updated);
-  if (record2.harnessRoot && path29.resolve(record2.harnessRoot) !== path29.resolve(checkoutDir) && fs30.existsSync(path29.join(record2.harnessRoot, ".har"))) {
+  if (record2.harnessRoot && path32.resolve(record2.harnessRoot) !== path32.resolve(checkoutDir) && fs32.existsSync(path32.join(record2.harnessRoot, ".har"))) {
     writeRecord(record2.harnessRoot, updated);
   }
   return updated;
 }
 function listValidations(harnessRoot) {
   const dir = getValidationsDir(harnessRoot);
-  if (!fs30.existsSync(dir)) return [];
+  if (!fs32.existsSync(dir)) return [];
   const records = [];
-  for (const entry of fs30.readdirSync(dir)) {
+  for (const entry of fs32.readdirSync(dir)) {
     if (!entry.endsWith(".json")) continue;
     try {
-      records.push(ValidationRecordSchema.parse(JSON.parse(fs30.readFileSync(path29.join(dir, entry), "utf8"))));
+      records.push(ValidationRecordSchema.parse(JSON.parse(fs32.readFileSync(path32.join(dir, entry), "utf8"))));
     } catch {
     }
   }
@@ -29491,7 +29917,7 @@ async function waitForControlApi(apiUrl = getControlApiUrl(), timeoutMs = 6e4, i
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await isControlApiReachable(apiUrl)) return true;
-    await new Promise((resolve26) => setTimeout(resolve26, intervalMs));
+    await new Promise((resolve28) => setTimeout(resolve28, intervalMs));
   }
   return false;
 }
@@ -29503,7 +29929,7 @@ async function syncAllKnownReposWithControl(options) {
   }
   const repoPaths = new Set(listRegisteredRepos());
   if (options?.cwd) {
-    const cwd = path30.resolve(options.cwd);
+    const cwd = path33.resolve(options.cwd);
     if (readManifest(cwd)) repoPaths.add(cwd);
   }
   try {
@@ -29511,7 +29937,7 @@ async function syncAllKnownReposWithControl(options) {
     if (listResponse.ok) {
       const repos = await listResponse.json();
       for (const repo of repos) {
-        const resolved = path30.resolve(repo.path);
+        const resolved = path33.resolve(repo.path);
         if (readManifest(resolved)) repoPaths.add(resolved);
       }
     }
@@ -29530,7 +29956,7 @@ async function syncAllKnownReposWithControl(options) {
   return { synced, failed };
 }
 async function registerRepoWithControl(options) {
-  const repoPath = path30.resolve(options.repoPath);
+  const repoPath = path33.resolve(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   const manifest = readManifest(repoPath);
   const stagesRegistry = readStageRegistry(repoPath);
@@ -29543,7 +29969,7 @@ async function registerRepoWithControl(options) {
   return postJson(`${apiUrl}/api/repos`, body, options.dryRun);
 }
 async function syncRepoWithControl(options) {
-  const repoPath = path30.resolve(options.repoPath);
+  const repoPath = path33.resolve(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   if (options.cloud) {
     const remote = createRemoteExecutor();
@@ -29571,7 +29997,7 @@ async function syncRepoWithControl(options) {
     const listResponse = await fetch(`${apiUrl}/api/repos`);
     if (!listResponse.ok) throw new Error("Failed to list repos from Control API");
     const repos = await listResponse.json();
-    const existing = repos.find((r2) => path30.resolve(r2.path) === repoPath);
+    const existing = repos.find((r2) => path33.resolve(r2.path) === repoPath);
     if (!existing) throw new Error(`Repo not registered: ${repoPath}`);
     await syncRepoRunsAndSlots(apiUrl, existing.id, repoPath, options.dryRun);
     return;
@@ -29978,6 +30404,13 @@ var envCommand = {
       type: "boolean",
       default: false,
       describe: "Skip Cursor rule scaffolding"
+    }).option("agents", {
+      type: "string",
+      describe: "Scaffold agent skills for these targets (comma-separated: claude,cursor,codex); auto-detected when omitted"
+    }).option("no-agents", {
+      type: "boolean",
+      default: false,
+      describe: "Skip agent skills scaffolding"
     }),
     handleInit
   ).command(
@@ -30002,14 +30435,46 @@ var envCommand = {
       type: "boolean",
       default: false,
       describe: "Skip Cursor rule scaffolding"
+    }).option("agents", {
+      type: "string",
+      describe: "Scaffold agent skills for these targets (comma-separated: claude,cursor,codex); auto-detected when omitted"
+    }).option("no-agents", {
+      type: "boolean",
+      default: false,
+      describe: "Skip agent skills scaffolding"
     }),
     handleMaintain
   ).command(
-    "add-stage <template>",
-    "Add an optional stage template (e.g. playwright)",
+    "add-stage [template]",
+    `Add a stage template (${STAGE_TEMPLATE_IDS.join(", ")}) or a custom stage (--custom)`,
     (y2) => y2.positional("template", {
       type: "string",
-      describe: "Stage template id (playwright)"
+      describe: `Stage template id (${STAGE_TEMPLATE_IDS.join(", ")}), or the new stage id with --custom`
+    }).option("list", {
+      type: "boolean",
+      default: false,
+      describe: "List available stage templates and exit"
+    }).option("custom", {
+      type: "boolean",
+      default: false,
+      describe: "Register a custom stage instead of a shipped template"
+    }).option("kind", {
+      type: "string",
+      describe: "Custom stage kind (setup, launch, verify, test, inspect, reset, teardown, custom)"
+    }).option("command", {
+      type: "string",
+      describe: 'Custom stage shell command ({agentId} is substituted), e.g. "npm test"'
+    }).option("script", {
+      type: "boolean",
+      default: false,
+      describe: "Scaffold .har/stages/<id>.sh from the contract skeleton (see .har/STAGES.md)"
+    }).option("description", {
+      type: "string",
+      describe: "Custom stage description shown in the registry and Mission Control"
+    }).option("verification", {
+      type: "boolean",
+      default: false,
+      describe: "Include the custom stage in verify --full (stages.json verificationStages)"
     }).option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("force", {
       type: "boolean",
       default: false,
@@ -30017,7 +30482,7 @@ var envCommand = {
     }).option("skip-ci", {
       type: "boolean",
       default: false,
-      describe: "Do not copy .github/workflows/playwright.yml"
+      describe: "Do not copy optional CI workflow files (e.g. .github/workflows/playwright.yml)"
     }),
     handleAddStage
   ).command(
@@ -30112,7 +30577,7 @@ var envCommand = {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path31.resolve(argv.repo);
+  const repoPath = path34.resolve(argv.repo);
   header("har env init");
   info(`Repository: ${repoPath}`);
   try {
@@ -30156,6 +30621,14 @@ async function handleInit(argv) {
       autoYes: argv.yes,
       mode: "init"
     });
+    await handleAgentSkills({
+      repoPath,
+      agents: argv.agents,
+      enabled: argv.noAgents ? false : void 0,
+      autoYes: argv.yes,
+      force: argv.force,
+      mode: "init"
+    });
     printNextSteps(argv.auto);
   } catch (err) {
     error(err.message);
@@ -30163,7 +30636,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path31.resolve(argv.repo);
+  const repoPath = path34.resolve(argv.repo);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
   try {
@@ -30221,6 +30694,13 @@ async function handleMaintain(argv) {
       autoYes: argv.yes,
       mode: "maintain"
     });
+    await handleAgentSkills({
+      repoPath,
+      agents: argv.agents,
+      enabled: argv.noAgents ? false : void 0,
+      autoYes: argv.yes,
+      mode: "maintain"
+    });
   } catch (err) {
     error(err.message);
     process.exit(1);
@@ -30252,7 +30732,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path31.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path34.join(repoPath, "AGENT.md"), proposal.content);
       clearAgentMdProposal(repoPath);
       info("Applied AGENT.md proposal (--yes)");
     }
@@ -30261,16 +30741,64 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   await promptApplyAgentMdProposal(repoPath);
 }
 async function handleAddStage(argv) {
-  const repoPath = path31.resolve(argv.repo);
-  if (argv.template !== "playwright") {
-    error(`Unknown stage template: ${argv.template ?? "(missing)"}. Available: playwright`);
+  const repoPath = path34.resolve(argv.repo);
+  const available = listStageTemplateIds();
+  if (argv.list) {
+    for (const id of available) {
+      console.log(id);
+    }
+    return;
+  }
+  if (argv.custom) {
+    if (!argv.template) {
+      error(
+        'Missing stage id. Usage: har env add-stage <id> --custom (--command "npm test" | --script) [--kind test] [--verification]'
+      );
+      process.exit(1);
+    }
+    header("har env add-stage --custom");
+    info(`Repository: ${repoPath}`);
+    info(`Stage: ${argv.template}`);
+    try {
+      const result = addCustomStage(repoPath, {
+        id: argv.template,
+        kind: argv.kind,
+        command: argv.command,
+        script: argv.script,
+        description: argv.description,
+        verification: argv.verification,
+        force: argv.force
+      });
+      divider();
+      success(`Custom stage registered: ${result.stageId} (kind: ${result.kind}, ${result.mode})`);
+      for (const file of result.filesWritten) {
+        info(`  + ${file}`);
+      }
+      console.error("");
+      console.error("  Next steps:");
+      for (const step of result.nextSteps) {
+        console.error(`    ${step}`);
+      }
+      console.error("");
+      console.error("  Docs: .har/STAGES.md");
+      console.error("");
+    } catch (err) {
+      error(err.message);
+      process.exit(1);
+    }
+    return;
+  }
+  if (!argv.template || !available.includes(argv.template)) {
+    error(
+      `Unknown stage template: ${argv.template ?? "(missing)"}. Available: ${available.join(", ")}. For a project-specific stage, use: har env add-stage <id> --custom`
+    );
     process.exit(1);
   }
   header("har env add-stage");
   info(`Repository: ${repoPath}`);
   info(`Template: ${argv.template}`);
   try {
-    const result = addStageTemplate(repoPath, "playwright", {
+    const result = addStageTemplate(repoPath, argv.template, {
       force: argv.force,
       skipCi: argv.skipCi
     });
@@ -30282,7 +30810,7 @@ async function handleAddStage(argv) {
       console.error(`    ${step}`);
     }
     console.error("");
-    console.error("  Docs: .har/stages/PLAYWRIGHT.md");
+    console.error(`  Docs: ${result.docsPath}`);
     console.error("");
   } catch (err) {
     error(err.message);
@@ -30290,7 +30818,7 @@ async function handleAddStage(argv) {
   }
 }
 async function handlePreflight(argv) {
-  const repo = path31.resolve(argv.repo);
+  const repo = path34.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -30308,7 +30836,7 @@ async function handlePreflight(argv) {
   process.exit(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path31.resolve(argv.repo);
+  const repo = path34.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   let confirmReplace = argv.replace;
   let force = argv.force;
@@ -30318,10 +30846,10 @@ async function handleLaunch(argv) {
       if (!confirmReplace && process.stdin.isTTY && process.stdout.isTTY) {
         warn("Occupied slot \u2014 review before replacing:");
         console.error(guard.reason ?? "");
-        const readline4 = await import("readline");
-        const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve26) => {
-          rl.question("Replace this slot? [y/N] ", resolve26);
+        const readline5 = await import("readline");
+        const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
+        const answer = await new Promise((resolve28) => {
+          rl.question("Replace this slot? [y/N] ", resolve28);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -30335,10 +30863,10 @@ async function handleLaunch(argv) {
     if (!guardAfterConfirm.allowed && guardAfterConfirm.blocked && guardAfterConfirm.slot?.dirty) {
       if (!force && process.stdin.isTTY && process.stdout.isTTY) {
         warn("Worktree has uncommitted changes.");
-        const readline4 = await import("readline");
-        const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve26) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve26);
+        const readline5 = await import("readline");
+        const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
+        const answer = await new Promise((resolve28) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve28);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -30385,7 +30913,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path31.resolve(argv.repo);
+  const repo = path34.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -30397,7 +30925,7 @@ async function handleVerify(argv) {
   process.exit(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path31.resolve(argv.repo);
+  const repo = path34.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -30408,7 +30936,7 @@ async function handleTeardown(argv) {
   process.exit(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path31.resolve(argv.repo);
+  const repo = path34.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -30429,7 +30957,7 @@ async function handleComplete(argv) {
   process.exit(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path31.resolve(argv.repo);
+  const repoPath = path34.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -30442,7 +30970,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path31.resolve(argv.repo);
+  const repoPath = path34.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");
@@ -30459,7 +30987,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path31.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path34.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     process.exit(1);
@@ -30532,11 +31060,11 @@ function printNextSteps(auto2) {
 }
 
 // src/cli/commands/control.ts
-var path33 = __toESM(require("path"));
+var path36 = __toESM(require("path"));
 
 // src/core/control-lifecycle.ts
 var import_child_process8 = require("child_process");
-var path32 = __toESM(require("path"));
+var path35 = __toESM(require("path"));
 
 // src/core/control-image.ts
 var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
@@ -30555,13 +31083,13 @@ function shouldBuildControlLocally() {
 
 // src/core/control-lifecycle.ts
 function resolveControlDir() {
-  return path32.resolve(__dirname, "..", "control");
+  return path35.resolve(__dirname, "..", "control");
 }
 function resolveControlComposeFiles(options) {
   const controlDir = resolveControlDir();
-  const files = [path32.join(controlDir, "docker-compose.yml")];
+  const files = [path35.join(controlDir, "docker-compose.yml")];
   if (options?.build ?? shouldBuildControlLocally()) {
-    files.push(path32.join(controlDir, "docker-compose.build.yml"));
+    files.push(path35.join(controlDir, "docker-compose.build.yml"));
   }
   return files;
 }
@@ -30730,7 +31258,7 @@ async function handleDown() {
   process.exit(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path33.resolve(argv.repo);
+  const repoPath = path36.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -30750,7 +31278,7 @@ async function handleRegister(argv) {
   }
 }
 async function handleSync(argv) {
-  const repoPath = path33.resolve(argv.repo);
+  const repoPath = path36.resolve(argv.repo);
   try {
     await syncRepoWithControl({
       repoPath,
@@ -30789,7 +31317,7 @@ async function handleWatch(argv) {
   };
   const tick = async () => {
     if (argv.repo) {
-      await syncOne(path33.resolve(argv.repo));
+      await syncOne(path36.resolve(argv.repo));
       return;
     }
     try {
@@ -30820,12 +31348,12 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path35 = __toESM(require("path"));
+var path39 = __toESM(require("path"));
 
 // src/core/hooks.ts
-var fs31 = __toESM(require("fs"));
-var os8 = __toESM(require("os"));
-var path34 = __toESM(require("path"));
+var fs33 = __toESM(require("fs"));
+var os9 = __toESM(require("os"));
+var path37 = __toESM(require("path"));
 var MARKER_START = "# >>> har commit gate (managed by `har hooks`) >>>";
 var MARKER_END = "# <<< har commit gate <<<";
 var PRE_COMMIT_BLOCK = [
@@ -30850,7 +31378,7 @@ function resolveCheckoutRoot(cwd) {
 function resolveHooksDir(checkoutDir) {
   const hooksPath = tryGit2(checkoutDir, "rev-parse --git-path hooks");
   if (!hooksPath) throw new Error(`Not a git checkout: ${checkoutDir}`);
-  return path34.resolve(checkoutDir, hooksPath);
+  return path37.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
   return tryGit2(checkoutDir, "config core.hooksPath") || void 0;
@@ -30858,9 +31386,9 @@ function getConfiguredHooksPath(checkoutDir) {
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path34.resolve(entry)}"`;
+    return `"${process.execPath}" "${path37.resolve(entry)}"`;
   }
-  if (entry) return `"${path34.resolve(entry)}"`;
+  if (entry) return `"${path37.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -30881,40 +31409,40 @@ exit 0
 `;
 }
 function upsertMarkedBlock(filePath, block) {
-  if (!fs31.existsSync(filePath)) {
-    fs31.writeFileSync(filePath, `#!/bin/sh
+  if (!fs33.existsSync(filePath)) {
+    fs33.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs31.readFileSync(filePath, "utf8");
+  const content = fs33.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
       `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
     );
-    fs31.writeFileSync(filePath, content.replace(pattern, block));
-    fs31.chmodSync(filePath, 493);
+    fs33.writeFileSync(filePath, content.replace(pattern, block));
+    fs33.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs31.writeFileSync(filePath, `${content}${suffix}
+  fs33.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs31.chmodSync(filePath, 493);
+  fs33.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs31.existsSync(filePath)) return false;
-  const content = fs31.readFileSync(filePath, "utf8");
+  if (!fs33.existsSync(filePath)) return false;
+  const content = fs33.readFileSync(filePath, "utf8");
   if (!content.includes(MARKER_START)) return false;
   const pattern = new RegExp(
     `\\n?${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}\\n?`
   );
   const stripped = content.replace(pattern, "\n");
   if (stripped.replace(/^#!\/bin\/sh\n?/, "").trim() === "") {
-    fs31.rmSync(filePath);
+    fs33.rmSync(filePath);
   } else {
-    fs31.writeFileSync(filePath, stripped);
+    fs33.writeFileSync(filePath, stripped);
   }
   return true;
 }
@@ -30936,20 +31464,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs31.mkdirSync(hooksDir, { recursive: true });
+  fs33.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs31.writeFileSync(
-    path34.join(hooksDir, "har-pre-commit"),
+  fs33.writeFileSync(
+    path37.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs31.writeFileSync(
-    path34.join(hooksDir, "har-post-commit"),
+  fs33.writeFileSync(
+    path37.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path34.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path34.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock(path37.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock(path37.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -30958,12 +31486,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path34.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path34.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path37.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path37.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path34.join(hooksDir, file);
-    if (fs31.existsSync(full)) {
-      fs31.rmSync(full);
+    const full = path37.join(hooksDir, file);
+    if (fs33.existsSync(full)) {
+      fs33.rmSync(full);
       removed = true;
     }
   }
@@ -30980,9 +31508,9 @@ function getCommitGateConfig(checkoutDir) {
 function isAgentWorktree(checkoutDir) {
   const branch = getCurrentBranch(checkoutDir);
   if (branch && /^har-agent-\d+$/.test(branch)) return true;
-  const worktreesRoot = path34.join(os8.homedir(), "worktrees");
-  const resolved = path34.resolve(checkoutDir);
-  return resolved.startsWith(`${worktreesRoot}${path34.sep}`) && /-agent-\d+$/.test(path34.basename(resolved));
+  const worktreesRoot = path37.join(os9.homedir(), "worktrees");
+  const resolved = path37.resolve(checkoutDir);
+  return resolved.startsWith(`${worktreesRoot}${path37.sep}`) && /-agent-\d+$/.test(path37.basename(resolved));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -30995,15 +31523,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path34.join(hooksDir, name);
-    return fs31.existsSync(file) && fs31.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path37.join(hooksDir, name);
+    return fs33.existsSync(file) && fs33.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs31.existsSync(path34.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs31.existsSync(path34.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs33.existsSync(path37.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs33.existsSync(path37.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -31014,7 +31542,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs31.existsSync(path34.join(checkout, ".har", "stages.json"))) {
+  if (!fs33.existsSync(path37.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -31084,13 +31612,114 @@ async function recordCommitAssociation(cwd) {
   }
 }
 
+// src/core/claude-hooks.ts
+var fs34 = __toESM(require("fs"));
+var path38 = __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";
+var GUARD_COMMAND = `"$CLAUDE_PROJECT_DIR"/${CLAUDE_GUARD_RELATIVE_PATH}`;
+function isHarGuardEntry(entry) {
+  return (entry.hooks ?? []).some(
+    (hook) => typeof hook.command === "string" && hook.command.includes("claude-worktree-guard.sh")
+  );
+}
+function readSettings(settingsPath) {
+  if (!fs34.existsSync(settingsPath)) return {};
+  const raw = fs34.readFileSync(settingsPath, "utf8").trim();
+  if (raw === "") return {};
+  const parsed = JSON.parse(raw);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${settingsPath} is not a JSON object \u2014 fix it before installing the guard.`);
+  }
+  return parsed;
+}
+function writeSettings(settingsPath, settings) {
+  fs34.mkdirSync(path38.dirname(settingsPath), { recursive: true });
+  fs34.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 = path38.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs34.mkdirSync(path38.dirname(guardScript), { recursive: true });
+  fs34.copyFileSync(templatePath, guardScript);
+  fs34.chmodSync(guardScript, 493);
+  const settingsPath = path38.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const settings = readSettings(settingsPath);
+  const hooks = settings.hooks ?? {};
+  const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
+  preToolUse.push({
+    matcher: GUARD_MATCHER,
+    hooks: [{ type: "command", command: GUARD_COMMAND }]
+  });
+  settings.hooks = { ...hooks, PreToolUse: preToolUse };
+  writeSettings(settingsPath, settings);
+  return { guardScript, settingsPath };
+}
+function uninstallClaudeGuard(repoPath) {
+  let removed = false;
+  const guardScript = path38.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs34.existsSync(guardScript)) {
+    fs34.rmSync(guardScript);
+    removed = true;
+    const parent = path38.dirname(guardScript);
+    if (fs34.existsSync(parent) && fs34.readdirSync(parent).length === 0) fs34.rmdirSync(parent);
+  }
+  const settingsPath = path38.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs34.existsSync(settingsPath)) {
+    const settings = readSettings(settingsPath);
+    const preToolUse = settings.hooks?.PreToolUse;
+    if (preToolUse) {
+      const filtered = preToolUse.filter((entry) => !isHarGuardEntry(entry));
+      if (filtered.length !== preToolUse.length) {
+        removed = true;
+        if (filtered.length > 0) {
+          settings.hooks = { ...settings.hooks, PreToolUse: filtered };
+        } else {
+          const rest = { ...settings.hooks };
+          delete rest.PreToolUse;
+          if (Object.keys(rest).length > 0) {
+            settings.hooks = rest;
+          } else {
+            delete settings.hooks;
+          }
+        }
+        writeSettings(settingsPath, settings);
+      }
+    }
+  }
+  return { removed };
+}
+function claudeGuardInstalled(repoPath) {
+  const settingsPath = path38.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs34.existsSync(settingsPath)) return false;
+  try {
+    const settings = readSettings(settingsPath);
+    return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
+  } catch {
+    return false;
+  }
+}
+
 // src/cli/commands/hooks.ts
 function repoOption(y2) {
   return y2.option("repo", { type: "string", default: ".", describe: "Path to the repository" });
 }
-function handleInstall(argv) {
+function handleInstall2(argv) {
   try {
-    const result = installHooks({ repoPath: path35.resolve(argv.repo), force: argv.force });
+    if (argv.claude) {
+      const result2 = installClaudeGuard(path39.resolve(argv.repo));
+      success("Claude Code worktree guard installed.");
+      info(`Guard script:  ${result2.guardScript}`);
+      info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
+      info("File edits in the MAIN checkout are now blocked with a pointer to /har-wt.");
+      info("Commit both files so the guard travels with the repo.");
+      return;
+    }
+    const result = installHooks({ repoPath: path39.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.");
@@ -31102,7 +31731,16 @@ function handleInstall(argv) {
 }
 function handleUninstall(argv) {
   try {
-    const result = uninstallHooks(path35.resolve(argv.repo));
+    if (argv.claude) {
+      const result2 = uninstallClaudeGuard(path39.resolve(argv.repo));
+      if (result2.removed) {
+        success("Claude Code worktree guard removed.");
+      } else {
+        info("No Claude Code worktree guard was installed.");
+      }
+      return;
+    }
+    const result = uninstallHooks(path39.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -31115,7 +31753,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path35.resolve(argv.repo));
+    const status = getHooksStatus(path39.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -31132,6 +31770,9 @@ function handleStatus2(argv) {
       `Gate:          enabled=${status.gate.enabled} mode=${status.gate.mode} scope=${status.gate.scope}`
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
+    info(
+      `Claude guard:  ${claudeGuardInstalled(path39.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+    );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
     process.exitCode = 1;
@@ -31158,9 +31799,22 @@ var hooksCommand = {
       type: "boolean",
       default: false,
       describe: "Write hooks even when core.hooksPath points at a managed directory"
+    }).option("claude", {
+      type: "boolean",
+      default: false,
+      describe: "Install the Claude Code worktree guard instead (blocks Edit/Write in the main checkout, points to /har-wt)"
     }),
-    handleInstall
-  ).command("uninstall", "Remove the har commit gate hooks", repoOption, handleUninstall).command(
+    handleInstall2
+  ).command(
+    "uninstall",
+    "Remove the har commit gate hooks",
+    (y2) => repoOption(y2).option("claude", {
+      type: "boolean",
+      default: false,
+      describe: "Remove the Claude Code worktree guard instead"
+    }),
+    handleUninstall
+  ).command(
     "status",
     "Show hook installation and gate configuration",
     (y2) => repoOption(y2).option("json", { type: "boolean", default: false }),
@@ -31378,10 +32032,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path37) {
-  if (!path37)
+function getElementAtPath(obj, path41) {
+  if (!path41)
     return obj;
-  return path37.reduce((acc, key) => acc?.[key], obj);
+  return path41.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -31701,11 +32355,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path37, issues) {
+function prefixIssues(path41, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path37);
+    iss.path.unshift(path41);
     return iss;
   });
 }
@@ -37028,7 +37682,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve26) => setTimeout(resolve26, pollInterval));
+        await new Promise((resolve28) => setTimeout(resolve28, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -37045,7 +37699,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve26, reject) => {
+    return new Promise((resolve28, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -37123,7 +37777,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve26(parseResult.data);
+            resolve28(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -37384,12 +38038,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve26, reject) => {
+    return new Promise((resolve28, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve26, interval);
+      const timeoutId = setTimeout(resolve28, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -38179,7 +38833,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path36 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process2 = __toESM(require("node:process"), 1);
@@ -38262,12 +38916,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve26) => {
+    return new Promise((resolve28) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve26();
+        resolve28();
       } else {
-        this._stdout.once("drain", resolve26);
+        this._stdout.once("drain", resolve28);
       }
     });
   }
@@ -38811,7 +39465,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path36.resolve(input.repo)
+        cwd: path40.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -38875,7 +39529,7 @@ var mcpCommand = {
 
 // src/cli/index.ts
 async function runCli() {
-  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(envCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).demandCommand(1, "Please specify a command. Try: har env init").strict().help().version(getHarPackageVersion()).parse();
+  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(envCommand).command(agentsCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).demandCommand(1, "Please specify a command. Try: har env init").strict().help().version(getHarPackageVersion()).parse();
 }
 
 // src/index.ts