@osfactory/har 0.18.0 → 0.19.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 path49 = url.path;
-      if (path49.length === 0) {
+      const path51 = url.path;
+      if (path51.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path49.length === 1 && isNormalizedWindowsDriveLetter(path49[0])) {
+      if (url.scheme === "file" && path51.length === 1 && isNormalizedWindowsDriveLetter(path51[0])) {
         return;
       }
-      path49.pop();
+      path51.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(resolve34, reject) {
+      return new Body.Promise(function(resolve36, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2126,7 +2126,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve34(Buffer.concat(accum, accumBytes));
+            resolve36(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(resolve34, reject) {
+      return new fetch3.Promise(function(resolve36, 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");
                 }
-                resolve34(fetch3(new Request3(locationURL, requestOpts)));
+                resolve36(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);
-            resolve34(response);
+            resolve36(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);
-            resolve34(response);
+            resolve36(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);
-              resolve34(response);
+              resolve36(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve34(response);
+                resolve36(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);
-            resolve34(response);
+            resolve36(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve34(response);
+          resolve36(response);
         });
         writeToStream(req, request);
       });
@@ -6351,14 +6351,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path49, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path51, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path49, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path51, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6367,13 +6367,13 @@ function createFileFromPath(path49, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path49, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path49);
-  return createFileFromPath(path49, stats, filenameOrOptions, options);
+function fileFromPathSync(path51, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path51);
+  return createFileFromPath(path51, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path49, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path49);
-  return createFileFromPath(path49, stats, filenameOrOptions, options);
+async function fileFromPath2(path51, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path51);
+  return createFileFromPath(path51, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -6451,9 +6451,9 @@ var init_control_config = __esm({
 // src/core/telemetry-config.ts
 function getPreferencePath() {
   if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
-    return path34.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
+    return path35.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
   }
-  return path34.join(os9.homedir(), ".har", "telemetry.json");
+  return path35.join(os9.homedir(), ".har", "telemetry.json");
 }
 function parseEnvOverride(raw) {
   if (raw === void 0 || raw === "") return void 0;
@@ -6474,10 +6474,10 @@ function normalizeSignals(enabled, raw) {
 function readTelemetryPreference() {
   const preferencePath = getPreferencePath();
   try {
-    if (!fs34.existsSync(preferencePath)) {
+    if (!fs35.existsSync(preferencePath)) {
       return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
     }
-    const parsed = JSON.parse(fs34.readFileSync(preferencePath, "utf8"));
+    const parsed = JSON.parse(fs35.readFileSync(preferencePath, "utf8"));
     const enabled = parsed.enabled !== false;
     return {
       enabled,
@@ -6500,8 +6500,8 @@ function writeTelemetryPreference(enabled, signals) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   const preferencePath = getPreferencePath();
-  fs34.mkdirSync(path34.dirname(preferencePath), { recursive: true });
-  fs34.writeFileSync(preferencePath, JSON.stringify(preference, null, 2) + "\n");
+  fs35.mkdirSync(path35.dirname(preferencePath), { recursive: true });
+  fs35.writeFileSync(preferencePath, JSON.stringify(preference, null, 2) + "\n");
   return preference;
 }
 function isTelemetryEnabled() {
@@ -6516,13 +6516,13 @@ function getTelemetrySignals() {
 function getTelemetryPreferencePath() {
   return getPreferencePath();
 }
-var fs34, os9, path34, DEFAULT_SIGNALS_ON, DEFAULT_SIGNALS_OFF, TELEMETRY_SIGNALS;
+var fs35, os9, path35, DEFAULT_SIGNALS_ON, DEFAULT_SIGNALS_OFF, TELEMETRY_SIGNALS;
 var init_telemetry_config = __esm({
   "src/core/telemetry-config.ts"() {
     "use strict";
-    fs34 = __toESM(require("fs"));
+    fs35 = __toESM(require("fs"));
     os9 = __toESM(require("os"));
-    path34 = __toESM(require("path"));
+    path35 = __toESM(require("path"));
     DEFAULT_SIGNALS_ON = {
       metrics: true,
       logs: true,
@@ -6563,15 +6563,15 @@ __export(otel_hooks_exports, {
 });
 function getOtelHooksHome() {
   if (process.env.HAR_OTEL_HOOKS_HOME) {
-    return path40.resolve(process.env.HAR_OTEL_HOOKS_HOME);
+    return path41.resolve(process.env.HAR_OTEL_HOOKS_HOME);
   }
-  return path40.join(os12.homedir(), ".har", "otel-hooks");
+  return path41.join(os12.homedir(), ".har", "otel-hooks");
 }
 function getOtelHooksConfigPath(hooksHome = getOtelHooksHome()) {
-  return path40.join(hooksHome, "otel_config.json");
+  return path41.join(hooksHome, "otel_config.json");
 }
 function getOtelHooksWrapperPath(hooksHome = getOtelHooksHome()) {
-  return path40.join(hooksHome, "run-otel-hook.sh");
+  return path41.join(hooksHome, "run-otel-hook.sh");
 }
 function buildOtelHooksConfig(options) {
   const enabled = options?.enabled ?? isTelemetryEnabled();
@@ -6590,18 +6590,18 @@ function buildOtelHooksConfig(options) {
   };
 }
 function writeOtelHooksConfig(config2, hooksHome = getOtelHooksHome()) {
-  fs38.mkdirSync(hooksHome, { recursive: true });
+  fs39.mkdirSync(hooksHome, { recursive: true });
   const configPath = getOtelHooksConfigPath(hooksHome);
   const payload = {
     _comment: "Managed by har telemetry \u2014 do not edit by hand; use: har telemetry on|off",
     ...config2
   };
-  fs38.writeFileSync(configPath, `${JSON.stringify(payload, null, 2)}
+  fs39.writeFileSync(configPath, `${JSON.stringify(payload, null, 2)}
 `);
   return configPath;
 }
 function writeOtelHooksWrapper(otelHookCommand, hooksHome = getOtelHooksHome()) {
-  fs38.mkdirSync(hooksHome, { recursive: true });
+  fs39.mkdirSync(hooksHome, { recursive: true });
   const wrapperPath = getOtelHooksWrapperPath(hooksHome);
   const script = `#!/usr/bin/env bash
 # Managed by har telemetry \u2014 invokes opentelemetry-hooks with HAR config home.
@@ -6609,9 +6609,9 @@ set -euo pipefail
 export IDE_OTEL_HOOK_HOME="${hooksHome}"
 exec "${otelHookCommand}" "$@"
 `;
-  fs38.writeFileSync(wrapperPath, script, { mode: 493 });
+  fs39.writeFileSync(wrapperPath, script, { mode: 493 });
   try {
-    fs38.chmodSync(wrapperPath, 493);
+    fs39.chmodSync(wrapperPath, 493);
   } catch {
   }
   return wrapperPath;
@@ -6691,10 +6691,10 @@ function runSetupAgent(agent, otelHookCommand, hooksHome) {
   };
 }
 function rewriteHookCommandsToWrapper(filePath, wrapperPath) {
-  if (!fs38.existsSync(filePath)) return false;
+  if (!fs39.existsSync(filePath)) return false;
   let raw;
   try {
-    raw = fs38.readFileSync(filePath, "utf8");
+    raw = fs39.readFileSync(filePath, "utf8");
   } catch {
     return false;
   }
@@ -6733,16 +6733,16 @@ function rewriteHookCommandsToWrapper(filePath, wrapperPath) {
     return changed;
   };
   if (!walk(parsed)) return false;
-  fs38.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
+  fs39.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
 `);
   return true;
 }
 function rewriteKnownHookRegistrations(wrapperPath) {
   const home = os12.homedir();
   const candidates = [
-    path40.join(home, ".cursor", "hooks.json"),
-    path40.join(home, ".claude", "settings.json"),
-    path40.join(home, ".codex", "hooks.json")
+    path41.join(home, ".cursor", "hooks.json"),
+    path41.join(home, ".claude", "settings.json"),
+    path41.join(home, ".codex", "hooks.json")
   ];
   for (const filePath of candidates) {
     try {
@@ -6755,7 +6755,7 @@ function ensureOtelHooks(options) {
   const hooksHome = getOtelHooksHome();
   const errors = [];
   const agentsSetup = [];
-  fs38.mkdirSync(hooksHome, { recursive: true });
+  fs39.mkdirSync(hooksHome, { recursive: true });
   let otelHookCommand = resolveOtelHookCommand();
   if (!otelHookCommand) {
     const installed = tryInstallPackage();
@@ -6824,14 +6824,14 @@ function ensureOtelHooks(options) {
 function disableOtelHooksExport() {
   return writeOtelHooksConfig(buildOtelHooksConfig({ enabled: false }));
 }
-var import_child_process9, fs38, os12, path40, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_AGENTS;
+var import_child_process9, fs39, os12, path41, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_AGENTS;
 var init_otel_hooks = __esm({
   "src/core/otel-hooks.ts"() {
     "use strict";
     import_child_process9 = require("child_process");
-    fs38 = __toESM(require("fs"));
+    fs39 = __toESM(require("fs"));
     os12 = __toESM(require("os"));
-    path40 = __toESM(require("path"));
+    path41 = __toESM(require("path"));
     init_control_config();
     init_telemetry_config();
     OTEL_HOOKS_PACKAGE = "opentelemetry-hooks==0.14.0";
@@ -9790,7 +9790,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve34.call(this, root, ref);
+      let _sch = resolve36.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;
@@ -9817,7 +9817,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve34(root, ref) {
+    function resolve36(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -10035,8 +10035,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path49) {
-      let input = path49;
+    function removeDotSegments(path51) {
+      let input = path51;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -10288,8 +10288,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path49, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path49 && path49 !== "/" ? path49 : void 0;
+        const [path51, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path51 && path51 !== "/" ? path51 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10448,55 +10448,55 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve34(baseURI, relativeURI, options) {
+    function resolve36(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;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative2, options, skipNormalization) {
+    function resolveComponent(base, relative3, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse4(serialize(base, options), options);
-        relative2 = parse4(serialize(relative2, options), options);
+        relative3 = parse4(serialize(relative3, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative2.scheme) {
-        target.scheme = relative2.scheme;
-        target.userinfo = relative2.userinfo;
-        target.host = relative2.host;
-        target.port = relative2.port;
-        target.path = removeDotSegments(relative2.path || "");
-        target.query = relative2.query;
+      if (!options.tolerant && relative3.scheme) {
+        target.scheme = relative3.scheme;
+        target.userinfo = relative3.userinfo;
+        target.host = relative3.host;
+        target.port = relative3.port;
+        target.path = removeDotSegments(relative3.path || "");
+        target.query = relative3.query;
       } else {
-        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
-          target.userinfo = relative2.userinfo;
-          target.host = relative2.host;
-          target.port = relative2.port;
-          target.path = removeDotSegments(relative2.path || "");
-          target.query = relative2.query;
+        if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
+          target.userinfo = relative3.userinfo;
+          target.host = relative3.host;
+          target.port = relative3.port;
+          target.path = removeDotSegments(relative3.path || "");
+          target.query = relative3.query;
         } else {
-          if (!relative2.path) {
+          if (!relative3.path) {
             target.path = base.path;
-            if (relative2.query !== void 0) {
-              target.query = relative2.query;
+            if (relative3.query !== void 0) {
+              target.query = relative3.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative2.path[0] === "/") {
-              target.path = removeDotSegments(relative2.path);
+            if (relative3.path[0] === "/") {
+              target.path = removeDotSegments(relative3.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative2.path;
+                target.path = "/" + relative3.path;
               } else if (!base.path) {
-                target.path = relative2.path;
+                target.path = relative3.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative2.query;
+            target.query = relative3.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -10504,7 +10504,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative2.fragment;
+      target.fragment = relative3.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -10706,7 +10706,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve34,
+      resolve: resolve36,
       resolveComponent,
       equal,
       serialize,
@@ -13682,12 +13682,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs41, exportName) {
+    function addFormats(ajv, list, fs43, 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, fs41[f2]);
+        ajv.addFormat(f2, fs43[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -14971,11 +14971,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: (path49) => {
+  require: (path51) => {
     if (typeof require !== "undefined") {
-      return require(path49);
-    } else if (path49.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path49, "utf8"));
+      return require(path51);
+    } else if (path51.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path51, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -16318,13 +16318,13 @@ function usage(yargs, shim3) {
   };
   self.stringifiedValues = function stringifiedValues(values, separator) {
     let string3 = "";
-    const sep5 = separator || ", ";
+    const sep6 = separator || ", ";
     const array2 = [].concat(values);
     if (!values || !array2.length)
       return string3;
     array2.forEach((value) => {
       if (string3.length)
-        string3 += sep5;
+        string3 += sep6;
       string3 += JSON.stringify(value);
     });
     return string3;
@@ -17501,12 +17501,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve34, reject) => {
+      return new Promise((resolve36, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve34(completions);
+            resolve36(completions);
         });
       });
     } else {
@@ -19656,8 +19656,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path49, errorMaps, issueData } = params;
-  const fullPath = [...path49, ...issueData.path || []];
+  const { data, path: path51, errorMaps, issueData } = params;
+  const fullPath = [...path51, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -19773,11 +19773,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path49, key) {
+  constructor(parent, value, path51, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path49;
+    this._path = path51;
     this._key = key;
   }
   get path() {
@@ -23477,7 +23477,26 @@ var RegisterRepoInputSchema = external_exports.object({
   path: external_exports.string().min(1),
   gitRemote: external_exports.string().optional(),
   manifest: HarnessManifestSchema.optional(),
-  stagesRegistry: HarnessStageRegistrySchema.optional()
+  stagesRegistry: HarnessStageRegistrySchema.optional(),
+  /** Clear a prior unregister blocklist entry and re-register. */
+  force: external_exports.boolean().optional()
+});
+var UnregisterRepoInputSchema = external_exports.object({
+  /** When true, attempt to remove session worktrees on disk (host paths). */
+  deleteWorktrees: external_exports.boolean().optional().default(false)
+});
+var UnregisterWorktreeResultSchema = external_exports.object({
+  path: external_exports.string(),
+  agentId: external_exports.number().optional(),
+  deleted: external_exports.boolean(),
+  error: external_exports.string().optional()
+});
+var UnregisterRepoResultSchema = external_exports.object({
+  ok: external_exports.literal(true),
+  id: external_exports.string(),
+  path: external_exports.string(),
+  deleteWorktrees: external_exports.boolean(),
+  worktrees: external_exports.array(UnregisterWorktreeResultSchema)
 });
 var SyncRunsInputSchema = external_exports.object({
   runs: external_exports.array(RunRecordSchema)
@@ -23816,16 +23835,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve34) => {
+  return new Promise((resolve36) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve34(true);
+        resolve36(true);
         return;
       }
-      resolve34(/^y(es)?$/i.test(trimmed));
+      resolve36(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -23904,7 +23923,7 @@ function handleRemove(argv) {
 }
 
 // src/cli/commands/env.ts
-var path42 = __toESM(require("path"));
+var path43 = __toESM(require("path"));
 
 // src/core/harness.ts
 var fs20 = __toESM(require("fs"));
@@ -24683,13 +24702,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(path49, ...args) {
+async function fileFromPath3(path51, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path49)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path51)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path49, ...args);
+  return await _fileFromPath(path51, ...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 });
@@ -25185,8 +25204,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve34) => {
-      resolve34(null);
+    super((resolve36) => {
+      resolve36(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -25286,29 +25305,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path49, opts) {
-    return this.methodRequest("get", path49, opts);
+  get(path51, opts) {
+    return this.methodRequest("get", path51, opts);
   }
-  post(path49, opts) {
-    return this.methodRequest("post", path49, opts);
+  post(path51, opts) {
+    return this.methodRequest("post", path51, opts);
   }
-  patch(path49, opts) {
-    return this.methodRequest("patch", path49, opts);
+  patch(path51, opts) {
+    return this.methodRequest("patch", path51, opts);
   }
-  put(path49, opts) {
-    return this.methodRequest("put", path49, opts);
+  put(path51, opts) {
+    return this.methodRequest("put", path51, opts);
   }
-  delete(path49, opts) {
-    return this.methodRequest("delete", path49, opts);
+  delete(path51, opts) {
+    return this.methodRequest("delete", path51, opts);
   }
-  methodRequest(method, path49, opts) {
+  methodRequest(method, path51, 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: path49, ...opts2, body };
+      return { method, path: path51, ...opts2, body };
     }));
   }
-  getAPIList(path49, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path49, ...opts });
+  getAPIList(path51, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path51, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -25326,10 +25345,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path49, query, headers = {} } = options;
+    const { method, path: path51, 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(path49, query);
+    const url = this.buildURL(path51, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -25438,8 +25457,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path49, query) {
-    const url = isAbsoluteURL(path49) ? new URL(path49) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path49.startsWith("/") ? path49.slice(1) : path49));
+  buildURL(path51, query) {
+    const url = isAbsoluteURL(path51) ? new URL(path51) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path51.startsWith("/") ? path51.slice(1) : path51));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -25724,7 +25743,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve34) => setTimeout(resolve34, ms));
+var sleep = (ms) => new Promise((resolve36) => setTimeout(resolve36, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -26215,12 +26234,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve34, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve34, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve36, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve36, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve34, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve34, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve36, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve36, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -26349,11 +26368,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve34, reject) => {
+    return new Promise((resolve36, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve34);
+      this.once(event, resolve36);
     });
   }
   async done() {
@@ -26580,7 +26599,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve34, reject) => readQueue.push({ resolve: resolve34, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve36, reject) => readQueue.push({ resolve: resolve36, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26728,12 +26747,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve34, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve34, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve36, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve36, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve34, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve34, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve36, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve36, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -26862,11 +26881,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve34, reject) => {
+    return new Promise((resolve36, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve34);
+      this.once(event, resolve36);
     });
   }
   async done() {
@@ -27093,7 +27112,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve34, reject) => readQueue.push({ resolve: resolve34, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve36, reject) => readQueue.push({ resolve: resolve36, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -27353,11 +27372,11 @@ async function promptApplyAgentMdProposal(repoPath) {
 }
 async function askYesNo2(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve34) => {
+  return new Promise((resolve36) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve34(/^y(es)?$/i.test(answer.trim()));
+      resolve36(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -27587,7 +27606,7 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
 }
 async function askUser(question, options) {
   const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve34) => {
+  return new Promise((resolve36) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -27598,7 +27617,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve34(answer.trim());
+      resolve36(answer.trim());
     });
   });
 }
@@ -27742,7 +27761,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve34) => {
+  return new Promise((resolve36) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27757,13 +27776,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve34({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve36({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve34) => {
+  return new Promise((resolve36) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27778,7 +27797,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve34({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve36({ stdout, stderr, code: code ?? 0 }));
   });
 }
 
@@ -28942,16 +28961,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve34) => {
+  return new Promise((resolve36) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve34(true);
+        resolve36(true);
         return;
       }
-      resolve34(/^y(es)?$/i.test(trimmed));
+      resolve36(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -29056,6 +29075,18 @@ function readSlotRegistry(repoPath, agentId) {
     return void 0;
   }
 }
+function listSlotRegistryEntries(repoPath) {
+  const dir = getSlotRegistryDir(repoPath);
+  if (!fs24.existsSync(dir)) return [];
+  const entries = [];
+  for (const name of fs24.readdirSync(dir)) {
+    const match = name.match(/^agent-(\d+)\.json$/);
+    if (!match) continue;
+    const entry = readSlotRegistry(repoPath, Number(match[1]));
+    if (entry) entries.push(entry);
+  }
+  return entries;
+}
 
 // src/core/local-executor.ts
 function quoteShellArg(arg) {
@@ -29222,16 +29253,16 @@ var LocalScriptExecutor = class {
     const walk = (dir, prefix) => {
       for (const entry of fs25.readdirSync(dir, { withFileTypes: true })) {
         const full = path24.join(dir, entry.name);
-        const relative2 = path24.join(prefix, entry.name);
+        const relative3 = path24.join(prefix, entry.name);
         if (entry.isDirectory()) {
-          walk(full, relative2);
+          walk(full, relative3);
           continue;
         }
-        if (filter?.stageId && !relative2.includes(filter.stageId)) continue;
+        if (filter?.stageId && !relative3.includes(filter.stageId)) continue;
         const stat = fs25.statSync(full);
         entries.push({
           path: full,
-          relativePath: relative2,
+          relativePath: relative3,
           sizeBytes: stat.size,
           modifiedAt: stat.mtime.toISOString()
         });
@@ -29244,63 +29275,136 @@ var LocalScriptExecutor = class {
 var localScriptExecutor = new LocalScriptExecutor();
 
 // src/core/control-sync.ts
-var path38 = __toESM(require("path"));
+var path39 = __toESM(require("path"));
 init_control_config();
 
 // src/core/control-registry.ts
-var fs26 = __toESM(require("fs"));
+var fs27 = __toESM(require("fs"));
 var os4 = __toESM(require("os"));
+var path26 = __toESM(require("path"));
+
+// src/core/control-repo-path.ts
+var fs26 = __toESM(require("fs"));
 var path25 = __toESM(require("path"));
+function tryGit(cwd, args) {
+  if (!fs26.existsSync(cwd)) return void 0;
+  const result = run(`git ${args}`, { cwd });
+  return result.code === 0 ? result.stdout.trim() : void 0;
+}
+function resolveMainWorkingTree(cwd) {
+  const toplevel = tryGit(cwd, "rev-parse --show-toplevel");
+  if (!toplevel) return void 0;
+  const commonDirRaw = tryGit(cwd, "rev-parse --git-common-dir");
+  const commonDir = commonDirRaw ? path25.resolve(cwd, commonDirRaw) : void 0;
+  if (!commonDir) return path25.resolve(toplevel);
+  if (path25.basename(commonDir) === ".git") {
+    return path25.dirname(commonDir);
+  }
+  const porcelain = tryGit(cwd, "worktree list --porcelain");
+  if (porcelain) {
+    for (const line of porcelain.split("\n")) {
+      if (line.startsWith("worktree ")) {
+        return path25.resolve(line.slice("worktree ".length));
+      }
+    }
+  }
+  return path25.resolve(toplevel);
+}
+function canonicalizeControlRepoPath(repoPath) {
+  const resolved = path25.resolve(repoPath);
+  const toplevel = tryGit(resolved, "rev-parse --show-toplevel");
+  if (!toplevel) return resolved;
+  const mainRoot = resolveMainWorkingTree(resolved);
+  if (!mainRoot) return resolved;
+  const top2 = path25.resolve(toplevel);
+  const main = path25.resolve(mainRoot);
+  if (top2 === main) return resolved;
+  const rel = path25.relative(top2, resolved);
+  if (!rel || rel === ".") return main;
+  if (rel.startsWith(`..${path25.sep}`) || rel === ".." || path25.isAbsolute(rel)) {
+    return resolved;
+  }
+  return path25.resolve(main, rel);
+}
+
+// src/core/control-registry.ts
 function getRegistryPath() {
   if (process.env.HAR_CONTROL_REGISTRY_PATH) {
-    return path25.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
+    return path26.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
   }
-  return path25.join(os4.homedir(), ".har", "repos.json");
+  return path26.join(os4.homedir(), ".har", "repos.json");
 }
 function readRegistry() {
   const registryPath = getRegistryPath();
   try {
-    if (!fs26.existsSync(registryPath)) return { repos: [] };
-    return JSON.parse(fs26.readFileSync(registryPath, "utf8"));
+    if (!fs27.existsSync(registryPath)) return { repos: [] };
+    return JSON.parse(fs27.readFileSync(registryPath, "utf8"));
   } catch {
     return { repos: [] };
   }
 }
 function writeRegistry(registry2) {
   const registryPath = getRegistryPath();
-  fs26.mkdirSync(path25.dirname(registryPath), { recursive: true });
-  fs26.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
+  fs27.mkdirSync(path26.dirname(registryPath), { recursive: true });
+  fs27.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
+}
+function registryChanged(before, after) {
+  if (before.length !== after.length) return true;
+  return before.some((repoPath, index) => repoPath !== after[index]);
 }
 function recordRepoForControlSync(repoPath) {
   if (process.env.HAR_CONTROL_DISABLED === "true") return;
-  const resolved = path25.resolve(repoPath);
+  const resolved = canonicalizeControlRepoPath(repoPath);
   if (!readManifest(resolved)) return;
   const registry2 = readRegistry();
   if (registry2.repos.includes(resolved)) return;
   registry2.repos.push(resolved);
   writeRegistry(registry2);
 }
+function removeRegisteredRepo(repoPath) {
+  const resolved = canonicalizeControlRepoPath(repoPath);
+  const registry2 = readRegistry();
+  const next = registry2.repos.filter((entry) => {
+    try {
+      return canonicalizeControlRepoPath(entry) !== resolved;
+    } catch {
+      return path26.resolve(entry) !== resolved;
+    }
+  });
+  if (next.length === registry2.repos.length) return false;
+  writeRegistry({ repos: next });
+  return true;
+}
 function listRegisteredRepos() {
   const registry2 = readRegistry();
-  const kept = registry2.repos.filter((repoPath) => fs26.existsSync(repoPath) && readManifest(repoPath));
-  if (kept.length !== registry2.repos.length) {
+  const kept = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const repoPath of registry2.repos) {
+    if (!fs27.existsSync(repoPath)) continue;
+    const canonical = canonicalizeControlRepoPath(repoPath);
+    if (!fs27.existsSync(canonical) || !readManifest(canonical)) continue;
+    if (seen.has(canonical)) continue;
+    seen.add(canonical);
+    kept.push(canonical);
+  }
+  if (registryChanged(registry2.repos, kept)) {
     writeRegistry({ repos: kept });
   }
   return kept;
 }
 
 // src/core/slot-status.ts
-var fs31 = __toESM(require("fs"));
+var fs32 = __toESM(require("fs"));
 var os7 = __toESM(require("os"));
-var path31 = __toESM(require("path"));
+var path32 = __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 fs27 = __toESM(require("fs"));
+var fs28 = __toESM(require("fs"));
 var os5 = __toESM(require("os"));
-var path26 = __toESM(require("path"));
+var path27 = __toESM(require("path"));
 var RUNS_DIR = "runs";
 function gitCommonDir(cwd) {
   try {
@@ -29309,7 +29413,7 @@ function gitCommonDir(cwd) {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
     }).trim();
-    return out ? path26.resolve(cwd, out) : void 0;
+    return out ? path27.resolve(cwd, out) : void 0;
   } catch {
     return void 0;
   }
@@ -29331,7 +29435,7 @@ function gitPrefix(cwd) {
   }
 }
 function getRunsDir(harnessRoot) {
-  return path26.join(getHarnessDir(harnessRoot), RUNS_DIR);
+  return path27.join(getHarnessDir(harnessRoot), RUNS_DIR);
 }
 function formatLocalDate(d2) {
   const y2 = d2.getFullYear();
@@ -29351,24 +29455,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 = path26.join(runsDir, dateFolder, filename);
-  if (fs27.existsSync(fullPath)) {
+  const fullPath = path27.join(runsDir, dateFolder, filename);
+  if (fs28.existsSync(fullPath)) {
     filename = `${timePart}_${stageId}${agentPart}-${runId.slice(0, 8)}.json`;
   }
-  return path26.join(dateFolder, filename);
+  return path27.join(dateFolder, filename);
 }
 function resolveRunFilePath(harnessRoot, run2) {
   if (run2.relativePath) {
-    return path26.join(getRunsDir(harnessRoot), run2.relativePath);
+    return path27.join(getRunsDir(harnessRoot), run2.relativePath);
   }
-  return path26.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
+  return path27.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
 }
 function collectRunFiles(runsDir) {
-  if (!fs27.existsSync(runsDir)) return [];
+  if (!fs28.existsSync(runsDir)) return [];
   const files = [];
   const walk = (dir) => {
-    for (const entry of fs27.readdirSync(dir, { withFileTypes: true })) {
-      const full = path26.join(dir, entry.name);
+    for (const entry of fs28.readdirSync(dir, { withFileTypes: true })) {
+      const full = path27.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(full);
       } else if (entry.name.endsWith(".json")) {
@@ -29382,30 +29486,30 @@ function collectRunFiles(runsDir) {
 function resolveAgentWorkDir(harnessRoot, agentId) {
   if (agentId === void 0) return void 0;
   const entry = readSlotRegistry(harnessRoot, agentId);
-  if (entry?.workDir && fs27.existsSync(entry.workDir)) return entry.workDir;
+  if (entry?.workDir && fs28.existsSync(entry.workDir)) return entry.workDir;
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path26.basename(harnessRoot);
-  const worktreeDir = path26.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path27.basename(harnessRoot);
+  const worktreeDir = path27.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
   const relPrefix = gitPrefix(harnessRoot);
   const sessionEnvFiles = [];
-  const worktreesRoot = path26.join(os5.homedir(), "worktrees");
-  if (fs27.existsSync(worktreesRoot)) {
+  const worktreesRoot = path27.join(os5.homedir(), "worktrees");
+  if (fs28.existsSync(worktreesRoot)) {
     const suffix = `-har-agent-${agentId}-`;
-    for (const entry2 of fs27.readdirSync(worktreesRoot, { withFileTypes: true })) {
+    for (const entry2 of fs28.readdirSync(worktreesRoot, { withFileTypes: true })) {
       if (!entry2.isDirectory() || !entry2.name.includes(suffix)) continue;
-      const sessionDir = path26.join(worktreesRoot, entry2.name);
+      const sessionDir = path27.join(worktreesRoot, entry2.name);
       if (!sameGitCheckout(harnessRoot, sessionDir)) continue;
-      sessionEnvFiles.push(path26.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
+      sessionEnvFiles.push(path27.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
     }
   }
   const candidates = [
-    path26.join(worktreeDir, `.env.agent.${agentId}`),
-    path26.join(harnessRoot, `.env.agent.${agentId}`),
+    path27.join(worktreeDir, `.env.agent.${agentId}`),
+    path27.join(harnessRoot, `.env.agent.${agentId}`),
     ...sessionEnvFiles.sort()
   ];
   for (const envFile of candidates) {
-    if (!fs27.existsSync(envFile)) continue;
-    const content = fs27.readFileSync(envFile, "utf8");
+    if (!fs28.existsSync(envFile)) continue;
+    const content = fs28.readFileSync(envFile, "utf8");
     const match = content.match(/^REPO_ROOT=(.+)$/m);
     if (match) return match[1].trim();
   }
@@ -29417,11 +29521,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 = path26.join(runsDir, relativePath);
-  fs27.mkdirSync(path26.dirname(runFilePath), { recursive: true });
+  const runFilePath = path27.join(runsDir, relativePath);
+  fs28.mkdirSync(path27.dirname(runFilePath), { recursive: true });
   const run2 = RunRecordSchema.parse({
     runId,
-    repoPath: path26.resolve(ctx.repoPath),
+    repoPath: path27.resolve(ctx.repoPath),
     harnessRoot,
     stageId: meta.stageId,
     kind: meta.kind,
@@ -29432,7 +29536,7 @@ function createRun(ctx, meta) {
     relativePath,
     trigger: ctx.trigger ?? "cli"
   });
-  fs27.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
+  fs28.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
   return run2;
 }
 function finishRun(repoPath, runId, update) {
@@ -29451,13 +29555,13 @@ function finishRun(repoPath, runId, update) {
     finishedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   const runPath = resolveRunFilePath(harnessRoot, finished);
-  fs27.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
+  fs28.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(fs27.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs28.readFileSync(filePath, "utf8")));
     if (parsed.success && parsed.data.runId === runId) {
       return parsed.data;
     }
@@ -29469,10 +29573,10 @@ function getRun(repoPath, runId) {
 }
 function listRuns(repoPath, filter = {}) {
   const runsDir = getRunsDir(resolveHarnessRoot(repoPath));
-  if (!fs27.existsSync(runsDir)) return [];
+  if (!fs28.existsSync(runsDir)) return [];
   const runs = [];
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs27.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs28.readFileSync(filePath, "utf8")));
     if (!parsed.success) continue;
     if (filter.stageId && parsed.data.stageId !== filter.stageId) continue;
     runs.push(parsed.data);
@@ -29485,18 +29589,18 @@ function listRuns(repoPath, filter = {}) {
 }
 
 // src/core/slot-preflight.ts
-var path30 = __toESM(require("path"));
+var path31 = __toESM(require("path"));
 
 // src/core/control-port.ts
 var import_child_process4 = require("child_process");
-var fs29 = __toESM(require("fs"));
-var path28 = __toESM(require("path"));
+var fs30 = __toESM(require("fs"));
+var path29 = __toESM(require("path"));
 init_control_config();
 
 // src/core/slot-ports.ts
 var import_child_process3 = require("child_process");
-var fs28 = __toESM(require("fs"));
-var path27 = __toESM(require("path"));
+var fs29 = __toESM(require("fs"));
+var path28 = __toESM(require("path"));
 function portStep(env3) {
   return Number(env3.HARNESS_PORT_STEP ?? 10);
 }
@@ -29552,7 +29656,7 @@ function allocateAppPorts(repoPath, agentId) {
 }
 function harnessUsesPm2(repoPath) {
   const harnessRoot = resolveHarnessRoot(repoPath);
-  return fs28.existsSync(path27.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
+  return fs29.existsSync(path28.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
 }
 
 // src/core/control-port.ts
@@ -29607,13 +29711,13 @@ function controlDefaultPortWarnings(containers, defaultFrontendPort, allocatedFr
   return [formatControlDefaultPortWarning(control.name, defaultFrontendPort, allocatedFrontend)];
 }
 function inspectControlUpReadiness(repoPath) {
-  const resolved = path28.resolve(repoPath);
+  const resolved = path29.resolve(repoPath);
   const port = parseControlHostPort();
   const containers = listDockerContainers();
   const control = controlContainerOnPort(containers, port);
   const warnings = [];
-  const controlHarnessDir = path28.join(resolved, "control", ".har");
-  const harnessSlot1Active = fs29.existsSync(controlHarnessDir) && readSlotRegistry(path28.join(resolved, "control"), 1)?.status === "active";
+  const controlHarnessDir = path29.join(resolved, "control", ".har");
+  const harnessSlot1Active = fs30.existsSync(controlHarnessDir) && readSlotRegistry(path29.join(resolved, "control"), 1)?.status === "active";
   if (control) {
     return {
       warnings,
@@ -29644,9 +29748,9 @@ function inspectControlUpReadiness(repoPath) {
 }
 
 // src/core/slot-launch-guard-occupied.ts
-var fs30 = __toESM(require("fs"));
+var fs31 = __toESM(require("fs"));
 var os6 = __toESM(require("os"));
-var path29 = __toESM(require("path"));
+var path30 = __toESM(require("path"));
 var import_child_process5 = require("child_process");
 function runGit(cwd, args) {
   try {
@@ -29665,7 +29769,7 @@ function worktreeDirty(worktreePath) {
 }
 function gitCommonDir2(cwd) {
   const out = runGit(cwd, "rev-parse --git-common-dir");
-  return out ? path29.resolve(cwd, out) : void 0;
+  return out ? path30.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout2(a2, b2) {
   const left2 = gitCommonDir2(a2);
@@ -29674,20 +29778,20 @@ function sameGitCheckout2(a2, b2) {
 }
 function discoverWorktree(harnessRoot, agentId, projectName) {
   const session = readSlotRegistry(harnessRoot, agentId);
-  if (session?.worktreePath && fs30.existsSync(session.worktreePath)) {
+  if (session?.worktreePath && fs31.existsSync(session.worktreePath)) {
     return session.worktreePath;
   }
-  const legacy = path29.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
-  if (fs30.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
-  const worktreesRoot = path29.join(os6.homedir(), "worktrees");
-  if (!fs30.existsSync(worktreesRoot)) return void 0;
+  const legacy = path30.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  if (fs31.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
+  const worktreesRoot = path30.join(os6.homedir(), "worktrees");
+  if (!fs31.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = runGit(harnessRoot, "rev-parse --show-prefix") ?? "";
-  for (const name of fs30.readdirSync(worktreesRoot)) {
+  for (const name of fs31.readdirSync(worktreesRoot)) {
     if (!name.includes(suffix)) continue;
-    const candidate = path29.join(worktreesRoot, name);
+    const candidate = path30.join(worktreesRoot, name);
     if (!sameGitCheckout2(harnessRoot, candidate)) continue;
-    if (!fs30.existsSync(path29.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
+    if (!fs31.existsSync(path30.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
     return candidate;
   }
   return void 0;
@@ -29695,13 +29799,13 @@ function discoverWorktree(harnessRoot, agentId, projectName) {
 function collectOccupiedSlot(repoPath, agentId) {
   const harnessRoot = resolveHarnessRoot(repoPath);
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path29.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path30.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
   const worktreePath = discoverWorktree(harnessRoot, agentId, projectName);
   const workDir = session?.workDir;
-  const envInWorkDir = workDir ? fs30.existsSync(path29.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs30.existsSync(path29.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs30.existsSync(path29.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs31.existsSync(path30.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs31.existsSync(path30.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs31.existsSync(path30.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;
@@ -29718,7 +29822,17 @@ function collectOccupiedSlot(repoPath, agentId) {
     harnessUsage: "none"
   };
 }
-function formatOccupiedSlot(slot, resume) {
+function describeLaunchBase(repoPath) {
+  const harnessRoot = resolveHarnessRoot(repoPath);
+  const branch = runGit(harnessRoot, "rev-parse --abbrev-ref HEAD") ?? "detached";
+  const sha = runGit(harnessRoot, "rev-parse --short HEAD");
+  return [
+    `New session will be based on: ${branch}${sha ? ` @ ${sha}` : ""}`,
+    `  (HEAD of ${harnessRoot})`,
+    "  --replace does not choose this base \u2014 switch the main checkout first for a new unrelated task."
+  ];
+}
+function formatOccupiedSlot(slot, repoPath, resume) {
   const lines = [
     `Slot ${slot.agentId} is already in use.`,
     slot.worktreePath ? `  Worktree: ${slot.worktreePath}` : void 0,
@@ -29728,6 +29842,8 @@ function formatOccupiedSlot(slot, resume) {
     slot.lastError ? `  Error:    ${slot.lastError}` : void 0,
     slot.sessionCreatedAt ? `  Since:    ${slot.sessionCreatedAt}` : void 0,
     slot.dirty ? "  Git:      dirty (uncommitted changes \u2014 commit or use force to discard)" : "  Git:      clean",
+    "",
+    ...describeLaunchBase(repoPath),
     ""
   ];
   if (resume || slot.sessionStatus === "failed" || slot.sessionStatus === "starting") {
@@ -29740,6 +29856,7 @@ function formatOccupiedSlot(slot, resume) {
     );
   }
   lines.push(
+    "Prefer complete/teardown when the previous task is finished, then launch.",
     "Replacing removes the worktree. The session branch is kept only if you committed.",
     "Gitignored paths (state/, runs/, local clones) are NOT preserved.",
     "",
@@ -29775,7 +29892,7 @@ function checkLaunchGuard(repoPath, agentId, options = {}) {
       allowed: false,
       blocked: true,
       slot,
-      reason: formatOccupiedSlot(slot)
+      reason: formatOccupiedSlot(slot, repoPath)
     };
   }
   if (!options.confirmReplace) {
@@ -29783,7 +29900,7 @@ function checkLaunchGuard(repoPath, agentId, options = {}) {
       allowed: false,
       blocked: true,
       slot,
-      reason: formatOccupiedSlot(slot)
+      reason: formatOccupiedSlot(slot, repoPath)
     };
   }
   if (slot.dirty && !options.force) {
@@ -29792,7 +29909,7 @@ function checkLaunchGuard(repoPath, agentId, options = {}) {
       blocked: true,
       slot,
       reason: [
-        formatOccupiedSlot(slot),
+        formatOccupiedSlot(slot, repoPath),
         "",
         "The occupied worktree has uncommitted changes.",
         "Pass force=true / --force to discard them (only after explicit user approval)."
@@ -29854,7 +29971,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 ?? path30.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path31.basename(harnessRoot);
   const usesPm2 = harnessUsesPm2(repoPath);
   const blockers = [];
   const remediations = [];
@@ -30056,7 +30173,7 @@ function readWorktreeBranch(worktreePath) {
 }
 function gitCommonDir3(cwd) {
   const out = runGit2(cwd, "rev-parse --git-common-dir");
-  return out ? path31.resolve(cwd, out) : void 0;
+  return out ? path32.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout3(a2, b2) {
   const left2 = gitCommonDir3(a2);
@@ -30068,12 +30185,12 @@ function gitPrefix2(cwd) {
   return out ?? "";
 }
 function discoverSessionWorktreePath(harnessRoot, agentId) {
-  const worktreesRoot = path31.join(os7.homedir(), "worktrees");
-  if (!fs31.existsSync(worktreesRoot)) return void 0;
+  const worktreesRoot = path32.join(os7.homedir(), "worktrees");
+  if (!fs32.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = gitPrefix2(harnessRoot);
-  const matches = fs31.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path31.join(worktreesRoot, entry.name)).filter(
-    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs31.existsSync(path31.join(candidate, relPrefix, `.env.agent.${agentId}`))
+  const matches = fs32.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path32.join(worktreesRoot, entry.name)).filter(
+    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs32.existsSync(path32.join(candidate, relPrefix, `.env.agent.${agentId}`))
   );
   return matches.sort()[0];
 }
@@ -30148,18 +30265,18 @@ function detectPm2Issue(projectName, agentId, session, procs) {
 }
 function collectSlotStatus(harnessRoot, agentId, runs, pm2Procs) {
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path31.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path32.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
-  const legacyWorktreePath = path31.join(
+  const legacyWorktreePath = path32.join(
     os7.homedir(),
     "worktrees",
     `${projectName}-agent-${agentId}`
   );
-  const worktreePath = session?.worktreePath && fs31.existsSync(session.worktreePath) ? session.worktreePath : fs31.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
+  const worktreePath = session?.worktreePath && fs32.existsSync(session.worktreePath) ? session.worktreePath : fs32.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
   const workDir = resolveAgentWorkDir(harnessRoot, agentId);
-  const envInWorkDir = workDir ? fs31.existsSync(path31.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs31.existsSync(path31.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs31.existsSync(path31.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs32.existsSync(path32.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs32.existsSync(path32.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs32.existsSync(path32.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");
@@ -30211,7 +30328,7 @@ function collectEnvironmentStatus(repoPath) {
   const slotIds = getAgentSlotIds(harnessRoot);
   const pm2Procs = listPm2Processes2();
   return {
-    repoPath: path31.resolve(repoPath),
+    repoPath: path32.resolve(repoPath),
     harnessRoot,
     gitRemote: readGitRemote(harnessRoot),
     profile: manifest?.profile,
@@ -30222,13 +30339,13 @@ function collectEnvironmentStatus(repoPath) {
 
 // src/core/validations.ts
 var crypto3 = __toESM(require("crypto"));
-var fs33 = __toESM(require("fs"));
-var path33 = __toESM(require("path"));
+var fs34 = __toESM(require("fs"));
+var path34 = __toESM(require("path"));
 
 // src/core/change-batch.ts
-var fs32 = __toESM(require("fs"));
+var fs33 = __toESM(require("fs"));
 var os8 = __toESM(require("os"));
-var path32 = __toESM(require("path"));
+var path33 = __toESM(require("path"));
 function git(checkoutDir, args, env3) {
   const result = run(`git ${args}`, { cwd: checkoutDir, env: env3 });
   if (result.code !== 0) {
@@ -30236,37 +30353,37 @@ function git(checkoutDir, args, env3) {
   }
   return result.stdout.trim();
 }
-function tryGit(checkoutDir, args) {
+function tryGit2(checkoutDir, args) {
   const result = run(`git ${args}`, { cwd: checkoutDir });
   return result.code === 0 ? result.stdout.trim() : void 0;
 }
 function isCheckoutRoot(checkoutDir) {
-  const toplevel = tryGit(checkoutDir, "rev-parse --show-toplevel");
+  const toplevel = tryGit2(checkoutDir, "rev-parse --show-toplevel");
   if (!toplevel) return false;
   try {
-    return fs32.realpathSync(toplevel) === fs32.realpathSync(checkoutDir);
+    return fs33.realpathSync(toplevel) === fs33.realpathSync(checkoutDir);
   } catch {
     return false;
   }
 }
 function getHeadTree(checkoutDir) {
-  return tryGit(checkoutDir, "rev-parse -q --verify HEAD^{tree}");
+  return tryGit2(checkoutDir, "rev-parse -q --verify HEAD^{tree}");
 }
 function getHeadSha(checkoutDir) {
-  return tryGit(checkoutDir, "rev-parse -q --verify HEAD");
+  return tryGit2(checkoutDir, "rev-parse -q --verify HEAD");
 }
 function getCurrentBranch(checkoutDir) {
-  const branch = tryGit(checkoutDir, "rev-parse --abbrev-ref HEAD");
+  const branch = tryGit2(checkoutDir, "rev-parse --abbrev-ref HEAD");
   return branch && branch !== "HEAD" ? branch : void 0;
 }
 function getEmptyTree(checkoutDir) {
   return git(checkoutDir, "hash-object -t tree /dev/null");
 }
 function isMergeOrRebaseInProgress(checkoutDir) {
-  if (tryGit(checkoutDir, "rev-parse -q --verify MERGE_HEAD") !== void 0) return true;
+  if (tryGit2(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 && fs32.existsSync(path32.resolve(checkoutDir, gitPath))) return true;
+    const gitPath = tryGit2(checkoutDir, `rev-parse --git-path ${dir}`);
+    if (gitPath && fs33.existsSync(path33.resolve(checkoutDir, gitPath))) return true;
   }
   return false;
 }
@@ -30289,8 +30406,8 @@ function parseNameStatus(output) {
   return files;
 }
 function computeWorktreeSnapshot(checkoutDir) {
-  const tmpDir = fs32.mkdtempSync(path32.join(os8.tmpdir(), "har-idx-"));
-  const tmpIndex = path32.join(tmpDir, "index");
+  const tmpDir = fs33.mkdtempSync(path33.join(os8.tmpdir(), "har-idx-"));
+  const tmpIndex = path33.join(tmpDir, "index");
   const env3 = { GIT_INDEX_FILE: tmpIndex };
   try {
     const headTree = getHeadTree(checkoutDir);
@@ -30313,35 +30430,35 @@ function computeWorktreeSnapshot(checkoutDir) {
       changedFiles: parseNameStatus(diffOutput)
     };
   } finally {
-    fs32.rmSync(tmpDir, { recursive: true, force: true });
+    fs33.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 
 // src/core/validations.ts
 var VALIDATIONS_DIR = "validations";
 function getValidationsDir(checkoutDir) {
-  return path33.join(checkoutDir, ".har", VALIDATIONS_DIR);
+  return path34.join(checkoutDir, ".har", VALIDATIONS_DIR);
 }
 function validationPath(checkoutDir, treeHash) {
-  return path33.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
+  return path34.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
 }
 function writeRecord(checkoutDir, record2) {
   const dir = getValidationsDir(checkoutDir);
-  fs33.mkdirSync(dir, { recursive: true });
-  fs33.writeFileSync(
+  fs34.mkdirSync(dir, { recursive: true });
+  fs34.writeFileSync(
     validationPath(checkoutDir, record2.treeHash),
     `${JSON.stringify(record2, null, 2)}
 `
   );
 }
 function ensureValidationsIgnored(checkoutDir) {
-  const harDir = path33.join(checkoutDir, ".har");
-  if (!fs33.existsSync(harDir)) return;
-  const gitignorePath = path33.join(harDir, ".gitignore");
-  const content = fs33.existsSync(gitignorePath) ? fs33.readFileSync(gitignorePath, "utf8") : "";
+  const harDir = path34.join(checkoutDir, ".har");
+  if (!fs34.existsSync(harDir)) return;
+  const gitignorePath = path34.join(harDir, ".gitignore");
+  const content = fs34.existsSync(gitignorePath) ? fs34.readFileSync(gitignorePath, "utf8") : "";
   if (content.split("\n").some((line) => line.trim() === `${VALIDATIONS_DIR}/`)) return;
   const suffix = content.length === 0 || content.endsWith("\n") ? "" : "\n";
-  fs33.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
+  fs34.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
 `);
 }
 function recordValidation(input) {
@@ -30358,8 +30475,8 @@ function recordValidation(input) {
     treeHash: snapshot.treeHash,
     headSha: snapshot.headSha,
     branch: snapshot.branch,
-    workDir: path33.resolve(input.checkoutDir),
-    harnessRoot: path33.resolve(input.harnessRoot),
+    workDir: path34.resolve(input.checkoutDir),
+    harnessRoot: path34.resolve(input.harnessRoot),
     agentId: input.agentId,
     status: input.status,
     full: input.full,
@@ -30371,16 +30488,16 @@ function recordValidation(input) {
     committedAt: existing?.committedAt
   });
   writeRecord(input.checkoutDir, record2);
-  if (path33.resolve(input.harnessRoot) !== path33.resolve(input.checkoutDir)) {
+  if (path34.resolve(input.harnessRoot) !== path34.resolve(input.checkoutDir)) {
     writeRecord(input.harnessRoot, record2);
   }
   return record2;
 }
 function findValidation(checkoutDir, treeHash) {
   const file = validationPath(checkoutDir, treeHash);
-  if (!fs33.existsSync(file)) return void 0;
+  if (!fs34.existsSync(file)) return void 0;
   try {
-    return ValidationRecordSchema.parse(JSON.parse(fs33.readFileSync(file, "utf8")));
+    return ValidationRecordSchema.parse(JSON.parse(fs34.readFileSync(file, "utf8")));
   } catch {
     return void 0;
   }
@@ -30395,19 +30512,19 @@ function attachCommit(checkoutDir, treeHash, commitSha) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   writeRecord(checkoutDir, updated);
-  if (record2.harnessRoot && path33.resolve(record2.harnessRoot) !== path33.resolve(checkoutDir) && fs33.existsSync(path33.join(record2.harnessRoot, ".har"))) {
+  if (record2.harnessRoot && path34.resolve(record2.harnessRoot) !== path34.resolve(checkoutDir) && fs34.existsSync(path34.join(record2.harnessRoot, ".har"))) {
     writeRecord(record2.harnessRoot, updated);
   }
   return updated;
 }
 function listValidations(harnessRoot) {
   const dir = getValidationsDir(harnessRoot);
-  if (!fs33.existsSync(dir)) return [];
+  if (!fs34.existsSync(dir)) return [];
   const records = [];
-  for (const entry of fs33.readdirSync(dir)) {
+  for (const entry of fs34.readdirSync(dir)) {
     if (!entry.endsWith(".json")) continue;
     try {
-      records.push(ValidationRecordSchema.parse(JSON.parse(fs33.readFileSync(path33.join(dir, entry), "utf8"))));
+      records.push(ValidationRecordSchema.parse(JSON.parse(fs34.readFileSync(path34.join(dir, entry), "utf8"))));
     } catch {
     }
   }
@@ -30440,14 +30557,14 @@ function createRemoteExecutor(apiUrl, apiKey) {
 init_telemetry_config();
 
 // src/core/usage-harvest/claude.ts
-var fs36 = __toESM(require("fs"));
+var fs37 = __toESM(require("fs"));
 var os10 = __toESM(require("os"));
-var path36 = __toESM(require("path"));
+var path37 = __toESM(require("path"));
 init_telemetry_config();
 
 // src/core/telemetry-env.ts
-var fs35 = __toESM(require("fs"));
-var path35 = __toESM(require("path"));
+var fs36 = __toESM(require("fs"));
+var path36 = __toESM(require("path"));
 init_control_config();
 function escapeAttrValue(value) {
   return value.replace(/[,=]/g, "_");
@@ -30487,8 +30604,8 @@ function appendTelemetryEnvToFile(envFilePath, attrs) {
 ${TELEMETRY_MARKER_END}
 `;
   let existing = "";
-  if (fs35.existsSync(envFilePath)) {
-    existing = fs35.readFileSync(envFilePath, "utf8");
+  if (fs36.existsSync(envFilePath)) {
+    existing = fs36.readFileSync(envFilePath, "utf8");
     const start = existing.indexOf(TELEMETRY_MARKER_START);
     if (start >= 0) {
       const end = existing.indexOf(TELEMETRY_MARKER_END, start);
@@ -30499,28 +30616,28 @@ ${TELEMETRY_MARKER_END}
       }
     }
   }
-  fs35.mkdirSync(path35.dirname(envFilePath), { recursive: true });
+  fs36.mkdirSync(path36.dirname(envFilePath), { recursive: true });
   const combined = (existing.replace(/\n+$/, "\n") + block).replace(/^\n+/, "");
-  fs35.writeFileSync(envFilePath, combined.endsWith("\n") ? combined : combined + "\n");
+  fs36.writeFileSync(envFilePath, combined.endsWith("\n") ? combined : combined + "\n");
 }
 
 // src/core/usage-harvest/claude.ts
 function pathsMatch(candidate, targets) {
-  const norm = path36.resolve(candidate);
+  const norm = path37.resolve(candidate);
   return targets.some((t2) => {
-    const target = path36.resolve(t2);
-    return norm === target || norm.startsWith(target + path36.sep) || target.startsWith(norm + path36.sep);
+    const target = path37.resolve(t2);
+    return norm === target || norm.startsWith(target + path37.sep) || target.startsWith(norm + path37.sep);
   });
 }
 function claudeProjectsRoot() {
-  return process.env.HAR_CLAUDE_PROJECTS_DIR ? path36.resolve(process.env.HAR_CLAUDE_PROJECTS_DIR) : path36.join(os10.homedir(), ".claude", "projects");
+  return process.env.HAR_CLAUDE_PROJECTS_DIR ? path37.resolve(process.env.HAR_CLAUDE_PROJECTS_DIR) : path37.join(os10.homedir(), ".claude", "projects");
 }
 function encodeClaudeProjectDir(cwd) {
   return cwd.replace(/[^a-zA-Z0-9]/g, "-");
 }
 function readJsonlRecords(filePath) {
-  if (!fs36.existsSync(filePath)) return [];
-  const lines = fs36.readFileSync(filePath, "utf8").split(/\r?\n/);
+  if (!fs37.existsSync(filePath)) return [];
+  const lines = fs37.readFileSync(filePath, "utf8").split(/\r?\n/);
   const out = [];
   for (const line of lines) {
     const trimmed = line.trim();
@@ -30563,16 +30680,16 @@ function findMatchingClaudeTranscripts(slot) {
   const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
   if (targets.length === 0) return [];
   const root = claudeProjectsRoot();
-  if (!fs36.existsSync(root)) return [];
+  if (!fs37.existsSync(root)) return [];
   const matches = [];
-  for (const entry of fs36.readdirSync(root, { withFileTypes: true })) {
+  for (const entry of fs37.readdirSync(root, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
-    const projectDir = path36.join(root, entry.name);
+    const projectDir = path37.join(root, entry.name);
     const encodedHit = targets.some((t2) => entry.name.includes(encodeClaudeProjectDir(t2).slice(0, 40)));
-    for (const file of fs36.readdirSync(projectDir)) {
+    for (const file of fs37.readdirSync(projectDir)) {
       if (!file.endsWith(".jsonl")) continue;
-      const filePath = path36.join(projectDir, file);
-      const stat = fs36.statSync(filePath);
+      const filePath = path37.join(projectDir, file);
+      const stat = fs37.statSync(filePath);
       const records = readJsonlRecords(filePath);
       let cwdHit = encodedHit;
       for (const record2 of records) {
@@ -30683,30 +30800,30 @@ function harvestClaudeEvents(slot) {
 }
 
 // src/core/usage-harvest/codex.ts
-var fs37 = __toESM(require("fs"));
+var fs38 = __toESM(require("fs"));
 var os11 = __toESM(require("os"));
-var path37 = __toESM(require("path"));
+var path38 = __toESM(require("path"));
 function pathsMatch2(candidate, targets) {
-  const norm = path37.resolve(candidate);
+  const norm = path38.resolve(candidate);
   return targets.some((t2) => {
-    const target = path37.resolve(t2);
-    return norm === target || norm.startsWith(target + path37.sep) || target.startsWith(norm + path37.sep);
+    const target = path38.resolve(t2);
+    return norm === target || norm.startsWith(target + path38.sep) || target.startsWith(norm + path38.sep);
   });
 }
 function codexSessionsRoot() {
-  return process.env.HAR_CODEX_SESSIONS_DIR ? path37.resolve(process.env.HAR_CODEX_SESSIONS_DIR) : path37.join(os11.homedir(), ".codex", "sessions");
+  return process.env.HAR_CODEX_SESSIONS_DIR ? path38.resolve(process.env.HAR_CODEX_SESSIONS_DIR) : path38.join(os11.homedir(), ".codex", "sessions");
 }
 function walkJsonlFiles(dir, out = []) {
-  if (!fs37.existsSync(dir)) return out;
-  for (const entry of fs37.readdirSync(dir, { withFileTypes: true })) {
-    const full = path37.join(dir, entry.name);
+  if (!fs38.existsSync(dir)) return out;
+  for (const entry of fs38.readdirSync(dir, { withFileTypes: true })) {
+    const full = path38.join(dir, entry.name);
     if (entry.isDirectory()) walkJsonlFiles(full, out);
     else if (entry.isFile() && entry.name.endsWith(".jsonl")) out.push(full);
   }
   return out;
 }
 function readJsonl(filePath) {
-  const lines = fs37.readFileSync(filePath, "utf8").split(/\r?\n/);
+  const lines = fs38.readFileSync(filePath, "utf8").split(/\r?\n/);
   const out = [];
   for (const line of lines) {
     const trimmed = line.trim();
@@ -30770,7 +30887,7 @@ function harvestCodexUsage(slot) {
     const extracted = extractCodexTokens(records);
     if (!extracted.cwd || !pathsMatch2(extracted.cwd, targets)) continue;
     if (extracted.tokensInput + extracted.tokensOutput + extracted.tokensCacheRead === 0) continue;
-    const mtime = fs37.statSync(file).mtimeMs;
+    const mtime = fs38.statSync(file).mtimeMs;
     if (mtime >= bestMtime) {
       bestMtime = mtime;
       best = extracted;
@@ -30840,7 +30957,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((resolve34) => setTimeout(resolve34, intervalMs));
+    await new Promise((resolve36) => setTimeout(resolve36, intervalMs));
   }
   return false;
 }
@@ -30852,7 +30969,7 @@ async function syncAllKnownReposWithControl(options) {
   }
   const repoPaths = new Set(listRegisteredRepos());
   if (options?.cwd) {
-    const cwd = path38.resolve(options.cwd);
+    const cwd = canonicalizeControlRepoPath(options.cwd);
     if (readManifest(cwd)) repoPaths.add(cwd);
   }
   try {
@@ -30860,7 +30977,7 @@ async function syncAllKnownReposWithControl(options) {
     if (listResponse.ok) {
       const repos = await listResponse.json();
       for (const repo of repos) {
-        const resolved = path38.resolve(repo.path);
+        const resolved = canonicalizeControlRepoPath(repo.path);
         if (readManifest(resolved)) repoPaths.add(resolved);
       }
     }
@@ -30879,7 +30996,7 @@ async function syncAllKnownReposWithControl(options) {
   return { synced, failed };
 }
 async function registerRepoWithControl(options) {
-  const repoPath = path38.resolve(options.repoPath);
+  const repoPath = canonicalizeControlRepoPath(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   const manifest = readManifest(repoPath);
   const stagesRegistry = readStageRegistry(repoPath);
@@ -30887,12 +31004,27 @@ async function registerRepoWithControl(options) {
     path: repoPath,
     gitRemote: options.gitRemote,
     manifest: manifest ?? void 0,
-    stagesRegistry: stagesRegistry ?? void 0
+    stagesRegistry: stagesRegistry ?? void 0,
+    force: options.force
   };
-  return postJson(`${apiUrl}/api/repos`, body, options.dryRun);
+  if (options.dryRun) return null;
+  const response = await fetch(`${apiUrl}/api/repos`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (response.status === 409) {
+    removeRegisteredRepo(repoPath);
+    return null;
+  }
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Control API ${response.status}: ${text || response.statusText}`);
+  }
+  return await response.json();
 }
 async function syncRepoWithControl(options) {
-  const repoPath = path38.resolve(options.repoPath);
+  const repoPath = canonicalizeControlRepoPath(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   if (options.cloud) {
     const remote = createRemoteExecutor();
@@ -30920,8 +31052,10 @@ 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) => path38.resolve(r2.path) === repoPath);
-    if (!existing) throw new Error(`Repo not registered: ${repoPath}`);
+    const existing = repos.find((r2) => path39.resolve(r2.path) === repoPath);
+    if (!existing) {
+      return;
+    }
     await syncRepoRunsAndSlots(apiUrl, existing.id, repoPath, options.dryRun);
     return;
   }
@@ -31011,7 +31145,12 @@ async function syncRepoWithControlAsync(repoPath) {
       }
       return;
     }
-    await withTimeout(syncRepoWithControl({ repoPath, apiUrl }), SYNC_TIMEOUT_MS, "control sync");
+    const canonical = canonicalizeControlRepoPath(repoPath);
+    await withTimeout(
+      syncRepoWithControl({ repoPath: canonical, apiUrl }),
+      SYNC_TIMEOUT_MS,
+      "control sync"
+    );
   } catch (err) {
     if (verbose) {
       const message = err instanceof Error ? err.message : String(err);
@@ -31042,7 +31181,7 @@ init_control_config();
 
 // src/core/control-lifecycle.ts
 var import_child_process8 = require("child_process");
-var path39 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 
 // src/core/control-image.ts
 var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
@@ -31066,10 +31205,10 @@ var CONTROL_DATA_VOLUME = "har_control_data";
 var CONTROL_CONTAINER_PORT = 3847;
 var CONTROL_DATA_DB_URL = "file:/data/har_control.db";
 function resolveControlDir() {
-  return path39.resolve(__dirname, "..", "control");
+  return path40.resolve(__dirname, "..", "control");
 }
 function resolveControlBuildContext() {
-  return path39.resolve(resolveControlDir(), "..");
+  return path40.resolve(resolveControlDir(), "..");
 }
 function buildDockerRunArgs(options) {
   const name = options.containerName ?? CONTROL_CONTAINER_NAME;
@@ -31125,7 +31264,7 @@ async function startMissionControl(options) {
       "-t",
       imageRef,
       "-f",
-      path39.join(resolveControlDir(), "Dockerfile"),
+      path40.join(resolveControlDir(), "Dockerfile"),
       resolveControlBuildContext()
     ]);
     if (buildCode !== 0) {
@@ -31269,7 +31408,7 @@ async function ensureTelemetryInfrastructure(options) {
 
 // src/core/run-service.ts
 init_telemetry_config();
-var path41 = __toESM(require("path"));
+var path42 = __toESM(require("path"));
 function extractShellOutput(result) {
   const stdout = result.logs?.find((log) => log.stream === "stdout")?.content ?? result.logs?.find((log) => !log.stream)?.content ?? "";
   const stderr = result.logs?.find((log) => log.stream === "stderr")?.content ?? "";
@@ -31442,12 +31581,12 @@ Usage from Cursor / Claude / Codex (opentelemetry-hooks) will appear under Workt
           suffix: session.suffix,
           createdAt: session.createdAt
         });
-        const envFile = path41.join(session.workDir, `.env.agent.${options.agentId}`);
+        const envFile = path42.join(session.workDir, `.env.agent.${options.agentId}`);
         try {
           appendTelemetryEnvToFile(envFile, {
             sessionKey,
             agentId: options.agentId,
-            repoPath: path41.resolve(options.repoPath),
+            repoPath: path42.resolve(options.repoPath),
             workDir: session.workDir,
             branch: session.branch,
             suffix: session.suffix
@@ -31612,6 +31751,9 @@ Usage from Cursor / Claude / Codex (opentelemetry-hooks) will appear under Workt
   }
 };
 var defaultRunService = new RunService();
+function createRunService(executor = localScriptExecutor) {
+  return new RunService(executor);
+}
 var runStage = defaultRunService.runStage.bind(defaultRunService);
 var listArtifacts = defaultRunService.listArtifacts.bind(defaultRunService);
 var launchEnvironment = defaultRunService.launchEnvironment.bind(defaultRunService);
@@ -31622,10 +31764,59 @@ var completeEnvironment = defaultRunService.completeEnvironment.bind(defaultRunS
 var getEnvironmentStatus = defaultRunService.getEnvironmentStatus.bind(defaultRunService);
 var getEnvironmentLogs = defaultRunService.getEnvironmentLogs.bind(defaultRunService);
 
+// src/cli/help-text.ts
+var HAR_ROOT_EPILOG = `Typical agent workflow:
+  har env status                 # see which slots are free / occupied
+  har env launch <id>            # new session from the main checkout's HEAD
+  # \u2026edit only under the printed work dir\u2026
+  har env verify <id> --full
+  har env complete <id>          # done: verify + free the slot (branch kept for PR)
+
+Slot lifecycle (do not confuse these):
+  launch     start a NEW session (worktree from $REPO_ROOT HEAD)
+  recover    resume a failed/partial launch (keeps the existing worktree)
+  complete   finish successfully: full verify, then teardown (frees the slot)
+  teardown   abandon / free the slot without a completion validation
+
+  --replace  only confirms destroying a previous session on that slot id
+             it does NOT choose main \u2014 new session still uses current HEAD
+  --force    additionally discard dirty uncommitted work (user approval only)
+  --resume   recover failed/starting; never use --replace for that
+
+For a new unrelated task: checkout main (or your intended base) on the main
+repo checkout, free the slot (complete/teardown), then launch.`;
+var HAR_ENV_EPILOG = `Environment lifecycle:
+  preflight <id>   dry-run: ports, PM2, Docker, occupied-slot gates
+  launch <id>      fresh session worktree from the main checkout's current HEAD
+  recover <id>     alias for launch --resume (failed/starting only)
+  verify <id>      run checks (--full before declaring done)
+  complete <id>    full verify + teardown; keeps branch for push/PR (frees slot)
+  teardown <id>    free the slot without recording a completion validation
+
+Occupied slots:
+  Prefer complete/teardown when the previous task is finished, then launch.
+  Use --replace only to reuse the same slot id immediately (destroys old worktree).
+  --replace does not select the base branch \u2014 HEAD of --repo does.
+  Dirty previous worktree also needs --force after explicit user approval.`;
+var LAUNCH_COMMAND_DESCRIBE = "Start a fresh agent session (new worktree from the main checkout HEAD)";
+var LAUNCH_REPLACE_DESCRIBE = "Destroy the previous session on this slot and start another (does not choose main; still uses --repo HEAD)";
+var LAUNCH_FORCE_DESCRIBE = "With --replace: discard uncommitted changes in the old worktree (only after explicit user approval)";
+var LAUNCH_RESUME_DESCRIBE = "Continue a failed or starting launch without creating a new worktree (prefer over --replace)";
+var LAUNCH_EPILOG = `Every launch creates a NEW session from the current HEAD of --repo (the main
+checkout). The worktree path encodes that base branch \u2014 switch --repo to main
+before launch for a new unrelated task unless you intentionally stack on a
+feature branch.
+
+  Free slot:     har env launch 1
+  Occupied:      har env complete 1   # or teardown \u2014 then launch
+                 har env launch 1 --replace          # reuse slot id now
+                 har env launch 1 --replace --force  # + discard dirty work
+  Failed launch: har env recover 1    # or: har env launch 1 --resume`;
+
 // src/cli/commands/env.ts
 var envCommand = {
   command: "env <subcommand>",
-  describe: "Manage agent environments",
+  describe: "Manage agent environments (launch \u2192 verify \u2192 complete)",
   builder: (yargs) => yargs.command(
     "init",
     "Copy harness boilerplate into .har/ (use --auto for built-in Claude adaptation)",
@@ -31720,24 +31911,28 @@ var envCommand = {
     handleAddStage
   ).command(
     "launch <id>",
-    "Launch a fresh agent session (replaces any previous session for the slot)",
-    (y2) => y2.positional("id", { type: "number", describe: "Agent slot id (see .har/stages.json agentSlots)" }).option("repo", { type: "string", default: "." }).option("worktree", {
+    LAUNCH_COMMAND_DESCRIBE,
+    (y2) => y2.positional("id", { type: "number", describe: "Agent slot id (see .har/stages.json agentSlots)" }).option("repo", {
+      type: "string",
+      default: ".",
+      describe: "Main checkout whose HEAD becomes the new session base"
+    }).option("worktree", {
       type: "boolean",
       default: true,
       describe: "Use an isolated git worktree (default)"
     }).option("claude", { type: "boolean", default: false }).option("replace", {
       type: "boolean",
       default: false,
-      describe: "Replace an occupied slot (prompts on TTY when omitted)"
+      describe: LAUNCH_REPLACE_DESCRIBE
     }).option("force", {
       type: "boolean",
       default: false,
-      describe: "Discard uncommitted changes when replacing a dirty worktree (only after explicit approval)"
+      describe: LAUNCH_FORCE_DESCRIBE
     }).option("resume", {
       type: "boolean",
       default: false,
-      describe: "Resume a failed or partial launch without creating a new worktree"
-    }),
+      describe: LAUNCH_RESUME_DESCRIBE
+    }).epilog(LAUNCH_EPILOG),
     handleLaunch
   ).command(
     "recover <id>",
@@ -31805,12 +32000,15 @@ var envCommand = {
     ).demandCommand(1, "Use: runs list | runs get <runId>"),
     () => {
     }
-  ).demandCommand(1, "Please specify a subcommand: init, maintain, add-stage, launch, recover, verify, complete, teardown, status, runs"),
+  ).demandCommand(
+    1,
+    "Please specify a subcommand: init, maintain, add-stage, launch, recover, verify, complete, teardown, status, runs"
+  ).epilog(HAR_ENV_EPILOG),
   handler: () => {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   header("har env init");
   info(`Repository: ${repoPath}`);
   try {
@@ -31868,7 +32066,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
   try {
@@ -31966,7 +32164,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path42.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path43.join(repoPath, "AGENT.md"), proposal.content);
       clearAgentMdProposal(repoPath);
       info("Applied AGENT.md proposal (--yes)");
     }
@@ -31975,7 +32173,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   await promptApplyAgentMdProposal(repoPath);
 }
 async function handleAddStage(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   const available = listStageTemplateIds();
   if (argv.list) {
     for (const id of available) {
@@ -32052,7 +32250,7 @@ async function handleAddStage(argv) {
   }
 }
 async function handlePreflight(argv) {
-  const repo = path42.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -32070,7 +32268,7 @@ async function handlePreflight(argv) {
   process.exit(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path42.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   let confirmReplace = argv.replace;
   let force = argv.force;
@@ -32082,8 +32280,8 @@ async function handleLaunch(argv) {
         console.error(guard.reason ?? "");
         const readline5 = await import("readline");
         const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve34) => {
-          rl.question("Replace this slot? [y/N] ", resolve34);
+        const answer = await new Promise((resolve36) => {
+          rl.question("Replace this slot? [y/N] ", resolve36);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -32099,8 +32297,8 @@ async function handleLaunch(argv) {
         warn("Worktree has uncommitted changes.");
         const readline5 = await import("readline");
         const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve34) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve34);
+        const answer = await new Promise((resolve36) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve36);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -32154,7 +32352,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path42.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -32166,7 +32364,7 @@ async function handleVerify(argv) {
   process.exit(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path42.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -32177,7 +32375,7 @@ async function handleTeardown(argv) {
   process.exit(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path42.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -32198,7 +32396,7 @@ async function handleComplete(argv) {
   process.exit(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -32211,7 +32409,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.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");
@@ -32228,7 +32426,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path42.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path43.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     process.exit(1);
@@ -32307,8 +32505,213 @@ function printNextSteps(auto2) {
 }
 
 // src/cli/commands/control.ts
-var path43 = __toESM(require("path"));
+var path45 = __toESM(require("path"));
 init_control_config();
+
+// src/core/control-unregister.ts
+var fs40 = __toESM(require("fs"));
+var path44 = __toESM(require("path"));
+init_control_config();
+function listUnregisterWorktreeCandidates(repoPath) {
+  const harnessRoot = canonicalizeControlRepoPath(repoPath);
+  const byPath = /* @__PURE__ */ new Map();
+  const add = (partial2) => {
+    const resolved = path44.resolve(partial2.worktreePath);
+    if (!resolved || resolved === harnessRoot) return;
+    const exists = partial2.exists ?? fs40.existsSync(resolved);
+    const prev = byPath.get(resolved);
+    if (prev) {
+      byPath.set(resolved, {
+        ...prev,
+        dirty: prev.dirty || partial2.dirty,
+        branch: prev.branch ?? partial2.branch,
+        workDir: prev.workDir ?? partial2.workDir
+      });
+      return;
+    }
+    byPath.set(resolved, {
+      agentId: partial2.agentId,
+      worktreePath: resolved,
+      workDir: partial2.workDir,
+      branch: partial2.branch,
+      dirty: partial2.dirty,
+      exists
+    });
+  };
+  for (const entry of listSlotRegistryEntries(harnessRoot)) {
+    const worktreePath = entry.worktreePath ?? entry.workDir;
+    if (!worktreePath) continue;
+    add({
+      agentId: entry.agentId,
+      worktreePath,
+      workDir: entry.workDir,
+      branch: entry.branch
+    });
+  }
+  try {
+    const status = collectEnvironmentStatus(harnessRoot);
+    for (const slot of status.slots) {
+      const worktreePath = slot.worktreePath ?? slot.workDir;
+      if (!worktreePath) continue;
+      add({
+        agentId: slot.agentId,
+        worktreePath,
+        workDir: slot.workDir,
+        branch: slot.branch,
+        dirty: slot.dirty === true
+      });
+    }
+  } catch {
+  }
+  return [...byPath.values()].sort((a2, b2) => a2.agentId - b2.agentId);
+}
+async function askYesNo4(question) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
+  const readline5 = await import("readline");
+  const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
+  const answer = await new Promise((resolve36) => {
+    rl.question(question, resolve36);
+  });
+  rl.close();
+  return /^[Yy]$/.test(answer.trim());
+}
+async function confirmUnregister(options) {
+  if (options.yes) {
+    return { proceed: true, deleteWorktrees: false };
+  }
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error("Non-interactive terminal \u2014 pass --yes (and optionally --delete-worktrees)");
+  }
+  const proceed = await askYesNo4("Unregister this repository from Mission Control? [y/N] ");
+  if (!proceed) return { proceed: false, deleteWorktrees: false };
+  const existing = options.worktrees.filter((w2) => w2.exists);
+  if (existing.length === 0) {
+    return { proceed: true, deleteWorktrees: false };
+  }
+  process.stderr.write("\nSession worktrees:\n");
+  for (const wt2 of existing) {
+    const dirty = wt2.dirty ? " (dirty)" : "";
+    process.stderr.write(`  agent-${wt2.agentId}: ${wt2.worktreePath}${dirty}
+`);
+  }
+  const deleteWorktrees = await askYesNo4(
+    `Also delete ${existing.length} session worktree(s) on disk? [y/N] `
+  );
+  return { proceed: true, deleteWorktrees };
+}
+async function deleteJson(url, body, dryRun) {
+  if (dryRun) return null;
+  const response = await fetch(url, {
+    method: "DELETE",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    return { ok: false, status: response.status, text: text || response.statusText };
+  }
+  return { ok: true, data: await response.json() };
+}
+async function teardownWorktrees(repoPath, candidates, dryRun) {
+  const outcomes = [];
+  const service = createRunService();
+  const seen = /* @__PURE__ */ new Set();
+  for (const candidate of candidates) {
+    if (!candidate.exists) continue;
+    if (seen.has(candidate.worktreePath)) continue;
+    seen.add(candidate.worktreePath);
+    if (dryRun) {
+      outcomes.push({ path: candidate.worktreePath, agentId: candidate.agentId, deleted: false });
+      continue;
+    }
+    try {
+      const result = await service.teardownEnvironment({
+        repoPath,
+        agentId: candidate.agentId,
+        capture: false,
+        trigger: "cli"
+      });
+      if (result.code !== 0) {
+        if (fs40.existsSync(candidate.worktreePath)) {
+          fs40.rmSync(candidate.worktreePath, { recursive: true, force: true });
+        }
+      }
+      outcomes.push({
+        path: candidate.worktreePath,
+        agentId: candidate.agentId,
+        deleted: !fs40.existsSync(candidate.worktreePath),
+        error: result.code !== 0 && fs40.existsSync(candidate.worktreePath) ? result.stderr : void 0
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      try {
+        if (fs40.existsSync(candidate.worktreePath)) {
+          fs40.rmSync(candidate.worktreePath, { recursive: true, force: true });
+        }
+      } catch {
+      }
+      outcomes.push({
+        path: candidate.worktreePath,
+        agentId: candidate.agentId,
+        deleted: !fs40.existsSync(candidate.worktreePath),
+        error: message
+      });
+    }
+  }
+  return outcomes;
+}
+async function unregisterRepoWithControl(options) {
+  const repoPath = canonicalizeControlRepoPath(options.repoPath);
+  const apiUrl = options.apiUrl ?? getControlApiUrl();
+  const deleteWorktrees = options.deleteWorktrees === true;
+  const candidates = listUnregisterWorktreeCandidates(repoPath);
+  let id = null;
+  let apiUnreachable = false;
+  let apiWorktrees = [];
+  if (!options.dryRun) {
+    try {
+      const listResponse = await fetch(`${apiUrl}/api/repos`, {
+        signal: AbortSignal.timeout(5e3)
+      });
+      if (listResponse.ok) {
+        const repos = await listResponse.json();
+        id = repos.find((r2) => canonicalizeControlRepoPath(r2.path) === repoPath)?.id ?? null;
+      } else {
+        apiUnreachable = true;
+      }
+    } catch {
+      apiUnreachable = true;
+    }
+  }
+  if (id && !options.dryRun) {
+    const deleted = await deleteJson(`${apiUrl}/api/repos/${id}`, { deleteWorktrees: false }, options.dryRun);
+    if (deleted && !deleted.ok && deleted.status !== 404) {
+      throw new Error(`Control API ${deleted.status}: ${deleted.text}`);
+    }
+    if (deleted?.ok) {
+      apiWorktrees = deleted.data.worktrees ?? [];
+    }
+  } else if (!id && !options.dryRun && !apiUnreachable) {
+  }
+  const removedFromRegistry = options.dryRun ? false : removeRegisteredRepo(repoPath);
+  let worktrees = apiWorktrees;
+  if (deleteWorktrees) {
+    worktrees = await teardownWorktrees(repoPath, candidates, options.dryRun);
+  } else {
+    worktrees = candidates.filter((c2) => c2.exists).map((c2) => ({ path: c2.worktreePath, agentId: c2.agentId, deleted: false }));
+  }
+  return {
+    ok: true,
+    id,
+    path: repoPath,
+    removedFromRegistry,
+    deleteWorktrees,
+    worktrees,
+    apiUnreachable: apiUnreachable || void 0
+  };
+}
+
+// src/cli/commands/control.ts
 var controlCommand = {
   command: "control <subcommand>",
   describe: "Mission Control dashboard (local)",
@@ -32330,8 +32733,26 @@ var controlCommand = {
   ).command(
     "register",
     "Register a repository with Mission Control and sync runs + slots",
-    (y2) => y2.option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("api-url", { type: "string", describe: "Control API URL" }).option("dry-run", { type: "boolean", default: false }),
+    (y2) => y2.option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("api-url", { type: "string", describe: "Control API URL" }).option("dry-run", { type: "boolean", default: false }).option("force", {
+      type: "boolean",
+      default: false,
+      describe: "Re-register even if previously unregistered"
+    }),
     handleRegister
+  ).command(
+    "unregister",
+    "Remove a repository from Mission Control (optionally delete session worktrees)",
+    (y2) => y2.option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("api-url", { type: "string", describe: "Control API URL" }).option("dry-run", { type: "boolean", default: false }).option("yes", {
+      alias: "y",
+      type: "boolean",
+      default: false,
+      describe: "Skip confirmation prompts"
+    }).option("delete-worktrees", {
+      type: "boolean",
+      default: false,
+      describe: "Delete session worktrees for this repo (prompted interactively when omitted)"
+    }).option("json", { type: "boolean", default: false }),
+    handleUnregister
   ).command(
     "sync",
     "Sync runs and slot status to Mission Control",
@@ -32351,7 +32772,10 @@ var controlCommand = {
     "Configure HAR Cloud API credentials (hosted sync)",
     (y2) => y2.option("api-key", { type: "string", describe: "HAR Cloud API key" }),
     handleLogin
-  ).demandCommand(1, "Please specify a subcommand: up, down, register, sync, watch, login"),
+  ).demandCommand(
+    1,
+    "Please specify a subcommand: up, down, register, unregister, sync, watch, login"
+  ),
   handler: () => {
   }
 };
@@ -32411,14 +32835,18 @@ async function handleDown() {
   process.exit(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path43.resolve(argv.repo);
+  const repoPath = path45.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
+    if (!argv.dryRun) {
+      recordRepoForControlSync(repoPath);
+    }
     await syncRepoWithControl({
       repoPath,
       apiUrl: argv.apiUrl,
-      dryRun: argv.dryRun
+      dryRun: argv.dryRun,
+      force: true
     });
     if (argv.dryRun) {
       info("Dry run \u2014 no API call made");
@@ -32430,8 +32858,77 @@ async function handleRegister(argv) {
     process.exit(1);
   }
 }
+async function handleUnregister(argv) {
+  const repoPath = path45.resolve(argv.repo);
+  const worktrees = listUnregisterWorktreeCandidates(repoPath);
+  try {
+    let deleteWorktrees = argv.deleteWorktrees;
+    if (!argv.yes && !argv.dryRun) {
+      const confirmation = await confirmUnregister({ yes: false, worktrees });
+      if (!confirmation.proceed) {
+        error("Aborted \u2014 repository left registered.");
+        process.exit(2);
+      }
+      deleteWorktrees = argv.deleteWorktrees || confirmation.deleteWorktrees;
+    } else if (argv.yes && !argv.deleteWorktrees && worktrees.some((w2) => w2.exists)) {
+      deleteWorktrees = false;
+    }
+    const result = await unregisterRepoWithControl({
+      repoPath,
+      apiUrl: argv.apiUrl,
+      dryRun: argv.dryRun,
+      deleteWorktrees
+    });
+    if (argv.json) {
+      process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+      return;
+    }
+    header("har control unregister");
+    info(`Repository: ${result.path}`);
+    if (argv.dryRun) {
+      info("Dry run \u2014 no changes made");
+      if (worktrees.filter((w2) => w2.exists).length > 0) {
+        info(
+          `Would propose deleting ${worktrees.filter((w2) => w2.exists).length} session worktree(s)`
+        );
+      }
+      return;
+    }
+    if (result.apiUnreachable) {
+      warn("Mission Control API unreachable \u2014 removed from local registry only");
+    } else if (result.id) {
+      success("Removed from Mission Control");
+    } else {
+      info("Repository was not present in Mission Control");
+    }
+    if (result.removedFromRegistry) {
+      success("Removed from local sync registry (~/.har/repos.json)");
+    }
+    if (result.deleteWorktrees) {
+      const deleted = result.worktrees.filter((w2) => w2.deleted).length;
+      const failed = result.worktrees.filter((w2) => !w2.deleted && w2.error);
+      success(`Deleted ${deleted} session worktree(s)`);
+      for (const failure of failed) {
+        warn(`Failed to delete ${failure.path}: ${failure.error}`);
+      }
+    } else if (result.worktrees.length > 0) {
+      info(
+        `Left ${result.worktrees.length} session worktree(s) on disk (rerun with --delete-worktrees to remove)`
+      );
+    }
+  } catch (err) {
+    if (argv.json) {
+      process.stdout.write(
+        JSON.stringify({ ok: false, error: err.message }, null, 2) + "\n"
+      );
+      process.exit(1);
+    }
+    error(err.message);
+    process.exit(1);
+  }
+}
 async function handleSync(argv) {
-  const repoPath = path43.resolve(argv.repo);
+  const repoPath = path45.resolve(argv.repo);
   try {
     await syncRepoWithControl({
       repoPath,
@@ -32470,7 +32967,7 @@ async function handleWatch(argv) {
   };
   const tick = async () => {
     if (argv.repo) {
-      await syncOne(path43.resolve(argv.repo));
+      await syncOne(path45.resolve(argv.repo));
       return;
     }
     try {
@@ -32501,12 +32998,12 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path46 = __toESM(require("path"));
+var path48 = __toESM(require("path"));
 
 // src/core/hooks.ts
-var fs39 = __toESM(require("fs"));
+var fs41 = __toESM(require("fs"));
 var os13 = __toESM(require("os"));
-var path44 = __toESM(require("path"));
+var path46 = __toESM(require("path"));
 var MARKER_START = "# >>> har commit gate (managed by `har hooks`) >>>";
 var MARKER_END = "# <<< har commit gate <<<";
 var PRE_COMMIT_BLOCK = [
@@ -32521,27 +33018,27 @@ var POST_COMMIT_BLOCK = [
   '"$(git rev-parse --git-path hooks)/har-post-commit" || true',
   MARKER_END
 ].join("\n");
-function tryGit2(cwd, args) {
+function tryGit3(cwd, args) {
   const result = run(`git ${args}`, { cwd });
   return result.code === 0 ? result.stdout.trim() : void 0;
 }
 function resolveCheckoutRoot(cwd) {
-  return tryGit2(cwd, "rev-parse --show-toplevel");
+  return tryGit3(cwd, "rev-parse --show-toplevel");
 }
 function resolveHooksDir(checkoutDir) {
-  const hooksPath = tryGit2(checkoutDir, "rev-parse --git-path hooks");
+  const hooksPath = tryGit3(checkoutDir, "rev-parse --git-path hooks");
   if (!hooksPath) throw new Error(`Not a git checkout: ${checkoutDir}`);
-  return path44.resolve(checkoutDir, hooksPath);
+  return path46.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
-  return tryGit2(checkoutDir, "config core.hooksPath") || void 0;
+  return tryGit3(checkoutDir, "config core.hooksPath") || void 0;
 }
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path44.resolve(entry)}"`;
+    return `"${process.execPath}" "${path46.resolve(entry)}"`;
   }
-  if (entry) return `"${path44.resolve(entry)}"`;
+  if (entry) return `"${path46.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -32562,40 +33059,40 @@ exit 0
 `;
 }
 function upsertMarkedBlock(filePath, block) {
-  if (!fs39.existsSync(filePath)) {
-    fs39.writeFileSync(filePath, `#!/bin/sh
+  if (!fs41.existsSync(filePath)) {
+    fs41.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs39.readFileSync(filePath, "utf8");
+  const content = fs41.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
       `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
     );
-    fs39.writeFileSync(filePath, content.replace(pattern, block));
-    fs39.chmodSync(filePath, 493);
+    fs41.writeFileSync(filePath, content.replace(pattern, block));
+    fs41.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs39.writeFileSync(filePath, `${content}${suffix}
+  fs41.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs39.chmodSync(filePath, 493);
+  fs41.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs39.existsSync(filePath)) return false;
-  const content = fs39.readFileSync(filePath, "utf8");
+  if (!fs41.existsSync(filePath)) return false;
+  const content = fs41.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() === "") {
-    fs39.rmSync(filePath);
+    fs41.rmSync(filePath);
   } else {
-    fs39.writeFileSync(filePath, stripped);
+    fs41.writeFileSync(filePath, stripped);
   }
   return true;
 }
@@ -32617,20 +33114,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs39.mkdirSync(hooksDir, { recursive: true });
+  fs41.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs39.writeFileSync(
-    path44.join(hooksDir, "har-pre-commit"),
+  fs41.writeFileSync(
+    path46.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs39.writeFileSync(
-    path44.join(hooksDir, "har-post-commit"),
+  fs41.writeFileSync(
+    path46.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path44.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path44.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock(path46.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock(path46.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -32639,12 +33136,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path44.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path44.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path46.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path46.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path44.join(hooksDir, file);
-    if (fs39.existsSync(full)) {
-      fs39.rmSync(full);
+    const full = path46.join(hooksDir, file);
+    if (fs41.existsSync(full)) {
+      fs41.rmSync(full);
       removed = true;
     }
   }
@@ -32661,9 +33158,9 @@ function getCommitGateConfig(checkoutDir) {
 function isAgentWorktree(checkoutDir) {
   const branch = getCurrentBranch(checkoutDir);
   if (branch && /^har-agent-\d+$/.test(branch)) return true;
-  const worktreesRoot = path44.join(os13.homedir(), "worktrees");
-  const resolved = path44.resolve(checkoutDir);
-  return resolved.startsWith(`${worktreesRoot}${path44.sep}`) && /-agent-\d+$/.test(path44.basename(resolved));
+  const worktreesRoot = path46.join(os13.homedir(), "worktrees");
+  const resolved = path46.resolve(checkoutDir);
+  return resolved.startsWith(`${worktreesRoot}${path46.sep}`) && /-agent-\d+$/.test(path46.basename(resolved));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -32676,15 +33173,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path44.join(hooksDir, name);
-    return fs39.existsSync(file) && fs39.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path46.join(hooksDir, name);
+    return fs41.existsSync(file) && fs41.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs39.existsSync(path44.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs39.existsSync(path44.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs41.existsSync(path46.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs41.existsSync(path46.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -32695,7 +33192,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs39.existsSync(path44.join(checkout, ".har", "stages.json"))) {
+  if (!fs41.existsSync(path46.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -32752,7 +33249,7 @@ async function recordCommitAssociation(cwd) {
     const checkout = resolveCheckoutRoot(cwd);
     if (!checkout) return { attached: false };
     const commitSha = getHeadSha(checkout);
-    const tree = tryGit2(checkout, "rev-parse HEAD^{tree}");
+    const tree = tryGit3(checkout, "rev-parse HEAD^{tree}");
     if (!commitSha || !tree) return { attached: false };
     const updated = attachCommit(checkout, tree, commitSha);
     if (updated) {
@@ -32766,8 +33263,8 @@ async function recordCommitAssociation(cwd) {
 }
 
 // src/core/claude-hooks.ts
-var fs40 = __toESM(require("fs"));
-var path45 = __toESM(require("path"));
+var fs42 = __toESM(require("fs"));
+var path47 = __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";
@@ -32778,8 +33275,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs40.existsSync(settingsPath)) return {};
-  const raw = fs40.readFileSync(settingsPath, "utf8").trim();
+  if (!fs42.existsSync(settingsPath)) return {};
+  const raw = fs42.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -32788,19 +33285,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs40.mkdirSync(path45.dirname(settingsPath), { recursive: true });
-  fs40.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs42.mkdirSync(path47.dirname(settingsPath), { recursive: true });
+  fs42.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 = path45.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs40.mkdirSync(path45.dirname(guardScript), { recursive: true });
-  fs40.copyFileSync(templatePath, guardScript);
-  fs40.chmodSync(guardScript, 493);
-  const settingsPath = path45.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path47.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs42.mkdirSync(path47.dirname(guardScript), { recursive: true });
+  fs42.copyFileSync(templatePath, guardScript);
+  fs42.chmodSync(guardScript, 493);
+  const settingsPath = path47.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -32814,15 +33311,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path45.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs40.existsSync(guardScript)) {
-    fs40.rmSync(guardScript);
+  const guardScript = path47.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs42.existsSync(guardScript)) {
+    fs42.rmSync(guardScript);
     removed = true;
-    const parent = path45.dirname(guardScript);
-    if (fs40.existsSync(parent) && fs40.readdirSync(parent).length === 0) fs40.rmdirSync(parent);
+    const parent = path47.dirname(guardScript);
+    if (fs42.existsSync(parent) && fs42.readdirSync(parent).length === 0) fs42.rmdirSync(parent);
   }
-  const settingsPath = path45.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs40.existsSync(settingsPath)) {
+  const settingsPath = path47.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs42.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -32847,8 +33344,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path45.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs40.existsSync(settingsPath)) return false;
+  const settingsPath = path47.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs42.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -32864,7 +33361,7 @@ function repoOption(y2) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path46.resolve(argv.repo));
+      const result2 = installClaudeGuard(path48.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -32872,7 +33369,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path46.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path48.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.");
@@ -32885,7 +33382,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path46.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path48.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -32893,7 +33390,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path46.resolve(argv.repo));
+    const result = uninstallHooks(path48.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -32906,7 +33403,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path46.resolve(argv.repo));
+    const status = getHooksStatus(path48.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -32924,7 +33421,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path46.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path48.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -33185,10 +33682,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path49) {
-  if (!path49)
+function getElementAtPath(obj, path51) {
+  if (!path51)
     return obj;
-  return path49.reduce((acc, key) => acc?.[key], obj);
+  return path51.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -33508,11 +34005,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path49, issues) {
+function prefixIssues(path51, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path49);
+    iss.path.unshift(path51);
     return iss;
   });
 }
@@ -38835,7 +39332,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve34) => setTimeout(resolve34, pollInterval));
+        await new Promise((resolve36) => setTimeout(resolve36, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -38852,7 +39349,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve34, reject) => {
+    return new Promise((resolve36, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -38930,7 +39427,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve34(parseResult.data);
+            resolve36(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -39191,12 +39688,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve34, reject) => {
+    return new Promise((resolve36, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve34, interval);
+      const timeoutId = setTimeout(resolve36, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -39986,7 +40483,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path47 = __toESM(require("path"));
+var path49 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process2 = __toESM(require("node:process"), 1);
@@ -40069,12 +40566,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve34) => {
+    return new Promise((resolve36) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve34();
+        resolve36();
       } else {
-        this._stdout.once("drain", resolve34);
+        this._stdout.once("drain", resolve36);
       }
     });
   }
@@ -40152,7 +40649,7 @@ var LaunchEnvironmentInputSchema = external_exports.object({
   worktree: external_exports.boolean().default(true),
   claude: external_exports.boolean().default(false),
   confirmReplace: external_exports.boolean().default(false).describe(
-    "Replace an occupied slot. Required when a session is already active. Call har_get_status first; get explicit user approval before setting this."
+    "Destroy the previous session on this slot and start another from main-checkout HEAD. Does not choose main. Prefer complete/teardown when the prior task is finished. Call har_get_status first; get explicit user approval."
   ),
   force: external_exports.boolean().default(false).describe(
     "Discard uncommitted changes in a dirty occupied worktree. Requires confirmReplace=true and explicit user approval \u2014 never set autonomously."
@@ -40278,7 +40775,7 @@ var HAR_MCP_TOOLS = [
   },
   {
     name: "har_launch_environment",
-    description: "Start a FRESH agent session. Run this BEFORE editing any file: it returns workDir \u2014 ALL file edits must go under that path, never the main checkout. If the slot is already occupied, launch is BLOCKED until confirmReplace=true (call har_get_status first; get explicit user approval). force=true discards dirty uncommitted work \u2014 never set without user approval. Edits under workDir hot-reload in the running slot.",
+    description: "Start a FRESH agent session from the main checkout HEAD (switch that checkout to main first for a new unrelated task). Run BEFORE editing any file: returns workDir \u2014 ALL edits go there, never the main checkout. Prefer har_complete_environment / har_teardown_environment when a prior task is done. Occupied slots block until confirmReplace=true (does NOT choose main). force=true discards dirty work \u2014 never set without user approval. Failed launches: resume=true / har_recover_environment.",
     inputSchema: objectJsonSchema(
       {
         repo: repoJsonProperty,
@@ -40287,7 +40784,7 @@ var HAR_MCP_TOOLS = [
         claude: { type: "boolean" },
         confirmReplace: {
           type: "boolean",
-          description: "Replace an occupied slot. Required when a session is active. Call har_get_status first; get explicit user approval before setting true."
+          description: "Destroy the previous session on this slot and start another from main-checkout HEAD. Does not choose main. Prefer complete/teardown when the prior task is finished. Call har_get_status first; get explicit user approval."
         },
         force: {
           type: "boolean",
@@ -40295,7 +40792,7 @@ var HAR_MCP_TOOLS = [
         },
         resume: {
           type: "boolean",
-          description: "Resume a failed or partial launch (status failed/starting) without --replace. Preserves worktree and env."
+          description: "Resume a failed or partial launch (status failed/starting) without confirmReplace. Preserves worktree and env."
         }
       },
       ["agentId"]
@@ -40618,7 +41115,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path47.resolve(input.repo)
+        cwd: path49.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -40681,7 +41178,7 @@ var mcpCommand = {
 };
 
 // src/cli/commands/telemetry.ts
-var path48 = __toESM(require("path"));
+var path50 = __toESM(require("path"));
 init_control_config();
 init_otel_hooks();
 init_telemetry_config();
@@ -40766,7 +41263,7 @@ async function handleOff() {
   info("Mission Control will not auto-start. Existing usage rows are kept.");
 }
 async function handleWriteEnv(argv) {
-  const repoPath = path48.resolve(argv.repo);
+  const repoPath = path50.resolve(argv.repo);
   const harnessRoot = resolveHarnessRoot(repoPath);
   const session = readSlotRegistry(harnessRoot, argv.agentId);
   const workDir = argv.workDir ?? session?.workDir ?? repoPath;
@@ -40778,7 +41275,7 @@ async function handleWriteEnv(argv) {
     suffix,
     createdAt: session?.createdAt
   });
-  const envFile = argv.envFile ?? path48.join(workDir, `.env.agent.${argv.agentId}`);
+  const envFile = argv.envFile ?? path50.join(workDir, `.env.agent.${argv.agentId}`);
   const attrs = {
     sessionKey,
     agentId: argv.agentId,
@@ -40797,7 +41294,7 @@ async function handleWriteEnv(argv) {
   success(`Wrote session attribution to ${envFile}`);
 }
 function handlePrintEnv(argv) {
-  const repoPath = path48.resolve(argv.repo);
+  const repoPath = path50.resolve(argv.repo);
   const workDir = argv.workDir ?? repoPath;
   const sessionKey = buildSessionKey({
     branch: argv.branch,
@@ -40910,7 +41407,7 @@ var telemetryCommand = {
 
 // src/cli/index.ts
 async function runCli() {
-  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(envCommand).command(agentsCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).command(telemetryCommand).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).command(telemetryCommand).demandCommand(1, "Please specify a command. Try: har env --help").epilog(HAR_ROOT_EPILOG).strict().help().version(getHarPackageVersion()).parse();
 }
 
 // src/index.ts