@osfactory/har 0.17.0 → 0.18.1

package/dist/index.js

@@ -765,14 +765,14 @@ var require_url_state_machine = __commonJS({
       return url.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url) {
-      const path48 = url.path;
-      if (path48.length === 0) {
+      const path50 = url.path;
+      if (path50.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path48.length === 1 && isNormalizedWindowsDriveLetter(path48[0])) {
+      if (url.scheme === "file" && path50.length === 1 && isNormalizedWindowsDriveLetter(path50[0])) {
         return;
       }
-      path48.pop();
+      path50.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(resolve33, reject) {
+      return new Body.Promise(function(resolve35, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2126,7 +2126,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve33(Buffer.concat(accum, accumBytes));
+            resolve35(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(resolve33, reject) {
+      return new fetch3.Promise(function(resolve35, 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");
                 }
-                resolve33(fetch3(new Request3(locationURL, requestOpts)));
+                resolve35(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);
-            resolve33(response);
+            resolve35(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);
-            resolve33(response);
+            resolve35(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);
-              resolve33(response);
+              resolve35(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve33(response);
+                resolve35(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);
-            resolve33(response);
+            resolve35(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve33(response);
+          resolve35(response);
         });
         writeToStream(req, request);
       });
@@ -6351,14 +6351,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path48, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path50, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path48, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path50, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6367,13 +6367,13 @@ function createFileFromPath(path48, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path48, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path48);
-  return createFileFromPath(path48, stats, filenameOrOptions, options);
+function fileFromPathSync(path50, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path50);
+  return createFileFromPath(path50, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path48, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path48);
-  return createFileFromPath(path48, stats, filenameOrOptions, options);
+async function fileFromPath2(path50, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path50);
+  return createFileFromPath(path50, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -6433,6 +6433,412 @@ var init_fileFromPath = __esm({
   }
 });
 
+// src/core/control-config.ts
+function getControlApiUrl() {
+  return process.env.HAR_CONTROL_API_URL ?? DEFAULT_CONTROL_API_URL;
+}
+function isControlEnabled() {
+  return process.env.HAR_CONTROL_DISABLED !== "true";
+}
+var DEFAULT_CONTROL_API_URL;
+var init_control_config = __esm({
+  "src/core/control-config.ts"() {
+    "use strict";
+    DEFAULT_CONTROL_API_URL = "http://localhost:3847";
+  }
+});
+
+// src/core/telemetry-config.ts
+function getPreferencePath() {
+  if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
+    return path35.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
+  }
+  return path35.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 normalizeSignals(enabled, raw) {
+  if (!enabled) return { ...DEFAULT_SIGNALS_OFF };
+  return {
+    metrics: raw?.metrics !== false,
+    logs: raw?.logs !== false,
+    prompts: raw?.prompts === true,
+    traces: raw?.traces !== false
+  };
+}
+function readTelemetryPreference() {
+  const preferencePath = getPreferencePath();
+  try {
+    if (!fs35.existsSync(preferencePath)) {
+      return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
+    }
+    const parsed = JSON.parse(fs35.readFileSync(preferencePath, "utf8"));
+    const enabled = parsed.enabled !== false;
+    return {
+      enabled,
+      signals: normalizeSignals(enabled, parsed.signals),
+      updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : void 0
+    };
+  } catch {
+    return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
+  }
+}
+function writeTelemetryPreference(enabled, signals) {
+  const current = readTelemetryPreference();
+  const nextSignals = normalizeSignals(enabled, {
+    ...current.signals,
+    ...signals
+  });
+  const preference = {
+    enabled,
+    signals: enabled ? nextSignals : { ...DEFAULT_SIGNALS_OFF },
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const preferencePath = getPreferencePath();
+  fs35.mkdirSync(path35.dirname(preferencePath), { recursive: true });
+  fs35.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 getTelemetrySignals() {
+  if (!isTelemetryEnabled()) return { ...DEFAULT_SIGNALS_OFF };
+  return readTelemetryPreference().signals;
+}
+function getTelemetryPreferencePath() {
+  return getPreferencePath();
+}
+var fs35, os9, path35, DEFAULT_SIGNALS_ON, DEFAULT_SIGNALS_OFF, TELEMETRY_SIGNALS;
+var init_telemetry_config = __esm({
+  "src/core/telemetry-config.ts"() {
+    "use strict";
+    fs35 = __toESM(require("fs"));
+    os9 = __toESM(require("os"));
+    path35 = __toESM(require("path"));
+    DEFAULT_SIGNALS_ON = {
+      metrics: true,
+      logs: true,
+      prompts: false,
+      /** Hooks are traces-first; usage metrics are derived from span gen_ai.usage.* in Mission Control. */
+      traces: true
+    };
+    DEFAULT_SIGNALS_OFF = {
+      metrics: false,
+      logs: false,
+      prompts: false,
+      traces: false
+    };
+    TELEMETRY_SIGNALS = [
+      "Traces (default): Cursor / Claude / Codex activity via opentelemetry-hooks \u2192 Mission Control",
+      "Logs/events (default): hook lifecycle logs without prompt bodies",
+      "Metrics (default): token usage derived from span gen_ai.usage.* attributes",
+      "Prompts (opt-in): user prompt text via IDE_OTEL_CAPTURE_TEXT \u2014 har telemetry on --prompts (also fills Mission Control purpose)",
+      "Fallback: har control sync harvests local Claude/Codex session files when hooks telemetry is missing"
+    ];
+  }
+});
+
+// src/core/otel-hooks.ts
+var otel_hooks_exports = {};
+__export(otel_hooks_exports, {
+  OTEL_HOOKS_AGENTS: () => OTEL_HOOKS_AGENTS,
+  OTEL_HOOKS_PACKAGE: () => OTEL_HOOKS_PACKAGE,
+  buildOtelHooksConfig: () => buildOtelHooksConfig,
+  disableOtelHooksExport: () => disableOtelHooksExport,
+  ensureOtelHooks: () => ensureOtelHooks,
+  getOtelHooksConfigPath: () => getOtelHooksConfigPath,
+  getOtelHooksHome: () => getOtelHooksHome,
+  getOtelHooksWrapperPath: () => getOtelHooksWrapperPath,
+  rewriteHookCommandsToWrapper: () => rewriteHookCommandsToWrapper,
+  writeOtelHooksConfig: () => writeOtelHooksConfig,
+  writeOtelHooksWrapper: () => writeOtelHooksWrapper
+});
+function getOtelHooksHome() {
+  if (process.env.HAR_OTEL_HOOKS_HOME) {
+    return path41.resolve(process.env.HAR_OTEL_HOOKS_HOME);
+  }
+  return path41.join(os12.homedir(), ".har", "otel-hooks");
+}
+function getOtelHooksConfigPath(hooksHome = getOtelHooksHome()) {
+  return path41.join(hooksHome, "otel_config.json");
+}
+function getOtelHooksWrapperPath(hooksHome = getOtelHooksHome()) {
+  return path41.join(hooksHome, "run-otel-hook.sh");
+}
+function buildOtelHooksConfig(options) {
+  const enabled = options?.enabled ?? isTelemetryEnabled();
+  const signals = getTelemetrySignals();
+  const apiUrl = (options?.apiUrl ?? getControlApiUrl()).replace(/\/$/, "");
+  return {
+    OTEL_EXPORTER_OTLP_ENDPOINT: enabled ? `${apiUrl}/api/otel/v1/traces` : null,
+    OTEL_EXPORTER_OTLP_PROTOCOL: "http/json",
+    OTEL_SERVICE_NAME: "har-ide-agent",
+    IDE_OTEL_BATCH_ON_STOP: "true",
+    IDE_OTEL_ENABLE_LOGS: enabled && signals.logs ? "true" : "false",
+    IDE_OTEL_LOG_ALL_EVENTS: enabled && signals.logs ? "true" : "false",
+    IDE_OTEL_CAPTURE_TEXT: enabled && signals.prompts ? "true" : "false",
+    IDE_OTEL_MASK_PROMPTS: "false",
+    OTEL_RESOURCE_ATTRIBUTES: options?.resourceAttributes ?? null
+  };
+}
+function writeOtelHooksConfig(config2, hooksHome = getOtelHooksHome()) {
+  fs39.mkdirSync(hooksHome, { recursive: true });
+  const configPath = getOtelHooksConfigPath(hooksHome);
+  const payload = {
+    _comment: "Managed by har telemetry \u2014 do not edit by hand; use: har telemetry on|off",
+    ...config2
+  };
+  fs39.writeFileSync(configPath, `${JSON.stringify(payload, null, 2)}
+`);
+  return configPath;
+}
+function writeOtelHooksWrapper(otelHookCommand, hooksHome = getOtelHooksHome()) {
+  fs39.mkdirSync(hooksHome, { recursive: true });
+  const wrapperPath = getOtelHooksWrapperPath(hooksHome);
+  const script = `#!/usr/bin/env bash
+# Managed by har telemetry \u2014 invokes opentelemetry-hooks with HAR config home.
+set -euo pipefail
+export IDE_OTEL_HOOK_HOME="${hooksHome}"
+exec "${otelHookCommand}" "$@"
+`;
+  fs39.writeFileSync(wrapperPath, script, { mode: 493 });
+  try {
+    fs39.chmodSync(wrapperPath, 493);
+  } catch {
+  }
+  return wrapperPath;
+}
+function commandExists(command2) {
+  const result = (0, import_child_process9.spawnSync)("sh", ["-c", `command -v ${JSON.stringify(command2)}`], {
+    encoding: "utf8"
+  });
+  return result.status === 0 && Boolean(result.stdout?.trim());
+}
+function resolveOtelHookCommand() {
+  if (commandExists("otel-hook")) {
+    const which = (0, import_child_process9.spawnSync)("sh", ["-c", "command -v otel-hook"], { encoding: "utf8" });
+    return which.stdout?.trim() || "otel-hook";
+  }
+  return null;
+}
+function tryInstallPackage() {
+  if (commandExists("uv")) {
+    const result = (0, import_child_process9.spawnSync)(
+      "uv",
+      ["tool", "install", "--force", OTEL_HOOKS_PACKAGE],
+      { encoding: "utf8", timeout: 18e4 }
+    );
+    if (result.status === 0) {
+      return { ok: true, detail: `uv tool install ${OTEL_HOOKS_PACKAGE}` };
+    }
+  }
+  if (commandExists("pipx")) {
+    const result = (0, import_child_process9.spawnSync)("pipx", ["install", "--force", OTEL_HOOKS_PACKAGE], {
+      encoding: "utf8",
+      timeout: 18e4
+    });
+    if (result.status === 0) {
+      return { ok: true, detail: `pipx install ${OTEL_HOOKS_PACKAGE}` };
+    }
+    return {
+      ok: false,
+      detail: `pipx install failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
+    };
+  }
+  if (commandExists("pip3") || commandExists("pip")) {
+    const pip = commandExists("pip3") ? "pip3" : "pip";
+    const result = (0, import_child_process9.spawnSync)(
+      pip,
+      ["install", "--user", OTEL_HOOKS_PACKAGE],
+      { encoding: "utf8", timeout: 18e4 }
+    );
+    if (result.status === 0) {
+      return { ok: true, detail: `${pip} install --user ${OTEL_HOOKS_PACKAGE}` };
+    }
+    return {
+      ok: false,
+      detail: `${pip} install failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
+    };
+  }
+  return {
+    ok: false,
+    detail: "Neither uv, pipx, nor pip3/pip found; install Python tooling to use opentelemetry-hooks"
+  };
+}
+function runSetupAgent(agent, otelHookCommand, hooksHome) {
+  const result = (0, import_child_process9.spawnSync)(otelHookCommand, ["setup", "--agent", agent], {
+    encoding: "utf8",
+    env: {
+      ...process.env,
+      IDE_OTEL_HOOK_HOME: hooksHome
+    },
+    timeout: 6e4
+  });
+  if (result.status === 0) {
+    return { ok: true, detail: `setup --agent ${agent}` };
+  }
+  return {
+    ok: false,
+    detail: `setup --agent ${agent} failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
+  };
+}
+function rewriteHookCommandsToWrapper(filePath, wrapperPath) {
+  if (!fs39.existsSync(filePath)) return false;
+  let raw;
+  try {
+    raw = fs39.readFileSync(filePath, "utf8");
+  } catch {
+    return false;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return false;
+  }
+  if (!parsed || typeof parsed !== "object") return false;
+  const quoted = JSON.stringify(wrapperPath);
+  const rewriteCommand = (command2) => {
+    if (!command2.includes("otel-hook") && !command2.includes("otel_hook.py")) return command2;
+    if (command2.includes(wrapperPath)) return command2;
+    return command2.replace(
+      /(?:^|[;&|]\s*)(?:env\s+[^=\s]+=\S+\s+)*(?:python3?\s+)?(?:\S*otel[_-]hook\S*)/,
+      (match) => match.replace(/(?:python3?\s+)?(?:\S*otel[_-]hook\S*)/, quoted.slice(1, -1))
+    );
+  };
+  const walk = (node) => {
+    let changed = false;
+    if (Array.isArray(node)) {
+      for (const item of node) changed = walk(item) || changed;
+      return changed;
+    }
+    if (!node || typeof node !== "object") return false;
+    const obj = node;
+    if (typeof obj.command === "string") {
+      const next = rewriteCommand(obj.command);
+      if (next !== obj.command) {
+        obj.command = next;
+        changed = true;
+      }
+    }
+    for (const value of Object.values(obj)) changed = walk(value) || changed;
+    return changed;
+  };
+  if (!walk(parsed)) return false;
+  fs39.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
+`);
+  return true;
+}
+function rewriteKnownHookRegistrations(wrapperPath) {
+  const home = os12.homedir();
+  const candidates = [
+    path41.join(home, ".cursor", "hooks.json"),
+    path41.join(home, ".claude", "settings.json"),
+    path41.join(home, ".codex", "hooks.json")
+  ];
+  for (const filePath of candidates) {
+    try {
+      rewriteHookCommandsToWrapper(filePath, wrapperPath);
+    } catch {
+    }
+  }
+}
+function ensureOtelHooks(options) {
+  const hooksHome = getOtelHooksHome();
+  const errors = [];
+  const agentsSetup = [];
+  fs39.mkdirSync(hooksHome, { recursive: true });
+  let otelHookCommand = resolveOtelHookCommand();
+  if (!otelHookCommand) {
+    const installed = tryInstallPackage();
+    if (!installed.ok) {
+      errors.push(installed.detail);
+      const configPath2 = writeOtelHooksConfig(
+        buildOtelHooksConfig({ resourceAttributes: options?.resourceAttributes }),
+        hooksHome
+      );
+      return {
+        ok: false,
+        hooksHome,
+        configPath: configPath2,
+        wrapperPath: getOtelHooksWrapperPath(hooksHome),
+        otelHookCommand: null,
+        warning: installed.detail,
+        agentsSetup,
+        errors
+      };
+    }
+    otelHookCommand = resolveOtelHookCommand();
+    if (!otelHookCommand) {
+      errors.push("opentelemetry-hooks installed but otel-hook is not on PATH");
+      const configPath2 = writeOtelHooksConfig(
+        buildOtelHooksConfig({ resourceAttributes: options?.resourceAttributes }),
+        hooksHome
+      );
+      return {
+        ok: false,
+        hooksHome,
+        configPath: configPath2,
+        wrapperPath: getOtelHooksWrapperPath(hooksHome),
+        otelHookCommand: null,
+        warning: errors[errors.length - 1],
+        agentsSetup,
+        errors
+      };
+    }
+  }
+  const configPath = writeOtelHooksConfig(
+    buildOtelHooksConfig({ resourceAttributes: options?.resourceAttributes }),
+    hooksHome
+  );
+  const wrapperPath = writeOtelHooksWrapper(otelHookCommand, hooksHome);
+  if (options?.setupAgents !== false && isTelemetryEnabled()) {
+    for (const agent of OTEL_HOOKS_AGENTS) {
+      const setup = runSetupAgent(agent, otelHookCommand, hooksHome);
+      if (setup.ok) agentsSetup.push(agent);
+      else errors.push(setup.detail);
+    }
+    rewriteKnownHookRegistrations(wrapperPath);
+  }
+  const ok = errors.length === 0;
+  return {
+    ok,
+    hooksHome,
+    configPath,
+    wrapperPath,
+    otelHookCommand,
+    message: ok ? `opentelemetry-hooks ready (${agentsSetup.join(", ") || "config only"}) \u2192 ${configPath}` : void 0,
+    warning: errors.length ? errors.join("; ") : void 0,
+    agentsSetup,
+    errors
+  };
+}
+function disableOtelHooksExport() {
+  return writeOtelHooksConfig(buildOtelHooksConfig({ enabled: false }));
+}
+var import_child_process9, fs39, os12, path41, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_AGENTS;
+var init_otel_hooks = __esm({
+  "src/core/otel-hooks.ts"() {
+    "use strict";
+    import_child_process9 = require("child_process");
+    fs39 = __toESM(require("fs"));
+    os12 = __toESM(require("os"));
+    path41 = __toESM(require("path"));
+    init_control_config();
+    init_telemetry_config();
+    OTEL_HOOKS_PACKAGE = "opentelemetry-hooks==0.14.0";
+    OTEL_HOOKS_AGENTS = ["cursor", "claude", "codex"];
+  }
+});
+
 // node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
   "node_modules/ajv/dist/compile/codegen/code.js"(exports2) {
@@ -9384,7 +9790,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve33.call(this, root, ref);
+      let _sch = resolve35.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 +9817,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve33(root, ref) {
+    function resolve35(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -9629,8 +10035,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path48) {
-      let input = path48;
+    function removeDotSegments(path50) {
+      let input = path50;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -9882,8 +10288,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path48, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path48 && path48 !== "/" ? path48 : void 0;
+        const [path50, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path50 && path50 !== "/" ? path50 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10042,55 +10448,55 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve33(baseURI, relativeURI, options) {
+    function resolve35(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative2, options, skipNormalization) {
+    function resolveComponent(base, relative3, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse4(serialize(base, options), options);
-        relative2 = parse4(serialize(relative2, options), options);
+        relative3 = parse4(serialize(relative3, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative2.scheme) {
-        target.scheme = relative2.scheme;
-        target.userinfo = relative2.userinfo;
-        target.host = relative2.host;
-        target.port = relative2.port;
-        target.path = removeDotSegments(relative2.path || "");
-        target.query = relative2.query;
+      if (!options.tolerant && relative3.scheme) {
+        target.scheme = relative3.scheme;
+        target.userinfo = relative3.userinfo;
+        target.host = relative3.host;
+        target.port = relative3.port;
+        target.path = removeDotSegments(relative3.path || "");
+        target.query = relative3.query;
       } else {
-        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
-          target.userinfo = relative2.userinfo;
-          target.host = relative2.host;
-          target.port = relative2.port;
-          target.path = removeDotSegments(relative2.path || "");
-          target.query = relative2.query;
+        if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
+          target.userinfo = relative3.userinfo;
+          target.host = relative3.host;
+          target.port = relative3.port;
+          target.path = removeDotSegments(relative3.path || "");
+          target.query = relative3.query;
         } else {
-          if (!relative2.path) {
+          if (!relative3.path) {
             target.path = base.path;
-            if (relative2.query !== void 0) {
-              target.query = relative2.query;
+            if (relative3.query !== void 0) {
+              target.query = relative3.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative2.path[0] === "/") {
-              target.path = removeDotSegments(relative2.path);
+            if (relative3.path[0] === "/") {
+              target.path = removeDotSegments(relative3.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative2.path;
+                target.path = "/" + relative3.path;
               } else if (!base.path) {
-                target.path = relative2.path;
+                target.path = relative3.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative2.query;
+            target.query = relative3.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -10098,7 +10504,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative2.fragment;
+      target.fragment = relative3.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -10300,7 +10706,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve33,
+      resolve: resolve35,
       resolveComponent,
       equal,
       serialize,
@@ -13276,12 +13682,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs41, exportName) {
+    function addFormats(ajv, list, fs42, exportName) {
       var _a3;
       var _b2;
       (_a3 = (_b2 = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b2.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f2 of list)
-        ajv.addFormat(f2, fs41[f2]);
+        ajv.addFormat(f2, fs42[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -14565,11 +14971,11 @@ var parser = new YargsParser({
   resolve: import_path2.resolve,
   // TODO: figure  out a  way to combine ESM and CJS coverage, such  that
   // we can exercise all the lines below:
-  require: (path48) => {
+  require: (path50) => {
     if (typeof require !== "undefined") {
-      return require(path48);
-    } else if (path48.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path48, "utf8"));
+      return require(path50);
+    } else if (path50.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path50, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -15912,13 +16318,13 @@ function usage(yargs, shim3) {
   };
   self.stringifiedValues = function stringifiedValues(values, separator) {
     let string3 = "";
-    const sep5 = separator || ", ";
+    const sep6 = separator || ", ";
     const array2 = [].concat(values);
     if (!values || !array2.length)
       return string3;
     array2.forEach((value) => {
       if (string3.length)
-        string3 += sep5;
+        string3 += sep6;
       string3 += JSON.stringify(value);
     });
     return string3;
@@ -17095,12 +17501,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve33, reject) => {
+      return new Promise((resolve35, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve33(completions);
+            resolve35(completions);
         });
       });
     } else {
@@ -19250,8 +19656,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path48, errorMaps, issueData } = params;
-  const fullPath = [...path48, ...issueData.path || []];
+  const { data, path: path50, errorMaps, issueData } = params;
+  const fullPath = [...path50, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -19367,11 +19773,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path48, key) {
+  constructor(parent, value, path50, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path48;
+    this._path = path50;
     this._key = key;
   }
   get path() {
@@ -22992,7 +23398,6 @@ var SlotRegistryEntrySchema = external_exports.object({
   /** Random per-session chars; absent in root mode. */
   suffix: external_exports.string().optional(),
   createdAt: external_exports.string(),
-  purpose: external_exports.string().optional(),
   ports: external_exports.record(external_exports.number()).optional(),
   previewUrls: external_exports.record(external_exports.string()).optional(),
   status: external_exports.enum(["starting", "active", "failed", "completed"]).default("active"),
@@ -23038,6 +23443,7 @@ var AgentSlotStatusSchema = external_exports.object({
   baseBranch: external_exports.string().optional(),
   baseCommit: external_exports.string().optional(),
   sessionCreatedAt: external_exports.string().optional(),
+  /** Derived from first captured user prompt (OTEL hooks); not set at launch. */
   purpose: external_exports.string().optional(),
   sessionStatus: external_exports.enum(["starting", "active", "failed", "completed"]).optional(),
   lastError: external_exports.string().optional(),
@@ -23106,7 +23512,7 @@ var ValidationRecordSchema = external_exports.object({
 var SyncValidationsInputSchema = external_exports.object({
   validations: external_exports.array(ValidationRecordSchema)
 });
-var AgentToolSchema = external_exports.enum(["claude_code", "codex"]);
+var AgentToolSchema = external_exports.enum(["claude_code", "codex", "cursor"]);
 var UsageSourceSchema = external_exports.enum(["otel", "harvest"]);
 var AgentSessionUsageSchema = external_exports.object({
   sessionKey: external_exports.string().min(1),
@@ -23410,16 +23816,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve33) => {
+  return new Promise((resolve35) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve33(true);
+        resolve35(true);
         return;
       }
-      resolve33(/^y(es)?$/i.test(trimmed));
+      resolve35(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -23498,7 +23904,7 @@ function handleRemove(argv) {
 }
 
 // src/cli/commands/env.ts
-var path41 = __toESM(require("path"));
+var path43 = __toESM(require("path"));
 
 // src/core/harness.ts
 var fs20 = __toESM(require("fs"));
@@ -24277,13 +24683,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(path48, ...args) {
+async function fileFromPath3(path50, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path48)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path50)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path48, ...args);
+  return await _fileFromPath(path50, ...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 });
@@ -24779,8 +25185,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve33) => {
-      resolve33(null);
+    super((resolve35) => {
+      resolve35(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -24880,29 +25286,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path48, opts) {
-    return this.methodRequest("get", path48, opts);
+  get(path50, opts) {
+    return this.methodRequest("get", path50, opts);
   }
-  post(path48, opts) {
-    return this.methodRequest("post", path48, opts);
+  post(path50, opts) {
+    return this.methodRequest("post", path50, opts);
   }
-  patch(path48, opts) {
-    return this.methodRequest("patch", path48, opts);
+  patch(path50, opts) {
+    return this.methodRequest("patch", path50, opts);
   }
-  put(path48, opts) {
-    return this.methodRequest("put", path48, opts);
+  put(path50, opts) {
+    return this.methodRequest("put", path50, opts);
   }
-  delete(path48, opts) {
-    return this.methodRequest("delete", path48, opts);
+  delete(path50, opts) {
+    return this.methodRequest("delete", path50, opts);
   }
-  methodRequest(method, path48, opts) {
+  methodRequest(method, path50, 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: path48, ...opts2, body };
+      return { method, path: path50, ...opts2, body };
     }));
   }
-  getAPIList(path48, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path48, ...opts });
+  getAPIList(path50, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path50, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -24920,10 +25326,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path48, query, headers = {} } = options;
+    const { method, path: path50, 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(path48, query);
+    const url = this.buildURL(path50, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -25032,8 +25438,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path48, query) {
-    const url = isAbsoluteURL(path48) ? new URL(path48) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path48.startsWith("/") ? path48.slice(1) : path48));
+  buildURL(path50, query) {
+    const url = isAbsoluteURL(path50) ? new URL(path50) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path50.startsWith("/") ? path50.slice(1) : path50));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -25318,7 +25724,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve33) => setTimeout(resolve33, ms));
+var sleep = (ms) => new Promise((resolve35) => setTimeout(resolve35, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -25809,12 +26215,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve33, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve35, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve35, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve33, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve35, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve35, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -25943,11 +26349,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve35, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve33);
+      this.once(event, resolve35);
     });
   }
   async done() {
@@ -26174,7 +26580,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { 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 });
+          return new Promise((resolve35, reject) => readQueue.push({ resolve: resolve35, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26322,12 +26728,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve33, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve35, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve35, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve33, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve35, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve35, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -26456,11 +26862,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve35, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve33);
+      this.once(event, resolve35);
     });
   }
   async done() {
@@ -26687,7 +27093,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { 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 });
+          return new Promise((resolve35, reject) => readQueue.push({ resolve: resolve35, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26947,11 +27353,11 @@ async function promptApplyAgentMdProposal(repoPath) {
 }
 async function askYesNo2(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve33) => {
+  return new Promise((resolve35) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve33(/^y(es)?$/i.test(answer.trim()));
+      resolve35(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -27181,7 +27587,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((resolve33) => {
+  return new Promise((resolve35) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -27192,7 +27598,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve33(answer.trim());
+      resolve35(answer.trim());
     });
   });
 }
@@ -27336,7 +27742,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve33) => {
+  return new Promise((resolve35) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27351,13 +27757,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve35({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve33) => {
+  return new Promise((resolve35) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27372,7 +27778,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve35({ stdout, stderr, code: code ?? 0 }));
   });
 }
 
@@ -28536,16 +28942,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve33) => {
+  return new Promise((resolve35) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve33(true);
+        resolve35(true);
         return;
       }
-      resolve33(/^y(es)?$/i.test(trimmed));
+      resolve35(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -28663,7 +29069,6 @@ function buildLaunchFlagArgs(flags) {
   if (flags.confirmReplace) args.push("--replace");
   if (flags.force) args.push("--force");
   if (flags.resume) args.push("--resume");
-  if (flags.purpose) args.push(`--purpose=${flags.purpose}`);
   return args;
 }
 function resolveRepoPath(repoPath) {
@@ -28744,9 +29149,6 @@ function buildExecutionPlan(repoPath, stage, options) {
   const cwd = stage.cwd ? path24.resolve(resolvedRepo, stage.cwd) : resolvedRepo;
   const extraArgs = options.args ?? [];
   const launchFlagArgs = stage.kind === "launch" && options.launchFlags ? buildLaunchFlagArgs(options.launchFlags) : [];
-  if (stage.kind === "launch" && options.launchFlags?.purpose) {
-    mergedEnv.HAR_SESSION_PURPOSE = options.launchFlags.purpose;
-  }
   if (stage.command) {
     let shellCommand = substituteAgentId(stage.command, options.agentId);
     for (const extra of [...extraArgs, ...launchFlagArgs]) {
@@ -28820,16 +29222,16 @@ var LocalScriptExecutor = class {
     const walk = (dir, prefix) => {
       for (const entry of fs25.readdirSync(dir, { withFileTypes: true })) {
         const full = path24.join(dir, entry.name);
-        const relative2 = path24.join(prefix, entry.name);
+        const relative3 = path24.join(prefix, entry.name);
         if (entry.isDirectory()) {
-          walk(full, relative2);
+          walk(full, relative3);
           continue;
         }
-        if (filter?.stageId && !relative2.includes(filter.stageId)) continue;
+        if (filter?.stageId && !relative3.includes(filter.stageId)) continue;
         const stat = fs25.statSync(full);
         entries.push({
           path: full,
-          relativePath: relative2,
+          relativePath: relative3,
           sizeBytes: stat.size,
           modifiedAt: stat.mtime.toISOString()
         });
@@ -28842,44 +29244,86 @@ var LocalScriptExecutor = class {
 var localScriptExecutor = new LocalScriptExecutor();
 
 // src/core/control-sync.ts
-var path38 = __toESM(require("path"));
+var path39 = __toESM(require("path"));
+init_control_config();
 
-// src/core/control-config.ts
-var DEFAULT_CONTROL_API_URL = "http://localhost:3847";
-function getControlApiUrl() {
-  return process.env.HAR_CONTROL_API_URL ?? DEFAULT_CONTROL_API_URL;
+// src/core/control-registry.ts
+var fs27 = __toESM(require("fs"));
+var os4 = __toESM(require("os"));
+var path26 = __toESM(require("path"));
+
+// src/core/control-repo-path.ts
+var fs26 = __toESM(require("fs"));
+var path25 = __toESM(require("path"));
+function tryGit(cwd, args) {
+  if (!fs26.existsSync(cwd)) return void 0;
+  const result = run(`git ${args}`, { cwd });
+  return result.code === 0 ? result.stdout.trim() : void 0;
 }
-function isControlEnabled() {
-  return process.env.HAR_CONTROL_DISABLED !== "true";
+function resolveMainWorkingTree(cwd) {
+  const toplevel = tryGit(cwd, "rev-parse --show-toplevel");
+  if (!toplevel) return void 0;
+  const commonDirRaw = tryGit(cwd, "rev-parse --git-common-dir");
+  const commonDir = commonDirRaw ? path25.resolve(cwd, commonDirRaw) : void 0;
+  if (!commonDir) return path25.resolve(toplevel);
+  if (path25.basename(commonDir) === ".git") {
+    return path25.dirname(commonDir);
+  }
+  const porcelain = tryGit(cwd, "worktree list --porcelain");
+  if (porcelain) {
+    for (const line of porcelain.split("\n")) {
+      if (line.startsWith("worktree ")) {
+        return path25.resolve(line.slice("worktree ".length));
+      }
+    }
+  }
+  return path25.resolve(toplevel);
+}
+function canonicalizeControlRepoPath(repoPath) {
+  const resolved = path25.resolve(repoPath);
+  const toplevel = tryGit(resolved, "rev-parse --show-toplevel");
+  if (!toplevel) return resolved;
+  const mainRoot = resolveMainWorkingTree(resolved);
+  if (!mainRoot) return resolved;
+  const top2 = path25.resolve(toplevel);
+  const main = path25.resolve(mainRoot);
+  if (top2 === main) return resolved;
+  const rel = path25.relative(top2, resolved);
+  if (!rel || rel === ".") return main;
+  if (rel.startsWith(`..${path25.sep}`) || rel === ".." || path25.isAbsolute(rel)) {
+    return resolved;
+  }
+  return path25.resolve(main, rel);
 }
 
 // src/core/control-registry.ts
-var fs26 = __toESM(require("fs"));
-var os4 = __toESM(require("os"));
-var path25 = __toESM(require("path"));
 function getRegistryPath() {
   if (process.env.HAR_CONTROL_REGISTRY_PATH) {
-    return path25.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
+    return path26.resolve(process.env.HAR_CONTROL_REGISTRY_PATH);
   }
-  return path25.join(os4.homedir(), ".har", "repos.json");
+  return path26.join(os4.homedir(), ".har", "repos.json");
 }
 function readRegistry() {
   const registryPath = getRegistryPath();
   try {
-    if (!fs26.existsSync(registryPath)) return { repos: [] };
-    return JSON.parse(fs26.readFileSync(registryPath, "utf8"));
+    if (!fs27.existsSync(registryPath)) return { repos: [] };
+    return JSON.parse(fs27.readFileSync(registryPath, "utf8"));
   } catch {
     return { repos: [] };
   }
 }
 function writeRegistry(registry2) {
   const registryPath = getRegistryPath();
-  fs26.mkdirSync(path25.dirname(registryPath), { recursive: true });
-  fs26.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
+  fs27.mkdirSync(path26.dirname(registryPath), { recursive: true });
+  fs27.writeFileSync(registryPath, JSON.stringify(registry2, null, 2) + "\n");
+}
+function registryChanged(before, after) {
+  if (before.length !== after.length) return true;
+  return before.some((repoPath, index) => repoPath !== after[index]);
 }
 function recordRepoForControlSync(repoPath) {
   if (process.env.HAR_CONTROL_DISABLED === "true") return;
-  const resolved = path25.resolve(repoPath);
+  const resolved = canonicalizeControlRepoPath(repoPath);
   if (!readManifest(resolved)) return;
   const registry2 = readRegistry();
   if (registry2.repos.includes(resolved)) return;
@@ -28888,25 +29332,34 @@ function recordRepoForControlSync(repoPath) {
 }
 function listRegisteredRepos() {
   const registry2 = readRegistry();
-  const kept = registry2.repos.filter((repoPath) => fs26.existsSync(repoPath) && readManifest(repoPath));
-  if (kept.length !== registry2.repos.length) {
+  const kept = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const repoPath of registry2.repos) {
+    if (!fs27.existsSync(repoPath)) continue;
+    const canonical = canonicalizeControlRepoPath(repoPath);
+    if (!fs27.existsSync(canonical) || !readManifest(canonical)) continue;
+    if (seen.has(canonical)) continue;
+    seen.add(canonical);
+    kept.push(canonical);
+  }
+  if (registryChanged(registry2.repos, kept)) {
     writeRegistry({ repos: kept });
   }
   return kept;
 }
 
 // src/core/slot-status.ts
-var fs31 = __toESM(require("fs"));
+var fs32 = __toESM(require("fs"));
 var os7 = __toESM(require("os"));
-var path31 = __toESM(require("path"));
+var path32 = __toESM(require("path"));
 var import_child_process7 = require("child_process");
 
 // src/core/runs.ts
 var crypto2 = __toESM(require("crypto"));
 var import_child_process2 = require("child_process");
-var fs27 = __toESM(require("fs"));
+var fs28 = __toESM(require("fs"));
 var os5 = __toESM(require("os"));
-var path26 = __toESM(require("path"));
+var path27 = __toESM(require("path"));
 var RUNS_DIR = "runs";
 function gitCommonDir(cwd) {
   try {
@@ -28915,7 +29368,7 @@ function gitCommonDir(cwd) {
       encoding: "utf8",
       stdio: ["pipe", "pipe", "ignore"]
     }).trim();
-    return out ? path26.resolve(cwd, out) : void 0;
+    return out ? path27.resolve(cwd, out) : void 0;
   } catch {
     return void 0;
   }
@@ -28937,7 +29390,7 @@ function gitPrefix(cwd) {
   }
 }
 function getRunsDir(harnessRoot) {
-  return path26.join(getHarnessDir(harnessRoot), RUNS_DIR);
+  return path27.join(getHarnessDir(harnessRoot), RUNS_DIR);
 }
 function formatLocalDate(d2) {
   const y2 = d2.getFullYear();
@@ -28957,24 +29410,24 @@ function buildRunRelativePath(stageId, agentId, startedAt, runId, runsDir) {
   const timePart = formatLocalTime(started);
   const agentPart = agentId !== void 0 ? `_agent-${agentId}` : "";
   let filename = `${timePart}_${stageId}${agentPart}.json`;
-  const fullPath = path26.join(runsDir, dateFolder, filename);
-  if (fs27.existsSync(fullPath)) {
+  const fullPath = path27.join(runsDir, dateFolder, filename);
+  if (fs28.existsSync(fullPath)) {
     filename = `${timePart}_${stageId}${agentPart}-${runId.slice(0, 8)}.json`;
   }
-  return path26.join(dateFolder, filename);
+  return path27.join(dateFolder, filename);
 }
 function resolveRunFilePath(harnessRoot, run2) {
   if (run2.relativePath) {
-    return path26.join(getRunsDir(harnessRoot), run2.relativePath);
+    return path27.join(getRunsDir(harnessRoot), run2.relativePath);
   }
-  return path26.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
+  return path27.join(getRunsDir(harnessRoot), `${run2.runId}.json`);
 }
 function collectRunFiles(runsDir) {
-  if (!fs27.existsSync(runsDir)) return [];
+  if (!fs28.existsSync(runsDir)) return [];
   const files = [];
   const walk = (dir) => {
-    for (const entry of fs27.readdirSync(dir, { withFileTypes: true })) {
-      const full = path26.join(dir, entry.name);
+    for (const entry of fs28.readdirSync(dir, { withFileTypes: true })) {
+      const full = path27.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(full);
       } else if (entry.name.endsWith(".json")) {
@@ -28988,30 +29441,30 @@ function collectRunFiles(runsDir) {
 function resolveAgentWorkDir(harnessRoot, agentId) {
   if (agentId === void 0) return void 0;
   const entry = readSlotRegistry(harnessRoot, agentId);
-  if (entry?.workDir && fs27.existsSync(entry.workDir)) return entry.workDir;
+  if (entry?.workDir && fs28.existsSync(entry.workDir)) return entry.workDir;
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path26.basename(harnessRoot);
-  const worktreeDir = path26.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path27.basename(harnessRoot);
+  const worktreeDir = path27.join(os5.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
   const relPrefix = gitPrefix(harnessRoot);
   const sessionEnvFiles = [];
-  const worktreesRoot = path26.join(os5.homedir(), "worktrees");
-  if (fs27.existsSync(worktreesRoot)) {
+  const worktreesRoot = path27.join(os5.homedir(), "worktrees");
+  if (fs28.existsSync(worktreesRoot)) {
     const suffix = `-har-agent-${agentId}-`;
-    for (const entry2 of fs27.readdirSync(worktreesRoot, { withFileTypes: true })) {
+    for (const entry2 of fs28.readdirSync(worktreesRoot, { withFileTypes: true })) {
       if (!entry2.isDirectory() || !entry2.name.includes(suffix)) continue;
-      const sessionDir = path26.join(worktreesRoot, entry2.name);
+      const sessionDir = path27.join(worktreesRoot, entry2.name);
       if (!sameGitCheckout(harnessRoot, sessionDir)) continue;
-      sessionEnvFiles.push(path26.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
+      sessionEnvFiles.push(path27.join(sessionDir, relPrefix, `.env.agent.${agentId}`));
     }
   }
   const candidates = [
-    path26.join(worktreeDir, `.env.agent.${agentId}`),
-    path26.join(harnessRoot, `.env.agent.${agentId}`),
+    path27.join(worktreeDir, `.env.agent.${agentId}`),
+    path27.join(harnessRoot, `.env.agent.${agentId}`),
     ...sessionEnvFiles.sort()
   ];
   for (const envFile of candidates) {
-    if (!fs27.existsSync(envFile)) continue;
-    const content = fs27.readFileSync(envFile, "utf8");
+    if (!fs28.existsSync(envFile)) continue;
+    const content = fs28.readFileSync(envFile, "utf8");
     const match = content.match(/^REPO_ROOT=(.+)$/m);
     if (match) return match[1].trim();
   }
@@ -29023,11 +29476,11 @@ function createRun(ctx, meta) {
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const runId = crypto2.randomUUID();
   const relativePath = buildRunRelativePath(meta.stageId, meta.agentId, startedAt, runId, runsDir);
-  const runFilePath = path26.join(runsDir, relativePath);
-  fs27.mkdirSync(path26.dirname(runFilePath), { recursive: true });
+  const runFilePath = path27.join(runsDir, relativePath);
+  fs28.mkdirSync(path27.dirname(runFilePath), { recursive: true });
   const run2 = RunRecordSchema.parse({
     runId,
-    repoPath: path26.resolve(ctx.repoPath),
+    repoPath: path27.resolve(ctx.repoPath),
     harnessRoot,
     stageId: meta.stageId,
     kind: meta.kind,
@@ -29038,7 +29491,7 @@ function createRun(ctx, meta) {
     relativePath,
     trigger: ctx.trigger ?? "cli"
   });
-  fs27.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
+  fs28.writeFileSync(runFilePath, JSON.stringify(run2, null, 2) + "\n");
   return run2;
 }
 function finishRun(repoPath, runId, update) {
@@ -29057,13 +29510,13 @@ function finishRun(repoPath, runId, update) {
     finishedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   const runPath = resolveRunFilePath(harnessRoot, finished);
-  fs27.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
+  fs28.writeFileSync(runPath, JSON.stringify(finished, null, 2) + "\n");
   return finished;
 }
 function findRunRecord(harnessRoot, runId) {
   const runsDir = getRunsDir(harnessRoot);
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs27.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs28.readFileSync(filePath, "utf8")));
     if (parsed.success && parsed.data.runId === runId) {
       return parsed.data;
     }
@@ -29075,10 +29528,10 @@ function getRun(repoPath, runId) {
 }
 function listRuns(repoPath, filter = {}) {
   const runsDir = getRunsDir(resolveHarnessRoot(repoPath));
-  if (!fs27.existsSync(runsDir)) return [];
+  if (!fs28.existsSync(runsDir)) return [];
   const runs = [];
   for (const filePath of collectRunFiles(runsDir)) {
-    const parsed = RunRecordSchema.safeParse(JSON.parse(fs27.readFileSync(filePath, "utf8")));
+    const parsed = RunRecordSchema.safeParse(JSON.parse(fs28.readFileSync(filePath, "utf8")));
     if (!parsed.success) continue;
     if (filter.stageId && parsed.data.stageId !== filter.stageId) continue;
     runs.push(parsed.data);
@@ -29091,17 +29544,18 @@ function listRuns(repoPath, filter = {}) {
 }
 
 // src/core/slot-preflight.ts
-var path30 = __toESM(require("path"));
+var path31 = __toESM(require("path"));
 
 // src/core/control-port.ts
 var import_child_process4 = require("child_process");
-var fs29 = __toESM(require("fs"));
-var path28 = __toESM(require("path"));
+var fs30 = __toESM(require("fs"));
+var path29 = __toESM(require("path"));
+init_control_config();
 
 // src/core/slot-ports.ts
 var import_child_process3 = require("child_process");
-var fs28 = __toESM(require("fs"));
-var path27 = __toESM(require("path"));
+var fs29 = __toESM(require("fs"));
+var path28 = __toESM(require("path"));
 function portStep(env3) {
   return Number(env3.HARNESS_PORT_STEP ?? 10);
 }
@@ -29157,7 +29611,7 @@ function allocateAppPorts(repoPath, agentId) {
 }
 function harnessUsesPm2(repoPath) {
   const harnessRoot = resolveHarnessRoot(repoPath);
-  return fs28.existsSync(path27.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
+  return fs29.existsSync(path28.join(harnessRoot, ".har", "ecosystem.agent.template.cjs"));
 }
 
 // src/core/control-port.ts
@@ -29212,13 +29666,13 @@ function controlDefaultPortWarnings(containers, defaultFrontendPort, allocatedFr
   return [formatControlDefaultPortWarning(control.name, defaultFrontendPort, allocatedFrontend)];
 }
 function inspectControlUpReadiness(repoPath) {
-  const resolved = path28.resolve(repoPath);
+  const resolved = path29.resolve(repoPath);
   const port = parseControlHostPort();
   const containers = listDockerContainers();
   const control = controlContainerOnPort(containers, port);
   const warnings = [];
-  const controlHarnessDir = path28.join(resolved, "control", ".har");
-  const harnessSlot1Active = fs29.existsSync(controlHarnessDir) && readSlotRegistry(path28.join(resolved, "control"), 1)?.status === "active";
+  const controlHarnessDir = path29.join(resolved, "control", ".har");
+  const harnessSlot1Active = fs30.existsSync(controlHarnessDir) && readSlotRegistry(path29.join(resolved, "control"), 1)?.status === "active";
   if (control) {
     return {
       warnings,
@@ -29249,9 +29703,9 @@ function inspectControlUpReadiness(repoPath) {
 }
 
 // src/core/slot-launch-guard-occupied.ts
-var fs30 = __toESM(require("fs"));
+var fs31 = __toESM(require("fs"));
 var os6 = __toESM(require("os"));
-var path29 = __toESM(require("path"));
+var path30 = __toESM(require("path"));
 var import_child_process5 = require("child_process");
 function runGit(cwd, args) {
   try {
@@ -29270,7 +29724,7 @@ function worktreeDirty(worktreePath) {
 }
 function gitCommonDir2(cwd) {
   const out = runGit(cwd, "rev-parse --git-common-dir");
-  return out ? path29.resolve(cwd, out) : void 0;
+  return out ? path30.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout2(a2, b2) {
   const left2 = gitCommonDir2(a2);
@@ -29279,20 +29733,20 @@ function sameGitCheckout2(a2, b2) {
 }
 function discoverWorktree(harnessRoot, agentId, projectName) {
   const session = readSlotRegistry(harnessRoot, agentId);
-  if (session?.worktreePath && fs30.existsSync(session.worktreePath)) {
+  if (session?.worktreePath && fs31.existsSync(session.worktreePath)) {
     return session.worktreePath;
   }
-  const legacy = path29.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
-  if (fs30.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
-  const worktreesRoot = path29.join(os6.homedir(), "worktrees");
-  if (!fs30.existsSync(worktreesRoot)) return void 0;
+  const legacy = path30.join(os6.homedir(), "worktrees", `${projectName}-agent-${agentId}`);
+  if (fs31.existsSync(legacy) && sameGitCheckout2(harnessRoot, legacy)) return legacy;
+  const worktreesRoot = path30.join(os6.homedir(), "worktrees");
+  if (!fs31.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = runGit(harnessRoot, "rev-parse --show-prefix") ?? "";
-  for (const name of fs30.readdirSync(worktreesRoot)) {
+  for (const name of fs31.readdirSync(worktreesRoot)) {
     if (!name.includes(suffix)) continue;
-    const candidate = path29.join(worktreesRoot, name);
+    const candidate = path30.join(worktreesRoot, name);
     if (!sameGitCheckout2(harnessRoot, candidate)) continue;
-    if (!fs30.existsSync(path29.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
+    if (!fs31.existsSync(path30.join(candidate, relPrefix, `.env.agent.${agentId}`))) continue;
     return candidate;
   }
   return void 0;
@@ -29300,13 +29754,13 @@ function discoverWorktree(harnessRoot, agentId, projectName) {
 function collectOccupiedSlot(repoPath, agentId) {
   const harnessRoot = resolveHarnessRoot(repoPath);
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path29.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path30.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
   const worktreePath = discoverWorktree(harnessRoot, agentId, projectName);
   const workDir = session?.workDir;
-  const envInWorkDir = workDir ? fs30.existsSync(path29.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs30.existsSync(path29.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs30.existsSync(path29.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs31.existsSync(path30.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs31.existsSync(path30.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs31.existsSync(path30.join(worktreePath, `.env.agent.${agentId}`)) : false;
   const active = session !== void 0 && session.status !== "completed" || envInWorkDir || envInRoot || envInWorktree;
   if (!active) return void 0;
   const dirty = worktreePath ? worktreeDirty(worktreePath) : void 0;
@@ -29319,7 +29773,6 @@ function collectOccupiedSlot(repoPath, agentId) {
     sessionStatus: session?.status,
     lastError: session?.lastError,
     sessionCreatedAt: session?.createdAt,
-    purpose: session?.purpose,
     dirty,
     harnessUsage: "none"
   };
@@ -29330,7 +29783,6 @@ function formatOccupiedSlot(slot, resume) {
     slot.worktreePath ? `  Worktree: ${slot.worktreePath}` : void 0,
     slot.branch ? `  Branch:   ${slot.branch}` : void 0,
     slot.workDir ? `  Work dir: ${slot.workDir}` : void 0,
-    slot.purpose ? `  Purpose:  ${slot.purpose}` : void 0,
     slot.sessionStatus ? `  Status:   ${slot.sessionStatus}` : void 0,
     slot.lastError ? `  Error:    ${slot.lastError}` : void 0,
     slot.sessionCreatedAt ? `  Since:    ${slot.sessionCreatedAt}` : void 0,
@@ -29461,7 +29913,7 @@ function checkInfraPort(env3, varName, defaultPort, scanStart, scanEnd) {
 function inspectSlotReadiness(repoPath, agentId, options = {}) {
   const harnessRoot = resolveHarnessRoot(repoPath);
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path30.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path31.basename(harnessRoot);
   const usesPm2 = harnessUsesPm2(repoPath);
   const blockers = [];
   const remediations = [];
@@ -29663,7 +30115,7 @@ function readWorktreeBranch(worktreePath) {
 }
 function gitCommonDir3(cwd) {
   const out = runGit2(cwd, "rev-parse --git-common-dir");
-  return out ? path31.resolve(cwd, out) : void 0;
+  return out ? path32.resolve(cwd, out) : void 0;
 }
 function sameGitCheckout3(a2, b2) {
   const left2 = gitCommonDir3(a2);
@@ -29675,12 +30127,12 @@ function gitPrefix2(cwd) {
   return out ?? "";
 }
 function discoverSessionWorktreePath(harnessRoot, agentId) {
-  const worktreesRoot = path31.join(os7.homedir(), "worktrees");
-  if (!fs31.existsSync(worktreesRoot)) return void 0;
+  const worktreesRoot = path32.join(os7.homedir(), "worktrees");
+  if (!fs32.existsSync(worktreesRoot)) return void 0;
   const suffix = `-har-agent-${agentId}-`;
   const relPrefix = gitPrefix2(harnessRoot);
-  const matches = fs31.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path31.join(worktreesRoot, entry.name)).filter(
-    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs31.existsSync(path31.join(candidate, relPrefix, `.env.agent.${agentId}`))
+  const matches = fs32.readdirSync(worktreesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name.includes(suffix)).map((entry) => path32.join(worktreesRoot, entry.name)).filter(
+    (candidate) => sameGitCheckout3(harnessRoot, candidate) && fs32.existsSync(path32.join(candidate, relPrefix, `.env.agent.${agentId}`))
   );
   return matches.sort()[0];
 }
@@ -29755,18 +30207,18 @@ function detectPm2Issue(projectName, agentId, session, procs) {
 }
 function collectSlotStatus(harnessRoot, agentId, runs, pm2Procs) {
   const env3 = readHarnessEnv(harnessRoot);
-  const projectName = env3.HARNESS_PROJECT_NAME ?? path31.basename(harnessRoot);
+  const projectName = env3.HARNESS_PROJECT_NAME ?? path32.basename(harnessRoot);
   const session = readSlotRegistry(harnessRoot, agentId);
-  const legacyWorktreePath = path31.join(
+  const legacyWorktreePath = path32.join(
     os7.homedir(),
     "worktrees",
     `${projectName}-agent-${agentId}`
   );
-  const worktreePath = session?.worktreePath && fs31.existsSync(session.worktreePath) ? session.worktreePath : fs31.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
+  const worktreePath = session?.worktreePath && fs32.existsSync(session.worktreePath) ? session.worktreePath : fs32.existsSync(legacyWorktreePath) ? legacyWorktreePath : discoverSessionWorktreePath(harnessRoot, agentId);
   const workDir = resolveAgentWorkDir(harnessRoot, agentId);
-  const envInWorkDir = workDir ? fs31.existsSync(path31.join(workDir, `.env.agent.${agentId}`)) : false;
-  const envInRoot = fs31.existsSync(path31.join(harnessRoot, `.env.agent.${agentId}`));
-  const envInWorktree = worktreePath ? fs31.existsSync(path31.join(worktreePath, `.env.agent.${agentId}`)) : false;
+  const envInWorkDir = workDir ? fs32.existsSync(path32.join(workDir, `.env.agent.${agentId}`)) : false;
+  const envInRoot = fs32.existsSync(path32.join(harnessRoot, `.env.agent.${agentId}`));
+  const envInWorktree = worktreePath ? fs32.existsSync(path32.join(worktreePath, `.env.agent.${agentId}`)) : false;
   const active = session !== void 0 && session.status !== "completed" || envInWorkDir || envInRoot || envInWorktree;
   const latest = latestRunForAgent(runs, agentId);
   const verifyRun = runs.find((r2) => r2.agentId === agentId && r2.stageId === "verify");
@@ -29805,7 +30257,6 @@ function collectSlotStatus(harnessRoot, agentId, runs, pm2Procs) {
     baseBranch: session?.baseBranch,
     baseCommit: session?.baseCommit,
     sessionCreatedAt: session?.createdAt,
-    purpose: session?.purpose,
     sessionStatus: session?.status,
     lastError: session?.lastError,
     resumeHint,
@@ -29819,7 +30270,7 @@ function collectEnvironmentStatus(repoPath) {
   const slotIds = getAgentSlotIds(harnessRoot);
   const pm2Procs = listPm2Processes2();
   return {
-    repoPath: path31.resolve(repoPath),
+    repoPath: path32.resolve(repoPath),
     harnessRoot,
     gitRemote: readGitRemote(harnessRoot),
     profile: manifest?.profile,
@@ -29830,13 +30281,13 @@ function collectEnvironmentStatus(repoPath) {
 
 // src/core/validations.ts
 var crypto3 = __toESM(require("crypto"));
-var fs33 = __toESM(require("fs"));
-var path33 = __toESM(require("path"));
+var fs34 = __toESM(require("fs"));
+var path34 = __toESM(require("path"));
 
 // src/core/change-batch.ts
-var fs32 = __toESM(require("fs"));
+var fs33 = __toESM(require("fs"));
 var os8 = __toESM(require("os"));
-var path32 = __toESM(require("path"));
+var path33 = __toESM(require("path"));
 function git(checkoutDir, args, env3) {
   const result = run(`git ${args}`, { cwd: checkoutDir, env: env3 });
   if (result.code !== 0) {
@@ -29844,37 +30295,37 @@ function git(checkoutDir, args, env3) {
   }
   return result.stdout.trim();
 }
-function tryGit(checkoutDir, args) {
+function tryGit2(checkoutDir, args) {
   const result = run(`git ${args}`, { cwd: checkoutDir });
   return result.code === 0 ? result.stdout.trim() : void 0;
 }
 function isCheckoutRoot(checkoutDir) {
-  const toplevel = tryGit(checkoutDir, "rev-parse --show-toplevel");
+  const toplevel = tryGit2(checkoutDir, "rev-parse --show-toplevel");
   if (!toplevel) return false;
   try {
-    return fs32.realpathSync(toplevel) === fs32.realpathSync(checkoutDir);
+    return fs33.realpathSync(toplevel) === fs33.realpathSync(checkoutDir);
   } catch {
     return false;
   }
 }
 function getHeadTree(checkoutDir) {
-  return tryGit(checkoutDir, "rev-parse -q --verify HEAD^{tree}");
+  return tryGit2(checkoutDir, "rev-parse -q --verify HEAD^{tree}");
 }
 function getHeadSha(checkoutDir) {
-  return tryGit(checkoutDir, "rev-parse -q --verify HEAD");
+  return tryGit2(checkoutDir, "rev-parse -q --verify HEAD");
 }
 function getCurrentBranch(checkoutDir) {
-  const branch = tryGit(checkoutDir, "rev-parse --abbrev-ref HEAD");
+  const branch = tryGit2(checkoutDir, "rev-parse --abbrev-ref HEAD");
   return branch && branch !== "HEAD" ? branch : void 0;
 }
 function getEmptyTree(checkoutDir) {
   return git(checkoutDir, "hash-object -t tree /dev/null");
 }
 function isMergeOrRebaseInProgress(checkoutDir) {
-  if (tryGit(checkoutDir, "rev-parse -q --verify MERGE_HEAD") !== void 0) return true;
+  if (tryGit2(checkoutDir, "rev-parse -q --verify MERGE_HEAD") !== void 0) return true;
   for (const dir of ["rebase-merge", "rebase-apply"]) {
-    const gitPath = tryGit(checkoutDir, `rev-parse --git-path ${dir}`);
-    if (gitPath && fs32.existsSync(path32.resolve(checkoutDir, gitPath))) return true;
+    const gitPath = tryGit2(checkoutDir, `rev-parse --git-path ${dir}`);
+    if (gitPath && fs33.existsSync(path33.resolve(checkoutDir, gitPath))) return true;
   }
   return false;
 }
@@ -29897,8 +30348,8 @@ function parseNameStatus(output) {
   return files;
 }
 function computeWorktreeSnapshot(checkoutDir) {
-  const tmpDir = fs32.mkdtempSync(path32.join(os8.tmpdir(), "har-idx-"));
-  const tmpIndex = path32.join(tmpDir, "index");
+  const tmpDir = fs33.mkdtempSync(path33.join(os8.tmpdir(), "har-idx-"));
+  const tmpIndex = path33.join(tmpDir, "index");
   const env3 = { GIT_INDEX_FILE: tmpIndex };
   try {
     const headTree = getHeadTree(checkoutDir);
@@ -29921,35 +30372,35 @@ function computeWorktreeSnapshot(checkoutDir) {
       changedFiles: parseNameStatus(diffOutput)
     };
   } finally {
-    fs32.rmSync(tmpDir, { recursive: true, force: true });
+    fs33.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 
 // src/core/validations.ts
 var VALIDATIONS_DIR = "validations";
 function getValidationsDir(checkoutDir) {
-  return path33.join(checkoutDir, ".har", VALIDATIONS_DIR);
+  return path34.join(checkoutDir, ".har", VALIDATIONS_DIR);
 }
 function validationPath(checkoutDir, treeHash) {
-  return path33.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
+  return path34.join(getValidationsDir(checkoutDir), `${treeHash}.json`);
 }
 function writeRecord(checkoutDir, record2) {
   const dir = getValidationsDir(checkoutDir);
-  fs33.mkdirSync(dir, { recursive: true });
-  fs33.writeFileSync(
+  fs34.mkdirSync(dir, { recursive: true });
+  fs34.writeFileSync(
     validationPath(checkoutDir, record2.treeHash),
     `${JSON.stringify(record2, null, 2)}
 `
   );
 }
 function ensureValidationsIgnored(checkoutDir) {
-  const harDir = path33.join(checkoutDir, ".har");
-  if (!fs33.existsSync(harDir)) return;
-  const gitignorePath = path33.join(harDir, ".gitignore");
-  const content = fs33.existsSync(gitignorePath) ? fs33.readFileSync(gitignorePath, "utf8") : "";
+  const harDir = path34.join(checkoutDir, ".har");
+  if (!fs34.existsSync(harDir)) return;
+  const gitignorePath = path34.join(harDir, ".gitignore");
+  const content = fs34.existsSync(gitignorePath) ? fs34.readFileSync(gitignorePath, "utf8") : "";
   if (content.split("\n").some((line) => line.trim() === `${VALIDATIONS_DIR}/`)) return;
   const suffix = content.length === 0 || content.endsWith("\n") ? "" : "\n";
-  fs33.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
+  fs34.writeFileSync(gitignorePath, `${content}${suffix}${VALIDATIONS_DIR}/
 `);
 }
 function recordValidation(input) {
@@ -29966,8 +30417,8 @@ function recordValidation(input) {
     treeHash: snapshot.treeHash,
     headSha: snapshot.headSha,
     branch: snapshot.branch,
-    workDir: path33.resolve(input.checkoutDir),
-    harnessRoot: path33.resolve(input.harnessRoot),
+    workDir: path34.resolve(input.checkoutDir),
+    harnessRoot: path34.resolve(input.harnessRoot),
     agentId: input.agentId,
     status: input.status,
     full: input.full,
@@ -29979,16 +30430,16 @@ function recordValidation(input) {
     committedAt: existing?.committedAt
   });
   writeRecord(input.checkoutDir, record2);
-  if (path33.resolve(input.harnessRoot) !== path33.resolve(input.checkoutDir)) {
+  if (path34.resolve(input.harnessRoot) !== path34.resolve(input.checkoutDir)) {
     writeRecord(input.harnessRoot, record2);
   }
   return record2;
 }
 function findValidation(checkoutDir, treeHash) {
   const file = validationPath(checkoutDir, treeHash);
-  if (!fs33.existsSync(file)) return void 0;
+  if (!fs34.existsSync(file)) return void 0;
   try {
-    return ValidationRecordSchema.parse(JSON.parse(fs33.readFileSync(file, "utf8")));
+    return ValidationRecordSchema.parse(JSON.parse(fs34.readFileSync(file, "utf8")));
   } catch {
     return void 0;
   }
@@ -30003,19 +30454,19 @@ function attachCommit(checkoutDir, treeHash, commitSha) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   writeRecord(checkoutDir, updated);
-  if (record2.harnessRoot && path33.resolve(record2.harnessRoot) !== path33.resolve(checkoutDir) && fs33.existsSync(path33.join(record2.harnessRoot, ".har"))) {
+  if (record2.harnessRoot && path34.resolve(record2.harnessRoot) !== path34.resolve(checkoutDir) && fs34.existsSync(path34.join(record2.harnessRoot, ".har"))) {
     writeRecord(record2.harnessRoot, updated);
   }
   return updated;
 }
 function listValidations(harnessRoot) {
   const dir = getValidationsDir(harnessRoot);
-  if (!fs33.existsSync(dir)) return [];
+  if (!fs34.existsSync(dir)) return [];
   const records = [];
-  for (const entry of fs33.readdirSync(dir)) {
+  for (const entry of fs34.readdirSync(dir)) {
     if (!entry.endsWith(".json")) continue;
     try {
-      records.push(ValidationRecordSchema.parse(JSON.parse(fs33.readFileSync(path33.join(dir, entry), "utf8"))));
+      records.push(ValidationRecordSchema.parse(JSON.parse(fs34.readFileSync(path34.join(dir, entry), "utf8"))));
     } catch {
     }
   }
@@ -30044,105 +30495,19 @@ function createRemoteExecutor(apiUrl, apiKey) {
   return new RemoteExecutor(url, key);
 }
 
-// src/core/telemetry-config.ts
-var fs34 = __toESM(require("fs"));
-var os9 = __toESM(require("os"));
-var path34 = __toESM(require("path"));
-var DEFAULT_SIGNALS_ON = {
-  metrics: true,
-  logs: true,
-  prompts: false,
-  traces: false
-};
-var DEFAULT_SIGNALS_OFF = {
-  metrics: false,
-  logs: false,
-  prompts: false,
-  traces: false
-};
-function getPreferencePath() {
-  if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
-    return path34.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
-  }
-  return path34.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 normalizeSignals(enabled, raw) {
-  if (!enabled) return { ...DEFAULT_SIGNALS_OFF };
-  return {
-    metrics: raw?.metrics !== false,
-    logs: raw?.logs !== false,
-    prompts: raw?.prompts === true,
-    traces: raw?.traces === true
-  };
-}
-function readTelemetryPreference() {
-  const preferencePath = getPreferencePath();
-  try {
-    if (!fs34.existsSync(preferencePath)) {
-      return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
-    }
-    const parsed = JSON.parse(fs34.readFileSync(preferencePath, "utf8"));
-    const enabled = parsed.enabled !== false;
-    return {
-      enabled,
-      signals: normalizeSignals(enabled, parsed.signals),
-      updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : void 0
-    };
-  } catch {
-    return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
-  }
-}
-function writeTelemetryPreference(enabled, signals) {
-  const current = readTelemetryPreference();
-  const nextSignals = normalizeSignals(enabled, {
-    ...current.signals,
-    ...signals
-  });
-  const preference = {
-    enabled,
-    signals: enabled ? nextSignals : { ...DEFAULT_SIGNALS_OFF },
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  const preferencePath = getPreferencePath();
-  fs34.mkdirSync(path34.dirname(preferencePath), { recursive: true });
-  fs34.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 getTelemetrySignals() {
-  if (!isTelemetryEnabled()) return { ...DEFAULT_SIGNALS_OFF };
-  return readTelemetryPreference().signals;
-}
-function getTelemetryPreferencePath() {
-  return getPreferencePath();
-}
-var TELEMETRY_SIGNALS = [
-  "Metrics (default): tokens and estimated USD cost via OTEL metrics",
-  "Logs/events (default): session events (tool calls, api_request) without prompt bodies",
-  "Prompts (opt-in): user/assistant text via OTEL_LOG_USER_PROMPTS \u2014 har telemetry on --prompts",
-  "Traces (opt-in): thin span ingest when CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1",
-  "Fallback: har control sync harvests local Claude/Codex session files when OTEL is missing"
-];
+// src/core/control-sync.ts
+init_telemetry_config();
 
 // src/core/usage-harvest/claude.ts
-var fs36 = __toESM(require("fs"));
+var fs37 = __toESM(require("fs"));
 var os10 = __toESM(require("os"));
-var path36 = __toESM(require("path"));
+var path37 = __toESM(require("path"));
+init_telemetry_config();
 
 // src/core/telemetry-env.ts
-var fs35 = __toESM(require("fs"));
-var path35 = __toESM(require("path"));
+var fs36 = __toESM(require("fs"));
+var path36 = __toESM(require("path"));
+init_control_config();
 function escapeAttrValue(value) {
   return value.replace(/[,=]/g, "_");
 }
@@ -30155,7 +30520,6 @@ function buildOtelResourceAttributes(attrs) {
   ];
   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) {
@@ -30163,54 +30527,27 @@ function buildSessionKey(input) {
   const stamp = (input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()).replace(/[:.]/g, "-");
   return `agent-${input.agentId}-${input.suffix ?? stamp}`;
 }
-function buildTelemetryEnvBlock(attrs, options) {
+function buildTelemetryEnvBlock(attrs) {
   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)}`
+    `OTEL_RESOURCE_ATTRIBUTES=${buildOtelResourceAttributes(attrs)}`,
+    "# Agent telemetry: opentelemetry-hooks \u2192 Mission Control (har telemetry on|off)"
   ];
-  const injectOtel = isTelemetryEnabled() && options?.otelReady !== false;
-  if (injectOtel) {
-    const signals = getTelemetrySignals();
-    lines.push(
-      "# HAR telemetry \u2192 Mission Control OTLP (disable: har telemetry off)",
-      "CLAUDE_CODE_ENABLE_TELEMETRY=1",
-      "OTEL_EXPORTER_OTLP_PROTOCOL=http/json",
-      `OTEL_EXPORTER_OTLP_ENDPOINT=${apiUrl}/api/otel`
-    );
-    if (signals.metrics) {
-      lines.push("OTEL_METRICS_EXPORTER=otlp");
-    }
-    if (signals.logs) {
-      lines.push("OTEL_LOGS_EXPORTER=otlp");
-    }
-    if (signals.prompts) {
-      lines.push(
-        "OTEL_LOG_USER_PROMPTS=1",
-        "OTEL_LOG_ASSISTANT_RESPONSES=1"
-      );
-    }
-    if (signals.traces) {
-      lines.push(
-        "OTEL_TRACES_EXPORTER=otlp",
-        "CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1"
-      );
-    }
-  }
   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() + `
+function appendTelemetryEnvToFile(envFilePath, attrs) {
+  const block = buildTelemetryEnvBlock(attrs).trimEnd() + `
 ${TELEMETRY_MARKER_END}
 `;
   let existing = "";
-  if (fs35.existsSync(envFilePath)) {
-    existing = fs35.readFileSync(envFilePath, "utf8");
+  if (fs36.existsSync(envFilePath)) {
+    existing = fs36.readFileSync(envFilePath, "utf8");
     const start = existing.indexOf(TELEMETRY_MARKER_START);
     if (start >= 0) {
       const end = existing.indexOf(TELEMETRY_MARKER_END, start);
@@ -30221,44 +30558,28 @@ ${TELEMETRY_MARKER_END}
       }
     }
   }
-  fs35.mkdirSync(path35.dirname(envFilePath), { recursive: true });
+  fs36.mkdirSync(path36.dirname(envFilePath), { recursive: true });
   const combined = (existing.replace(/\n+$/, "\n") + block).replace(/^\n+/, "");
-  fs35.writeFileSync(envFilePath, combined.endsWith("\n") ? combined : combined + "\n");
-}
-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}"
-`;
+  fs36.writeFileSync(envFilePath, combined.endsWith("\n") ? combined : combined + "\n");
 }
 
 // src/core/usage-harvest/claude.ts
 function pathsMatch(candidate, targets) {
-  const norm = path36.resolve(candidate);
+  const norm = path37.resolve(candidate);
   return targets.some((t2) => {
-    const target = path36.resolve(t2);
-    return norm === target || norm.startsWith(target + path36.sep) || target.startsWith(norm + path36.sep);
+    const target = path37.resolve(t2);
+    return norm === target || norm.startsWith(target + path37.sep) || target.startsWith(norm + path37.sep);
   });
 }
 function claudeProjectsRoot() {
-  return process.env.HAR_CLAUDE_PROJECTS_DIR ? path36.resolve(process.env.HAR_CLAUDE_PROJECTS_DIR) : path36.join(os10.homedir(), ".claude", "projects");
+  return process.env.HAR_CLAUDE_PROJECTS_DIR ? path37.resolve(process.env.HAR_CLAUDE_PROJECTS_DIR) : path37.join(os10.homedir(), ".claude", "projects");
 }
 function encodeClaudeProjectDir(cwd) {
   return cwd.replace(/[^a-zA-Z0-9]/g, "-");
 }
 function readJsonlRecords(filePath) {
-  if (!fs36.existsSync(filePath)) return [];
-  const lines = fs36.readFileSync(filePath, "utf8").split(/\r?\n/);
+  if (!fs37.existsSync(filePath)) return [];
+  const lines = fs37.readFileSync(filePath, "utf8").split(/\r?\n/);
   const out = [];
   for (const line of lines) {
     const trimmed = line.trim();
@@ -30301,16 +30622,16 @@ function findMatchingClaudeTranscripts(slot) {
   const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
   if (targets.length === 0) return [];
   const root = claudeProjectsRoot();
-  if (!fs36.existsSync(root)) return [];
+  if (!fs37.existsSync(root)) return [];
   const matches = [];
-  for (const entry of fs36.readdirSync(root, { withFileTypes: true })) {
+  for (const entry of fs37.readdirSync(root, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
-    const projectDir = path36.join(root, entry.name);
+    const projectDir = path37.join(root, entry.name);
     const encodedHit = targets.some((t2) => entry.name.includes(encodeClaudeProjectDir(t2).slice(0, 40)));
-    for (const file of fs36.readdirSync(projectDir)) {
+    for (const file of fs37.readdirSync(projectDir)) {
       if (!file.endsWith(".jsonl")) continue;
-      const filePath = path36.join(projectDir, file);
-      const stat = fs36.statSync(filePath);
+      const filePath = path37.join(projectDir, file);
+      const stat = fs37.statSync(filePath);
       const records = readJsonlRecords(filePath);
       let cwdHit = encodedHit;
       for (const record2 of records) {
@@ -30421,30 +30742,30 @@ function harvestClaudeEvents(slot) {
 }
 
 // src/core/usage-harvest/codex.ts
-var fs37 = __toESM(require("fs"));
+var fs38 = __toESM(require("fs"));
 var os11 = __toESM(require("os"));
-var path37 = __toESM(require("path"));
+var path38 = __toESM(require("path"));
 function pathsMatch2(candidate, targets) {
-  const norm = path37.resolve(candidate);
+  const norm = path38.resolve(candidate);
   return targets.some((t2) => {
-    const target = path37.resolve(t2);
-    return norm === target || norm.startsWith(target + path37.sep) || target.startsWith(norm + path37.sep);
+    const target = path38.resolve(t2);
+    return norm === target || norm.startsWith(target + path38.sep) || target.startsWith(norm + path38.sep);
   });
 }
 function codexSessionsRoot() {
-  return process.env.HAR_CODEX_SESSIONS_DIR ? path37.resolve(process.env.HAR_CODEX_SESSIONS_DIR) : path37.join(os11.homedir(), ".codex", "sessions");
+  return process.env.HAR_CODEX_SESSIONS_DIR ? path38.resolve(process.env.HAR_CODEX_SESSIONS_DIR) : path38.join(os11.homedir(), ".codex", "sessions");
 }
 function walkJsonlFiles(dir, out = []) {
-  if (!fs37.existsSync(dir)) return out;
-  for (const entry of fs37.readdirSync(dir, { withFileTypes: true })) {
-    const full = path37.join(dir, entry.name);
+  if (!fs38.existsSync(dir)) return out;
+  for (const entry of fs38.readdirSync(dir, { withFileTypes: true })) {
+    const full = path38.join(dir, entry.name);
     if (entry.isDirectory()) walkJsonlFiles(full, out);
     else if (entry.isFile() && entry.name.endsWith(".jsonl")) out.push(full);
   }
   return out;
 }
 function readJsonl(filePath) {
-  const lines = fs37.readFileSync(filePath, "utf8").split(/\r?\n/);
+  const lines = fs38.readFileSync(filePath, "utf8").split(/\r?\n/);
   const out = [];
   for (const line of lines) {
     const trimmed = line.trim();
@@ -30508,7 +30829,7 @@ function harvestCodexUsage(slot) {
     const extracted = extractCodexTokens(records);
     if (!extracted.cwd || !pathsMatch2(extracted.cwd, targets)) continue;
     if (extracted.tokensInput + extracted.tokensOutput + extracted.tokensCacheRead === 0) continue;
-    const mtime = fs37.statSync(file).mtimeMs;
+    const mtime = fs38.statSync(file).mtimeMs;
     if (mtime >= bestMtime) {
       bestMtime = mtime;
       best = extracted;
@@ -30578,7 +30899,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((resolve33) => setTimeout(resolve33, intervalMs));
+    await new Promise((resolve35) => setTimeout(resolve35, intervalMs));
   }
   return false;
 }
@@ -30590,7 +30911,7 @@ async function syncAllKnownReposWithControl(options) {
   }
   const repoPaths = new Set(listRegisteredRepos());
   if (options?.cwd) {
-    const cwd = path38.resolve(options.cwd);
+    const cwd = canonicalizeControlRepoPath(options.cwd);
     if (readManifest(cwd)) repoPaths.add(cwd);
   }
   try {
@@ -30598,7 +30919,7 @@ async function syncAllKnownReposWithControl(options) {
     if (listResponse.ok) {
       const repos = await listResponse.json();
       for (const repo of repos) {
-        const resolved = path38.resolve(repo.path);
+        const resolved = canonicalizeControlRepoPath(repo.path);
         if (readManifest(resolved)) repoPaths.add(resolved);
       }
     }
@@ -30617,7 +30938,7 @@ async function syncAllKnownReposWithControl(options) {
   return { synced, failed };
 }
 async function registerRepoWithControl(options) {
-  const repoPath = path38.resolve(options.repoPath);
+  const repoPath = canonicalizeControlRepoPath(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   const manifest = readManifest(repoPath);
   const stagesRegistry = readStageRegistry(repoPath);
@@ -30630,7 +30951,7 @@ async function registerRepoWithControl(options) {
   return postJson(`${apiUrl}/api/repos`, body, options.dryRun);
 }
 async function syncRepoWithControl(options) {
-  const repoPath = path38.resolve(options.repoPath);
+  const repoPath = canonicalizeControlRepoPath(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   if (options.cloud) {
     const remote = createRemoteExecutor();
@@ -30658,7 +30979,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) => path38.resolve(r2.path) === repoPath);
+    const existing = repos.find((r2) => path39.resolve(r2.path) === repoPath);
     if (!existing) throw new Error(`Repo not registered: ${repoPath}`);
     await syncRepoRunsAndSlots(apiUrl, existing.id, repoPath, options.dryRun);
     return;
@@ -30749,7 +31070,12 @@ async function syncRepoWithControlAsync(repoPath) {
       }
       return;
     }
-    await withTimeout(syncRepoWithControl({ repoPath, apiUrl }), SYNC_TIMEOUT_MS, "control sync");
+    const canonical = canonicalizeControlRepoPath(repoPath);
+    await withTimeout(
+      syncRepoWithControl({ repoPath: canonical, apiUrl }),
+      SYNC_TIMEOUT_MS,
+      "control sync"
+    );
   } catch (err) {
     if (verbose) {
       const message = err instanceof Error ? err.message : String(err);
@@ -30775,9 +31101,12 @@ function checkLaunchGuard2(repoPath, agentId, options = {}) {
   return { allowed: true, slot: occupied.slot, readiness };
 }
 
+// src/core/telemetry-ensure.ts
+init_control_config();
+
 // src/core/control-lifecycle.ts
 var import_child_process8 = require("child_process");
-var path39 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 
 // src/core/control-image.ts
 var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
@@ -30795,15 +31124,16 @@ function shouldBuildControlLocally() {
 }
 
 // src/core/control-lifecycle.ts
+init_control_config();
 var CONTROL_CONTAINER_NAME = "har-control";
 var CONTROL_DATA_VOLUME = "har_control_data";
 var CONTROL_CONTAINER_PORT = 3847;
 var CONTROL_DATA_DB_URL = "file:/data/har_control.db";
 function resolveControlDir() {
-  return path39.resolve(__dirname, "..", "control");
+  return path40.resolve(__dirname, "..", "control");
 }
 function resolveControlBuildContext() {
-  return path39.resolve(resolveControlDir(), "..");
+  return path40.resolve(resolveControlDir(), "..");
 }
 function buildDockerRunArgs(options) {
   const name = options.containerName ?? CONTROL_CONTAINER_NAME;
@@ -30859,7 +31189,7 @@ async function startMissionControl(options) {
       "-t",
       imageRef,
       "-f",
-      path39.join(resolveControlDir(), "Dockerfile"),
+      path40.join(resolveControlDir(), "Dockerfile"),
       resolveControlBuildContext()
     ]);
     if (buildCode !== 0) {
@@ -30903,6 +31233,7 @@ async function startControlAndSync(options) {
 }
 
 // src/core/telemetry-ensure.ts
+init_telemetry_config();
 async function ensureTelemetryInfrastructure(options) {
   const apiUrl = getControlApiUrl();
   const telemetryEnabled = isTelemetryEnabled();
@@ -31001,7 +31332,8 @@ async function ensureTelemetryInfrastructure(options) {
 }
 
 // src/core/run-service.ts
-var path40 = __toESM(require("path"));
+init_telemetry_config();
+var path42 = __toESM(require("path"));
 function extractShellOutput(result) {
   const stdout = result.logs?.find((log) => log.stream === "stdout")?.content ?? result.logs?.find((log) => !log.stream)?.content ?? "";
   const stderr = result.logs?.find((log) => log.stream === "stderr")?.content ?? "";
@@ -31117,23 +31449,31 @@ var RunService = class {
           worktreePath: slot.worktreePath,
           branch: slot.branch,
           dirty: slot.dirty,
-          sessionCreatedAt: slot.sessionCreatedAt,
-          purpose: slot.purpose
+          sessionCreatedAt: slot.sessionCreatedAt
         } : 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
+Usage from Cursor / Claude / Codex (opentelemetry-hooks) will appear under Worktrees. Disable: har telemetry off
 `;
       }
       if (ensured.warning) {
         telemetryBanner += `${ensured.warning}
+`;
+      }
+      try {
+        const { ensureOtelHooks: ensureOtelHooks2 } = await Promise.resolve().then(() => (init_otel_hooks(), otel_hooks_exports));
+        const hooks = ensureOtelHooks2({ setupAgents: true });
+        if (hooks.message) telemetryBanner += `${hooks.message}
+`;
+        if (hooks.warning) telemetryBanner += `${hooks.warning}
+`;
+      } catch (err) {
+        telemetryBanner += `opentelemetry-hooks setup skipped: ${err instanceof Error ? err.message : String(err)}
 `;
       }
     }
@@ -31147,8 +31487,7 @@ Usage from Claude Code / Codex will appear under Worktrees. Disable: har telemet
         claude: options.claude,
         confirmReplace: options.confirmReplace,
         force: options.force,
-        resume: options.resume,
-        purpose: options.purpose
+        resume: options.resume
       },
       trigger: "cli"
     });
@@ -31167,21 +31506,16 @@ Usage from Claude Code / Codex will appear under Worktrees. Disable: har telemet
           suffix: session.suffix,
           createdAt: session.createdAt
         });
-        const envFile = path40.join(session.workDir, `.env.agent.${options.agentId}`);
+        const envFile = path42.join(session.workDir, `.env.agent.${options.agentId}`);
         try {
-          appendTelemetryEnvToFile(
-            envFile,
-            {
-              sessionKey,
-              agentId: options.agentId,
-              repoPath: path40.resolve(options.repoPath),
-              workDir: session.workDir,
-              branch: session.branch,
-              suffix: session.suffix,
-              purpose: session.purpose
-            },
-            { otelReady: otelReady && isTelemetryEnabled() }
-          );
+          appendTelemetryEnvToFile(envFile, {
+            sessionKey,
+            agentId: options.agentId,
+            repoPath: path42.resolve(options.repoPath),
+            workDir: session.workDir,
+            branch: session.branch,
+            suffix: session.suffix
+          });
         } catch {
         }
       }
@@ -31467,9 +31801,6 @@ var envCommand = {
       type: "boolean",
       default: false,
       describe: "Resume a failed or partial launch without creating a new worktree"
-    }).option("purpose", {
-      type: "string",
-      describe: "Optional session label stored in the slot registry (shown in status and occupied-slot warnings)"
     }),
     handleLaunch
   ).command(
@@ -31543,7 +31874,7 @@ var envCommand = {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   header("har env init");
   info(`Repository: ${repoPath}`);
   try {
@@ -31601,7 +31932,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
   try {
@@ -31699,7 +32030,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path41.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path43.join(repoPath, "AGENT.md"), proposal.content);
       clearAgentMdProposal(repoPath);
       info("Applied AGENT.md proposal (--yes)");
     }
@@ -31708,7 +32039,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   await promptApplyAgentMdProposal(repoPath);
 }
 async function handleAddStage(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   const available = listStageTemplateIds();
   if (argv.list) {
     for (const id of available) {
@@ -31785,7 +32116,7 @@ async function handleAddStage(argv) {
   }
 }
 async function handlePreflight(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -31803,7 +32134,7 @@ async function handlePreflight(argv) {
   process.exit(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   let confirmReplace = argv.replace;
   let force = argv.force;
@@ -31815,8 +32146,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((resolve33) => {
-          rl.question("Replace this slot? [y/N] ", resolve33);
+        const answer = await new Promise((resolve35) => {
+          rl.question("Replace this slot? [y/N] ", resolve35);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -31832,8 +32163,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((resolve33) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve33);
+        const answer = await new Promise((resolve35) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve35);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -31855,7 +32186,6 @@ async function handleLaunch(argv) {
     confirmReplace,
     force,
     resume: argv.resume,
-    purpose: argv.purpose,
     capture: false
   });
   if (result.blocked) {
@@ -31888,7 +32218,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -31900,7 +32230,7 @@ async function handleVerify(argv) {
   process.exit(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -31911,7 +32241,7 @@ async function handleTeardown(argv) {
   process.exit(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path43.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -31932,7 +32262,7 @@ async function handleComplete(argv) {
   process.exit(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -31945,7 +32275,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   const runs = listRuns(repoPath, { stageId: argv.stage, limit: argv.limit });
   if (argv.json) {
     process.stdout.write(JSON.stringify({ runs }, null, 2) + "\n");
@@ -31962,7 +32292,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path41.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path43.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     process.exit(1);
@@ -32041,7 +32371,8 @@ function printNextSteps(auto2) {
 }
 
 // src/cli/commands/control.ts
-var path42 = __toESM(require("path"));
+var path44 = __toESM(require("path"));
+init_control_config();
 var controlCommand = {
   command: "control <subcommand>",
   describe: "Mission Control dashboard (local)",
@@ -32144,7 +32475,7 @@ async function handleDown() {
   process.exit(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path44.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -32164,7 +32495,7 @@ async function handleRegister(argv) {
   }
 }
 async function handleSync(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path44.resolve(argv.repo);
   try {
     await syncRepoWithControl({
       repoPath,
@@ -32203,7 +32534,7 @@ async function handleWatch(argv) {
   };
   const tick = async () => {
     if (argv.repo) {
-      await syncOne(path42.resolve(argv.repo));
+      await syncOne(path44.resolve(argv.repo));
       return;
     }
     try {
@@ -32234,12 +32565,12 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path45 = __toESM(require("path"));
+var path47 = __toESM(require("path"));
 
 // src/core/hooks.ts
-var fs38 = __toESM(require("fs"));
-var os12 = __toESM(require("os"));
-var path43 = __toESM(require("path"));
+var fs40 = __toESM(require("fs"));
+var os13 = __toESM(require("os"));
+var path45 = __toESM(require("path"));
 var MARKER_START = "# >>> har commit gate (managed by `har hooks`) >>>";
 var MARKER_END = "# <<< har commit gate <<<";
 var PRE_COMMIT_BLOCK = [
@@ -32254,27 +32585,27 @@ var POST_COMMIT_BLOCK = [
   '"$(git rev-parse --git-path hooks)/har-post-commit" || true',
   MARKER_END
 ].join("\n");
-function tryGit2(cwd, args) {
+function tryGit3(cwd, args) {
   const result = run(`git ${args}`, { cwd });
   return result.code === 0 ? result.stdout.trim() : void 0;
 }
 function resolveCheckoutRoot(cwd) {
-  return tryGit2(cwd, "rev-parse --show-toplevel");
+  return tryGit3(cwd, "rev-parse --show-toplevel");
 }
 function resolveHooksDir(checkoutDir) {
-  const hooksPath = tryGit2(checkoutDir, "rev-parse --git-path hooks");
+  const hooksPath = tryGit3(checkoutDir, "rev-parse --git-path hooks");
   if (!hooksPath) throw new Error(`Not a git checkout: ${checkoutDir}`);
-  return path43.resolve(checkoutDir, hooksPath);
+  return path45.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
-  return tryGit2(checkoutDir, "config core.hooksPath") || void 0;
+  return tryGit3(checkoutDir, "config core.hooksPath") || void 0;
 }
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path43.resolve(entry)}"`;
+    return `"${process.execPath}" "${path45.resolve(entry)}"`;
   }
-  if (entry) return `"${path43.resolve(entry)}"`;
+  if (entry) return `"${path45.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -32295,40 +32626,40 @@ exit 0
 `;
 }
 function upsertMarkedBlock(filePath, block) {
-  if (!fs38.existsSync(filePath)) {
-    fs38.writeFileSync(filePath, `#!/bin/sh
+  if (!fs40.existsSync(filePath)) {
+    fs40.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs38.readFileSync(filePath, "utf8");
+  const content = fs40.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
       `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
     );
-    fs38.writeFileSync(filePath, content.replace(pattern, block));
-    fs38.chmodSync(filePath, 493);
+    fs40.writeFileSync(filePath, content.replace(pattern, block));
+    fs40.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs38.writeFileSync(filePath, `${content}${suffix}
+  fs40.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs38.chmodSync(filePath, 493);
+  fs40.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs38.existsSync(filePath)) return false;
-  const content = fs38.readFileSync(filePath, "utf8");
+  if (!fs40.existsSync(filePath)) return false;
+  const content = fs40.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() === "") {
-    fs38.rmSync(filePath);
+    fs40.rmSync(filePath);
   } else {
-    fs38.writeFileSync(filePath, stripped);
+    fs40.writeFileSync(filePath, stripped);
   }
   return true;
 }
@@ -32350,20 +32681,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs38.mkdirSync(hooksDir, { recursive: true });
+  fs40.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs38.writeFileSync(
-    path43.join(hooksDir, "har-pre-commit"),
+  fs40.writeFileSync(
+    path45.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs38.writeFileSync(
-    path43.join(hooksDir, "har-post-commit"),
+  fs40.writeFileSync(
+    path45.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path43.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path43.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock(path45.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock(path45.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -32372,12 +32703,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path43.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path43.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path45.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path45.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path43.join(hooksDir, file);
-    if (fs38.existsSync(full)) {
-      fs38.rmSync(full);
+    const full = path45.join(hooksDir, file);
+    if (fs40.existsSync(full)) {
+      fs40.rmSync(full);
       removed = true;
     }
   }
@@ -32394,9 +32725,9 @@ function getCommitGateConfig(checkoutDir) {
 function isAgentWorktree(checkoutDir) {
   const branch = getCurrentBranch(checkoutDir);
   if (branch && /^har-agent-\d+$/.test(branch)) return true;
-  const worktreesRoot = path43.join(os12.homedir(), "worktrees");
-  const resolved = path43.resolve(checkoutDir);
-  return resolved.startsWith(`${worktreesRoot}${path43.sep}`) && /-agent-\d+$/.test(path43.basename(resolved));
+  const worktreesRoot = path45.join(os13.homedir(), "worktrees");
+  const resolved = path45.resolve(checkoutDir);
+  return resolved.startsWith(`${worktreesRoot}${path45.sep}`) && /-agent-\d+$/.test(path45.basename(resolved));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -32409,15 +32740,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path43.join(hooksDir, name);
-    return fs38.existsSync(file) && fs38.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path45.join(hooksDir, name);
+    return fs40.existsSync(file) && fs40.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs38.existsSync(path43.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs38.existsSync(path43.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs40.existsSync(path45.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs40.existsSync(path45.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -32428,7 +32759,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs38.existsSync(path43.join(checkout, ".har", "stages.json"))) {
+  if (!fs40.existsSync(path45.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -32485,7 +32816,7 @@ async function recordCommitAssociation(cwd) {
     const checkout = resolveCheckoutRoot(cwd);
     if (!checkout) return { attached: false };
     const commitSha = getHeadSha(checkout);
-    const tree = tryGit2(checkout, "rev-parse HEAD^{tree}");
+    const tree = tryGit3(checkout, "rev-parse HEAD^{tree}");
     if (!commitSha || !tree) return { attached: false };
     const updated = attachCommit(checkout, tree, commitSha);
     if (updated) {
@@ -32499,8 +32830,8 @@ async function recordCommitAssociation(cwd) {
 }
 
 // src/core/claude-hooks.ts
-var fs39 = __toESM(require("fs"));
-var path44 = __toESM(require("path"));
+var fs41 = __toESM(require("fs"));
+var path46 = __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";
@@ -32511,8 +32842,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs39.existsSync(settingsPath)) return {};
-  const raw = fs39.readFileSync(settingsPath, "utf8").trim();
+  if (!fs41.existsSync(settingsPath)) return {};
+  const raw = fs41.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -32521,19 +32852,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs39.mkdirSync(path44.dirname(settingsPath), { recursive: true });
-  fs39.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs41.mkdirSync(path46.dirname(settingsPath), { recursive: true });
+  fs41.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 = path44.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs39.mkdirSync(path44.dirname(guardScript), { recursive: true });
-  fs39.copyFileSync(templatePath, guardScript);
-  fs39.chmodSync(guardScript, 493);
-  const settingsPath = path44.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path46.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs41.mkdirSync(path46.dirname(guardScript), { recursive: true });
+  fs41.copyFileSync(templatePath, guardScript);
+  fs41.chmodSync(guardScript, 493);
+  const settingsPath = path46.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -32547,15 +32878,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path44.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs39.existsSync(guardScript)) {
-    fs39.rmSync(guardScript);
+  const guardScript = path46.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs41.existsSync(guardScript)) {
+    fs41.rmSync(guardScript);
     removed = true;
-    const parent = path44.dirname(guardScript);
-    if (fs39.existsSync(parent) && fs39.readdirSync(parent).length === 0) fs39.rmdirSync(parent);
+    const parent = path46.dirname(guardScript);
+    if (fs41.existsSync(parent) && fs41.readdirSync(parent).length === 0) fs41.rmdirSync(parent);
   }
-  const settingsPath = path44.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs39.existsSync(settingsPath)) {
+  const settingsPath = path46.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs41.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -32580,8 +32911,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path44.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs39.existsSync(settingsPath)) return false;
+  const settingsPath = path46.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs41.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -32597,7 +32928,7 @@ function repoOption(y2) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path45.resolve(argv.repo));
+      const result2 = installClaudeGuard(path47.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -32605,7 +32936,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path45.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path47.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.");
@@ -32618,7 +32949,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path45.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path47.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -32626,7 +32957,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path45.resolve(argv.repo));
+    const result = uninstallHooks(path47.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -32639,7 +32970,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path45.resolve(argv.repo));
+    const status = getHooksStatus(path47.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -32657,7 +32988,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path45.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path47.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -32918,10 +33249,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path48) {
-  if (!path48)
+function getElementAtPath(obj, path50) {
+  if (!path50)
     return obj;
-  return path48.reduce((acc, key) => acc?.[key], obj);
+  return path50.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -33241,11 +33572,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path48, issues) {
+function prefixIssues(path50, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path48);
+    iss.path.unshift(path50);
     return iss;
   });
 }
@@ -38568,7 +38899,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve33) => setTimeout(resolve33, pollInterval));
+        await new Promise((resolve35) => setTimeout(resolve35, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -38585,7 +38916,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve35, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -38663,7 +38994,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve33(parseResult.data);
+            resolve35(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -38924,12 +39255,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve35, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve33, interval);
+      const timeoutId = setTimeout(resolve35, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -39719,7 +40050,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path46 = __toESM(require("path"));
+var path48 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process2 = __toESM(require("node:process"), 1);
@@ -39802,12 +40133,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve33) => {
+    return new Promise((resolve35) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve33();
+        resolve35();
       } else {
-        this._stdout.once("drain", resolve33);
+        this._stdout.once("drain", resolve35);
       }
     });
   }
@@ -39890,10 +40221,7 @@ var LaunchEnvironmentInputSchema = external_exports.object({
   force: external_exports.boolean().default(false).describe(
     "Discard uncommitted changes in a dirty occupied worktree. Requires confirmReplace=true and explicit user approval \u2014 never set autonomously."
   ),
-  resume: external_exports.boolean().default(false).describe("Resume a failed or partial launch without creating a new worktree."),
-  purpose: external_exports.string().optional().describe(
-    "Optional session label stored in the slot registry (shown in status and occupied-slot warnings)."
-  )
+  resume: external_exports.boolean().default(false).describe("Resume a failed or partial launch without creating a new worktree.")
 });
 var LaunchEnvironmentOutputSchema = ShellRunOutputSchema.extend({
   previewUrls: external_exports.record(external_exports.string()).optional(),
@@ -39907,8 +40235,7 @@ var LaunchEnvironmentOutputSchema = ShellRunOutputSchema.extend({
     worktreePath: external_exports.string().optional(),
     branch: external_exports.string().optional(),
     dirty: external_exports.boolean().optional(),
-    sessionCreatedAt: external_exports.string().optional(),
-    purpose: external_exports.string().optional()
+    sessionCreatedAt: external_exports.string().optional()
   }).optional()
 });
 var PreflightEnvironmentInputSchema = external_exports.object({
@@ -40033,10 +40360,6 @@ var HAR_MCP_TOOLS = [
         resume: {
           type: "boolean",
           description: "Resume a failed or partial launch (status failed/starting) without --replace. Preserves worktree and env."
-        },
-        purpose: {
-          type: "string",
-          description: "Optional session label stored in the slot registry (shown in status and occupied-slot warnings)."
         }
       },
       ["agentId"]
@@ -40220,7 +40543,6 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
         confirmReplace: input.confirmReplace,
         force: input.force,
         resume: input.resume,
-        purpose: input.purpose,
         capture: true
       });
       const parsed = LaunchEnvironmentOutputSchema.parse(result);
@@ -40360,7 +40682,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path46.resolve(input.repo)
+        cwd: path48.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -40423,8 +40745,10 @@ var mcpCommand = {
 };
 
 // src/cli/commands/telemetry.ts
-var fs40 = __toESM(require("fs"));
-var path47 = __toESM(require("path"));
+var path49 = __toESM(require("path"));
+init_control_config();
+init_otel_hooks();
+init_telemetry_config();
 function printSignals() {
   info("Collected when enabled (local Mission Control only):");
   for (const signal of TELEMETRY_SIGNALS) {
@@ -40448,6 +40772,8 @@ async function handleStatus3(argv) {
     controlApiUrl: apiUrl,
     controlReachable: reachable,
     otelEndpoint: `${apiUrl.replace(/\/$/, "")}/api/otel`,
+    otelHooksHome: getOtelHooksHome(),
+    otelHooksConfig: getOtelHooksConfigPath(),
     signalDescriptions: [...TELEMETRY_SIGNALS]
   };
   if (argv.json) {
@@ -40463,25 +40789,29 @@ async function handleStatus3(argv) {
   );
   info(`Mission Control: ${apiUrl} (${reachable ? "reachable" : "not reachable"})`);
   info(`OTLP endpoint: ${payload.otelEndpoint}`);
+  info(`Hooks home:    ${payload.otelHooksHome}`);
   printSignals();
 }
 async function handleOn(argv) {
   header("har telemetry on");
   const preference = writeTelemetryPreference(true, {
     prompts: argv.prompts === true ? true : void 0,
-    traces: argv.traces === true ? true : void 0
+    traces: true
   });
-  success("Telemetry enabled (opt-out). Agent usage will be stored in local Mission Control.");
+  success("Telemetry enabled. Cursor / Claude / Codex export via opentelemetry-hooks \u2192 Mission Control.");
   info(
     `Signals: metrics=${preference.signals.metrics} logs=${preference.signals.logs} prompts=${preference.signals.prompts} traces=${preference.signals.traces}`
   );
   if (preference.signals.prompts) {
-    warn("Prompt/response text will leave the agent machine for local Mission Control storage.");
+    warn("Prompt text will leave the agent machine for local Mission Control (also used as session purpose).");
   }
   printSignals();
   const result = await ensureTelemetryInfrastructure({ startIfNeeded: true });
   if (result.message) success(result.message);
   if (result.warning) warn(result.warning);
+  const hooks = ensureOtelHooks({ setupAgents: true });
+  if (hooks.message) success(hooks.message);
+  if (hooks.warning) warn(hooks.warning);
   if (result.otelReady) {
     info(`OTLP ingest: ${result.apiUrl.replace(/\/$/, "")}/api/otel`);
     info("Usage appears under Mission Control \u2192 Worktrees / Usage. Disable: har telemetry off");
@@ -40490,44 +40820,48 @@ async function handleOn(argv) {
 async function handleOff() {
   header("har telemetry off");
   writeTelemetryPreference(false);
+  try {
+    disableOtelHooksExport();
+  } catch (err) {
+    warn(`Could not refresh hooks config: ${err instanceof Error ? err.message : String(err)}`);
+  }
   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.");
+  info("Hooks stay registered but OTLP export is cleared in ~/.har/otel-hooks/otel_config.json.");
+  info("Mission Control will not auto-start. Existing usage rows are kept.");
 }
 async function handleWriteEnv(argv) {
-  const repoPath = path47.resolve(argv.repo);
+  const repoPath = path49.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 ?? path47.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 envFile = argv.envFile ?? path49.join(workDir, `.env.agent.${argv.agentId}`);
   const attrs = {
     sessionKey,
     agentId: argv.agentId,
     repoPath,
     workDir,
     branch,
-    suffix,
-    purpose
+    suffix
   };
-  appendTelemetryEnvToFile(envFile, attrs, { otelReady: otelReady !== false && isTelemetryEnabled() });
-  success(`Wrote telemetry env to ${envFile}`);
+  appendTelemetryEnvToFile(envFile, attrs);
+  if (isTelemetryEnabled()) {
+    ensureOtelHooks({
+      setupAgents: false,
+      resourceAttributes: buildOtelResourceAttributes(attrs)
+    });
+  }
+  success(`Wrote session attribution to ${envFile}`);
 }
 function handlePrintEnv(argv) {
-  const repoPath = path47.resolve(argv.repo);
+  const repoPath = path49.resolve(argv.repo);
   const workDir = argv.workDir ?? repoPath;
   const sessionKey = buildSessionKey({
     branch: argv.branch,
@@ -40535,55 +40869,38 @@ function handlePrintEnv(argv) {
     suffix: argv.suffix
   });
   process.stdout.write(
-    buildTelemetryEnvBlock(
-      {
-        sessionKey,
-        agentId: argv.agentId,
-        repoPath,
-        workDir,
-        branch: argv.branch,
-        suffix: argv.suffix
-      },
-      { otelReady: argv.otelReady && isTelemetryEnabled() }
-    )
+    buildTelemetryEnvBlock({
+      sessionKey,
+      agentId: argv.agentId,
+      repoPath,
+      workDir,
+      branch: argv.branch,
+      suffix: argv.suffix
+    })
   );
 }
-function handleCodexSnippet(argv) {
-  const repoPath = path47.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 = path47.join(harnessRoot, ".har", "telemetry");
-    fs40.mkdirSync(outDir, { recursive: true });
-    const outPath = path47.join(outDir, "codex.otel.toml.snippet");
-    fs40.writeFileSync(outPath, snippet);
-    success(`Wrote ${outPath}`);
-    info("Merge the [otel] table into ~/.codex/config.toml manually.");
-    return;
+async function handleInstallHooks() {
+  header("har telemetry install-hooks");
+  if (!isTelemetryEnabled()) {
+    warn("Telemetry is off \u2014 enabling preference so hooks can export.");
+    writeTelemetryPreference(true, { traces: true });
+  }
+  const result = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+  if (result.message) success(result.message);
+  if (result.warning) warn(result.warning);
+  const hooks = ensureOtelHooks({ setupAgents: true });
+  if (hooks.ok) {
+    success(hooks.message ?? "opentelemetry-hooks installed and agents registered");
+    info(`Config: ${hooks.configPath}`);
+    info(`Wrapper: ${hooks.wrapperPath}`);
+  } else {
+    error(hooks.warning ?? "Failed to install opentelemetry-hooks");
+    process.exitCode = 1;
   }
-  process.stdout.write(snippet);
 }
 var telemetryCommand = {
   command: "telemetry <subcommand>",
-  describe: "Agent usage telemetry (Claude Code / Codex \u2192 Mission Control)",
+  describe: "Agent usage telemetry (Cursor / Claude / Codex via opentelemetry-hooks \u2192 Mission Control)",
   builder: (yargs) => yargs.command(
     "status",
     "Show telemetry preference and Mission Control reachability",
@@ -40593,34 +40910,40 @@ var telemetryCommand = {
     }
   ).command(
     "on",
-    "Enable telemetry (default) and ensure Mission Control is running",
+    "Enable telemetry, ensure Mission Control, install/configure opentelemetry-hooks",
     (y2) => y2.option("prompts", {
       type: "boolean",
       default: false,
-      describe: "Opt in to shipping user/assistant prompt text to Mission Control"
-    }).option("traces", {
-      type: "boolean",
-      default: false,
-      describe: "Opt in to thin OTEL traces ingest (Claude beta)"
+      describe: "Opt in to shipping user prompt text (also fills Mission Control purpose)"
     }),
     (argv) => {
       void handleOn({
-        prompts: argv.prompts,
-        traces: argv.traces
+        prompts: argv.prompts
       });
     }
   ).command(
     "off",
-    "Disable telemetry (no OTEL injection, no MC auto-start)",
+    "Disable telemetry (clear hooks OTLP endpoint, no MC auto-start)",
     () => {
     },
     () => {
       void handleOff();
     }
+  ).command(
+    "install-hooks",
+    "Install opentelemetry-hooks and register Cursor / Claude / Codex",
+    () => {
+    },
+    () => {
+      void handleInstallHooks().catch((err) => {
+        error(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+      });
+    }
   ).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" }),
+    "Append HAR session attribution to .env.agent.<id> and refresh hooks config",
+    (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("session-key", { type: "string" }),
     (argv) => handleWriteEnv({
       agentId: argv["agent-id"],
       repo: argv.repo,
@@ -40628,42 +40951,23 @@ var telemetryCommand = {
       workDir: argv["work-dir"],
       branch: argv.branch,
       suffix: argv.suffix,
-      purpose: argv.purpose,
-      sessionKey: argv["session-key"],
-      otelReady: argv["otel-ready"]
+      sessionKey: argv["session-key"]
     }).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 }),
+    "Print session attribution 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" }),
     (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
+      suffix: argv.suffix
     })
-  ).demandCommand(1, "Please specify a subcommand: status, on, off, write-env, print-env, codex-snippet"),
+  ).demandCommand(1, "Please specify a subcommand: status, on, off, install-hooks, write-env, print-env"),
   handler: () => {
   }
 };