npm - @osfactory/har - Versions diffs - 0.10.0 → 0.12.0 - Mend

@osfactory/har 0.10.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/dist/index.js CHANGED Viewed

@@ -765,14 +765,14 @@ var require_url_state_machine = __commonJS({
       return url.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url) {
-      const path40 = url.path;
-      if (path40.length === 0) {
+      const path47 = url.path;
+      if (path47.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path40.length === 1 && isNormalizedWindowsDriveLetter(path40[0])) {
+      if (url.scheme === "file" && path47.length === 1 && isNormalizedWindowsDriveLetter(path47[0])) {
         return;
       }
-      path40.pop();
+      path47.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(resolve27, reject) {
+      return new Body.Promise(function(resolve33, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2126,7 +2126,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve27(Buffer.concat(accum, accumBytes));
+            resolve33(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(resolve27, reject) {
+      return new fetch3.Promise(function(resolve33, 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");
                 }
-                resolve27(fetch3(new Request3(locationURL, requestOpts)));
+                resolve33(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);
-            resolve27(response);
+            resolve33(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);
-            resolve27(response);
+            resolve33(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);
-              resolve27(response);
+              resolve33(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve27(response);
+                resolve33(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);
-            resolve27(response);
+            resolve33(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve27(response);
+          resolve33(response);
         });
         writeToStream(req, request);
       });
@@ -6351,14 +6351,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path40, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path47, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path40, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path47, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6367,13 +6367,13 @@ function createFileFromPath(path40, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path40, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path40);
-  return createFileFromPath(path40, stats, filenameOrOptions, options);
+function fileFromPathSync(path47, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path47);
+  return createFileFromPath(path47, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path40, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path40);
-  return createFileFromPath(path40, stats, filenameOrOptions, options);
+async function fileFromPath2(path47, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path47);
+  return createFileFromPath(path47, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -9384,7 +9384,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve27.call(this, root, ref);
+      let _sch = resolve33.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -9411,7 +9411,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve27(root, ref) {
+    function resolve33(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -9629,8 +9629,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path40) {
-      let input = path40;
+    function removeDotSegments(path47) {
+      let input = path47;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -9882,8 +9882,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path40, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path40 && path40 !== "/" ? path40 : void 0;
+        const [path47, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path47 && path47 !== "/" ? path47 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10042,7 +10042,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve27(baseURI, relativeURI, options) {
+    function resolve33(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -10300,7 +10300,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve27,
+      resolve: resolve33,
       resolveComponent,
       equal,
       serialize,
@@ -13276,12 +13276,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs34, exportName) {
+    function addFormats(ajv, list, fs40, 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, fs34[f2]);
+        ajv.addFormat(f2, fs40[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -14565,11 +14565,11 @@ var parser = new YargsParser({
   resolve: import_path2.resolve,
   // TODO: figure  out a  way to combine ESM and CJS coverage, such  that
   // we can exercise all the lines below:
-  require: (path40) => {
+  require: (path47) => {
     if (typeof require !== "undefined") {
-      return require(path40);
-    } else if (path40.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path40, "utf8"));
+      return require(path47);
+    } else if (path47.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path47, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -15912,13 +15912,13 @@ function usage(yargs, shim3) {
   };
   self.stringifiedValues = function stringifiedValues(values, separator) {
     let string3 = "";
-    const sep3 = separator || ", ";
+    const sep5 = separator || ", ";
     const array2 = [].concat(values);
     if (!values || !array2.length)
       return string3;
     array2.forEach((value) => {
       if (string3.length)
-        string3 += sep3;
+        string3 += sep5;
       string3 += JSON.stringify(value);
     });
     return string3;
@@ -17095,12 +17095,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve27, reject) => {
+      return new Promise((resolve33, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve27(completions);
+            resolve33(completions);
         });
       });
     } else {
@@ -19250,8 +19250,8 @@ function getErrorMap() {
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path40, errorMaps, issueData } = params;
-  const fullPath = [...path40, ...issueData.path || []];
+  const { data, path: path47, errorMaps, issueData } = params;
+  const fullPath = [...path47, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -19367,11 +19367,11 @@ var errorUtil;
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path40, key) {
+  constructor(parent, value, path47, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path40;
+    this._path = path47;
     this._key = key;
   }
   get path() {
@@ -23106,6 +23106,29 @@ var ValidationRecordSchema = external_exports.object({
 var SyncValidationsInputSchema = external_exports.object({
   validations: external_exports.array(ValidationRecordSchema)
 });
+var AgentToolSchema = external_exports.enum(["claude_code", "codex"]);
+var UsageSourceSchema = external_exports.enum(["otel", "harvest"]);
+var AgentSessionUsageSchema = external_exports.object({
+  sessionKey: external_exports.string().min(1),
+  agentId: external_exports.number().int().min(HAR_AGENT_SLOT_MIN),
+  agentTool: AgentToolSchema,
+  workDir: external_exports.string().optional(),
+  branch: external_exports.string().optional(),
+  suffix: external_exports.string().optional(),
+  tokensInput: external_exports.number().nonnegative().default(0),
+  tokensOutput: external_exports.number().nonnegative().default(0),
+  tokensCacheRead: external_exports.number().nonnegative().default(0),
+  tokensCacheCreation: external_exports.number().nonnegative().default(0),
+  tokensTotal: external_exports.number().nonnegative().default(0),
+  costUsd: external_exports.number().nonnegative().nullable().optional(),
+  modelBreakdown: external_exports.record(external_exports.unknown()).optional(),
+  sources: external_exports.array(UsageSourceSchema).default([]),
+  firstSeenAt: external_exports.string(),
+  lastSeenAt: external_exports.string()
+});
+var SyncUsageInputSchema = external_exports.object({
+  usage: external_exports.array(AgentSessionUsageSchema)
+});
 // src/harness/manifest.ts
 var GENERATOR_VERSION = "0.4.0";
@@ -23371,16 +23394,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve27) => {
+  return new Promise((resolve33) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve27(true);
+        resolve33(true);
         return;
       }
-      resolve27(/^y(es)?$/i.test(trimmed));
+      resolve33(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -23459,7 +23482,7 @@ function handleRemove(argv) {
 }
 // src/cli/commands/env.ts
-var path33 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 // src/core/harness.ts
 var fs19 = __toESM(require("fs"));
@@ -23965,13 +23988,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(path40, ...args) {
+async function fileFromPath3(path47, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path40)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path47)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path40, ...args);
+  return await _fileFromPath(path47, ...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 });
@@ -24467,8 +24490,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve27) => {
-      resolve27(null);
+    super((resolve33) => {
+      resolve33(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -24568,29 +24591,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path40, opts) {
-    return this.methodRequest("get", path40, opts);
+  get(path47, opts) {
+    return this.methodRequest("get", path47, opts);
   }
-  post(path40, opts) {
-    return this.methodRequest("post", path40, opts);
+  post(path47, opts) {
+    return this.methodRequest("post", path47, opts);
   }
-  patch(path40, opts) {
-    return this.methodRequest("patch", path40, opts);
+  patch(path47, opts) {
+    return this.methodRequest("patch", path47, opts);
   }
-  put(path40, opts) {
-    return this.methodRequest("put", path40, opts);
+  put(path47, opts) {
+    return this.methodRequest("put", path47, opts);
   }
-  delete(path40, opts) {
-    return this.methodRequest("delete", path40, opts);
+  delete(path47, opts) {
+    return this.methodRequest("delete", path47, opts);
   }
-  methodRequest(method, path40, opts) {
+  methodRequest(method, path47, 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: path40, ...opts2, body };
+      return { method, path: path47, ...opts2, body };
     }));
   }
-  getAPIList(path40, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path40, ...opts });
+  getAPIList(path47, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path47, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -24608,10 +24631,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path40, query, headers = {} } = options;
+    const { method, path: path47, 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(path40, query);
+    const url = this.buildURL(path47, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -24720,8 +24743,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path40, query) {
-    const url = isAbsoluteURL(path40) ? new URL(path40) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path40.startsWith("/") ? path40.slice(1) : path40));
+  buildURL(path47, query) {
+    const url = isAbsoluteURL(path47) ? new URL(path47) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path47.startsWith("/") ? path47.slice(1) : path47));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -25006,7 +25029,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve27) => setTimeout(resolve27, ms));
+var sleep = (ms) => new Promise((resolve33) => setTimeout(resolve33, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -25497,12 +25520,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve27, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve27, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve33, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve27, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve27, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve33, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -25631,11 +25654,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve27, reject) => {
+    return new Promise((resolve33, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve27);
+      this.once(event, resolve33);
     });
   }
   async done() {
@@ -25862,7 +25885,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve27, reject) => readQueue.push({ resolve: resolve27, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve33, reject) => readQueue.push({ resolve: resolve33, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26010,12 +26033,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve27, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve27, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve33, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve27, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve27, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve33, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -26144,11 +26167,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve27, reject) => {
+    return new Promise((resolve33, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve27);
+      this.once(event, resolve33);
     });
   }
   async done() {
@@ -26375,7 +26398,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve27, reject) => readQueue.push({ resolve: resolve27, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve33, reject) => readQueue.push({ resolve: resolve33, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26635,11 +26658,11 @@ async function promptApplyAgentMdProposal(repoPath) {
 }
 async function askYesNo2(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve27) => {
+  return new Promise((resolve33) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve27(/^y(es)?$/i.test(answer.trim()));
+      resolve33(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -26869,7 +26892,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((resolve27) => {
+  return new Promise((resolve33) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -26880,7 +26903,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve27(answer.trim());
+      resolve33(answer.trim());
     });
   });
 }
@@ -27024,7 +27047,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve27) => {
+  return new Promise((resolve33) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27039,13 +27062,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve27({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve27) => {
+  return new Promise((resolve33) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27060,7 +27083,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve27({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
   });
 }
@@ -27849,6 +27872,24 @@ function harnessExists(repoPath) {
 }
 // src/harness/stage-templates.ts
+var STAGE_TEMPLATE_IDS = ["playwright", "rocketsim"];
+var TemplateManifestFileSchema = external_exports.object({
+  src: external_exports.string().min(1),
+  dest: external_exports.string().min(1),
+  executable: external_exports.boolean().optional(),
+  skipFlag: external_exports.string().optional()
+});
+var StageTemplateManifestSchema = external_exports.object({
+  id: external_exports.enum(STAGE_TEMPLATE_IDS),
+  stageId: external_exports.string().min(1),
+  verificationStages: external_exports.array(external_exports.string().min(1)).min(1),
+  stage: external_exports.record(external_exports.unknown()),
+  files: external_exports.array(TemplateManifestFileSchema).min(1),
+  optionalFiles: external_exports.array(TemplateManifestFileSchema).optional(),
+  merge: external_exports.record(external_exports.string()).optional(),
+  nextSteps: external_exports.array(external_exports.string().min(1)).min(1),
+  docsPath: external_exports.string().min(1)
+});
 function resolveTemplateDir(templateId) {
   const dir = path17.join(resolveTemplatesDir(), "stage-templates", templateId);
   if (!fs18.existsSync(dir)) {
@@ -27858,11 +27899,16 @@ function resolveTemplateDir(templateId) {
 }
 function readTemplateManifest(templateId) {
   const manifestPath = path17.join(resolveTemplateDir(templateId), "template.manifest.json");
-  const raw = JSON.parse(fs18.readFileSync(manifestPath, "utf8"));
-  if (raw.id !== templateId) {
-    throw new Error(`Template manifest id mismatch: expected ${templateId}, got ${raw.id}`);
+  const parsed = StageTemplateManifestSchema.safeParse(
+    JSON.parse(fs18.readFileSync(manifestPath, "utf8"))
+  );
+  if (!parsed.success) {
+    throw new Error(`Invalid template manifest for ${templateId}: ${parsed.error.message}`);
+  }
+  if (parsed.data.id !== templateId) {
+    throw new Error(`Template manifest id mismatch: expected ${templateId}, got ${parsed.data.id}`);
   }
-  return raw;
+  return parsed.data;
 }
 function ensureParentDir(filePath) {
   const parent = path17.dirname(filePath);
@@ -27891,7 +27937,7 @@ function copyTemplateFile(templateDir, file, repoPath, force) {
 function mergePackageJson(repoPath, templateDir, fragmentRelPath, warnings) {
   const packagePath = path17.join(repoPath, "package.json");
   if (!fs18.existsSync(packagePath)) {
-    throw new Error("No package.json in repo root. Add one before applying the Playwright template.");
+    throw new Error("No package.json in repo root. Add one before applying this stage template.");
   }
   const fragmentPath = path17.join(templateDir, fragmentRelPath);
   if (!fs18.existsSync(fragmentPath)) {
@@ -27924,8 +27970,7 @@ function patchStageRegistry(repoPath, manifest, force) {
   }
   const stages = existing ? registry2.stages.map((s2) => s2.id === stage.id ? stage : s2) : [...registry2.stages, stage];
   const verificationStages = [...registry2.verificationStages ?? []];
-  const toAdd = manifest.verificationStages ?? (manifest.verificationStageId ? [manifest.verificationStageId] : [manifest.stageId]);
-  for (const id of toAdd) {
+  for (const id of manifest.verificationStages) {
     if (!verificationStages.includes(id)) {
       verificationStages.push(id);
     }
@@ -27934,7 +27979,7 @@ function patchStageRegistry(repoPath, manifest, force) {
   if (verifyIdx >= 0) {
     stages[verifyIdx] = {
       ...stages[verifyIdx],
-      description: "Verification pipeline (quick smoke by default; --full adds tests, lint, and browser-e2e when installed)",
+      description: `Verification pipeline (quick smoke by default; --full runs the registry's verificationStages: ${verificationStages.join(", ")})`,
       acceptsArgs: ["--full"]
     };
   }
@@ -28010,21 +28055,22 @@ function applyStageTemplate(repoPath, templateId, options = {}) {
   for (const warning of warnings) {
     warn(`  \u26A0 ${warning}`);
   }
-  const nextSteps = manifest.nextSteps ?? [
-    "npm install",
-    "npx playwright install",
-    "./.har/launch.sh 1",
-    `./.har/stages/${manifest.stageId}.sh 1`,
-    "npx playwright show-report .har/artifacts/browser-e2e/playwright-report"
-  ];
   return {
     templateId,
     stageId: manifest.stageId,
     filesWritten,
     warnings,
-    nextSteps
+    nextSteps: manifest.nextSteps,
+    docsPath: manifest.docsPath
   };
 }
+function listStageTemplateIds() {
+  const root = path17.join(resolveTemplatesDir(), "stage-templates");
+  if (!fs18.existsSync(root)) return [...STAGE_TEMPLATE_IDS];
+  return fs18.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter(
+    (name) => STAGE_TEMPLATE_IDS.includes(name)
+  );
+}
 // src/utils/validation.ts
 function requireApiKey() {
@@ -28156,9 +28202,111 @@ function addStageTemplate(repoPath, templateId, options = {}) {
   return applyStageTemplate(repoPath, templateId, options);
 }
-// src/harness/adaptation-prompt.ts
+// src/harness/custom-stage.ts
 var fs20 = __toESM(require("fs"));
 var path19 = __toESM(require("path"));
+var STAGE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+function addCustomStage(repoPath, options) {
+  const resolved = path19.resolve(repoPath);
+  if (!harnessExists(resolved)) {
+    throw new Error('No .har/ harness found. Run "har env init" first.');
+  }
+  const id = options.id.trim();
+  if (!STAGE_ID_PATTERN.test(id)) {
+    throw new Error(
+      `Invalid stage id "${id}". Use lowercase letters, digits, dots, dashes (e.g. "unit-tests").`
+    );
+  }
+  const kind2 = options.kind ?? "custom";
+  if (!HarnessStageKindSchema.options.includes(kind2)) {
+    throw new Error(
+      `Invalid stage kind "${kind2}". Available: ${HarnessStageKindSchema.options.join(", ")}`
+    );
+  }
+  if (Boolean(options.command) === Boolean(options.script)) {
+    throw new Error(
+      'Choose exactly one execution mode: --command "<shell command>" for a one-liner, or --script to scaffold .har/stages/<id>.sh.'
+    );
+  }
+  const registry2 = readStageRegistry(resolved);
+  const existing = registry2.stages.find((s2) => s2.id === id);
+  if (existing && !options.force) {
+    throw new Error(`Stage "${id}" already registered in .har/stages.json. Use --force to replace.`);
+  }
+  const filesWritten = [];
+  const stage = {
+    id,
+    kind: kind2,
+    description: options.description ?? `Custom ${kind2} stage`,
+    requiresAgentId: true,
+    artifacts: []
+  };
+  if (options.command) {
+    stage.command = options.command;
+  } else {
+    const scriptRel = path19.join("stages", `${id}.sh`);
+    const scriptAbs = path19.join(resolved, ".har", scriptRel);
+    if (fs20.existsSync(scriptAbs) && !options.force) {
+      throw new Error(`Stage script already exists: .har/${scriptRel}. Use --force to overwrite.`);
+    }
+    const skeletonPath = path19.join(
+      resolveTemplatesDir(),
+      "stage-templates",
+      "custom-stage-skeleton.sh"
+    );
+    const skeleton = fs20.readFileSync(skeletonPath, "utf8").replace(/__STAGE_ID__/g, id).replace(/__STAGE_KIND__/g, kind2).replace(/__STAGE_DESCRIPTION__/g, stage.description);
+    fs20.mkdirSync(path19.dirname(scriptAbs), { recursive: true });
+    fs20.writeFileSync(scriptAbs, skeleton);
+    fs20.chmodSync(scriptAbs, 493);
+    filesWritten.push(`.har/${scriptRel}`);
+    stage.script = scriptRel;
+    stage.artifacts = [
+      {
+        path: `.har/artifacts/${id}`,
+        kind: "directory",
+        description: `Artifacts for the ${id} stage`
+      }
+    ];
+  }
+  const parsedStage = HarnessStageSchema.parse(stage);
+  const stages = existing ? registry2.stages.map((s2) => s2.id === id ? parsedStage : s2) : [...registry2.stages, parsedStage];
+  const verification = options.verification ?? false;
+  const verificationStages = [...registry2.verificationStages ?? []];
+  if (verification && !verificationStages.includes(id)) {
+    verificationStages.push(id);
+    const verifyIdx = stages.findIndex((s2) => s2.id === "verify");
+    if (verifyIdx >= 0) {
+      stages[verifyIdx] = {
+        ...stages[verifyIdx],
+        description: `Verification pipeline (quick smoke by default; --full runs the registry's verificationStages: ${verificationStages.join(", ")})`
+      };
+    }
+  }
+  writeStageRegistry(resolved, { ...registry2, stages, verificationStages });
+  filesWritten.push(".har/stages.json");
+  const nextSteps = options.command ? [
+    `Try it: ${options.command.replace(/\{agentId\}/g, "1")}`,
+    `Agents run it via the MCP tool har_run_stage (stageId: "${id}")`,
+    ...verification ? ["./.har/verify.sh 1 --full   # runs it as part of full verification"] : []
+  ] : [
+    `Edit .har/stages/${id}.sh \u2014 replace the TODO block with the real check`,
+    "./.har/launch.sh 1",
+    `./.har/stages/${id}.sh 1`,
+    ...verification ? ["./.har/verify.sh 1 --full   # runs it as part of full verification"] : []
+  ];
+  return {
+    stageId: id,
+    kind: kind2,
+    mode: options.command ? "command" : "script",
+    filesWritten,
+    verification,
+    nextSteps
+  };
+}
+// src/harness/adaptation-prompt.ts
+var fs21 = __toESM(require("fs"));
+var path20 = __toESM(require("path"));
 var ADAPTATION_PROMPT_FILE = "ADAPT-PROMPT.md";
 var PROFILE_HINTS = {
   default: "Web app profile (SaaS/full-stack) \u2014 Docker Compose for shared infra (HARNESS_INFRA_SERVICES), PM2 for the primary application only, git worktree per agent slot by default. Launch provisions toolchain via harness.env (HARNESS_ECOSYSTEM, HARNESS_INSTALL_CMD) and writes paths to .env.agent.<id>. Identify the primary app agents modify; run supporting services shared.",
@@ -28170,7 +28318,7 @@ function loadTemplate(name) {
   if (!filePath) {
     throw new Error(`Adaptation prompt template not found: ${name}. Run npm run build.`);
   }
-  return fs20.readFileSync(filePath, "utf8");
+  return fs21.readFileSync(filePath, "utf8");
 }
 function applyProfilePlaceholders(content, profile) {
   return content.replace(/\{\{PROFILE\}\}/g, profile).replace(/\{\{PROFILE_HINT\}\}/g, PROFILE_HINTS[profile]);
@@ -28192,7 +28340,7 @@ function buildMaintainAdaptationPrompt(_repoPath, bundleReport) {
 }
 function writeAdaptationPrompt(repoPath, content) {
   const harnessDir = getHarnessDir(repoPath);
-  const filePath = path19.join(harnessDir, ADAPTATION_PROMPT_FILE);
+  const filePath = path20.join(harnessDir, ADAPTATION_PROMPT_FILE);
   writeFileSafe(filePath, content);
   return filePath;
 }
@@ -28211,25 +28359,25 @@ function printAdaptationPrompt(content) {
 }
 // src/harness/cursor-rule.ts
-var fs21 = __toESM(require("fs"));
-var path20 = __toESM(require("path"));
+var fs22 = __toESM(require("fs"));
+var path21 = __toESM(require("path"));
 var readline4 = __toESM(require("readline"));
 var CURSOR_RULE_RELATIVE_PATH = ".cursor/rules/har-workflow.mdc";
 function getCursorRulePath(repoPath) {
-  return path20.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
+  return path21.join(repoPath, CURSOR_RULE_RELATIVE_PATH);
 }
 function isCursorWorkspace(repoPath) {
-  return fs21.existsSync(path20.join(repoPath, ".cursor"));
+  return fs22.existsSync(path21.join(repoPath, ".cursor"));
 }
 function cursorRuleExists(repoPath) {
-  return fs21.existsSync(getCursorRulePath(repoPath));
+  return fs22.existsSync(getCursorRulePath(repoPath));
 }
 function scaffoldCursorRule(repoPath) {
   const templatePath = resolveTemplateFile("cursor-rule.mdc.template");
   if (!templatePath) {
     throw new Error("Cursor rule template not found (cursor-rule.mdc.template). Run npm run build.");
   }
-  const content = fs21.readFileSync(templatePath, "utf8");
+  const content = fs22.readFileSync(templatePath, "utf8");
   writeFileSafe(getCursorRulePath(repoPath), content);
 }
 async function handleCursorRule(options) {
@@ -28267,16 +28415,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve27) => {
+  return new Promise((resolve33) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve27(true);
+        resolve33(true);
         return;
       }
-      resolve27(/^y(es)?$/i.test(trimmed));
+      resolve33(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -28355,26 +28503,26 @@ function buildStageResult(input) {
 }
 // src/core/local-executor.ts
-var fs23 = __toESM(require("fs"));
-var path22 = __toESM(require("path"));
+var fs24 = __toESM(require("fs"));
+var path23 = __toESM(require("path"));
 // src/core/slot-registry.ts
-var fs22 = __toESM(require("fs"));
-var path21 = __toESM(require("path"));
+var fs23 = __toESM(require("fs"));
+var path22 = __toESM(require("path"));
 function getSlotRegistryDir(repoPath) {
-  return path21.join(getHarnessDir(repoPath), "slots");
+  return path22.join(getHarnessDir(repoPath), "slots");
 }
 function getSlotRegistryPath(repoPath, agentId) {
-  return path21.join(getSlotRegistryDir(repoPath), `agent-${agentId}.json`);
+  return path22.join(getSlotRegistryDir(repoPath), `agent-${agentId}.json`);
 }
 function isSlotResumable(session) {
   return session?.status === "failed" || session?.status === "starting";
 }
 function readSlotRegistry(repoPath, agentId) {
   const file = getSlotRegistryPath(repoPath, agentId);
-  if (!fs22.existsSync(file)) return void 0;
+  if (!fs23.existsSync(file)) return void 0;
   try {
-    const raw = JSON.parse(fs22.readFileSync(file, "utf8"));
+    const raw = JSON.parse(fs23.readFileSync(file, "utf8"));
     const result = SlotRegistryEntrySchema.safeParse(raw);
     return result.success ? result.data : void 0;
   } catch {
@@ -28384,7 +28532,7 @@ function readSlotRegistry(repoPath, agentId) {
 // src/core/local-executor.ts
 function resolveRepoPath(repoPath) {
-  return path22.resolve(repoPath);
+  return path23.resolve(repoPath);
 }
 function buildPreviewUrlsFromPorts(ports, env3) {
   const urls = {};
@@ -28436,14 +28584,14 @@ function substituteAgentId(value, agentId) {
 function resolveStageScriptPath(repoPath, stage) {
   const harnessDir = getHarnessDir(repoPath);
   if (stage.script) {
-    return path22.join(harnessDir, stage.script);
+    return path23.join(harnessDir, stage.script);
   }
   if (stage.command) {
     const scriptName = stage.command.split(/\s+/)[0].replace(/^\.\/\.har\//, "").replace(/^\.\//, "");
-    return path22.join(harnessDir, scriptName);
+    return path23.join(harnessDir, scriptName);
   }
-  const stageScript = path22.join(harnessDir, "stages", `${stage.id}.sh`);
-  if (fs23.existsSync(stageScript)) {
+  const stageScript = path23.join(harnessDir, "stages", `${stage.id}.sh`);
+  if (fs24.existsSync(stageScript)) {
     return stageScript;
   }
   throw new Error(
@@ -28458,7 +28606,7 @@ function buildExecutionPlan(repoPath, stage, options) {
     ...harnessEnv,
     ...stage.env ?? {}
   };
-  const cwd = stage.cwd ? path22.resolve(resolvedRepo, stage.cwd) : resolvedRepo;
+  const cwd = stage.cwd ? path23.resolve(resolvedRepo, stage.cwd) : resolvedRepo;
   const extraArgs = options.args ?? [];
   const launchFlagArgs = [];
   if (stage.kind === "launch" && options.launchFlags) {
@@ -28535,19 +28683,19 @@ var LocalScriptExecutor = class {
     const repoPath = resolveRepoPath(ctx.repoPath);
     const harnessDir = getHarnessDir(repoPath);
     const artifactsDirName = getArtifactsDir(repoPath);
-    const artifactsDir = path22.join(harnessDir, artifactsDirName);
-    if (!fs23.existsSync(artifactsDir)) return [];
+    const artifactsDir = path23.join(harnessDir, artifactsDirName);
+    if (!fs24.existsSync(artifactsDir)) return [];
     const entries = [];
     const walk = (dir, prefix) => {
-      for (const entry of fs23.readdirSync(dir, { withFileTypes: true })) {
-        const full = path22.join(dir, entry.name);
-        const relative2 = path22.join(prefix, entry.name);
+      for (const entry of fs24.readdirSync(dir, { withFileTypes: true })) {
+        const full = path23.join(dir, entry.name);
+        const relative2 = path23.join(prefix, entry.name);
         if (entry.isDirectory()) {
           walk(full, relative2);
           continue;
         }
         if (filter?.stageId && !relative2.includes(filter.stageId)) continue;
-        const stat = fs23.statSync(full);
+        const stat = fs24.statSync(full);
         entries.push({
           path: full,
           relativePath: relative2,
@@ -28563,7 +28711,7 @@ var LocalScriptExecutor = class {
 var localScriptExecutor = new LocalScriptExecutor();
 // src/core/control-sync.ts
-var path32 = __toESM(require("path"));
+var path37 = __toESM(require("path"));
 // src/core/control-config.ts
 var DEFAULT_CONTROL_API_URL = "http://localhost:3847";
@@ -28575,32 +28723,32 @@ function isControlEnabled() {
 }
 // src/core/control-registry.ts
-var fs24 = __toESM(require("fs"));
+var fs25 = __toESM(require("fs"));
 var os4 = __toESM(require("os"));
-var path23 = __toESM(require("path"));
+var path24 = __toESM(require("path"));
 function getRegistryPath() {
   if (process.env.HAR_CONTROL_REGISTRY_PATH) {
-    return path23.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
+    return path24.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
   }
-  return path23.join(os4.homedir(), ".har", "repos.json");
+  return path24.join(os4.homedir(), ".har", "repos.json");
 }
 function readRegistry() {
   const registryPath = getRegistryPath();
   try {
-    if (!fs24.existsSync(registryPath)) return { repos: [] };
-    return JSON.parse(fs24.readFileSync(registryPath, "utf8"));
+    if (!fs25.existsSync(registryPath)) return { repos: [] };
+    return JSON.parse(fs25.readFileSync(registryPath, "utf8"));
   } catch {
     return { repos: [] };
   }
 }
 function writeRegistry(registry2) {
   const registryPath = getRegistryPath();
-  fs24.mkdirSync(path23.dirname(registryPath), { recursive: true });
-  fs24.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
+  fs25.mkdirSync(path24.dirname(registryPath), { recursive: true });
+  fs25.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
 }
 function recordRepoForControlSync(repoPath) {
   if (process.env.HAR_CONTROL_DISABLED === "true") return;
-  const resolved = path23.resolve(repoPath);
+  const resolved = path24.resolve(repoPath);
   if (!readManifest(resolved)) return;
   const registry2 = readRegistry();
   if (registry2.repos.includes(resolved)) return;
@@ -28609,7 +28757,7 @@ function recordRepoForControlSync(repoPath) {
 }
 function listRegisteredRepos() {
   const registry2 = readRegistry();
-  const kept = registry2.repos.filter((repoPath) => fs24.existsSync(repoPath) && readManifest(repoPath));
+  const kept = registry2.repos.filter((repoPath) => fs25.existsSync(repoPath) && readManifest(repoPath));
   if (kept.length !== registry2.repos.length) {
     writeRegistry({ repos: kept });
   }
@@ -28617,17 +28765,17 @@ function listRegisteredRepos() {
 }
 // src/core/slot-status.ts
-var fs29 = __toESM(require("fs"));
+var fs30 = __toESM(require("fs"));
 var os7 = __toESM(require("os"));
-var path29 = __toESM(require("path"));
+var path30 = __toESM(require("path"));
 var import_child_process7 = require("child_process");
 // src/core/runs.ts
 var crypto2 = __toESM(require("crypto"));
 var import_child_process2 = require("child_process");
-var fs25 = __toESM(require("fs"));
+var fs26 = __toESM(require("fs"));
 var os5 = __toESM(require("os"));
-var path24 = __toESM(require("path"));
+var path25 = __toESM(require("path"));
 var RUNS_DIR = "runs";
 function gitCommonDir(cwd) {
   try {
@@ -28636,7 +28784,7 @@ function gitCommonDir(cwd) {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
     }).trim();
-    return out ? path24.resolve(cwd, out) : void 0;
+    return out ? path25.resolve(cwd, out) : void 0;
   } catch {
     return void 0;
   }
@@ -28658,7 +28806,7 @@ function gitPrefix(cwd) {
   }
 }
 function getRunsDir(harnessRoot) {
-  return path24.join(getHarnessDir(harnessRoot), RUNS_DIR);
+  return path25.join(getHarnessDir(harnessRoot), RUNS_DIR);
 }
 function formatLocalDate(d2) {
   const y2 = d2.getFullYear();
@@ -28678,24 +28826,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 = path24.join(runsDir, dateFolder, filename);
-  if (fs25.existsSync(fullPath)) {
+  const fullPath = path25.join(runsDir, dateFolder, filename);
+  if (fs26.existsSync(fullPath)) {
     filename = `${timePart}_${stageId}${agentPart}-${runId.slice(0, 8)}.json`;
   }
-  return path24.join(dateFolder, filename);
+  return path25.join(dateFolder, filename);
 }
 function resolveRunFilePath(harnessRoot, run2) {
   if (run2.relativePath) {
-    return path24.join(getRunsDir(harnessRoot), run2.relativePath);
+    return path25.join(getRunsDir(harnessRoot), run2.relativePath);
   }
-  return path24.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
+  return path25.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
 }
 function collectRunFiles(runsDir) {
-  if (!fs25.existsSync(runsDir)) return [];
+  if (!fs26.existsSync(runsDir)) return [];
   const files = [];
   const walk = (dir) => {
-    for (const entry of fs25.readdirSync(dir, { withFileTypes: true })) {
-      const full = path24.join(dir, entry.name);
+    for (const entry of fs26.readdirSync(dir, { withFileTypes: true })) {
+      const full = path25.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(full);
       } else if (entry.name.endsWith(".json")) {
@@ -28709,30 +28857,30 @@ function collectRunFiles(runsDir) {
 function resolveAgentWorkDir(harnessRoot, agentId) {
   if (agentId === void 0) return void 0;
   const entry = readSlotRegistry(harnessRoot, agentId);
-  if (entry?.workDir && fs25.existsSync(entry.workDir)) return entry.workDir;
+  if (entry?.workDir && fs26.existsSync(entry.workDir)) return entry.workDir;
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path24.basename(harnessRoot);
-  const worktreeDir = path24.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path25.basename(harnessRoot);
+  const worktreeDir = path25.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
   const relPrefix = gitPrefix(harnessRoot);
   const sessionEnvFiles = [];
-  const worktreesRoot = path24.join(os5.homedir(), "worktrees");
-  if (fs25.existsSync(worktreesRoot)) {
+  const worktreesRoot = path25.join(os5.homedir(), "worktrees");
+  if (fs26.existsSync(worktreesRoot)) {
     const suffix = `-har-agent-${agentId}-`;
-    for (const entry2 of fs25.readdirSync(worktreesRoot, { withFileTypes: true })) {
+    for (const entry2 of fs26.readdirSync(worktreesRoot, { withFileTypes: true })) {
       if (!entry2.isDirectory() || !entry2.name.includes(suffix)) continue;
-      const sessionDir = path24.join(worktreesRoot, entry2.name);
+      const sessionDir = path25.join(worktreesRoot, entry2.name);
       if (!sameGitCheckout(harnessRoot, sessionDir)) continue;
-      sessionEnvFiles.push(path24.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
+      sessionEnvFiles.push(path25.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
     }
   }
   const candidates = [
-    path24.join(worktreeDir, `.env.agent.${agentId}`),
-    path24.join(harnessRoot, `.env.agent.${agentId}`),
+    path25.join(worktreeDir, `.env.agent.${agentId}`),
+    path25.join(harnessRoot, `.env.agent.${agentId}`),
     ...sessionEnvFiles.sort()
   ];
   for (const envFile of candidates) {
-    if (!fs25.existsSync(envFile)) continue;
-    const content = fs25.readFileSync(envFile, "utf8");
+    if (!fs26.existsSync(envFile)) continue;
+    const content = fs26.readFileSync(envFile, "utf8");
     const match = content.match(/^REPO_ROOT=(.+)$/m);
     if (match) return match[1].trim();
   }
@@ -28744,11 +28892,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 = path24.join(runsDir, relativePath);
-  fs25.mkdirSync(path24.dirname(runFilePath), { recursive: true });
+  const runFilePath = path25.join(runsDir, relativePath);
+  fs26.mkdirSync(path25.dirname(runFilePath), { recursive: true });
   const run2 = RunRecordSchema.parse({
     runId,
-    repoPath: path24.resolve(ctx.repoPath),
+    repoPath: path25.resolve(ctx.repoPath),
     harnessRoot,
     stageId: meta.stageId,
     kind: meta.kind,
@@ -28759,7 +28907,7 @@ function createRun(ctx, meta) {
     relativePath,
     trigger: ctx.trigger ?? "cli"
   });
-  fs25.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
+  fs26.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
   return run2;
 }
 function finishRun(repoPath, runId, update) {
@@ -28778,13 +28926,13 @@ function finishRun(repoPath, runId, update) {
     finishedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   const runPath = resolveRunFilePath(harnessRoot, finished);
-  fs25.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
+  fs26.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
   return finished;
 }
 function findRunRecord(harnessRoot, runId) {
   const runsDir = getRunsDir(harnessRoot);
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs25.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs26.readFileSync(filePath, "utf8")));
     if (parsed.success && parsed.data.runId === runId) {
       return parsed.data;
     }
@@ -28796,10 +28944,10 @@ function getRun(repoPath, runId) {
 }
 function listRuns(repoPath, filter = {}) {
   const runsDir = getRunsDir(resolveHarnessRoot(repoPath));
-  if (!fs25.existsSync(runsDir)) return [];
+  if (!fs26.existsSync(runsDir)) return [];
   const runs = [];
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs25.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs26.readFileSync(filePath, "utf8")));
     if (!parsed.success) continue;
     if (filter.stageId && parsed.data.stageId !== filter.stageId) continue;
     runs.push(parsed.data);
@@ -28812,17 +28960,17 @@ function listRuns(repoPath, filter = {}) {
 }
 // src/core/slot-preflight.ts
-var path28 = __toESM(require("path"));
+var path29 = __toESM(require("path"));
 // src/core/control-port.ts
 var import_child_process4 = require("child_process");
-var fs27 = __toESM(require("fs"));
-var path26 = __toESM(require("path"));
+var fs28 = __toESM(require("fs"));
+var path27 = __toESM(require("path"));
 // src/core/slot-ports.ts
 var import_child_process3 = require("child_process");
-var fs26 = __toESM(require("fs"));
-var path25 = __toESM(require("path"));
+var fs27 = __toESM(require("fs"));
+var path26 = __toESM(require("path"));
 function portStep(env3) {
   return Number(env3.HARNESS_PORT_STEP ?? 10);
 }
@@ -28878,7 +29026,7 @@ function allocateAppPorts(repoPath, agentId) {
 }
 function harnessUsesPm2(repoPath) {
   const harnessRoot = resolveHarnessRoot(repoPath);
-  return fs26.existsSync(path25.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
+  return fs27.existsSync(path26.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
 }
 // src/core/control-port.ts
@@ -28933,13 +29081,13 @@ function controlDefaultPortWarnings(containers, defaultFrontendPort, allocatedFr
   return [formatControlDefaultPortWarning(control.name, defaultFrontendPort, allocatedFrontend)];
 }
 function inspectControlUpReadiness(repoPath) {
-  const resolved = path26.resolve(repoPath);
+  const resolved = path27.resolve(repoPath);
   const port = parseControlHostPort();
   const containers = listDockerContainers();
   const control = controlContainerOnPort(containers, port);
   const warnings = [];
-  const controlHarnessDir = path26.join(resolved, "control", ".har");
-  const harnessSlot1Active = fs27.existsSync(controlHarnessDir) && readSlotRegistry(path26.join(resolved, "control"), 1)?.status === "active";
+  const controlHarnessDir = path27.join(resolved, "control", ".har");
+  const harnessSlot1Active = fs28.existsSync(controlHarnessDir) && readSlotRegistry(path27.join(resolved, "control"), 1)?.status === "active";
   if (control) {
     return {
       warnings,
@@ -28970,9 +29118,9 @@ function inspectControlUpReadiness(repoPath) {
 }
 // src/core/slot-launch-guard-occupied.ts
-var fs28 = __toESM(require("fs"));
+var fs29 = __toESM(require("fs"));
 var os6 = __toESM(require("os"));
-var path27 = __toESM(require("path"));
+var path28 = __toESM(require("path"));
 var import_child_process5 = require("child_process");
 function runGit(cwd, args) {
   try {
@@ -28991,7 +29139,7 @@ function worktreeDirty(worktreePath) {
 }
 function gitCommonDir2(cwd) {
   const out = runGit(cwd, "rev-parse --git-common-dir");
-  return out ? path27.resolve(cwd, out) : void 0;
+  return out ? path28.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout2(a2, b2) {
   const left2 = gitCommonDir2(a2);
@@ -29000,20 +29148,20 @@ function sameGitCheckout2(a2, b2) {
 }
 function discoverWorktree(harnessRoot, agentId, projectName) {
   const session = readSlotRegistry(harnessRoot, agentId);
-  if (session?.worktreePath && fs28.existsSync(session.worktreePath)) {
+  if (session?.worktreePath && fs29.existsSync(session.worktreePath)) {
     return session.worktreePath;
   }
-  const legacy = path27.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
-  if (fs28.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
-  const worktreesRoot = path27.join(os6.homedir(), "worktrees");
-  if (!fs28.existsSync(worktreesRoot)) return void 0;
+  const legacy = path28.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  if (fs29.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
+  const worktreesRoot = path28.join(os6.homedir(), "worktrees");
+  if (!fs29.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = runGit(harnessRoot, "rev-parse --show-prefix") ?? "";
-  for (const name of fs28.readdirSync(worktreesRoot)) {
+  for (const name of fs29.readdirSync(worktreesRoot)) {
     if (!name.includes(suffix)) continue;
-    const candidate = path27.join(worktreesRoot, name);
+    const candidate = path28.join(worktreesRoot, name);
     if (!sameGitCheckout2(harnessRoot, candidate)) continue;
-    if (!fs28.existsSync(path27.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
+    if (!fs29.existsSync(path28.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
     return candidate;
   }
   return void 0;
@@ -29021,13 +29169,13 @@ function discoverWorktree(harnessRoot, agentId, projectName) {
 function collectOccupiedSlot(repoPath, agentId) {
   const harnessRoot = resolveHarnessRoot(repoPath);
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path27.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path28.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
   const worktreePath = discoverWorktree(harnessRoot, agentId, projectName);
   const workDir = session?.workDir;
-  const envInWorkDir = workDir ? fs28.existsSync(path27.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs28.existsSync(path27.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs28.existsSync(path27.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs29.existsSync(path28.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs29.existsSync(path28.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs29.existsSync(path28.join(worktreePath, `.env.agent.${agentId}`)) : false;
   const active = session !== void 0 && session.status !== "completed" || envInWorkDir || envInRoot || envInWorktree;
   if (!active) return void 0;
   const dirty = worktreePath ? worktreeDirty(worktreePath) : void 0;
@@ -29180,7 +29328,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 ?? path28.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path29.basename(harnessRoot);
   const usesPm2 = harnessUsesPm2(repoPath);
   const blockers = [];
   const remediations = [];
@@ -29382,7 +29530,7 @@ function readWorktreeBranch(worktreePath) {
 }
 function gitCommonDir3(cwd) {
   const out = runGit2(cwd, "rev-parse --git-common-dir");
-  return out ? path29.resolve(cwd, out) : void 0;
+  return out ? path30.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout3(a2, b2) {
   const left2 = gitCommonDir3(a2);
@@ -29394,12 +29542,12 @@ function gitPrefix2(cwd) {
   return out ?? "";
 }
 function discoverSessionWorktreePath(harnessRoot, agentId) {
-  const worktreesRoot = path29.join(os7.homedir(), "worktrees");
-  if (!fs29.existsSync(worktreesRoot)) return void 0;
+  const worktreesRoot = path30.join(os7.homedir(), "worktrees");
+  if (!fs30.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = gitPrefix2(harnessRoot);
-  const matches = fs29.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path29.join(worktreesRoot, entry.name)).filter(
-    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs29.existsSync(path29.join(candidate, relPrefix, `.env.agent.${agentId}`))
+  const matches = fs30.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path30.join(worktreesRoot, entry.name)).filter(
+    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs30.existsSync(path30.join(candidate, relPrefix, `.env.agent.${agentId}`))
   );
   return matches.sort()[0];
 }
@@ -29474,18 +29622,18 @@ function detectPm2Issue(projectName, agentId, session, procs) {
 }
 function collectSlotStatus(harnessRoot, agentId, runs, pm2Procs) {
   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 legacyWorktreePath = path29.join(
+  const legacyWorktreePath = path30.join(
     os7.homedir(),
     "worktrees",
     `${projectName}-agent-${agentId}`
   );
-  const worktreePath = session?.worktreePath && fs29.existsSync(session.worktreePath) ? session.worktreePath : fs29.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
+  const worktreePath = session?.worktreePath && fs30.existsSync(session.worktreePath) ? session.worktreePath : fs30.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
   const workDir = resolveAgentWorkDir(harnessRoot, agentId);
-  const envInWorkDir = workDir ? fs29.existsSync(path29.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs29.existsSync(path29.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs29.existsSync(path29.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs30.existsSync(path30.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs30.existsSync(path30.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs30.existsSync(path30.join(worktreePath, `.env.agent.${agentId}`)) : false;
   const active = session !== void 0 && session.status !== "completed" || envInWorkDir || envInRoot || envInWorktree;
   const latest = latestRunForAgent(runs, agentId);
   const verifyRun = runs.find((r2) => r2.agentId === agentId && r2.stageId === "verify");
@@ -29538,7 +29686,7 @@ function collectEnvironmentStatus(repoPath) {
   const slotIds = getAgentSlotIds(harnessRoot);
   const pm2Procs = listPm2Processes2();
   return {
-    repoPath: path29.resolve(repoPath),
+    repoPath: path30.resolve(repoPath),
     harnessRoot,
     gitRemote: readGitRemote(harnessRoot),
     profile: manifest?.profile,
@@ -29549,13 +29697,13 @@ function collectEnvironmentStatus(repoPath) {
 // src/core/validations.ts
 var crypto3 = __toESM(require("crypto"));
-var fs31 = __toESM(require("fs"));
-var path31 = __toESM(require("path"));
+var fs32 = __toESM(require("fs"));
+var path32 = __toESM(require("path"));
 // src/core/change-batch.ts
-var fs30 = __toESM(require("fs"));
+var fs31 = __toESM(require("fs"));
 var os8 = __toESM(require("os"));
-var path30 = __toESM(require("path"));
+var path31 = __toESM(require("path"));
 function git(checkoutDir, args, env3) {
   const result = run(`git ${args}`, { cwd: checkoutDir, env: env3 });
   if (result.code !== 0) {
@@ -29571,7 +29719,7 @@ function isCheckoutRoot(checkoutDir) {
   const toplevel = tryGit(checkoutDir, "rev-parse --show-toplevel");
   if (!toplevel) return false;
   try {
-    return fs30.realpathSync(toplevel) === fs30.realpathSync(checkoutDir);
+    return fs31.realpathSync(toplevel) === fs31.realpathSync(checkoutDir);
   } catch {
     return false;
   }
@@ -29593,7 +29741,7 @@ function isMergeOrRebaseInProgress(checkoutDir) {
   if (tryGit(checkoutDir, "rev-parse -q --verify MERGE_HEAD") !== void 0) return true;
   for (const dir of ["rebase-merge", "rebase-apply"]) {
     const gitPath = tryGit(checkoutDir, `rev-parse --git-path ${dir}`);
-    if (gitPath && fs30.existsSync(path30.resolve(checkoutDir, gitPath))) return true;
+    if (gitPath && fs31.existsSync(path31.resolve(checkoutDir, gitPath))) return true;
   }
   return false;
 }
@@ -29616,8 +29764,8 @@ function parseNameStatus(output) {
   return files;
 }
 function computeWorktreeSnapshot(checkoutDir) {
-  const tmpDir = fs30.mkdtempSync(path30.join(os8.tmpdir(), "har-idx-"));
-  const tmpIndex = path30.join(tmpDir, "index");
+  const tmpDir = fs31.mkdtempSync(path31.join(os8.tmpdir(), "har-idx-"));
+  const tmpIndex = path31.join(tmpDir, "index");
   const env3 = { GIT_INDEX_FILE: tmpIndex };
   try {
     const headTree = getHeadTree(checkoutDir);
@@ -29640,35 +29788,35 @@ function computeWorktreeSnapshot(checkoutDir) {
       changedFiles: parseNameStatus(diffOutput)
     };
   } finally {
-    fs30.rmSync(tmpDir, { recursive: true, force: true });
+    fs31.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 // src/core/validations.ts
 var VALIDATIONS_DIR = "validations";
 function getValidationsDir(checkoutDir) {
-  return path31.join(checkoutDir, ".har", VALIDATIONS_DIR);
+  return path32.join(checkoutDir, ".har", VALIDATIONS_DIR);
 }
 function validationPath(checkoutDir, treeHash) {
-  return path31.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
+  return path32.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
 }
 function writeRecord(checkoutDir, record2) {
   const dir = getValidationsDir(checkoutDir);
-  fs31.mkdirSync(dir, { recursive: true });
-  fs31.writeFileSync(
+  fs32.mkdirSync(dir, { recursive: true });
+  fs32.writeFileSync(
     validationPath(checkoutDir, record2.treeHash),
     `${JSON.stringify(record2, null, 2)}
 `
   );
 }
 function ensureValidationsIgnored(checkoutDir) {
-  const harDir = path31.join(checkoutDir, ".har");
-  if (!fs31.existsSync(harDir)) return;
-  const gitignorePath = path31.join(harDir, ".gitignore");
-  const content = fs31.existsSync(gitignorePath) ? fs31.readFileSync(gitignorePath, "utf8") : "";
+  const harDir = path32.join(checkoutDir, ".har");
+  if (!fs32.existsSync(harDir)) return;
+  const gitignorePath = path32.join(harDir, ".gitignore");
+  const content = fs32.existsSync(gitignorePath) ? fs32.readFileSync(gitignorePath, "utf8") : "";
   if (content.split("\n").some((line) => line.trim() === `${VALIDATIONS_DIR}/`)) return;
   const suffix = content.length === 0 || content.endsWith("\n") ? "" : "\n";
-  fs31.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
+  fs32.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
 `);
 }
 function recordValidation(input) {
@@ -29685,8 +29833,8 @@ function recordValidation(input) {
     treeHash: snapshot.treeHash,
     headSha: snapshot.headSha,
     branch: snapshot.branch,
-    workDir: path31.resolve(input.checkoutDir),
-    harnessRoot: path31.resolve(input.harnessRoot),
+    workDir: path32.resolve(input.checkoutDir),
+    harnessRoot: path32.resolve(input.harnessRoot),
     agentId: input.agentId,
     status: input.status,
     full: input.full,
@@ -29698,16 +29846,16 @@ function recordValidation(input) {
     committedAt: existing?.committedAt
   });
   writeRecord(input.checkoutDir, record2);
-  if (path31.resolve(input.harnessRoot) !== path31.resolve(input.checkoutDir)) {
+  if (path32.resolve(input.harnessRoot) !== path32.resolve(input.checkoutDir)) {
     writeRecord(input.harnessRoot, record2);
   }
   return record2;
 }
 function findValidation(checkoutDir, treeHash) {
   const file = validationPath(checkoutDir, treeHash);
-  if (!fs31.existsSync(file)) return void 0;
+  if (!fs32.existsSync(file)) return void 0;
   try {
-    return ValidationRecordSchema.parse(JSON.parse(fs31.readFileSync(file, "utf8")));
+    return ValidationRecordSchema.parse(JSON.parse(fs32.readFileSync(file, "utf8")));
   } catch {
     return void 0;
   }
@@ -29722,19 +29870,19 @@ function attachCommit(checkoutDir, treeHash, commitSha) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   writeRecord(checkoutDir, updated);
-  if (record2.harnessRoot && path31.resolve(record2.harnessRoot) !== path31.resolve(checkoutDir) && fs31.existsSync(path31.join(record2.harnessRoot, ".har"))) {
+  if (record2.harnessRoot && path32.resolve(record2.harnessRoot) !== path32.resolve(checkoutDir) && fs32.existsSync(path32.join(record2.harnessRoot, ".har"))) {
     writeRecord(record2.harnessRoot, updated);
   }
   return updated;
 }
 function listValidations(harnessRoot) {
   const dir = getValidationsDir(harnessRoot);
-  if (!fs31.existsSync(dir)) return [];
+  if (!fs32.existsSync(dir)) return [];
   const records = [];
-  for (const entry of fs31.readdirSync(dir)) {
+  for (const entry of fs32.readdirSync(dir)) {
     if (!entry.endsWith(".json")) continue;
     try {
-      records.push(ValidationRecordSchema.parse(JSON.parse(fs31.readFileSync(path31.join(dir, entry), "utf8"))));
+      records.push(ValidationRecordSchema.parse(JSON.parse(fs32.readFileSync(path32.join(dir, entry), "utf8"))));
     } catch {
     }
   }
@@ -29763,6 +29911,396 @@ function createRemoteExecutor(apiUrl, apiKey) {
   return new RemoteExecutor(url, key);
 }
+// src/core/telemetry-config.ts
+var fs33 = __toESM(require("fs"));
+var os9 = __toESM(require("os"));
+var path33 = __toESM(require("path"));
+function getPreferencePath() {
+  if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
+    return path33.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
+  }
+  return path33.join(os9.homedir(), ".har", "telemetry.json");
+}
+function parseEnvOverride(raw) {
+  if (raw === void 0 || raw === "") return void 0;
+  const normalized = raw.trim().toLowerCase();
+  if (["0", "false", "off", "no", "disabled"].includes(normalized)) return false;
+  if (["1", "true", "on", "yes", "enabled"].includes(normalized)) return true;
+  return void 0;
+}
+function readTelemetryPreference() {
+  const preferencePath = getPreferencePath();
+  try {
+    if (!fs33.existsSync(preferencePath)) {
+      return { enabled: true };
+    }
+    const parsed = JSON.parse(fs33.readFileSync(preferencePath, "utf8"));
+    return {
+      enabled: parsed.enabled !== false,
+      updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : void 0
+    };
+  } catch {
+    return { enabled: true };
+  }
+}
+function writeTelemetryPreference(enabled) {
+  const preference = {
+    enabled,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const preferencePath = getPreferencePath();
+  fs33.mkdirSync(path33.dirname(preferencePath), { recursive: true });
+  fs33.writeFileSync(preferencePath, JSON.stringify(preference, null, 2) + "\n");
+  return preference;
+}
+function isTelemetryEnabled() {
+  const envOverride = parseEnvOverride(process.env.HAR_TELEMETRY);
+  if (envOverride !== void 0) return envOverride;
+  return readTelemetryPreference().enabled;
+}
+function getTelemetryPreferencePath() {
+  return getPreferencePath();
+}
+var TELEMETRY_SIGNALS = [
+  "Claude Code: tokens (input/output/cache) and estimated USD cost via OTEL metrics",
+  "Codex CLI: token usage via OTEL metrics (no native USD; harvest fills gaps)",
+  "Fallback: har control sync harvests local Claude/Codex session files when OTEL is missing"
+];
+// src/core/usage-harvest/claude.ts
+var fs35 = __toESM(require("fs"));
+var os10 = __toESM(require("os"));
+var path35 = __toESM(require("path"));
+// src/core/telemetry-env.ts
+var fs34 = __toESM(require("fs"));
+var path34 = __toESM(require("path"));
+function escapeAttrValue(value) {
+  return value.replace(/[,=]/g, "_");
+}
+function buildOtelResourceAttributes(attrs) {
+  const parts = [
+    `har.session_key=${escapeAttrValue(attrs.sessionKey)}`,
+    `har.agent_id=${attrs.agentId}`,
+    `har.repo_path=${escapeAttrValue(attrs.repoPath)}`,
+    `har.work_dir=${escapeAttrValue(attrs.workDir)}`
+  ];
+  if (attrs.branch) parts.push(`har.branch=${escapeAttrValue(attrs.branch)}`);
+  if (attrs.suffix) parts.push(`har.suffix=${escapeAttrValue(attrs.suffix)}`);
+  if (attrs.purpose) parts.push(`har.purpose=${escapeAttrValue(attrs.purpose)}`);
+  return parts.join(",");
+}
+function buildSessionKey(input) {
+  if (input.branch) return input.branch;
+  const stamp = (input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()).replace(/[:.]/g, "-");
+  return `agent-${input.agentId}-${input.suffix ?? stamp}`;
+}
+function buildTelemetryEnvBlock(attrs, options) {
+  const apiUrl = getControlApiUrl().replace(/\/$/, "");
+  const lines = [
+    "",
+    "# HAR session attribution (generated)",
+    `HAR_SESSION_KEY=${attrs.sessionKey}`,
+    `HAR_CONTROL_API_URL=${apiUrl}`,
+    `OTEL_RESOURCE_ATTRIBUTES=${buildOtelResourceAttributes(attrs)}`
+  ];
+  const injectOtel = isTelemetryEnabled() && options?.otelReady !== false;
+  if (injectOtel) {
+    lines.push(
+      "# HAR telemetry \u2192 Mission Control OTLP (disable: har telemetry off)",
+      "CLAUDE_CODE_ENABLE_TELEMETRY=1",
+      "OTEL_METRICS_EXPORTER=otlp",
+      "OTEL_EXPORTER_OTLP_PROTOCOL=http/json",
+      `OTEL_EXPORTER_OTLP_ENDPOINT=${apiUrl}/api/otel`
+    );
+  }
+  return lines.join("\n") + "\n";
+}
+var TELEMETRY_MARKER_START = "# HAR session attribution (generated)";
+var TELEMETRY_MARKER_END = "# end HAR telemetry";
+function appendTelemetryEnvToFile(envFilePath, attrs, options) {
+  const block = buildTelemetryEnvBlock(attrs, options).trimEnd() + `
+${TELEMETRY_MARKER_END}
+`;
+  let existing = "";
+  if (fs34.existsSync(envFilePath)) {
+    existing = fs34.readFileSync(envFilePath, "utf8");
+    const start = existing.indexOf(TELEMETRY_MARKER_START);
+    if (start >= 0) {
+      const end = existing.indexOf(TELEMETRY_MARKER_END, start);
+      if (end >= 0) {
+        existing = existing.slice(0, start).replace(/\n+$/, "\n") + existing.slice(end + TELEMETRY_MARKER_END.length).replace(/^\n+/, "\n");
+      } else {
+        existing = existing.slice(0, start).replace(/\n+$/, "\n");
+      }
+    }
+  }
+  fs34.mkdirSync(path34.dirname(envFilePath), { recursive: true });
+  const combined = (existing.replace(/\n+$/, "\n") + block).replace(/^\n+/, "");
+  fs34.writeFileSync(envFilePath, combined.endsWith("\n") ? combined : combined + "\n");
+}
+function buildCodexOtelSnippet(attrs) {
+  const apiUrl = getControlApiUrl().replace(/\/$/, "");
+  const resource = buildOtelResourceAttributes(attrs);
+  return `# Merge into ~/.codex/config.toml (HAR does not overwrite your config)
+# Generated for session ${attrs.sessionKey}
+[otel]
+exporter = "otlp-http"
+endpoint = "${apiUrl}/api/otel"
+metrics_exporter = "otlp-http"
+# Optional: set resource attributes via environment when starting Codex:
+# export OTEL_RESOURCE_ATTRIBUTES="${resource}"
+# export HAR_SESSION_KEY="${attrs.sessionKey}"
+`;
+}
+// src/core/usage-harvest/claude.ts
+function pathsMatch(candidate, targets) {
+  const norm = path35.resolve(candidate);
+  return targets.some((t2) => {
+    const target = path35.resolve(t2);
+    return norm === target || norm.startsWith(target + path35.sep) || target.startsWith(norm + path35.sep);
+  });
+}
+function claudeProjectsRoot() {
+  return process.env.HAR_CLAUDE_PROJECTS_DIR ? path35.resolve(process.env.HAR_CLAUDE_PROJECTS_DIR) : path35.join(os10.homedir(), ".claude", "projects");
+}
+function encodeClaudeProjectDir(cwd) {
+  return cwd.replace(/[^a-zA-Z0-9]/g, "-");
+}
+function readJsonlRecords(filePath) {
+  if (!fs35.existsSync(filePath)) return [];
+  const lines = fs35.readFileSync(filePath, "utf8").split(/\r?\n/);
+  const out = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{")) continue;
+    try {
+      out.push(JSON.parse(trimmed));
+    } catch {
+    }
+  }
+  return out;
+}
+function extractClaudeUsageFromRecords(records) {
+  let tokensInput = 0;
+  let tokensOutput = 0;
+  let tokensCacheRead = 0;
+  let tokensCacheCreation = 0;
+  let costUsd = null;
+  for (const record2 of records) {
+    if (!record2 || typeof record2 !== "object") continue;
+    const payload = record2;
+    if (payload.type === "result") {
+      const usage2 = payload.usage ?? {};
+      tokensInput = Number(usage2.input_tokens ?? 0) + Number(usage2.cache_read_input_tokens ?? 0);
+      tokensOutput = Number(usage2.output_tokens ?? 0);
+      tokensCacheRead = Number(usage2.cache_read_input_tokens ?? 0);
+      tokensCacheCreation = Number(usage2.cache_creation_input_tokens ?? 0);
+      if (payload.total_cost_usd != null) costUsd = Number(payload.total_cost_usd);
+    }
+    const nestedUsage = payload.usage ?? payload.message?.usage;
+    if (nestedUsage && payload.type !== "result") {
+      tokensInput += Number(nestedUsage.input_tokens ?? 0);
+      tokensOutput += Number(nestedUsage.output_tokens ?? 0);
+      tokensCacheRead += Number(nestedUsage.cache_read_input_tokens ?? 0);
+      tokensCacheCreation += Number(nestedUsage.cache_creation_input_tokens ?? 0);
+    }
+  }
+  return { tokensInput, tokensOutput, tokensCacheRead, tokensCacheCreation, costUsd };
+}
+function harvestClaudeUsage(slot) {
+  const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
+  if (targets.length === 0) return null;
+  const root = claudeProjectsRoot();
+  if (!fs35.existsSync(root)) return null;
+  const sessionKey = buildSessionKey({
+    branch: slot.branch,
+    agentId: slot.agentId,
+    suffix: slot.suffix,
+    createdAt: slot.sessionCreatedAt
+  });
+  let best = null;
+  let bestMtime = 0;
+  for (const entry of fs35.readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const projectDir = path35.join(root, entry.name);
+    const encodedHit = targets.some((t2) => entry.name.includes(encodeClaudeProjectDir(t2).slice(0, 40)));
+    for (const file of fs35.readdirSync(projectDir)) {
+      if (!file.endsWith(".jsonl")) continue;
+      const filePath = path35.join(projectDir, file);
+      const stat = fs35.statSync(filePath);
+      const records = readJsonlRecords(filePath);
+      let cwdHit = encodedHit;
+      for (const record2 of records) {
+        if (!record2 || typeof record2 !== "object") continue;
+        const cwd = String(record2.cwd ?? "");
+        if (cwd && pathsMatch(cwd, targets)) {
+          cwdHit = true;
+          break;
+        }
+      }
+      if (!cwdHit) continue;
+      const usage2 = extractClaudeUsageFromRecords(records);
+      if (usage2.tokensInput + usage2.tokensOutput + usage2.tokensCacheRead === 0 && (usage2.costUsd == null || usage2.costUsd === 0)) {
+        continue;
+      }
+      if (stat.mtimeMs >= bestMtime) {
+        bestMtime = stat.mtimeMs;
+        best = usage2;
+      }
+    }
+  }
+  if (!best) return null;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const tokensTotal = best.tokensInput + best.tokensOutput + best.tokensCacheRead + best.tokensCacheCreation;
+  return {
+    sessionKey,
+    agentId: slot.agentId,
+    agentTool: "claude_code",
+    workDir: slot.workDir,
+    branch: slot.branch,
+    suffix: slot.suffix,
+    tokensInput: best.tokensInput,
+    tokensOutput: best.tokensOutput,
+    tokensCacheRead: best.tokensCacheRead,
+    tokensCacheCreation: best.tokensCacheCreation,
+    tokensTotal,
+    costUsd: best.costUsd,
+    sources: ["harvest"],
+    firstSeenAt: slot.sessionCreatedAt ?? now,
+    lastSeenAt: now
+  };
+}
+// src/core/usage-harvest/codex.ts
+var fs36 = __toESM(require("fs"));
+var os11 = __toESM(require("os"));
+var path36 = __toESM(require("path"));
+function pathsMatch2(candidate, targets) {
+  const norm = path36.resolve(candidate);
+  return targets.some((t2) => {
+    const target = path36.resolve(t2);
+    return norm === target || norm.startsWith(target + path36.sep) || target.startsWith(norm + path36.sep);
+  });
+}
+function codexSessionsRoot() {
+  return process.env.HAR_CODEX_SESSIONS_DIR ? path36.resolve(process.env.HAR_CODEX_SESSIONS_DIR) : path36.join(os11.homedir(), ".codex", "sessions");
+}
+function walkJsonlFiles(dir, out = []) {
+  if (!fs36.existsSync(dir)) return out;
+  for (const entry of fs36.readdirSync(dir, { withFileTypes: true })) {
+    const full = path36.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 = fs36.readFileSync(filePath, "utf8").split(/\r?\n/);
+  const out = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{")) continue;
+    try {
+      out.push(JSON.parse(trimmed));
+    } catch {
+    }
+  }
+  return out;
+}
+function extractCodexTokens(records) {
+  let tokensInput = 0;
+  let tokensOutput = 0;
+  let tokensCacheRead = 0;
+  let cwd;
+  for (const record2 of records) {
+    if (!record2 || typeof record2 !== "object") continue;
+    const payload = record2;
+    if (typeof payload.cwd === "string") cwd = payload.cwd;
+    if (typeof payload.working_directory === "string") {
+      cwd = payload.working_directory;
+    }
+    const usage2 = payload.usage ?? payload.token_usage ?? payload.event?.usage;
+    if (usage2) {
+      tokensInput += Number(
+        usage2.input_tokens ?? usage2.input_token_count ?? usage2.input ?? 0
+      );
+      tokensOutput += Number(
+        usage2.output_tokens ?? usage2.output_token_count ?? usage2.output ?? 0
+      );
+      tokensCacheRead += Number(
+        usage2.cached_input_tokens ?? usage2.cached_token_count ?? usage2.cache_read_input_tokens ?? 0
+      );
+      tokensOutput += Number(usage2.reasoning_tokens ?? usage2.reasoning_token_count ?? 0);
+    }
+    if (payload.type === "response.completed" || payload["event.kind"] === "response.completed") {
+      tokensInput = Math.max(tokensInput, Number(payload.input_token_count ?? 0));
+      tokensOutput = Math.max(tokensOutput, Number(payload.output_token_count ?? 0));
+      tokensCacheRead = Math.max(tokensCacheRead, Number(payload.cached_token_count ?? 0));
+    }
+  }
+  return { tokensInput, tokensOutput, tokensCacheRead, cwd };
+}
+function harvestCodexUsage(slot) {
+  const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
+  if (targets.length === 0) return null;
+  const root = codexSessionsRoot();
+  const files = walkJsonlFiles(root);
+  if (files.length === 0) return null;
+  const sessionKey = buildSessionKey({
+    branch: slot.branch,
+    agentId: slot.agentId,
+    suffix: slot.suffix,
+    createdAt: slot.sessionCreatedAt
+  });
+  let best = null;
+  let bestMtime = 0;
+  for (const file of files) {
+    const records = readJsonl(file);
+    const extracted = extractCodexTokens(records);
+    if (!extracted.cwd || !pathsMatch2(extracted.cwd, targets)) continue;
+    if (extracted.tokensInput + extracted.tokensOutput + extracted.tokensCacheRead === 0) continue;
+    const mtime = fs36.statSync(file).mtimeMs;
+    if (mtime >= bestMtime) {
+      bestMtime = mtime;
+      best = extracted;
+    }
+  }
+  if (!best) return null;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const tokensTotal = best.tokensInput + best.tokensOutput + best.tokensCacheRead;
+  return {
+    sessionKey,
+    agentId: slot.agentId,
+    agentTool: "codex",
+    workDir: slot.workDir,
+    branch: slot.branch,
+    suffix: slot.suffix,
+    tokensInput: best.tokensInput,
+    tokensOutput: best.tokensOutput,
+    tokensCacheRead: best.tokensCacheRead,
+    tokensCacheCreation: 0,
+    tokensTotal,
+    costUsd: null,
+    sources: ["harvest"],
+    firstSeenAt: slot.sessionCreatedAt ?? now,
+    lastSeenAt: now
+  };
+}
+// src/core/usage-harvest/index.ts
+function harvestUsageForSlot(slot) {
+  const out = [];
+  const claude = harvestClaudeUsage(slot);
+  if (claude) out.push(claude);
+  const codex = harvestCodexUsage(slot);
+  if (codex) out.push(codex);
+  return out;
+}
 // src/core/control-sync.ts
 async function postJson(url, body, dryRun) {
   if (dryRun) return null;
@@ -29792,7 +30330,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((resolve27) => setTimeout(resolve27, intervalMs));
+    await new Promise((resolve33) => setTimeout(resolve33, intervalMs));
   }
   return false;
 }
@@ -29804,7 +30342,7 @@ async function syncAllKnownReposWithControl(options) {
   }
   const repoPaths = new Set(listRegisteredRepos());
   if (options?.cwd) {
-    const cwd = path32.resolve(options.cwd);
+    const cwd = path37.resolve(options.cwd);
     if (readManifest(cwd)) repoPaths.add(cwd);
   }
   try {
@@ -29812,7 +30350,7 @@ async function syncAllKnownReposWithControl(options) {
     if (listResponse.ok) {
       const repos = await listResponse.json();
       for (const repo of repos) {
-        const resolved = path32.resolve(repo.path);
+        const resolved = path37.resolve(repo.path);
         if (readManifest(resolved)) repoPaths.add(resolved);
       }
     }
@@ -29831,7 +30369,7 @@ async function syncAllKnownReposWithControl(options) {
   return { synced, failed };
 }
 async function registerRepoWithControl(options) {
-  const repoPath = path32.resolve(options.repoPath);
+  const repoPath = path37.resolve(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   const manifest = readManifest(repoPath);
   const stagesRegistry = readStageRegistry(repoPath);
@@ -29844,7 +30382,7 @@ async function registerRepoWithControl(options) {
   return postJson(`${apiUrl}/api/repos`, body, options.dryRun);
 }
 async function syncRepoWithControl(options) {
-  const repoPath = path32.resolve(options.repoPath);
+  const repoPath = path37.resolve(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   if (options.cloud) {
     const remote = createRemoteExecutor();
@@ -29872,7 +30410,7 @@ async function syncRepoWithControl(options) {
     const listResponse = await fetch(`${apiUrl}/api/repos`);
     if (!listResponse.ok) throw new Error("Failed to list repos from Control API");
     const repos = await listResponse.json();
-    const existing = repos.find((r2) => path32.resolve(r2.path) === repoPath);
+    const existing = repos.find((r2) => path37.resolve(r2.path) === repoPath);
     if (!existing) throw new Error(`Repo not registered: ${repoPath}`);
     await syncRepoRunsAndSlots(apiUrl, existing.id, repoPath, options.dryRun);
     return;
@@ -29891,6 +30429,37 @@ async function syncRepoRunsAndSlots(apiUrl, repoId, repoPath, dryRun) {
     generatedAt: status.generatedAt
   });
   await postJson(`${apiUrl}/api/repos/${repoId}/slots`, slotsBody, dryRun);
+  if (isTelemetryEnabled() && process.env.NODE_ENV !== "test") {
+    try {
+      const usage2 = status.slots.flatMap(
+        (slot) => harvestUsageForSlot({
+          agentId: slot.agentId,
+          workDir: slot.workDir,
+          worktreePath: slot.worktreePath,
+          branch: slot.branch,
+          suffix: slot.suffix,
+          sessionCreatedAt: slot.sessionCreatedAt,
+          repoPath
+        }).map((row) => ({
+          ...row,
+          sessionKey: row.sessionKey || buildSessionKey({
+            branch: slot.branch,
+            agentId: slot.agentId,
+            suffix: slot.suffix,
+            createdAt: slot.sessionCreatedAt
+          })
+        }))
+      );
+      if (usage2.length > 0) {
+        const usageBody = SyncUsageInputSchema.parse({ usage: usage2 });
+        await postJson(`${apiUrl}/api/repos/${repoId}/usage`, usageBody, dryRun);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`[har control] usage harvest skipped: ${message}
+`);
+    }
+  }
   const validations = listValidations(resolveHarnessRoot(repoPath));
   if (validations.length > 0) {
     const validationsBody = SyncValidationsInputSchema.parse({ validations });
@@ -29943,7 +30512,199 @@ function checkLaunchGuard2(repoPath, agentId, options = {}) {
   return { allowed: true, slot: occupied.slot, readiness };
 }
+// src/core/control-lifecycle.ts
+var import_child_process8 = require("child_process");
+var path38 = __toESM(require("path"));
+// src/core/control-image.ts
+var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
+function getControlImageName() {
+  return process.env.HAR_CONTROL_IMAGE ?? DEFAULT_CONTROL_IMAGE;
+}
+function getControlImageTag() {
+  return process.env.HAR_CONTROL_IMAGE_TAG ?? getHarPackageVersion();
+}
+function getControlImageRef() {
+  return `${getControlImageName()}:${getControlImageTag()}`;
+}
+function shouldBuildControlLocally() {
+  return process.env.HAR_CONTROL_BUILD === "true";
+}
+// src/core/control-lifecycle.ts
+function resolveControlDir() {
+  return path38.resolve(__dirname, "..", "control");
+}
+function resolveControlComposeFiles(options) {
+  const controlDir = resolveControlDir();
+  const files = [path38.join(controlDir, "docker-compose.yml")];
+  if (options?.build ?? shouldBuildControlLocally()) {
+    files.push(path38.join(controlDir, "docker-compose.build.yml"));
+  }
+  return files;
+}
+function buildDockerComposeEnv() {
+  return {
+    ...process.env,
+    HAR_CONTROL_IMAGE: getControlImageName(),
+    HAR_CONTROL_IMAGE_TAG: getControlImageTag()
+  };
+}
+function runDockerCompose(args, options) {
+  const controlDir = resolveControlDir();
+  const composeFiles = resolveControlComposeFiles(options);
+  const composeArgs = composeFiles.flatMap((file) => ["-f", file]);
+  const result = (0, import_child_process8.spawnSync)("docker", ["compose", ...composeArgs, ...args], {
+    cwd: controlDir,
+    stdio: "inherit",
+    env: buildDockerComposeEnv()
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  return result.status ?? 1;
+}
+async function startMissionControl(options) {
+  const build = options.build ?? shouldBuildControlLocally();
+  const imageRef = getControlImageRef();
+  if (!build) {
+    const pullCode = runDockerCompose(["pull"], { build: false });
+    if (pullCode !== 0) {
+      return { code: pullCode, apiUrl: getControlApiUrl(), imageRef };
+    }
+  }
+  const detach = options.detach !== false;
+  const upArgs = detach ? ["up", "-d"] : ["up"];
+  if (build) {
+    upArgs.push("--build");
+  }
+  const code = runDockerCompose(upArgs, { build });
+  return { code, apiUrl: getControlApiUrl(), imageRef };
+}
+async function syncReposAfterControlStart(cwd) {
+  if (!isControlEnabled()) {
+    return { synced: 0, failed: 0, apiReady: false };
+  }
+  const apiUrl = getControlApiUrl();
+  const apiReady = await waitForControlApi(apiUrl);
+  if (!apiReady) {
+    return { synced: 0, failed: 0, apiReady: false };
+  }
+  const { synced, failed } = await syncAllKnownReposWithControl({ apiUrl, cwd });
+  return { synced, failed, apiReady: true };
+}
+async function startControlAndSync(options) {
+  const { code, apiUrl, imageRef } = await startMissionControl({
+    detach: options?.detach,
+    build: options?.build
+  });
+  if (code !== 0) {
+    return { code, apiUrl, imageRef, synced: 0, failed: 0, apiReady: false };
+  }
+  const { synced, failed, apiReady } = await syncReposAfterControlStart(options?.cwd ?? process.cwd());
+  return { code, apiUrl, imageRef, synced, failed, apiReady };
+}
+// src/core/telemetry-ensure.ts
+async function ensureTelemetryInfrastructure(options) {
+  const apiUrl = getControlApiUrl();
+  const telemetryEnabled = isTelemetryEnabled();
+  const controlEnabled = isControlEnabled();
+  const startIfNeeded = options?.startIfNeeded !== false;
+  if (!telemetryEnabled) {
+    return {
+      telemetryEnabled: false,
+      controlEnabled,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      message: "Telemetry is off \u2014 Mission Control will not be auto-started. Enable with: har telemetry on"
+    };
+  }
+  if (!controlEnabled) {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: false,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      warning: "Telemetry is on but HAR_CONTROL_DISABLED=true \u2014 cannot start Mission Control. Unset it or run har control up manually."
+    };
+  }
+  if (await isControlApiReachable(apiUrl)) {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: true,
+      started: false,
+      otelReady: true,
+      message: `Telemetry on \u2014 Mission Control reachable at ${apiUrl}`
+    };
+  }
+  if (!startIfNeeded || process.env.NODE_ENV === "test") {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      warning: `Telemetry on but Mission Control is not reachable at ${apiUrl}. Run: har control up`
+    };
+  }
+  try {
+    const { code } = await startMissionControl({ detach: true });
+    if (code !== 0) {
+      return {
+        telemetryEnabled: true,
+        controlEnabled: true,
+        apiUrl,
+        reachable: false,
+        started: false,
+        otelReady: false,
+        warning: `Telemetry on \u2014 failed to start Mission Control (exit ${code}). OTEL export skipped; harvest may fill gaps later. Fix Docker / run: har control up`
+      };
+    }
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      warning: `Telemetry on \u2014 could not start Mission Control (${detail}). OTEL export skipped. Run: har control up`
+    };
+  }
+  const ready = await waitForControlApi(apiUrl, 9e4);
+  if (!ready) {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: false,
+      started: true,
+      otelReady: false,
+      warning: `Telemetry on \u2014 started Mission Control but API did not become ready at ${apiUrl}. OTEL export skipped for now.`
+    };
+  }
+  return {
+    telemetryEnabled: true,
+    controlEnabled: true,
+    apiUrl,
+    reachable: true,
+    started: true,
+    otelReady: true,
+    message: `Telemetry on \u2014 started Mission Control at ${apiUrl}`
+  };
+}
 // src/core/run-service.ts
+var path39 = __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 ?? "";
@@ -30063,6 +30824,21 @@ var RunService = class {
         } : void 0
       };
     }
+    let telemetryBanner = "";
+    let otelReady = false;
+    if (isTelemetryEnabled() && process.env.NODE_ENV !== "test") {
+      const ensured = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+      otelReady = ensured.otelReady;
+      if (ensured.message) {
+        telemetryBanner += `${ensured.message}
+Usage from Claude Code / Codex will appear under Worktrees. Disable: har telemetry off
+`;
+      }
+      if (ensured.warning) {
+        telemetryBanner += `${ensured.warning}
+`;
+      }
+    }
     const result = await this.runStage({
       repoPath: options.repoPath,
       kind: "launch",
@@ -30086,6 +30862,32 @@ var RunService = class {
         envResult.worktreePath = session.worktreePath;
         envResult.branch = session.branch;
         envResult.previewUrls = envResult.previewUrls ?? session.previewUrls;
+        const sessionKey = buildSessionKey({
+          branch: session.branch,
+          agentId: options.agentId,
+          suffix: session.suffix,
+          createdAt: session.createdAt
+        });
+        const envFile = path39.join(session.workDir, `.env.agent.${options.agentId}`);
+        try {
+          appendTelemetryEnvToFile(
+            envFile,
+            {
+              sessionKey,
+              agentId: options.agentId,
+              repoPath: path39.resolve(options.repoPath),
+              workDir: session.workDir,
+              branch: session.branch,
+              suffix: session.suffix,
+              purpose: session.purpose
+            },
+            { otelReady: otelReady && isTelemetryEnabled() }
+          );
+        } catch {
+        }
+      }
+      if (telemetryBanner) {
+        envResult.stderr = `${telemetryBanner}${envResult.stderr ?? ""}`;
       }
     }
     return envResult;
@@ -30320,11 +31122,36 @@ var envCommand = {
     }),
     handleMaintain
   ).command(
-    "add-stage <template>",
-    "Add an optional stage template (e.g. playwright)",
+    "add-stage [template]",
+    `Add a stage template (${STAGE_TEMPLATE_IDS.join(", ")}) or a custom stage (--custom)`,
     (y2) => y2.positional("template", {
       type: "string",
-      describe: "Stage template id (playwright)"
+      describe: `Stage template id (${STAGE_TEMPLATE_IDS.join(", ")}), or the new stage id with --custom`
+    }).option("list", {
+      type: "boolean",
+      default: false,
+      describe: "List available stage templates and exit"
+    }).option("custom", {
+      type: "boolean",
+      default: false,
+      describe: "Register a custom stage instead of a shipped template"
+    }).option("kind", {
+      type: "string",
+      describe: "Custom stage kind (setup, launch, verify, test, inspect, reset, teardown, custom)"
+    }).option("command", {
+      type: "string",
+      describe: 'Custom stage shell command ({agentId} is substituted), e.g. "npm test"'
+    }).option("script", {
+      type: "boolean",
+      default: false,
+      describe: "Scaffold .har/stages/<id>.sh from the contract skeleton (see .har/STAGES.md)"
+    }).option("description", {
+      type: "string",
+      describe: "Custom stage description shown in the registry and Mission Control"
+    }).option("verification", {
+      type: "boolean",
+      default: false,
+      describe: "Include the custom stage in verify --full (stages.json verificationStages)"
     }).option("repo", { type: "string", default: ".", describe: "Path to the repository" }).option("force", {
       type: "boolean",
       default: false,
@@ -30332,7 +31159,7 @@ var envCommand = {
     }).option("skip-ci", {
       type: "boolean",
       default: false,
-      describe: "Do not copy .github/workflows/playwright.yml"
+      describe: "Do not copy optional CI workflow files (e.g. .github/workflows/playwright.yml)"
     }),
     handleAddStage
   ).command(
@@ -30427,7 +31254,7 @@ var envCommand = {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path33.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   header("har env init");
   info(`Repository: ${repoPath}`);
   try {
@@ -30486,7 +31313,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path33.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
   try {
@@ -30582,7 +31409,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path33.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path40.join(repoPath, "AGENT.md"), proposal.content);
       clearAgentMdProposal(repoPath);
       info("Applied AGENT.md proposal (--yes)");
     }
@@ -30591,16 +31418,64 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   await promptApplyAgentMdProposal(repoPath);
 }
 async function handleAddStage(argv) {
-  const repoPath = path33.resolve(argv.repo);
-  if (argv.template !== "playwright") {
-    error(`Unknown stage template: ${argv.template ?? "(missing)"}. Available: playwright`);
+  const repoPath = path40.resolve(argv.repo);
+  const available = listStageTemplateIds();
+  if (argv.list) {
+    for (const id of available) {
+      console.log(id);
+    }
+    return;
+  }
+  if (argv.custom) {
+    if (!argv.template) {
+      error(
+        'Missing stage id. Usage: har env add-stage <id> --custom (--command "npm test" | --script) [--kind test] [--verification]'
+      );
+      process.exit(1);
+    }
+    header("har env add-stage --custom");
+    info(`Repository: ${repoPath}`);
+    info(`Stage: ${argv.template}`);
+    try {
+      const result = addCustomStage(repoPath, {
+        id: argv.template,
+        kind: argv.kind,
+        command: argv.command,
+        script: argv.script,
+        description: argv.description,
+        verification: argv.verification,
+        force: argv.force
+      });
+      divider();
+      success(`Custom stage registered: ${result.stageId} (kind: ${result.kind}, ${result.mode})`);
+      for (const file of result.filesWritten) {
+        info(`  + ${file}`);
+      }
+      console.error("");
+      console.error("  Next steps:");
+      for (const step of result.nextSteps) {
+        console.error(`    ${step}`);
+      }
+      console.error("");
+      console.error("  Docs: .har/STAGES.md");
+      console.error("");
+    } catch (err) {
+      error(err.message);
+      process.exit(1);
+    }
+    return;
+  }
+  if (!argv.template || !available.includes(argv.template)) {
+    error(
+      `Unknown stage template: ${argv.template ?? "(missing)"}. Available: ${available.join(", ")}. For a project-specific stage, use: har env add-stage <id> --custom`
+    );
     process.exit(1);
   }
   header("har env add-stage");
   info(`Repository: ${repoPath}`);
   info(`Template: ${argv.template}`);
   try {
-    const result = addStageTemplate(repoPath, "playwright", {
+    const result = addStageTemplate(repoPath, argv.template, {
       force: argv.force,
       skipCi: argv.skipCi
     });
@@ -30612,7 +31487,7 @@ async function handleAddStage(argv) {
       console.error(`    ${step}`);
     }
     console.error("");
-    console.error("  Docs: .har/stages/PLAYWRIGHT.md");
+    console.error(`  Docs: ${result.docsPath}`);
     console.error("");
   } catch (err) {
     error(err.message);
@@ -30620,7 +31495,7 @@ async function handleAddStage(argv) {
   }
 }
 async function handlePreflight(argv) {
-  const repo = path33.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -30638,7 +31513,7 @@ async function handlePreflight(argv) {
   process.exit(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path33.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   let confirmReplace = argv.replace;
   let force = argv.force;
@@ -30650,8 +31525,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((resolve27) => {
-          rl.question("Replace this slot? [y/N] ", resolve27);
+        const answer = await new Promise((resolve33) => {
+          rl.question("Replace this slot? [y/N] ", resolve33);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -30667,8 +31542,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((resolve27) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve27);
+        const answer = await new Promise((resolve33) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve33);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -30697,6 +31572,13 @@ async function handleLaunch(argv) {
     process.exit(result.code || 2);
   }
   if (result.code === 0 && result.workDir) {
+    if (result.stderr) {
+      for (const line of result.stderr.split("\n").filter(Boolean)) {
+        if (/telemetry|mission control|otel/i.test(line)) {
+          info(line);
+        }
+      }
+    }
     divider();
     success(`Session ready \u2014 make ALL file edits under: ${result.workDir}`);
     if (result.branch) info(`Branch: ${result.branch}`);
@@ -30715,7 +31597,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path33.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -30727,7 +31609,7 @@ async function handleVerify(argv) {
   process.exit(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path33.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -30738,7 +31620,7 @@ async function handleTeardown(argv) {
   process.exit(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path33.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -30759,7 +31641,7 @@ async function handleComplete(argv) {
   process.exit(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path33.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -30772,7 +31654,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path33.resolve(argv.repo);
+  const repoPath = path40.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");
@@ -30789,7 +31671,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path33.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path40.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     process.exit(1);
@@ -30862,102 +31744,7 @@ function printNextSteps(auto2) {
 }
 // src/cli/commands/control.ts
-var path35 = __toESM(require("path"));
-// src/core/control-lifecycle.ts
-var import_child_process8 = require("child_process");
-var path34 = __toESM(require("path"));
-// src/core/control-image.ts
-var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
-function getControlImageName() {
-  return process.env.HAR_CONTROL_IMAGE ?? DEFAULT_CONTROL_IMAGE;
-}
-function getControlImageTag() {
-  return process.env.HAR_CONTROL_IMAGE_TAG ?? getHarPackageVersion();
-}
-function getControlImageRef() {
-  return `${getControlImageName()}:${getControlImageTag()}`;
-}
-function shouldBuildControlLocally() {
-  return process.env.HAR_CONTROL_BUILD === "true";
-}
-// src/core/control-lifecycle.ts
-function resolveControlDir() {
-  return path34.resolve(__dirname, "..", "control");
-}
-function resolveControlComposeFiles(options) {
-  const controlDir = resolveControlDir();
-  const files = [path34.join(controlDir, "docker-compose.yml")];
-  if (options?.build ?? shouldBuildControlLocally()) {
-    files.push(path34.join(controlDir, "docker-compose.build.yml"));
-  }
-  return files;
-}
-function buildDockerComposeEnv() {
-  return {
-    ...process.env,
-    HAR_CONTROL_IMAGE: getControlImageName(),
-    HAR_CONTROL_IMAGE_TAG: getControlImageTag()
-  };
-}
-function runDockerCompose(args, options) {
-  const controlDir = resolveControlDir();
-  const composeFiles = resolveControlComposeFiles(options);
-  const composeArgs = composeFiles.flatMap((file) => ["-f", file]);
-  const result = (0, import_child_process8.spawnSync)("docker", ["compose", ...composeArgs, ...args], {
-    cwd: controlDir,
-    stdio: "inherit",
-    env: buildDockerComposeEnv()
-  });
-  if (result.error) {
-    throw result.error;
-  }
-  return result.status ?? 1;
-}
-async function startMissionControl(options) {
-  const build = options.build ?? shouldBuildControlLocally();
-  const imageRef = getControlImageRef();
-  if (!build) {
-    const pullCode = runDockerCompose(["pull"], { build: false });
-    if (pullCode !== 0) {
-      return { code: pullCode, apiUrl: getControlApiUrl(), imageRef };
-    }
-  }
-  const detach = options.detach !== false;
-  const upArgs = detach ? ["up", "-d"] : ["up"];
-  if (build) {
-    upArgs.push("--build");
-  }
-  const code = runDockerCompose(upArgs, { build });
-  return { code, apiUrl: getControlApiUrl(), imageRef };
-}
-async function syncReposAfterControlStart(cwd) {
-  if (!isControlEnabled()) {
-    return { synced: 0, failed: 0, apiReady: false };
-  }
-  const apiUrl = getControlApiUrl();
-  const apiReady = await waitForControlApi(apiUrl);
-  if (!apiReady) {
-    return { synced: 0, failed: 0, apiReady: false };
-  }
-  const { synced, failed } = await syncAllKnownReposWithControl({ apiUrl, cwd });
-  return { synced, failed, apiReady: true };
-}
-async function startControlAndSync(options) {
-  const { code, apiUrl, imageRef } = await startMissionControl({
-    detach: options?.detach,
-    build: options?.build
-  });
-  if (code !== 0) {
-    return { code, apiUrl, imageRef, synced: 0, failed: 0, apiReady: false };
-  }
-  const { synced, failed, apiReady } = await syncReposAfterControlStart(options?.cwd ?? process.cwd());
-  return { code, apiUrl, imageRef, synced, failed, apiReady };
-}
-// src/cli/commands/control.ts
+var path41 = __toESM(require("path"));
 var controlCommand = {
   command: "control <subcommand>",
   describe: "Mission Control dashboard (local)",
@@ -31060,7 +31847,7 @@ async function handleDown() {
   process.exit(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path35.resolve(argv.repo);
+  const repoPath = path41.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -31080,7 +31867,7 @@ async function handleRegister(argv) {
   }
 }
 async function handleSync(argv) {
-  const repoPath = path35.resolve(argv.repo);
+  const repoPath = path41.resolve(argv.repo);
   try {
     await syncRepoWithControl({
       repoPath,
@@ -31119,7 +31906,7 @@ async function handleWatch(argv) {
   };
   const tick = async () => {
     if (argv.repo) {
-      await syncOne(path35.resolve(argv.repo));
+      await syncOne(path41.resolve(argv.repo));
       return;
     }
     try {
@@ -31150,12 +31937,12 @@ async function handleLogin(argv) {
 }
 // src/cli/commands/hooks.ts
-var path38 = __toESM(require("path"));
+var path44 = __toESM(require("path"));
 // src/core/hooks.ts
-var fs32 = __toESM(require("fs"));
-var os9 = __toESM(require("os"));
-var path36 = __toESM(require("path"));
+var fs37 = __toESM(require("fs"));
+var os12 = __toESM(require("os"));
+var path42 = __toESM(require("path"));
 var MARKER_START = "# >>> har commit gate (managed by `har hooks`) >>>";
 var MARKER_END = "# <<< har commit gate <<<";
 var PRE_COMMIT_BLOCK = [
@@ -31180,7 +31967,7 @@ function resolveCheckoutRoot(cwd) {
 function resolveHooksDir(checkoutDir) {
   const hooksPath = tryGit2(checkoutDir, "rev-parse --git-path hooks");
   if (!hooksPath) throw new Error(`Not a git checkout: ${checkoutDir}`);
-  return path36.resolve(checkoutDir, hooksPath);
+  return path42.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
   return tryGit2(checkoutDir, "config core.hooksPath") || void 0;
@@ -31188,9 +31975,9 @@ function getConfiguredHooksPath(checkoutDir) {
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path36.resolve(entry)}"`;
+    return `"${process.execPath}" "${path42.resolve(entry)}"`;
   }
-  if (entry) return `"${path36.resolve(entry)}"`;
+  if (entry) return `"${path42.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -31211,40 +31998,40 @@ exit 0
 `;
 }
 function upsertMarkedBlock(filePath, block) {
-  if (!fs32.existsSync(filePath)) {
-    fs32.writeFileSync(filePath, `#!/bin/sh
+  if (!fs37.existsSync(filePath)) {
+    fs37.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs32.readFileSync(filePath, "utf8");
+  const content = fs37.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
       `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
     );
-    fs32.writeFileSync(filePath, content.replace(pattern, block));
-    fs32.chmodSync(filePath, 493);
+    fs37.writeFileSync(filePath, content.replace(pattern, block));
+    fs37.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs32.writeFileSync(filePath, `${content}${suffix}
+  fs37.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs32.chmodSync(filePath, 493);
+  fs37.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs32.existsSync(filePath)) return false;
-  const content = fs32.readFileSync(filePath, "utf8");
+  if (!fs37.existsSync(filePath)) return false;
+  const content = fs37.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() === "") {
-    fs32.rmSync(filePath);
+    fs37.rmSync(filePath);
   } else {
-    fs32.writeFileSync(filePath, stripped);
+    fs37.writeFileSync(filePath, stripped);
   }
   return true;
 }
@@ -31266,20 +32053,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs32.mkdirSync(hooksDir, { recursive: true });
+  fs37.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs32.writeFileSync(
-    path36.join(hooksDir, "har-pre-commit"),
+  fs37.writeFileSync(
+    path42.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs32.writeFileSync(
-    path36.join(hooksDir, "har-post-commit"),
+  fs37.writeFileSync(
+    path42.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path36.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path36.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock(path42.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock(path42.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -31288,12 +32075,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path36.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path36.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path42.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path42.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path36.join(hooksDir, file);
-    if (fs32.existsSync(full)) {
-      fs32.rmSync(full);
+    const full = path42.join(hooksDir, file);
+    if (fs37.existsSync(full)) {
+      fs37.rmSync(full);
       removed = true;
     }
   }
@@ -31310,9 +32097,9 @@ function getCommitGateConfig(checkoutDir) {
 function isAgentWorktree(checkoutDir) {
   const branch = getCurrentBranch(checkoutDir);
   if (branch && /^har-agent-\d+$/.test(branch)) return true;
-  const worktreesRoot = path36.join(os9.homedir(), "worktrees");
-  const resolved = path36.resolve(checkoutDir);
-  return resolved.startsWith(`${worktreesRoot}${path36.sep}`) && /-agent-\d+$/.test(path36.basename(resolved));
+  const worktreesRoot = path42.join(os12.homedir(), "worktrees");
+  const resolved = path42.resolve(checkoutDir);
+  return resolved.startsWith(`${worktreesRoot}${path42.sep}`) && /-agent-\d+$/.test(path42.basename(resolved));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -31325,15 +32112,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path36.join(hooksDir, name);
-    return fs32.existsSync(file) && fs32.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path42.join(hooksDir, name);
+    return fs37.existsSync(file) && fs37.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs32.existsSync(path36.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs32.existsSync(path36.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs37.existsSync(path42.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs37.existsSync(path42.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -31344,7 +32131,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs32.existsSync(path36.join(checkout, ".har", "stages.json"))) {
+  if (!fs37.existsSync(path42.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -31415,8 +32202,8 @@ async function recordCommitAssociation(cwd) {
 }
 // src/core/claude-hooks.ts
-var fs33 = __toESM(require("fs"));
-var path37 = __toESM(require("path"));
+var fs38 = __toESM(require("fs"));
+var path43 = __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";
@@ -31427,8 +32214,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs33.existsSync(settingsPath)) return {};
-  const raw = fs33.readFileSync(settingsPath, "utf8").trim();
+  if (!fs38.existsSync(settingsPath)) return {};
+  const raw = fs38.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -31437,19 +32224,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs33.mkdirSync(path37.dirname(settingsPath), { recursive: true });
-  fs33.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs38.mkdirSync(path43.dirname(settingsPath), { recursive: true });
+  fs38.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 = path37.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs33.mkdirSync(path37.dirname(guardScript), { recursive: true });
-  fs33.copyFileSync(templatePath, guardScript);
-  fs33.chmodSync(guardScript, 493);
-  const settingsPath = path37.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path43.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs38.mkdirSync(path43.dirname(guardScript), { recursive: true });
+  fs38.copyFileSync(templatePath, guardScript);
+  fs38.chmodSync(guardScript, 493);
+  const settingsPath = path43.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -31463,15 +32250,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path37.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs33.existsSync(guardScript)) {
-    fs33.rmSync(guardScript);
+  const guardScript = path43.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs38.existsSync(guardScript)) {
+    fs38.rmSync(guardScript);
     removed = true;
-    const parent = path37.dirname(guardScript);
-    if (fs33.existsSync(parent) && fs33.readdirSync(parent).length === 0) fs33.rmdirSync(parent);
+    const parent = path43.dirname(guardScript);
+    if (fs38.existsSync(parent) && fs38.readdirSync(parent).length === 0) fs38.rmdirSync(parent);
   }
-  const settingsPath = path37.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs33.existsSync(settingsPath)) {
+  const settingsPath = path43.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs38.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -31496,8 +32283,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path37.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs33.existsSync(settingsPath)) return false;
+  const settingsPath = path43.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs38.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -31513,7 +32300,7 @@ function repoOption(y2) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path38.resolve(argv.repo));
+      const result2 = installClaudeGuard(path44.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -31521,7 +32308,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path38.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path44.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.");
@@ -31534,7 +32321,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path38.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path44.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -31542,7 +32329,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path38.resolve(argv.repo));
+    const result = uninstallHooks(path44.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -31555,7 +32342,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path38.resolve(argv.repo));
+    const status = getHooksStatus(path44.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -31573,7 +32360,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path38.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path44.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -31834,10 +32621,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path40) {
-  if (!path40)
+function getElementAtPath(obj, path47) {
+  if (!path47)
     return obj;
-  return path40.reduce((acc, key) => acc?.[key], obj);
+  return path47.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -32157,11 +32944,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path40, issues) {
+function prefixIssues(path47, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path40);
+    iss.path.unshift(path47);
     return iss;
   });
 }
@@ -37484,7 +38271,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve27) => setTimeout(resolve27, pollInterval));
+        await new Promise((resolve33) => setTimeout(resolve33, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -37501,7 +38288,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve27, reject) => {
+    return new Promise((resolve33, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -37579,7 +38366,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve27(parseResult.data);
+            resolve33(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -37840,12 +38627,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve27, reject) => {
+    return new Promise((resolve33, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve27, interval);
+      const timeoutId = setTimeout(resolve33, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -38635,7 +39422,7 @@ var Server = class extends Protocol {
 };
 // src/mcp/server.ts
-var path39 = __toESM(require("path"));
+var path45 = __toESM(require("path"));
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process2 = __toESM(require("node:process"), 1);
@@ -38718,12 +39505,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve27) => {
+    return new Promise((resolve33) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve27();
+        resolve33();
       } else {
-        this._stdout.once("drain", resolve27);
+        this._stdout.once("drain", resolve33);
       }
     });
   }
@@ -39267,7 +40054,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path39.resolve(input.repo)
+        cwd: path45.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -39329,9 +40116,231 @@ var mcpCommand = {
   }
 };
+// src/cli/commands/telemetry.ts
+var fs39 = __toESM(require("fs"));
+var path46 = __toESM(require("path"));
+function printSignals() {
+  info("Collected when enabled (local Mission Control only):");
+  for (const signal of TELEMETRY_SIGNALS) {
+    info(`  \u2022 ${signal}`);
+  }
+  info("Disable anytime: har telemetry off");
+}
+async function handleStatus3(argv) {
+  const preference = readTelemetryPreference();
+  const enabled = isTelemetryEnabled();
+  const apiUrl = getControlApiUrl();
+  const reachable = enabled ? await isControlApiReachable(apiUrl) : false;
+  const payload = {
+    enabled,
+    preferenceEnabled: preference.enabled,
+    preferencePath: getTelemetryPreferencePath(),
+    updatedAt: preference.updatedAt ?? null,
+    envOverride: process.env.HAR_TELEMETRY ?? null,
+    controlApiUrl: apiUrl,
+    controlReachable: reachable,
+    otelEndpoint: `${apiUrl.replace(/\/$/, "")}/api/otel`,
+    signals: [...TELEMETRY_SIGNALS]
+  };
+  if (argv.json) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}
+`);
+    return;
+  }
+  header("har telemetry status");
+  info(`Enabled:       ${enabled ? "yes" : "no"}${process.env.HAR_TELEMETRY ? " (HAR_TELEMETRY override)" : ""}`);
+  info(`Preference:    ${getTelemetryPreferencePath()}${preference.updatedAt ? ` (updated ${preference.updatedAt})` : " (default on)"}`);
+  info(`Mission Control: ${apiUrl} (${reachable ? "reachable" : "not reachable"})`);
+  info(`OTLP endpoint: ${payload.otelEndpoint}`);
+  printSignals();
+}
+async function handleOn() {
+  header("har telemetry on");
+  writeTelemetryPreference(true);
+  success("Telemetry enabled (opt-out). Agent usage will be stored in local Mission Control.");
+  printSignals();
+  const result = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+  if (result.message) success(result.message);
+  if (result.warning) warn(result.warning);
+  if (result.otelReady) {
+    info(`OTLP ingest: ${result.apiUrl.replace(/\/$/, "")}/api/otel`);
+    info("Usage appears under Mission Control \u2192 Worktrees. Disable: har telemetry off");
+  }
+}
+async function handleOff() {
+  header("har telemetry off");
+  writeTelemetryPreference(false);
+  success("Telemetry disabled.");
+  info("Future launches will not inject OTEL exporters or auto-start Mission Control.");
+  info("Existing usage rows in Mission Control are kept. Historical data is not deleted.");
+}
+async function handleWriteEnv(argv) {
+  const repoPath = path46.resolve(argv.repo);
+  const harnessRoot = resolveHarnessRoot(repoPath);
+  const session = readSlotRegistry(harnessRoot, argv.agentId);
+  const workDir = argv.workDir ?? session?.workDir ?? repoPath;
+  const branch = argv.branch ?? session?.branch;
+  const suffix = argv.suffix ?? session?.suffix;
+  const purpose = argv.purpose ?? session?.purpose;
+  const sessionKey = argv.sessionKey ?? buildSessionKey({
+    branch,
+    agentId: argv.agentId,
+    suffix,
+    createdAt: session?.createdAt
+  });
+  const envFile = argv.envFile ?? path46.join(workDir, `.env.agent.${argv.agentId}`);
+  let otelReady = argv.otelReady;
+  if (otelReady === void 0 && isTelemetryEnabled()) {
+    const ensured = await ensureTelemetryInfrastructure({ startIfNeeded: false });
+    otelReady = ensured.otelReady;
+  }
+  const attrs = {
+    sessionKey,
+    agentId: argv.agentId,
+    repoPath,
+    workDir,
+    branch,
+    suffix,
+    purpose
+  };
+  appendTelemetryEnvToFile(envFile, attrs, { otelReady: otelReady !== false && isTelemetryEnabled() });
+  success(`Wrote telemetry env to ${envFile}`);
+}
+function handlePrintEnv(argv) {
+  const repoPath = path46.resolve(argv.repo);
+  const workDir = argv.workDir ?? repoPath;
+  const sessionKey = buildSessionKey({
+    branch: argv.branch,
+    agentId: argv.agentId,
+    suffix: argv.suffix
+  });
+  process.stdout.write(
+    buildTelemetryEnvBlock(
+      {
+        sessionKey,
+        agentId: argv.agentId,
+        repoPath,
+        workDir,
+        branch: argv.branch,
+        suffix: argv.suffix
+      },
+      { otelReady: argv.otelReady && isTelemetryEnabled() }
+    )
+  );
+}
+function handleCodexSnippet(argv) {
+  const repoPath = path46.resolve(argv.repo);
+  const harnessRoot = resolveHarnessRoot(repoPath);
+  const session = readSlotRegistry(harnessRoot, argv.agentId);
+  const workDir = argv.workDir ?? session?.workDir ?? repoPath;
+  const branch = argv.branch ?? session?.branch;
+  const suffix = argv.suffix ?? session?.suffix;
+  const sessionKey = buildSessionKey({
+    branch,
+    agentId: argv.agentId,
+    suffix,
+    createdAt: session?.createdAt
+  });
+  const snippet = buildCodexOtelSnippet({
+    sessionKey,
+    agentId: argv.agentId,
+    repoPath,
+    workDir,
+    branch,
+    suffix,
+    purpose: session?.purpose
+  });
+  if (argv.write) {
+    const outDir = path46.join(harnessRoot, ".har", "telemetry");
+    fs39.mkdirSync(outDir, { recursive: true });
+    const outPath = path46.join(outDir, "codex.otel.toml.snippet");
+    fs39.writeFileSync(outPath, snippet);
+    success(`Wrote ${outPath}`);
+    info("Merge the [otel] table into ~/.codex/config.toml manually.");
+    return;
+  }
+  process.stdout.write(snippet);
+}
+var telemetryCommand = {
+  command: "telemetry <subcommand>",
+  describe: "Agent usage telemetry (Claude Code / Codex \u2192 Mission Control)",
+  builder: (yargs) => yargs.command(
+    "status",
+    "Show telemetry preference and Mission Control reachability",
+    (y2) => y2.option("json", { type: "boolean", default: false }),
+    (argv) => {
+      void handleStatus3({ json: argv.json });
+    }
+  ).command(
+    "on",
+    "Enable telemetry (default) and ensure Mission Control is running",
+    () => {
+    },
+    () => {
+      void handleOn();
+    }
+  ).command(
+    "off",
+    "Disable telemetry (no OTEL injection, no MC auto-start)",
+    () => {
+    },
+    () => {
+      void handleOff();
+    }
+  ).command(
+    "write-env",
+    "Append session + OTEL env vars to .env.agent.<id>",
+    (y2) => y2.option("agent-id", { type: "number", demandOption: true }).option("repo", { type: "string", default: "." }).option("env-file", { type: "string" }).option("work-dir", { type: "string" }).option("branch", { type: "string" }).option("suffix", { type: "string" }).option("purpose", { type: "string" }).option("session-key", { type: "string" }).option("otel-ready", { type: "boolean" }),
+    (argv) => handleWriteEnv({
+      agentId: argv["agent-id"],
+      repo: argv.repo,
+      envFile: argv["env-file"],
+      workDir: argv["work-dir"],
+      branch: argv.branch,
+      suffix: argv.suffix,
+      purpose: argv.purpose,
+      sessionKey: argv["session-key"],
+      otelReady: argv["otel-ready"]
+    }).catch((err) => {
+      error(err instanceof Error ? err.message : String(err));
+      process.exitCode = 1;
+    })
+  ).command(
+    "print-env",
+    "Print telemetry env block to stdout",
+    (y2) => y2.option("agent-id", { type: "number", demandOption: true }).option("repo", { type: "string", default: "." }).option("work-dir", { type: "string" }).option("branch", { type: "string" }).option("suffix", { type: "string" }).option("otel-ready", { type: "boolean", default: true }),
+    (argv) => handlePrintEnv({
+      agentId: argv["agent-id"],
+      repo: argv.repo,
+      workDir: argv["work-dir"],
+      branch: argv.branch,
+      suffix: argv.suffix,
+      otelReady: argv["otel-ready"]
+    })
+  ).command(
+    "codex-snippet",
+    "Print or write a Codex [otel] config snippet",
+    (y2) => y2.option("agent-id", { type: "number", demandOption: true }).option("repo", { type: "string", default: "." }).option("work-dir", { type: "string" }).option("branch", { type: "string" }).option("suffix", { type: "string" }).option("write", {
+      type: "boolean",
+      default: false,
+      describe: "Write to .har/telemetry/codex.otel.toml.snippet"
+    }),
+    (argv) => handleCodexSnippet({
+      agentId: argv["agent-id"],
+      repo: argv.repo,
+      workDir: argv["work-dir"],
+      branch: argv.branch,
+      suffix: argv.suffix,
+      write: argv.write
+    })
+  ).demandCommand(1, "Please specify a subcommand: status, on, off, write-env, print-env, codex-snippet"),
+  handler: () => {
+  }
+};
 // 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).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 init").strict().help().version(getHarPackageVersion()).parse();
 }
 // src/index.ts