@harness-engineering/cli 1.24.0 → 1.24.1

package/dist/{chunk-46PEKT5G.js → chunk-ZKVLBOYA.js}

@@ -13,10 +13,10 @@ import {
 } from "./chunk-I4QR3HNH.js";
 import {
   runPersona
-} from "./chunk-DSB6O257.js";
+} from "./chunk-GISMXMVL.js";
 import {
   executeSkill
-} from "./chunk-LASBAGC6.js";
+} from "./chunk-UQEUYRBP.js";
 import {
   ALLOWED_PERSONA_COMMANDS
 } from "./chunk-TEFCFC4H.js";
@@ -25,7 +25,7 @@ import {
   OutputMode,
   createCheckPhaseGateCommand,
   findFiles
-} from "./chunk-LRX6J7IA.js";
+} from "./chunk-W2OZK3KC.js";
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
@@ -44,6 +44,7 @@ import {
   appendFrameworkAgents,
   captureHealthSnapshot,
   createGenerateSlashCommandsCommand,
+  ensureHarnessGitignore,
   generateSlashCommands,
   handleGetImpact,
   handleOrphanDeletion,
@@ -52,11 +53,11 @@ import {
   loadOrRebuildIndex,
   persistToolingConfig,
   recommend
-} from "./chunk-BH6GUAUS.js";
+} from "./chunk-LY3YVKXL.js";
 import {
   findConfigFile,
   resolveConfig
-} from "./chunk-ZOIGL5PP.js";
+} from "./chunk-AVVJ5EUU.js";
 import {
   VALID_PLATFORMS
 } from "./chunk-3ISINLYT.js";
@@ -70,7 +71,7 @@ import {
 } from "./chunk-6B6UN6SG.js";
 import {
   loadGraphStore
-} from "./chunk-7QYO5UWW.js";
+} from "./chunk-TDLOFNNQ.js";
 import {
   CLI_VERSION
 } from "./chunk-BM3PWGXQ.js";
@@ -108,6 +109,7 @@ import {
   diff,
   extractBundle,
   generateSuggestions,
+  getOrCreateInstallId,
   listStreams,
   listTaintedSessions,
   loadState,
@@ -118,10 +120,12 @@ import {
   parseManifest,
   parseSecurityConfig,
   pruneLearnings,
+  readIdentity,
   readLockfile,
   removeContributions,
   removeProvenance,
   requestPeerReview,
+  resolveConsent,
   resolveStreamPath,
   runAll,
   runCIChecks,
@@ -133,20 +137,20 @@ import {
   validateKnowledgeMap,
   writeConfig,
   writeLockfile
-} from "./chunk-WPFFEDTO.js";
+} from "./chunk-PCWYYFBP.js";
 import {
   Err,
   Ok
 } from "./chunk-5LMZA5LZ.js";
 import {
   createCreateSkillCommand
-} from "./chunk-ICPZNX6O.js";
+} from "./chunk-XNEMDKV5.js";
 import {
   logger
 } from "./chunk-EBJQ6N4M.js";
 import {
   SkillMetadataSchema
-} from "./chunk-BKHS7RPB.js";
+} from "./chunk-ZOVATVQC.js";
 import {
   CLIError,
   ExitCode,
@@ -154,7 +158,7 @@ import {
 } from "./chunk-3WGJMBKH.js";
 
 // src/index.ts
-import { Command as Command75 } from "commander";
+import { Command as Command80 } from "commander";
 
 // src/commands/add.ts
 import { Command } from "commander";
@@ -244,7 +248,7 @@ function addDoc(name, cwd, configResult, created) {
   return Ok(void 0);
 }
 async function addSkill(name, cwd, created) {
-  const { generateSkillFiles: generateSkillFiles2 } = await import("./create-skill-LTLAAJPC.js");
+  const { generateSkillFiles: generateSkillFiles2 } = await import("./create-skill-QCXINA5Q.js");
   generateSkillFiles2({
     name,
     description: `${name} skill`,
@@ -324,11 +328,164 @@ function createAddCommand() {
   return command;
 }
 
+// src/commands/adoption.ts
+import { Command as Command2 } from "commander";
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+  return `${(ms / 6e4).toFixed(1)}m`;
+}
+function formatRate(rate) {
+  return `${(rate * 100).toFixed(0)}%`;
+}
+function padRight(str, len) {
+  return str.length >= len ? str : str + " ".repeat(len - str.length);
+}
+function registerSkillsCommand(adoption) {
+  adoption.command("skills").description("Show top skills by invocation count").option("--limit <n>", "Number of skills to show (default: 20)", "20").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const limit = Math.max(parseInt(opts.limit, 10) || 20, 1);
+    const cwd = process.cwd();
+    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-TZQUURSP.js");
+    const records = readAdoptionRecords(cwd);
+    if (records.length === 0) {
+      if (globalOpts.json) {
+        console.log(JSON.stringify([]));
+      } else {
+        logger.info("No adoption data found. Skills will be tracked after your next session.");
+      }
+      return;
+    }
+    const summaries = aggregateBySkill(records).slice(0, limit);
+    if (globalOpts.json) {
+      console.log(JSON.stringify(summaries, null, 2));
+      return;
+    }
+    const header = "Skill                              | Invocations | Success | Avg Duration | Last Used";
+    const divider = "-----------------------------------|-------------|---------|--------------|----------";
+    console.log(header);
+    console.log(divider);
+    for (const s of summaries) {
+      const name = padRight(s.skill, 35);
+      const count = padRight(String(s.invocations), 11);
+      const rate = padRight(formatRate(s.successRate), 7);
+      const dur = padRight(formatDuration(s.avgDuration), 12);
+      const last = s.lastUsed.slice(0, 10);
+      console.log(`${name} | ${count} | ${rate} | ${dur} | ${last}`);
+    }
+    console.log(`
+Total: ${records.length} invocations across ${summaries.length} skill(s)`);
+  });
+}
+function registerRecentCommand(adoption) {
+  adoption.command("recent").description("Show recent skill invocations").option("--limit <n>", "Number of invocations to show (default: 20)", "20").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const limit = Math.max(parseInt(opts.limit, 10) || 20, 1);
+    const cwd = process.cwd();
+    const { readAdoptionRecords } = await import("./dist-TZQUURSP.js");
+    const records = readAdoptionRecords(cwd);
+    if (records.length === 0) {
+      if (globalOpts.json) {
+        console.log(JSON.stringify([]));
+      } else {
+        logger.info("No adoption data found. Skills will be tracked after your next session.");
+      }
+      return;
+    }
+    const sorted = [...records].sort(
+      (a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime()
+    );
+    const limited = sorted.slice(0, limit);
+    if (globalOpts.json) {
+      console.log(JSON.stringify(limited, null, 2));
+      return;
+    }
+    const header = "Date       | Skill                              | Outcome   | Duration";
+    const divider = "-----------|------------------------------------|-----------|---------";
+    console.log(header);
+    console.log(divider);
+    for (const r of limited) {
+      const date = r.startedAt.slice(0, 10);
+      const skill = padRight(r.skill, 35);
+      const outcome = padRight(r.outcome, 9);
+      const dur = formatDuration(r.duration);
+      console.log(`${date}  | ${skill}| ${outcome} | ${dur}`);
+    }
+    console.log(`
+Showing ${limited.length} of ${records.length} invocations`);
+  });
+}
+function registerSkillCommand(adoption) {
+  adoption.command("skill <name>").description("Show detail for a specific skill").action(async (name, _opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = process.cwd();
+    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-TZQUURSP.js");
+    const records = readAdoptionRecords(cwd);
+    const skillRecords = records.filter((r) => r.skill === name);
+    if (skillRecords.length === 0) {
+      if (globalOpts.json) {
+        console.log(JSON.stringify(null));
+      } else {
+        logger.info(`No adoption data found for skill "${name}".`);
+      }
+      return;
+    }
+    const summaries = aggregateBySkill(skillRecords);
+    const summary = summaries[0];
+    const phaseMap = /* @__PURE__ */ new Map();
+    for (const r of skillRecords) {
+      for (const phase of r.phasesReached) {
+        phaseMap.set(phase, (phaseMap.get(phase) ?? 0) + 1);
+      }
+    }
+    const phaseRates = Array.from(phaseMap.entries()).map(([phase, count]) => ({ phase, count, rate: count / skillRecords.length })).sort((a, b) => b.count - a.count);
+    if (globalOpts.json) {
+      console.log(
+        JSON.stringify({ summary, phaseRates, totalRecords: skillRecords.length }, null, 2)
+      );
+      return;
+    }
+    console.log(`Skill: ${name}`);
+    console.log(`Invocations: ${summary.invocations}`);
+    console.log(`Success rate: ${formatRate(summary.successRate)}`);
+    console.log(`Avg duration: ${formatDuration(summary.avgDuration)}`);
+    console.log(`Last used: ${summary.lastUsed.slice(0, 10)}`);
+    if (summary.tier != null) {
+      console.log(`Tier: ${summary.tier}`);
+    }
+    if (phaseRates.length > 0) {
+      console.log("\nPhase completion rates:");
+      for (const p of phaseRates) {
+        console.log(
+          `  ${padRight(p.phase, 20)} ${formatRate(p.rate)} (${p.count}/${skillRecords.length})`
+        );
+      }
+    }
+    const outcomes = { completed: 0, failed: 0, abandoned: 0 };
+    for (const r of skillRecords) {
+      if (r.outcome in outcomes) {
+        outcomes[r.outcome]++;
+      }
+    }
+    console.log("\nOutcome breakdown:");
+    console.log(`  Completed: ${outcomes.completed}`);
+    console.log(`  Failed: ${outcomes.failed}`);
+    console.log(`  Abandoned: ${outcomes.abandoned}`);
+  });
+}
+function createAdoptionCommand() {
+  const adoption = new Command2("adoption").description("View skill adoption telemetry").option("--json", "Output in JSON format");
+  registerSkillsCommand(adoption);
+  registerRecentCommand(adoption);
+  registerSkillCommand(adoption);
+  return adoption;
+}
+
 // src/commands/agent/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 
 // src/commands/agent/run.ts
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 import * as path2 from "path";
 import * as childProcess from "child_process";
 async function runAgentTask(task, options) {
@@ -425,7 +582,7 @@ async function runPersonaMode(opts, quiet) {
   process.exit(report.status === "fail" ? ExitCode.ERROR : ExitCode.SUCCESS);
 }
 function createRunCommand() {
-  return new Command2("run").description("Run an agent task").argument("[task]", "Task to run (review, doc-review, test-review)").option("--timeout <ms>", "Timeout in milliseconds", "300000").option("--persona <name>", "Run a persona by name").option("--trigger <context>", "Trigger context (auto, on_pr, on_commit, manual)", "auto").action(async (task, opts, cmd) => {
+  return new Command3("run").description("Run an agent task").argument("[task]", "Task to run (review, doc-review, test-review)").option("--timeout <ms>", "Timeout in milliseconds", "300000").option("--persona <name>", "Run a persona by name").option("--trigger <context>", "Trigger context (auto, on_pr, on_commit, manual)", "auto").action(async (task, opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     if (opts.persona) {
       await runPersonaMode(opts, globalOpts.quiet);
@@ -449,7 +606,7 @@ function createRunCommand() {
 }
 
 // src/commands/agent/review.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 import { execSync } from "child_process";
 async function runAgentReview(options) {
   const configResult = resolveConfig(options.configPath);
@@ -543,7 +700,7 @@ function printReviewResult(result, mode) {
   }
 }
 function createReviewCommand() {
-  return new Command3("review").description("Run unified code review pipeline on current changes").option("--comment", "Post inline comments to GitHub PR").option("--ci", "Enable eligibility gate, non-interactive output").option("--deep", "Add threat modeling pass to security agent").option("--no-mechanical", "Skip mechanical checks").action(async (opts, cmd) => {
+  return new Command4("review").description("Run unified code review pipeline on current changes").option("--comment", "Post inline comments to GitHub PR").option("--ci", "Enable eligibility gate, non-interactive output").option("--deep", "Add threat modeling pass to security agent").option("--no-mechanical", "Skip mechanical checks").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = resolveReviewMode(globalOpts);
     const result = await runAgentReview({
@@ -571,17 +728,17 @@ function createReviewCommand() {
 
 // src/commands/agent/index.ts
 function createAgentCommand() {
-  const command = new Command4("agent").description("Agent orchestration commands");
+  const command = new Command5("agent").description("Agent orchestration commands");
   command.addCommand(createRunCommand());
   command.addCommand(createReviewCommand());
   return command;
 }
 
 // src/commands/blueprint.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 import * as path3 from "path";
 function createBlueprintCommand() {
-  return new Command5("blueprint").description("Generate a self-contained, interactive blueprint of the codebase").argument("[path]", "Path to the project root", ".").option("-o, --output <dir>", "Output directory", "docs/blueprint").action(async (projectPath, options) => {
+  return new Command6("blueprint").description("Generate a self-contained, interactive blueprint of the codebase").argument("[path]", "Path to the project root", ".").option("-o, --output <dir>", "Output directory", "docs/blueprint").action(async (projectPath, options) => {
     try {
       const rootDir = path3.resolve(projectPath);
       const outputDir = path3.resolve(options.output);
@@ -602,7 +759,7 @@ function createBlueprintCommand() {
 }
 
 // src/commands/check-arch.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 import { execSync as execSync2 } from "child_process";
 function getCommitHash(cwd) {
   try {
@@ -732,7 +889,7 @@ function printArchResult(value, mode, formatter) {
   if (output) console.log(output);
 }
 function createCheckArchCommand() {
-  const command = new Command6("check-arch").description("Check architecture assertions against baseline and thresholds").option("--update-baseline", "Capture current state as new baseline").option("--module <path>", "Check a single module").action(async (opts, cmd) => {
+  const command = new Command7("check-arch").description("Check architecture assertions against baseline and thresholds").option("--update-baseline", "Capture current state as new baseline").option("--module <path>", "Check a single module").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = resolveOutputMode(globalOpts);
     const formatter = new OutputFormatter(mode);
@@ -762,7 +919,7 @@ function createCheckArchCommand() {
 }
 
 // src/commands/check-deps.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 import * as path4 from "path";
 async function runCheckDeps(options) {
   const cwd = options.cwd ?? process.cwd();
@@ -854,14 +1011,14 @@ async function runCheckDepsAction(globalOpts) {
   process.exit(result.value.valid ? ExitCode.SUCCESS : ExitCode.VALIDATION_FAILED);
 }
 function createCheckDepsCommand() {
-  const command = new Command7("check-deps").description("Validate dependency layers and detect circular dependencies").action(async (_opts, cmd) => {
+  const command = new Command8("check-deps").description("Validate dependency layers and detect circular dependencies").action(async (_opts, cmd) => {
     await runCheckDepsAction(cmd.optsWithGlobals());
   });
   return command;
 }
 
 // src/commands/check-docs.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 import * as path5 from "path";
 
 // src/utils/output.ts
@@ -949,7 +1106,7 @@ function printCheckDocsResult(value, mode, formatter) {
   }
 }
 function createCheckDocsCommand() {
-  const command = new Command8("check-docs").description("Check documentation coverage").option("--min-coverage <percent>", "Minimum coverage percentage", "80").action(async (opts, cmd) => {
+  const command = new Command9("check-docs").description("Check documentation coverage").option("--min-coverage <percent>", "Minimum coverage percentage", "80").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = resolveOutputMode2(globalOpts);
     const formatter = new OutputFormatter(mode);
@@ -979,7 +1136,7 @@ function createCheckDocsCommand() {
 }
 
 // src/commands/check-perf.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 import * as path6 from "path";
 async function runCheckPerf(cwd, options) {
   const runAll2 = !options.structural && !options.size && !options.coupling;
@@ -1096,14 +1253,14 @@ async function runCheckPerfAction(opts, globalOpts) {
   process.exit(result.value.valid ? ExitCode.SUCCESS : ExitCode.VALIDATION_FAILED);
 }
 function createCheckPerfCommand() {
-  const command = new Command9("check-perf").description("Run performance checks: structural complexity, coupling, and size budgets").option("--structural", "Run structural complexity checks only").option("--coupling", "Run coupling metric checks only").option("--size", "Run size budget checks only").action(async (opts, cmd) => {
+  const command = new Command10("check-perf").description("Run performance checks: structural complexity, coupling, and size budgets").option("--structural", "Run structural complexity checks only").option("--coupling", "Run coupling metric checks only").option("--size", "Run size budget checks only").action(async (opts, cmd) => {
     await runCheckPerfAction(opts, cmd.optsWithGlobals());
   });
   return command;
 }
 
 // src/commands/check-security.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 import * as path7 from "path";
 import { execSync as execSync3 } from "child_process";
 var SEVERITY_RANK = {
@@ -1126,10 +1283,10 @@ async function runCheckSecurity(cwd, options) {
   const projectRoot = path7.resolve(cwd);
   let configData = {};
   try {
-    const fs34 = await import("fs");
+    const fs36 = await import("fs");
     const configPath = path7.join(projectRoot, "harness.config.json");
-    if (fs34.existsSync(configPath)) {
-      const raw = fs34.readFileSync(configPath, "utf-8");
+    if (fs36.existsSync(configPath)) {
+      const raw = fs36.readFileSync(configPath, "utf-8");
       const parsed = JSON.parse(raw);
       configData = parsed.security ?? {};
     }
@@ -1198,7 +1355,7 @@ async function runCheckSecurityAction(opts, globalOpts) {
   process.exit(result.value.valid ? ExitCode.SUCCESS : ExitCode.VALIDATION_FAILED);
 }
 function createCheckSecurityCommand() {
-  const command = new Command10("check-security").description("Run lightweight security scan: secrets, injection, XSS, weak crypto").option("--severity <level>", "Minimum severity threshold", "warning").hook("preAction", (thisCommand) => {
+  const command = new Command11("check-security").description("Run lightweight security scan: secrets, injection, XSS, weak crypto").option("--severity <level>", "Minimum severity threshold", "warning").hook("preAction", (thisCommand) => {
     const severity = thisCommand.opts().severity;
     if (!["error", "warning", "info"].includes(severity)) {
       logger.error(`Invalid severity: "${severity}". Must be one of: error, warning, info`);
@@ -1211,10 +1368,10 @@ function createCheckSecurityCommand() {
 }
 
 // src/commands/ci/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // src/commands/ci/check.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 var VALID_CHECKS = [
   "validate",
   "deps",
@@ -1304,13 +1461,13 @@ async function runCheckAction(opts, globalOpts) {
   process.exit(report.exitCode);
 }
 function createCheckCommand() {
-  return new Command11("check").description("Run all harness checks for CI (validate, deps, docs, entropy, phase-gate, arch)").option("--skip <checks>", "Comma-separated checks to skip (e.g., entropy,docs)").option("--fail-on <severity>", "Fail on severity level: error (default) or warning", "error").action(async (opts, cmd) => {
+  return new Command12("check").description("Run all harness checks for CI (validate, deps, docs, entropy, phase-gate, arch)").option("--skip <checks>", "Comma-separated checks to skip (e.g., entropy,docs)").option("--fail-on <severity>", "Fail on severity level: error (default) or warning", "error").action(async (opts, cmd) => {
     await runCheckAction(opts, cmd.optsWithGlobals());
   });
 }
 
 // src/commands/ci/init.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 import * as fs2 from "fs";
 import * as path8 from "path";
 var ALL_CHECKS = [
@@ -1447,86 +1604,19 @@ async function runInitAction(opts, globalOpts) {
   }
 }
 function createInitCommand() {
-  return new Command12("init").description("Generate CI configuration for harness checks").option("--platform <platform>", "CI platform: github, gitlab, or generic").option("--checks <list>", "Comma-separated list of checks to include").action(async (opts, cmd) => {
+  return new Command13("init").description("Generate CI configuration for harness checks").option("--platform <platform>", "CI platform: github, gitlab, or generic").option("--checks <list>", "Comma-separated list of checks to include").action(async (opts, cmd) => {
     await runInitAction(opts, cmd.optsWithGlobals());
   });
 }
 
 // src/commands/ci/index.ts
 function createCICommand() {
-  const command = new Command13("ci").description("CI/CD integration commands");
+  const command = new Command14("ci").description("CI/CD integration commands");
   command.addCommand(createCheckCommand());
   command.addCommand(createInitCommand());
   return command;
 }
 
-// src/commands/dashboard.ts
-import { Command as Command14 } from "commander";
-import { spawn } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { dirname as dirname2, join as join5, resolve as resolve8 } from "path";
-import { fileURLToPath } from "url";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname2(__filename);
-var DEFAULT_CLIENT_PORT = 3700;
-var DEFAULT_API_PORT = 3701;
-function openBrowser(url) {
-  const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  spawn(cmd, [url], { detached: true, stdio: "ignore" }).unref();
-}
-function resolveServerScript() {
-  const built = [
-    join5(__dirname, "..", "..", "..", "dashboard", "dist", "server", "serve.js"),
-    join5(__dirname, "..", "..", "..", "..", "packages", "dashboard", "dist", "server", "serve.js")
-  ].find((p) => existsSync3(p));
-  if (built) return { script: built, dev: false };
-  const dev = [
-    join5(__dirname, "..", "..", "..", "dashboard", "src", "server", "serve.ts"),
-    join5(__dirname, "..", "..", "..", "..", "packages", "dashboard", "src", "server", "serve.ts")
-  ].find((p) => existsSync3(p));
-  return dev ? { script: dev, dev: true } : null;
-}
-function spawnDashboardServer(server, env) {
-  const child = server.dev ? spawn("tsx", [server.script], { env, stdio: "inherit" }) : spawn("node", [server.script], { env, stdio: "inherit" });
-  child.on("error", (e) => {
-    console.error(`Failed to start dashboard: ${e.message}`);
-    process.exit(1);
-  });
-  child.on("exit", (code) => {
-    if (code !== 0 && code !== null) {
-      console.error(`Dashboard server exited with code ${code}`);
-      process.exit(code);
-    }
-  });
-  return child;
-}
-function runDashboard(opts) {
-  const clientPort = Number(opts.port ?? DEFAULT_CLIENT_PORT);
-  const apiPort = Number(opts.apiPort ?? DEFAULT_API_PORT);
-  const projectPath = resolve8(opts.cwd ?? process.cwd());
-  const url = `http://localhost:${clientPort}`;
-  const server = resolveServerScript();
-  if (!server) {
-    console.error("Could not locate the dashboard server. Run `pnpm build` in packages/dashboard.");
-    process.exit(1);
-  }
-  const env = {
-    ...process.env,
-    DASHBOARD_API_PORT: String(apiPort),
-    DASHBOARD_CLIENT_PORT: String(clientPort),
-    HARNESS_PROJECT_PATH: projectPath
-  };
-  spawnDashboardServer(server, env);
-  console.log(`Dashboard API starting on http://localhost:${apiPort}`);
-  console.log(`Open ${url} (pass --no-open to suppress)`);
-  if (opts.noOpen !== true) {
-    setTimeout(() => openBrowser(url), 1500);
-  }
-}
-function createDashboardCommand() {
-  return new Command14("dashboard").description("Start the Harness local web dashboard").option("--port <port>", "Client dev server port", String(DEFAULT_CLIENT_PORT)).option("--api-port <port>", "API server port", String(DEFAULT_API_PORT)).option("--no-open", "Do not automatically open browser").option("--cwd <path>", "Project directory (defaults to cwd)").action((opts) => runDashboard(opts));
-}
-
 // src/commands/cleanup.ts
 import { Command as Command15 } from "commander";
 import * as path9 from "path";
@@ -1646,11 +1736,197 @@ function createCleanupCommand() {
   return command;
 }
 
-// src/commands/doctor.ts
+// src/commands/cleanup-sessions.ts
 import { Command as Command16 } from "commander";
-import * as fs4 from "fs";
+import * as fs3 from "fs";
+import * as path10 from "path";
+var STALE_TTL_MS = 24 * 60 * 60 * 1e3;
+function getMostRecentMtime(dirPath) {
+  let latest = 0;
+  try {
+    const entries = fs3.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path10.join(dirPath, entry.name);
+      const stat = fs3.statSync(fullPath);
+      if (stat.mtimeMs > latest) latest = stat.mtimeMs;
+    }
+    const dirStat = fs3.statSync(dirPath);
+    if (dirStat.mtimeMs > latest) latest = dirStat.mtimeMs;
+  } catch {
+  }
+  return latest;
+}
+async function runCleanupSessions(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const dryRun = options.dryRun ?? false;
+  const sessionsDir = path10.join(cwd, ".harness", "sessions");
+  const result = { removed: [], kept: [] };
+  if (!fs3.existsSync(sessionsDir)) {
+    return Ok(result);
+  }
+  let entries;
+  try {
+    entries = fs3.readdirSync(sessionsDir, { withFileTypes: true });
+  } catch (err) {
+    return Err(
+      new CLIError(
+        `Failed to read sessions directory: ${err instanceof Error ? err.message : String(err)}`,
+        ExitCode.ERROR
+      )
+    );
+  }
+  const now = Date.now();
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const sessionPath = path10.join(sessionsDir, entry.name);
+    const mostRecent = getMostRecentMtime(sessionPath);
+    const ageMs = now - mostRecent;
+    if (ageMs > STALE_TTL_MS) {
+      result.removed.push(entry.name);
+      if (!dryRun) {
+        try {
+          fs3.rmSync(sessionPath, { recursive: true, force: true });
+        } catch (err) {
+          return Err(
+            new CLIError(
+              `Failed to remove session ${entry.name}: ${err instanceof Error ? err.message : String(err)}`,
+              ExitCode.ERROR
+            )
+          );
+        }
+      }
+    } else {
+      result.kept.push(entry.name);
+    }
+  }
+  return Ok(result);
+}
+function printResult(result, dryRun, asJson) {
+  const { removed, kept } = result;
+  if (asJson) {
+    console.log(JSON.stringify({ removed, kept, dryRun }, null, 2));
+    return;
+  }
+  if (removed.length === 0 && kept.length === 0) {
+    console.log("No sessions found.");
+    return;
+  }
+  if (removed.length > 0) {
+    const label = dryRun ? "Stale (would remove)" : "Removed";
+    console.log(`
+${label} (${removed.length}):`);
+    for (const s of removed) console.log(`  - ${s}`);
+  }
+  if (kept.length > 0) {
+    console.log(`
+Kept (${kept.length}):`);
+    for (const s of kept) console.log(`  - ${s}`);
+  }
+  if (!dryRun && removed.length > 0) {
+    console.log(`
+Cleaned up ${removed.length} stale session(s).`);
+  }
+}
+function createCleanupSessionsCommand() {
+  const command = new Command16("cleanup-sessions").description("Remove stale session directories from .harness/sessions/ (no write in 24h)").option("--dry-run", "List stale sessions without deleting them", false).option("--path <path>", "Project root path", ".").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = path10.resolve(opts.path);
+    const result = await runCleanupSessions({ cwd, dryRun: opts.dryRun });
+    if (!result.ok) {
+      logger.error(result.error.message);
+      process.exit(result.error.exitCode);
+      return;
+    }
+    printResult(result.value, opts.dryRun, globalOpts.json);
+    process.exit(ExitCode.SUCCESS);
+  });
+  return command;
+}
+
+// src/commands/dashboard.ts
+import { Command as Command17 } from "commander";
+import { spawn } from "child_process";
+import { existsSync as existsSync4 } from "fs";
+import { createRequire } from "module";
+import { dirname as dirname2, join as join7, resolve as resolve10 } from "path";
+import { setTimeout } from "timers";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname2(__filename);
+var require2 = createRequire(import.meta.url);
+var DEFAULT_CLIENT_PORT = 3700;
+var DEFAULT_API_PORT = 3701;
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  spawn(cmd, [url], { detached: true, stdio: "ignore" }).unref();
+}
+function resolveServerScript() {
+  try {
+    const pkgPath = require2.resolve("@harness-engineering/dashboard/package.json");
+    const pkgDir = dirname2(pkgPath);
+    const built2 = join7(pkgDir, "dist", "server", "serve.js");
+    if (existsSync4(built2)) return { script: built2, dev: false };
+    const dev2 = join7(pkgDir, "src", "server", "serve.ts");
+    if (existsSync4(dev2)) return { script: dev2, dev: true };
+  } catch {
+  }
+  const built = [
+    join7(__dirname, "..", "..", "..", "dashboard", "dist", "server", "serve.js"),
+    join7(__dirname, "..", "..", "..", "..", "packages", "dashboard", "dist", "server", "serve.js")
+  ].find((p) => existsSync4(p));
+  if (built) return { script: built, dev: false };
+  const dev = [
+    join7(__dirname, "..", "..", "..", "dashboard", "src", "server", "serve.ts"),
+    join7(__dirname, "..", "..", "..", "..", "packages", "dashboard", "src", "server", "serve.ts")
+  ].find((p) => existsSync4(p));
+  return dev ? { script: dev, dev: true } : null;
+}
+function spawnDashboardServer(server, env) {
+  const child = server.dev ? spawn("tsx", [server.script], { env, stdio: "inherit" }) : spawn("node", [server.script], { env, stdio: "inherit" });
+  child.on("error", (e) => {
+    console.error(`Failed to start dashboard: ${e.message}`);
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    if (code !== 0 && code !== null) {
+      console.error(`Dashboard server exited with code ${code}`);
+      process.exit(code);
+    }
+  });
+  return child;
+}
+function runDashboard(opts) {
+  const clientPort = Number(opts.port ?? DEFAULT_CLIENT_PORT);
+  const apiPort = Number(opts.apiPort ?? DEFAULT_API_PORT);
+  const projectPath = resolve10(opts.cwd ?? process.cwd());
+  const url = `http://localhost:${clientPort}`;
+  const server = resolveServerScript();
+  if (!server) {
+    console.error("Could not locate the dashboard server. Run `pnpm build` in packages/dashboard.");
+    process.exit(1);
+  }
+  const env = {
+    ...process.env,
+    DASHBOARD_API_PORT: String(apiPort),
+    DASHBOARD_CLIENT_PORT: String(clientPort),
+    HARNESS_PROJECT_PATH: projectPath
+  };
+  spawnDashboardServer(server, env);
+  console.log(`Dashboard API starting on http://localhost:${apiPort}`);
+  console.log(`Open ${url} (pass --no-open to suppress)`);
+  if (opts.noOpen !== true) {
+    setTimeout(() => openBrowser(url), 1500);
+  }
+}
+function createDashboardCommand() {
+  return new Command17("dashboard").description("Start the Harness local web dashboard").option("--port <port>", "Client dev server port", String(DEFAULT_CLIENT_PORT)).option("--api-port <port>", "API server port", String(DEFAULT_API_PORT)).option("--no-open", "Do not automatically open browser").option("--cwd <path>", "Project directory (defaults to cwd)").action((opts) => runDashboard(opts));
+}
+
+// src/commands/doctor.ts
+import { Command as Command18 } from "commander";
+import * as fs5 from "fs";
 import * as os from "os";
-import * as path11 from "path";
+import * as path12 from "path";
 import chalk from "chalk";
 
 // src/utils/node-version.ts
@@ -1733,24 +2009,24 @@ var INTEGRATION_REGISTRY = [
 ];
 
 // src/integrations/config.ts
-import * as fs3 from "fs";
-import * as path10 from "path";
+import * as fs4 from "fs";
+import * as path11 from "path";
 function readJsonSafe(filePath) {
-  if (!fs3.existsSync(filePath)) return null;
+  if (!fs4.existsSync(filePath)) return null;
   try {
-    return JSON.parse(fs3.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs4.readFileSync(filePath, "utf-8"));
   } catch {
     return null;
   }
 }
 function writeJson(filePath, data) {
-  const dir = path10.dirname(filePath);
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true });
+  const dir = path11.dirname(filePath);
+  if (!fs4.existsSync(dir)) {
+    fs4.mkdirSync(dir, { recursive: true });
   }
   const tmp = filePath + ".tmp";
-  fs3.writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n");
-  fs3.renameSync(tmp, filePath);
+  fs4.writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n");
+  fs4.renameSync(tmp, filePath);
 }
 function readMcpConfig(filePath) {
   const config = readJsonSafe(filePath);
@@ -1764,7 +2040,7 @@ function writeMcpEntry(filePath, name, entry) {
   writeJson(filePath, config);
 }
 function removeMcpEntry(filePath, name) {
-  if (!fs3.existsSync(filePath)) return;
+  if (!fs4.existsSync(filePath)) return;
   const config = readMcpConfig(filePath);
   delete config.mcpServers[name];
   writeJson(filePath, config);
@@ -1803,7 +2079,7 @@ function checkNodeVersion2() {
 }
 function countCommandFiles(dir, ext) {
   try {
-    return fs4.readdirSync(dir).filter((f) => f.endsWith(ext)).length;
+    return fs5.readdirSync(dir).filter((f) => f.endsWith(ext)).length;
   } catch {
     return 0;
   }
@@ -1812,13 +2088,13 @@ function checkSlashCommands() {
   const platforms = [
     {
       name: "Claude Code",
-      dir: path11.join(os.homedir(), ".claude", "commands", "harness"),
+      dir: path12.join(os.homedir(), ".claude", "commands", "harness"),
       ext: ".md",
       client: "claude-code"
     },
     {
       name: "Gemini CLI",
-      dir: path11.join(os.homedir(), ".gemini", "commands", "harness"),
+      dir: path12.join(os.homedir(), ".gemini", "commands", "harness"),
       ext: ".toml",
       client: "gemini-cli"
     }
@@ -1842,7 +2118,7 @@ function checkSlashCommands() {
 }
 function checkMcpConfig(cwd) {
   const results = [];
-  const claudeConfig = readMcpConfig(path11.join(cwd, ".mcp.json"));
+  const claudeConfig = readMcpConfig(path12.join(cwd, ".mcp.json"));
   if (claudeConfig.mcpServers?.["harness"]) {
     results.push({
       name: "mcp-claude",
@@ -1857,9 +2133,9 @@ function checkMcpConfig(cwd) {
       fix: "Run: harness setup-mcp --client claude"
     });
   }
-  const geminiDir = path11.join(cwd, ".gemini");
-  if (fs4.existsSync(geminiDir)) {
-    const geminiConfig = readMcpConfig(path11.join(geminiDir, "settings.json"));
+  const geminiDir = path12.join(cwd, ".gemini");
+  if (fs5.existsSync(geminiDir)) {
+    const geminiConfig = readMcpConfig(path12.join(geminiDir, "settings.json"));
     if (geminiConfig.mcpServers?.["harness"]) {
       results.push({
         name: "mcp-gemini",
@@ -1878,12 +2154,12 @@ function checkMcpConfig(cwd) {
   return results;
 }
 function loadMcpPresence(cwd) {
-  const mcpPath = path11.join(cwd, ".mcp.json");
-  const geminiDir = path11.join(cwd, ".gemini");
-  const hasGemini = fs4.existsSync(geminiDir);
+  const mcpPath = path12.join(cwd, ".mcp.json");
+  const geminiDir = path12.join(cwd, ".gemini");
+  const hasGemini = fs5.existsSync(geminiDir);
   return {
     mcpConfig: readMcpConfig(mcpPath),
-    geminiConfig: hasGemini ? readMcpConfig(path11.join(geminiDir, "settings.json")) : null,
+    geminiConfig: hasGemini ? readMcpConfig(path12.join(geminiDir, "settings.json")) : null,
     hasGemini
   };
 }
@@ -1915,7 +2191,7 @@ function checkTier0Presence(def, presence) {
 function checkIntegrations(cwd) {
   const results = [];
   const presence = loadMcpPresence(cwd);
-  const configPath = path11.join(cwd, "harness.config.json");
+  const configPath = path12.join(cwd, "harness.config.json");
   const integrationsConfig = readIntegrationsConfig(configPath);
   for (const def of INTEGRATION_REGISTRY.filter((d) => d.tier === 0)) {
     results.push(checkTier0Presence(def, presence));
@@ -1965,7 +2241,7 @@ function formatCheck(check) {
   return line;
 }
 function createDoctorCommand() {
-  return new Command16("doctor").description("Check environment health: Node version, slash commands, MCP configuration").action((_opts, cmd) => {
+  return new Command18("doctor").description("Check environment health: Node version, slash commands, MCP configuration").action((_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     const useJson = globalOpts.json;
@@ -1990,8 +2266,8 @@ function createDoctorCommand() {
 }
 
 // src/commands/fix-drift.ts
-import { Command as Command17 } from "commander";
-import * as path12 from "path";
+import { Command as Command19 } from "commander";
+import * as path13 from "path";
 async function runFixDrift(options) {
   const cwd = options.cwd ?? process.cwd();
   const dryRun = options.dryRun !== false;
@@ -2000,11 +2276,11 @@ async function runFixDrift(options) {
     return Err(configResult.error);
   }
   const config = configResult.value;
-  const rootDir = path12.resolve(cwd, config.rootDir);
-  const docsDir = path12.resolve(cwd, config.docsDir);
+  const rootDir = path13.resolve(cwd, config.rootDir);
+  const docsDir = path13.resolve(cwd, config.docsDir);
   const entropyConfig = {
     rootDir,
-    entryPoints: [path12.join(rootDir, "src/index.ts")],
+    entryPoints: [path13.join(rootDir, "src/index.ts")],
     docPaths: [docsDir],
     analyze: {
       drift: true,
@@ -2123,7 +2399,7 @@ function printFixDriftResult(value, mode, formatter) {
   }
 }
 function createFixDriftCommand() {
-  const command = new Command17("fix-drift").description("Auto-fix entropy issues (doc drift, dead code)").option("--no-dry-run", "Actually apply fixes (default is dry-run mode)").action(async (opts, cmd) => {
+  const command = new Command19("fix-drift").description("Auto-fix entropy issues (doc drift, dead code)").option("--no-dry-run", "Actually apply fixes (default is dry-run mode)").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = resolveOutputMode2(globalOpts);
     const formatter = new OutputFormatter(mode);
@@ -2153,7 +2429,7 @@ function createFixDriftCommand() {
 }
 
 // src/commands/generate.ts
-import { Command as Command18 } from "commander";
+import { Command as Command20 } from "commander";
 function validatePlatforms(platforms) {
   for (const p of platforms) {
     if (!VALID_PLATFORMS.includes(p)) {
@@ -2213,27 +2489,27 @@ async function runGenerateAction(opts, globalOpts) {
   }
 }
 function createGenerateCommand() {
-  return new Command18("generate").description("Generate all platform integrations (slash commands + agent definitions)").option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global directories", false).option("--include-global", "Include built-in global skills", false).option("--output <dir>", "Custom output directory").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).action(async (opts, cmd) => {
+  return new Command20("generate").description("Generate all platform integrations (slash commands + agent definitions)").option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global directories", false).option("--include-global", "Include built-in global skills", false).option("--output <dir>", "Custom output directory").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).action(async (opts, cmd) => {
     await runGenerateAction(opts, cmd.optsWithGlobals());
   });
 }
 
 // src/commands/graph/index.ts
-import { Command as Command22 } from "commander";
+import { Command as Command24 } from "commander";
 
 // src/commands/graph/status.ts
-import * as path13 from "path";
+import * as path14 from "path";
 async function runGraphStatus(projectPath) {
-  const { GraphStore } = await import("./dist-M6FBUXZD.js");
-  const graphDir = path13.join(projectPath, ".harness", "graph");
+  const { GraphStore } = await import("./dist-QW5G3GX3.js");
+  const graphDir = path14.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
   if (!loaded) return { status: "no_graph", message: "No graph found. Run `harness scan` first." };
-  const fs34 = await import("fs/promises");
-  const metaPath = path13.join(graphDir, "metadata.json");
+  const fs36 = await import("fs/promises");
+  const metaPath = path14.join(graphDir, "metadata.json");
   let lastScan = "unknown";
   try {
-    const meta = JSON.parse(await fs34.readFile(metaPath, "utf-8"));
+    const meta = JSON.parse(await fs36.readFile(metaPath, "utf-8"));
     lastScan = meta.lastScanTimestamp;
   } catch {
   }
@@ -2244,8 +2520,8 @@ async function runGraphStatus(projectPath) {
   }
   let connectorSyncStatus = {};
   try {
-    const syncMetaPath = path13.join(graphDir, "sync-metadata.json");
-    const syncMeta = JSON.parse(await fs34.readFile(syncMetaPath, "utf-8"));
+    const syncMetaPath = path14.join(graphDir, "sync-metadata.json");
+    const syncMeta = JSON.parse(await fs36.readFile(syncMetaPath, "utf-8"));
     for (const [name, data] of Object.entries(syncMeta.connectors ?? {})) {
       connectorSyncStatus[name] = data.lastSyncTimestamp;
     }
@@ -2262,10 +2538,10 @@ async function runGraphStatus(projectPath) {
 }
 
 // src/commands/graph/export.ts
-import * as path14 from "path";
+import * as path15 from "path";
 async function runGraphExport(projectPath, format) {
-  const { GraphStore } = await import("./dist-M6FBUXZD.js");
-  const graphDir = path14.join(projectPath, ".harness", "graph");
+  const { GraphStore } = await import("./dist-QW5G3GX3.js");
+  const graphDir = path15.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
   if (!loaded) throw new Error("No graph found. Run `harness scan` first.");
@@ -2294,13 +2570,13 @@ async function runGraphExport(projectPath, format) {
 }
 
 // src/commands/graph/index.ts
-import * as path18 from "path";
+import * as path19 from "path";
 
 // src/commands/graph/scan.ts
-import { Command as Command19 } from "commander";
-import * as path15 from "path";
+import { Command as Command21 } from "commander";
+import * as path16 from "path";
 async function runScan(projectPath) {
-  const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-M6FBUXZD.js");
+  const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-QW5G3GX3.js");
   const store = new GraphStore();
   const start = Date.now();
   await new CodeIngestor(store).ingest(projectPath);
@@ -2311,13 +2587,13 @@ async function runScan(projectPath) {
     await new GitIngestor(store).ingest(projectPath);
   } catch {
   }
-  const graphDir = path15.join(projectPath, ".harness", "graph");
+  const graphDir = path16.join(projectPath, ".harness", "graph");
   await store.save(graphDir);
   return { nodeCount: store.nodeCount, edgeCount: store.edgeCount, durationMs: Date.now() - start };
 }
 function createScanCommand() {
-  return new Command19("scan").description("Scan project and build knowledge graph").argument("[path]", "Project root path", ".").action(async (inputPath, _opts, cmd) => {
-    const projectPath = path15.resolve(inputPath);
+  return new Command21("scan").description("Scan project and build knowledge graph").argument("[path]", "Project root path", ".").action(async (inputPath, _opts, cmd) => {
+    const projectPath = path16.resolve(inputPath);
     const globalOpts = cmd.optsWithGlobals();
     try {
       const result = await runScan(projectPath);
@@ -2336,12 +2612,12 @@ function createScanCommand() {
 }
 
 // src/commands/graph/query.ts
-import { Command as Command20 } from "commander";
-import * as path16 from "path";
+import { Command as Command22 } from "commander";
+import * as path17 from "path";
 async function runQuery(projectPath, rootNodeId, opts) {
-  const { GraphStore, ContextQL } = await import("./dist-M6FBUXZD.js");
+  const { GraphStore, ContextQL } = await import("./dist-QW5G3GX3.js");
   const store = new GraphStore();
-  const graphDir = path16.join(projectPath, ".harness", "graph");
+  const graphDir = path17.join(projectPath, ".harness", "graph");
   const loaded = await store.load(graphDir);
   if (!loaded) throw new Error("No graph found. Run `harness scan` first.");
   const params = {
@@ -2363,7 +2639,7 @@ function printQueryResult(result) {
   }
 }
 async function runQueryAction(rootNodeId, opts, globalOpts) {
-  const projectPath = path16.resolve(globalOpts.config ? path16.dirname(globalOpts.config) : ".");
+  const projectPath = path17.resolve(globalOpts.config ? path17.dirname(globalOpts.config) : ".");
   try {
     const result = await runQuery(projectPath, rootNodeId, {
       depth: parseInt(opts.depth),
@@ -2382,23 +2658,21 @@ async function runQueryAction(rootNodeId, opts, globalOpts) {
   }
 }
 function createQueryCommand() {
-  return new Command20("query").description("Query the knowledge graph").argument("<rootNodeId>", "Starting node ID").option("--depth <n>", "Max traversal depth", "3").option("--types <types>", "Comma-separated node types to include").option("--edges <edges>", "Comma-separated edge types to include").option("--bidirectional", "Traverse both directions").action(async (rootNodeId, opts, cmd) => {
+  return new Command22("query").description("Query the knowledge graph").argument("<rootNodeId>", "Starting node ID").option("--depth <n>", "Max traversal depth", "3").option("--types <types>", "Comma-separated node types to include").option("--edges <edges>", "Comma-separated edge types to include").option("--bidirectional", "Traverse both directions").action(async (rootNodeId, opts, cmd) => {
     await runQueryAction(rootNodeId, opts, cmd.optsWithGlobals());
   });
 }
 
 // src/commands/graph/ingest.ts
-import { Command as Command21 } from "commander";
-import * as path17 from "path";
+import { Command as Command23 } from "commander";
+import * as path18 from "path";
 async function loadConnectorConfig(projectPath, source) {
   try {
-    const fs34 = await import("fs/promises");
-    const configPath = path17.join(projectPath, "harness.config.json");
-    const config = JSON.parse(await fs34.readFile(configPath, "utf-8"));
-    const connector = config.graph?.connectors?.find(
-      (c) => c.source === source
-    );
-    return connector?.config ?? {};
+    const fs36 = await import("fs/promises");
+    const configPath = path18.join(projectPath, "harness.config.json");
+    const config = JSON.parse(await fs36.readFile(configPath, "utf-8"));
+    const connector = config.graph?.connectors?.[source];
+    return connector ?? {};
   } catch {
     return {};
   }
@@ -2432,9 +2706,11 @@ async function runIngest(projectPath, source, opts) {
     GitIngestor,
     SyncManager,
     JiraConnector,
-    SlackConnector
-  } = await import("./dist-M6FBUXZD.js");
-  const graphDir = path17.join(projectPath, ".harness", "graph");
+    SlackConnector,
+    CIConnector,
+    ConfluenceConnector
+  } = await import("./dist-QW5G3GX3.js");
+  const graphDir = path18.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   await store.load(graphDir);
   if (opts?.all) {
@@ -2446,7 +2722,9 @@ async function runIngest(projectPath, source, opts) {
     const syncManager = new SyncManager(store, graphDir);
     const connectorMap = {
       jira: () => new JiraConnector(),
-      slack: () => new SlackConnector()
+      slack: () => new SlackConnector(),
+      ci: () => new CIConnector(),
+      confluence: () => new ConfluenceConnector()
     };
     for (const [name, factory] of Object.entries(connectorMap)) {
       const config = await loadConnectorConfig(projectPath, name);
@@ -2470,9 +2748,11 @@ async function runIngest(projectPath, source, opts) {
       result = await new GitIngestor(store).ingest(projectPath);
       break;
     default: {
-      const knownConnectors = ["jira", "slack"];
+      const knownConnectors = ["jira", "slack", "ci", "confluence"];
       if (!knownConnectors.includes(source)) {
-        throw new Error(`Unknown source: ${source}. Available: code, knowledge, git, jira, slack`);
+        throw new Error(
+          `Unknown source: ${source}. Available: code, knowledge, git, jira, slack, ci, confluence`
+        );
       }
       if (!SyncManager) {
         throw new Error(
@@ -2482,7 +2762,9 @@ async function runIngest(projectPath, source, opts) {
       const syncManager = new SyncManager(store, graphDir);
       const extConnectorMap = {
         jira: () => new JiraConnector(),
-        slack: () => new SlackConnector()
+        slack: () => new SlackConnector(),
+        ci: () => new CIConnector(),
+        confluence: () => new ConfluenceConnector()
       };
       const factory = extConnectorMap[source];
       const config = await loadConnectorConfig(projectPath, source);
@@ -2495,13 +2777,16 @@ async function runIngest(projectPath, source, opts) {
   return result;
 }
 function createIngestCommand() {
-  return new Command21("ingest").description("Ingest data into the knowledge graph").option("--source <name>", "Source to ingest (code, knowledge, git, jira, slack)").option("--all", "Run all sources (code, knowledge, git, and configured connectors)").option("--full", "Force full re-ingestion").action(async (opts, cmd) => {
+  return new Command23("ingest").description("Ingest data into the knowledge graph").option(
+    "--source <name>",
+    "Source to ingest (code, knowledge, git, jira, slack, ci, confluence)"
+  ).option("--all", "Run all sources (code, knowledge, git, and configured connectors)").option("--full", "Force full re-ingestion").action(async (opts, cmd) => {
     if (!opts.source && !opts.all) {
       console.error("Error: --source or --all is required");
       process.exit(1);
     }
     const globalOpts = cmd.optsWithGlobals();
-    const projectPath = path17.resolve(globalOpts.config ? path17.dirname(globalOpts.config) : ".");
+    const projectPath = path18.resolve(globalOpts.config ? path18.dirname(globalOpts.config) : ".");
     try {
       const result = await runIngest(projectPath, opts.source ?? "", {
         full: opts.full,
@@ -2524,7 +2809,7 @@ function createIngestCommand() {
 
 // src/commands/graph/index.ts
 function resolveProjectPath(globalOpts) {
-  return path18.resolve(globalOpts.config ? path18.dirname(globalOpts.config) : ".");
+  return path19.resolve(globalOpts.config ? path19.dirname(globalOpts.config) : ".");
 }
 function printGraphStatus(result) {
   if (result.status === "no_graph") {
@@ -2568,19 +2853,19 @@ async function runExportAction(opts, cmd) {
   }
 }
 function createGraphCommand() {
-  const graph = new Command22("graph").description("Knowledge graph management");
+  const graph = new Command24("graph").description("Knowledge graph management");
   graph.command("status").description("Show graph statistics").action(runStatusAction);
   graph.command("export").description("Export graph").requiredOption("--format <format>", "Output format (json, mermaid)").action(runExportAction);
   return graph;
 }
 
 // src/commands/hooks/index.ts
-import { Command as Command27 } from "commander";
+import { Command as Command29 } from "commander";
 
 // src/commands/hooks/init.ts
-import { Command as Command23 } from "commander";
-import * as fs5 from "fs";
-import * as path19 from "path";
+import { Command as Command25 } from "commander";
+import * as fs6 from "fs";
+import * as path20 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/hooks/profiles.ts
@@ -2589,6 +2874,8 @@ var HOOK_SCRIPTS = [
   { name: "protect-config", event: "PreToolUse", matcher: "Write|Edit", minProfile: "standard" },
   { name: "quality-gate", event: "PostToolUse", matcher: "Edit|Write", minProfile: "standard" },
   { name: "pre-compact-state", event: "PreCompact", matcher: "*", minProfile: "standard" },
+  { name: "adoption-tracker", event: "Stop", matcher: "*", minProfile: "standard" },
+  { name: "telemetry-reporter", event: "Stop", matcher: "*", minProfile: "standard" },
   { name: "cost-tracker", event: "Stop", matcher: "*", minProfile: "strict" },
   { name: "sentinel-pre", event: "PreToolUse", matcher: "*", minProfile: "strict" },
   { name: "sentinel-post", event: "PostToolUse", matcher: "*", minProfile: "strict" }
@@ -2608,11 +2895,11 @@ var PROFILES = {
 
 // src/commands/hooks/init.ts
 var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = path19.dirname(__filename2);
+var __dirname2 = path20.dirname(__filename2);
 var VALID_PROFILES = ["minimal", "standard", "strict"];
 function resolveHookSourceDir() {
-  const candidate = path19.resolve(__dirname2, "..", "..", "hooks");
-  if (fs5.existsSync(candidate)) {
+  const candidate = path20.resolve(__dirname2, "..", "..", "hooks");
+  if (fs6.existsSync(candidate)) {
     return candidate;
   }
   throw new Error(`Cannot locate hook scripts directory. Expected at: ${candidate}`);
@@ -2640,12 +2927,12 @@ function mergeSettings(existing, hooksConfig) {
 }
 function initHooks(options) {
   const { profile, projectDir } = options;
-  const hooksDestDir = path19.join(projectDir, ".harness", "hooks");
-  fs5.mkdirSync(hooksDestDir, { recursive: true });
-  if (fs5.existsSync(hooksDestDir)) {
-    for (const entry of fs5.readdirSync(hooksDestDir)) {
+  const hooksDestDir = path20.join(projectDir, ".harness", "hooks");
+  fs6.mkdirSync(hooksDestDir, { recursive: true });
+  if (fs6.existsSync(hooksDestDir)) {
+    for (const entry of fs6.readdirSync(hooksDestDir)) {
       if (entry.endsWith(".js")) {
-        fs5.unlinkSync(path19.join(hooksDestDir, entry));
+        fs6.unlinkSync(path20.join(hooksDestDir, entry));
       }
     }
   }
@@ -2654,22 +2941,22 @@ function initHooks(options) {
   const activeNames = PROFILES[profile];
   const activeScripts = HOOK_SCRIPTS.filter((h) => activeNames.includes(h.name));
   for (const script of activeScripts) {
-    const srcFile = path19.join(sourceDir, `${script.name}.js`);
-    const destFile = path19.join(hooksDestDir, `${script.name}.js`);
-    if (fs5.existsSync(srcFile)) {
-      fs5.copyFileSync(srcFile, destFile);
+    const srcFile = path20.join(sourceDir, `${script.name}.js`);
+    const destFile = path20.join(hooksDestDir, `${script.name}.js`);
+    if (fs6.existsSync(srcFile)) {
+      fs6.copyFileSync(srcFile, destFile);
       copiedScripts.push(script.name);
     }
   }
-  const profilePath = path19.join(hooksDestDir, "profile.json");
-  fs5.writeFileSync(profilePath, JSON.stringify({ profile }, null, 2) + "\n");
-  const claudeDir = path19.join(projectDir, ".claude");
-  fs5.mkdirSync(claudeDir, { recursive: true });
-  const settingsPath = path19.join(claudeDir, "settings.json");
+  const profilePath = path20.join(hooksDestDir, "profile.json");
+  fs6.writeFileSync(profilePath, JSON.stringify({ profile }, null, 2) + "\n");
+  const claudeDir = path20.join(projectDir, ".claude");
+  fs6.mkdirSync(claudeDir, { recursive: true });
+  const settingsPath = path20.join(claudeDir, "settings.json");
   let existing = {};
-  if (fs5.existsSync(settingsPath)) {
+  if (fs6.existsSync(settingsPath)) {
     try {
-      existing = JSON.parse(fs5.readFileSync(settingsPath, "utf-8"));
+      existing = JSON.parse(fs6.readFileSync(settingsPath, "utf-8"));
     } catch (e) {
       throw new Error(
         `Malformed .claude/settings.json \u2014 fix the JSON syntax before running hooks init. Parse error: ${e instanceof Error ? e.message : String(e)}`,
@@ -2679,11 +2966,11 @@ function initHooks(options) {
   }
   const hooksConfig = buildSettingsHooks(profile);
   const merged = mergeSettings(existing, hooksConfig);
-  fs5.writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n");
+  fs6.writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n");
   return { copiedScripts, settingsPath, profilePath };
 }
 function createInitCommand2() {
-  return new Command23("init").description("Install Claude Code hook configurations into the current project").option("--profile <profile>", "Hook profile: minimal, standard, or strict", "standard").action(async (opts, cmd) => {
+  return new Command25("init").description("Install Claude Code hook configurations into the current project").option("--profile <profile>", "Hook profile: minimal, standard, or strict", "standard").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const profile = opts.profile;
     if (!VALID_PROFILES.includes(profile)) {
@@ -2707,7 +2994,7 @@ function createInitCommand2() {
           `Installed ${result.copiedScripts.length} hook scripts to .harness/hooks/`
         );
         logger.info(`Profile: ${profile}`);
-        logger.info(`Settings: ${path19.relative(projectDir, result.settingsPath)}`);
+        logger.info(`Settings: ${path20.relative(projectDir, result.settingsPath)}`);
         logger.dim("Run 'harness hooks list' to see installed hooks");
       }
     } catch (err) {
@@ -2719,19 +3006,19 @@ function createInitCommand2() {
 }
 
 // src/commands/hooks/list.ts
-import { Command as Command24 } from "commander";
-import * as fs6 from "fs";
-import * as path20 from "path";
+import { Command as Command26 } from "commander";
+import * as fs7 from "fs";
+import * as path21 from "path";
 function listHooks(projectDir) {
-  const hooksDir = path20.join(projectDir, ".harness", "hooks");
-  const profilePath = path20.join(hooksDir, "profile.json");
-  if (!fs6.existsSync(profilePath)) {
+  const hooksDir = path21.join(projectDir, ".harness", "hooks");
+  const profilePath = path21.join(hooksDir, "profile.json");
+  if (!fs7.existsSync(profilePath)) {
     return { installed: false, profile: null, hooks: [] };
   }
   let profile = "standard";
   let warning;
   try {
-    const data = JSON.parse(fs6.readFileSync(profilePath, "utf-8"));
+    const data = JSON.parse(fs7.readFileSync(profilePath, "utf-8"));
     if (data.profile && ["minimal", "standard", "strict"].includes(data.profile)) {
       profile = data.profile;
     }
@@ -2743,7 +3030,7 @@ function listHooks(projectDir) {
     name: h.name,
     event: h.event,
     matcher: h.matcher,
-    scriptPath: path20.join(".harness", "hooks", `${h.name}.js`)
+    scriptPath: path21.join(".harness", "hooks", `${h.name}.js`)
   }));
   const result = { installed: true, profile, hooks };
   if (warning) {
@@ -2752,7 +3039,7 @@ function listHooks(projectDir) {
   return result;
 }
 function createListCommand() {
-  return new Command24("list").description("Show installed hooks and active profile").action(async (_opts, cmd) => {
+  return new Command26("list").description("Show installed hooks and active profile").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const projectDir = process.cwd();
     const result = listHooks(projectDir);
@@ -2773,28 +3060,28 @@ function createListCommand() {
 }
 
 // src/commands/hooks/remove.ts
-import { Command as Command25 } from "commander";
-import * as fs7 from "fs";
-import * as path21 from "path";
+import { Command as Command27 } from "commander";
+import * as fs8 from "fs";
+import * as path22 from "path";
 function removeHooks(projectDir) {
-  const hooksDir = path21.join(projectDir, ".harness", "hooks");
-  const settingsPath = path21.join(projectDir, ".claude", "settings.json");
+  const hooksDir = path22.join(projectDir, ".harness", "hooks");
+  const settingsPath = path22.join(projectDir, ".claude", "settings.json");
   let removed = false;
   let settingsCleaned = false;
-  if (fs7.existsSync(hooksDir)) {
-    fs7.rmSync(hooksDir, { recursive: true, force: true });
+  if (fs8.existsSync(hooksDir)) {
+    fs8.rmSync(hooksDir, { recursive: true, force: true });
     removed = true;
   }
-  if (fs7.existsSync(settingsPath)) {
+  if (fs8.existsSync(settingsPath)) {
     try {
-      const settings = JSON.parse(fs7.readFileSync(settingsPath, "utf-8"));
+      const settings = JSON.parse(fs8.readFileSync(settingsPath, "utf-8"));
       if (settings.hooks !== void 0) {
         delete settings.hooks;
         settingsCleaned = true;
         if (Object.keys(settings).length === 0) {
-          fs7.unlinkSync(settingsPath);
+          fs8.unlinkSync(settingsPath);
         } else {
-          fs7.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+          fs8.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
         }
       }
     } catch {
@@ -2803,7 +3090,7 @@ function removeHooks(projectDir) {
   return { removed, hooksDir, settingsCleaned };
 }
 function createRemoveCommand() {
-  return new Command25("remove").description("Remove harness-managed hooks from the current project").action(async (_opts, cmd) => {
+  return new Command27("remove").description("Remove harness-managed hooks from the current project").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const projectDir = process.cwd();
     const result = removeHooks(projectDir);
@@ -2825,21 +3112,21 @@ function createRemoveCommand() {
 }
 
 // src/commands/hooks/add.ts
-import { Command as Command26 } from "commander";
-import * as fs8 from "fs";
-import * as path22 from "path";
+import { Command as Command28 } from "commander";
+import * as fs9 from "fs";
+import * as path23 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-var __dirname3 = path22.dirname(fileURLToPath3(import.meta.url));
+var __dirname3 = path23.dirname(fileURLToPath3(import.meta.url));
 var ALIASES = {
   sentinel: ["sentinel-pre", "sentinel-post"]
 };
 function hookSourceDir() {
-  const d = path22.resolve(__dirname3, "..", "..", "hooks");
-  if (fs8.existsSync(d)) return d;
+  const d = path23.resolve(__dirname3, "..", "..", "hooks");
+  if (fs9.existsSync(d)) return d;
   throw new Error(`Hook scripts not found: ${d}`);
 }
 function readJson(p) {
-  return fs8.existsSync(p) ? JSON.parse(fs8.readFileSync(p, "utf-8")) : {};
+  return fs9.existsSync(p) ? JSON.parse(fs9.readFileSync(p, "utf-8")) : {};
 }
 function registerHook(s, ev, matcher, name) {
   if (!s.hooks[ev]) s.hooks[ev] = [];
@@ -2852,11 +3139,11 @@ function addHooks(hookName, projectDir) {
   const names = ALIASES[hookName] ?? [hookName];
   const result = { added: [], alreadyInstalled: [], notFound: [] };
   const srcDir = hookSourceDir();
-  const destDir = path22.join(projectDir, ".harness", "hooks");
-  fs8.mkdirSync(destDir, { recursive: true });
-  const claudeDir = path22.join(projectDir, ".claude");
-  fs8.mkdirSync(claudeDir, { recursive: true });
-  const settingsPath = path22.join(claudeDir, "settings.json");
+  const destDir = path23.join(projectDir, ".harness", "hooks");
+  fs9.mkdirSync(destDir, { recursive: true });
+  const claudeDir = path23.join(projectDir, ".claude");
+  fs9.mkdirSync(claudeDir, { recursive: true });
+  const settingsPath = path23.join(claudeDir, "settings.json");
   const settings = readJson(settingsPath);
   if (!settings.hooks) settings.hooks = {};
   for (const name of names) {
@@ -2865,24 +3152,24 @@ function addHooks(hookName, projectDir) {
       result.notFound.push(name);
       continue;
     }
-    const src = path22.join(srcDir, `${name}.js`);
-    const dest = path22.join(destDir, `${name}.js`);
-    if (fs8.existsSync(dest)) {
+    const src = path23.join(srcDir, `${name}.js`);
+    const dest = path23.join(destDir, `${name}.js`);
+    if (fs9.existsSync(dest)) {
       result.alreadyInstalled.push(name);
-    } else if (!fs8.existsSync(src)) {
+    } else if (!fs9.existsSync(src)) {
       result.notFound.push(name);
       continue;
     } else {
-      fs8.copyFileSync(src, dest);
+      fs9.copyFileSync(src, dest);
       result.added.push(name);
     }
     registerHook(settings, def.event, def.matcher, name);
   }
-  fs8.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs9.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
   return result;
 }
 function createAddCommand2() {
-  return new Command26("add").argument("<hook-name>", "Hook name or alias (e.g., sentinel)").description("Add a hook without changing the profile").action(async (hookName, _opts, cmd) => {
+  return new Command28("add").argument("<hook-name>", "Hook name or alias (e.g., sentinel)").description("Add a hook without changing the profile").action(async (hookName, _opts, cmd) => {
     const projectDir = process.cwd();
     try {
       const res = addHooks(hookName, projectDir);
@@ -2907,7 +3194,7 @@ function createAddCommand2() {
 
 // src/commands/hooks/index.ts
 function createHooksCommand() {
-  const command = new Command27("hooks").description("Manage Claude Code hook configurations");
+  const command = new Command29("hooks").description("Manage Claude Code hook configurations");
   command.addCommand(createInitCommand2());
   command.addCommand(createListCommand());
   command.addCommand(createRemoveCommand());
@@ -2916,10 +3203,10 @@ function createHooksCommand() {
 }
 
 // src/commands/impact-preview.ts
-import { Command as Command28 } from "commander";
+import { Command as Command30 } from "commander";
 import { execSync as execSync4 } from "child_process";
-import * as path23 from "path";
-import * as fs9 from "fs";
+import * as path24 from "path";
+import * as fs10 from "fs";
 function getStagedFiles(cwd) {
   try {
     const output = execSync4("git diff --cached --name-only", {
@@ -2933,7 +3220,7 @@ function getStagedFiles(cwd) {
 }
 function graphExists(projectPath) {
   try {
-    return fs9.existsSync(path23.join(projectPath, ".harness", "graph", "graph.json"));
+    return fs10.existsSync(path24.join(projectPath, ".harness", "graph", "graph.json"));
   } catch {
     return false;
   }
@@ -2942,7 +3229,7 @@ function extractNodeName(id) {
   const parts = id.split(":");
   if (parts.length > 1) {
     const fullPath = parts.slice(1).join(":");
-    return path23.basename(fullPath);
+    return path24.basename(fullPath);
   }
   return id;
 }
@@ -3097,7 +3384,7 @@ function formatImpactOutput(stagedFiles, acc, options) {
   return options.detailed ? formatDetailed(stagedFiles.length, merged, acc.aggregateCounts) : formatCompact(stagedFiles.length, merged, acc.aggregateCounts);
 }
 async function runImpactPreview(options) {
-  const projectPath = path23.resolve(options.path ?? process.cwd());
+  const projectPath = path24.resolve(options.path ?? process.cwd());
   const stagedFiles = getStagedFiles(projectPath);
   if (stagedFiles.length === 0) return "Impact Preview: no staged changes";
   if (!graphExists(projectPath)) {
@@ -3115,7 +3402,7 @@ async function runImpactPreview(options) {
   return formatImpactOutput(stagedFiles, acc, options);
 }
 function createImpactPreviewCommand() {
-  const command = new Command28("impact-preview").description("Show blast radius of staged changes using the knowledge graph").option("--detailed", "Show all affected files instead of top items").option("--per-file", "Show impact per staged file instead of aggregate").option("--path <dir>", "Project root (default: cwd)").action(async (opts) => {
+  const command = new Command30("impact-preview").description("Show blast radius of staged changes using the knowledge graph").option("--detailed", "Show all affected files instead of top items").option("--per-file", "Show impact per staged file instead of aggregate").option("--path <dir>", "Project root (default: cwd)").action(async (opts) => {
     const output = await runImpactPreview({
       detailed: opts.detailed,
       perFile: opts.perFile,
@@ -3128,28 +3415,28 @@ function createImpactPreviewCommand() {
 }
 
 // src/commands/init.ts
-import { Command as Command30 } from "commander";
+import { Command as Command32 } from "commander";
 import chalk3 from "chalk";
-import * as fs12 from "fs";
-import * as path26 from "path";
+import * as fs13 from "fs";
+import * as path27 from "path";
 
 // src/commands/setup-mcp.ts
-import { Command as Command29 } from "commander";
-import * as fs11 from "fs";
-import * as path25 from "path";
+import { Command as Command31 } from "commander";
+import * as fs12 from "fs";
+import * as path26 from "path";
 import * as os2 from "os";
 import chalk2 from "chalk";
 import * as clack from "@clack/prompts";
 
 // src/integrations/toml.ts
-import * as fs10 from "fs";
-import * as path24 from "path";
+import * as fs11 from "fs";
+import * as path25 from "path";
 function writeTomlMcpEntry(filePath, name, entry) {
-  const dir = path24.dirname(filePath);
-  if (!fs10.existsSync(dir)) {
-    fs10.mkdirSync(dir, { recursive: true });
+  const dir = path25.dirname(filePath);
+  if (!fs11.existsSync(dir)) {
+    fs11.mkdirSync(dir, { recursive: true });
   }
-  const existing = fs10.existsSync(filePath) ? fs10.readFileSync(filePath, "utf-8") : "";
+  const existing = fs11.existsSync(filePath) ? fs11.readFileSync(filePath, "utf-8") : "";
   const blockHeader = `[mcp_servers.${name}]`;
   const newBlock = serializeTomlMcpBlock(name, entry);
   let updated;
@@ -3160,8 +3447,8 @@ function writeTomlMcpEntry(filePath, name, entry) {
     updated = existing + separator + newBlock;
   }
   const tmp = filePath + ".tmp";
-  fs10.writeFileSync(tmp, updated);
-  fs10.renameSync(tmp, filePath);
+  fs11.writeFileSync(tmp, updated);
+  fs11.renameSync(tmp, filePath);
 }
 function serializeTomlMcpBlock(name, entry) {
   const lines = [`[mcp_servers.${name}]`];
@@ -3288,7 +3575,8 @@ var ALL_MCP_TOOLS = [
   "predict_failures",
   "recommend_skills",
   "compute_blast_radius",
-  "dispatch_skills"
+  "dispatch_skills",
+  "compact"
 ];
 async function runCursorToolPicker() {
   try {
@@ -3316,20 +3604,20 @@ function writeCursorMcpEntryWithTools(configPath, tools) {
   });
 }
 function readJsonFile(filePath) {
-  if (!fs11.existsSync(filePath)) return null;
+  if (!fs12.existsSync(filePath)) return null;
   try {
-    return JSON.parse(fs11.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs12.readFileSync(filePath, "utf-8"));
   } catch {
-    fs11.copyFileSync(filePath, filePath + ".bak");
+    fs12.copyFileSync(filePath, filePath + ".bak");
     return null;
   }
 }
 function writeJsonFile(filePath, data) {
-  const dir = path25.dirname(filePath);
-  if (!fs11.existsSync(dir)) {
-    fs11.mkdirSync(dir, { recursive: true });
+  const dir = path26.dirname(filePath);
+  if (!fs12.existsSync(dir)) {
+    fs12.mkdirSync(dir, { recursive: true });
   }
-  fs11.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+  fs12.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
 }
 function configureMcpServer(configPath) {
   const config = readJsonFile(configPath) ?? {};
@@ -3344,7 +3632,7 @@ function configureMcpServer(configPath) {
   return true;
 }
 function addGeminiTrustedFolder(cwd) {
-  const trustedPath = path25.join(os2.homedir(), ".gemini", "trustedFolders.json");
+  const trustedPath = path26.join(os2.homedir(), ".gemini", "trustedFolders.json");
   const folders = readJsonFile(trustedPath) ?? {};
   if (folders[cwd] === "TRUST_FOLDER") {
     return false;
@@ -3358,7 +3646,7 @@ function setupMcp(cwd, client) {
   const skipped = [];
   let trustedFolder = false;
   if (client === "all" || client === "claude") {
-    const configPath = path25.join(cwd, ".mcp.json");
+    const configPath = path26.join(cwd, ".mcp.json");
     if (configureMcpServer(configPath)) {
       configured.push("Claude Code");
     } else {
@@ -3366,7 +3654,7 @@ function setupMcp(cwd, client) {
     }
   }
   if (client === "all" || client === "gemini") {
-    const configPath = path25.join(cwd, ".gemini", "settings.json");
+    const configPath = path26.join(cwd, ".gemini", "settings.json");
     if (configureMcpServer(configPath)) {
       configured.push("Gemini CLI");
     } else {
@@ -3375,10 +3663,10 @@ function setupMcp(cwd, client) {
     trustedFolder = addGeminiTrustedFolder(cwd);
   }
   if (client === "all" || client === "codex") {
-    const configPath = path25.join(cwd, ".codex", "config.toml");
+    const configPath = path26.join(cwd, ".codex", "config.toml");
     const alreadyConfigured = (() => {
-      if (!fs11.existsSync(configPath)) return false;
-      const content = fs11.readFileSync(configPath, "utf-8");
+      if (!fs12.existsSync(configPath)) return false;
+      const content = fs12.readFileSync(configPath, "utf-8");
       return content.includes("[mcp_servers.harness]");
     })();
     if (alreadyConfigured) {
@@ -3393,7 +3681,7 @@ function setupMcp(cwd, client) {
     }
   }
   if (client === "all" || client === "cursor") {
-    const configPath = path25.join(cwd, ".cursor", "mcp.json");
+    const configPath = path26.join(cwd, ".cursor", "mcp.json");
     const existing = readJsonFile(configPath);
     if (existing?.mcpServers?.["harness"]) {
       skipped.push("Cursor");
@@ -3407,7 +3695,7 @@ function setupMcp(cwd, client) {
 async function resolveCursorWithPicker(cwd, pick) {
   const configured = [];
   const skipped = [];
-  const cursorConfigPath = path25.join(cwd, ".cursor", "mcp.json");
+  const cursorConfigPath = path26.join(cwd, ".cursor", "mcp.json");
   const existing = readJsonFile(cursorConfigPath);
   if (existing?.mcpServers?.["harness"] && !pick) {
     skipped.push("Cursor");
@@ -3451,7 +3739,7 @@ function printMcpResult(configured, skipped, trustedFolder) {
   console.log("");
 }
 function createSetupMcpCommand() {
-  return new Command29("setup-mcp").description("Configure MCP server for AI agent integration").option("--client <client>", "Client to configure (claude, gemini, codex, cursor, all)", "all").option("--pick", "Launch interactive tool picker (Cursor only)").option("--yes", "Bypass interactive picker and use curated 25-tool set (Cursor only)").action(async (opts, cmd) => {
+  return new Command31("setup-mcp").description("Configure MCP server for AI agent integration").option("--client <client>", "Client to configure (claude, gemini, codex, cursor, all)", "all").option("--pick", "Launch interactive tool picker (Cursor only)").option("--yes", "Bypass interactive picker and use curated 25-tool set (Cursor only)").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     let configured;
@@ -3478,12 +3766,12 @@ function loadEngineAndTemplates(_options) {
 }
 function resolveInitDefaults(options) {
   const cwd = options.cwd ?? process.cwd();
-  return { cwd, name: options.name ?? path26.basename(cwd), force: options.force ?? false };
+  return { cwd, name: options.name ?? path27.basename(cwd), force: options.force ?? false };
 }
 async function runInit(options) {
   const { cwd, name, force } = resolveInitDefaults(options);
-  const configPath = path26.join(cwd, "harness.config.json");
-  if (!force && fs12.existsSync(configPath)) {
+  const configPath = path27.join(cwd, "harness.config.json");
+  if (!force && fs13.existsSync(configPath)) {
     return Err(
       new CLIError("Project already initialized. Use --force to overwrite.", ExitCode.ERROR)
     );
@@ -3549,6 +3837,7 @@ function scaffoldProject(engine, ctx) {
   }
   persistToolingConfig(cwd, resolveResult.value, options.framework);
   appendFrameworkAgents(cwd, options.framework, language);
+  ensureHarnessGitignore(cwd);
   return Ok({
     filesCreated: writeResult.value.written,
     skippedConfigs: writeResult.value.skippedConfigs
@@ -3590,7 +3879,7 @@ async function runInitAction2(opts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createInitCommand3() {
-  const command = new Command30("init").description("Initialize a new harness-engineering project").option("-n, --name <name>", "Project name").option("-l, --level <level>", "Adoption level (basic, intermediate, advanced)", "basic").option("--framework <framework>", "Framework overlay (nextjs)").option("--language <language>", "Target language (typescript, python, go, rust, java)").option("-f, --force", "Overwrite existing files").option("-y, --yes", "Use defaults without prompting").action(async (opts, cmd) => {
+  const command = new Command32("init").description("Initialize a new harness-engineering project").option("-n, --name <name>", "Project name").option("-l, --level <level>", "Adoption level (basic, intermediate, advanced)", "basic").option("--framework <framework>", "Framework overlay (nextjs)").option("--language <language>", "Target language (typescript, python, go, rust, java)").option("-f, --force", "Overwrite existing files").option("-y, --yes", "Use defaults without prompting").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     await runInitAction2({
       name: opts.name,
@@ -3605,16 +3894,16 @@ function createInitCommand3() {
 }
 
 // src/commands/install.ts
-import * as fs17 from "fs";
+import * as fs18 from "fs";
 import * as os5 from "os";
-import * as path31 from "path";
+import * as path32 from "path";
 import { execFileSync as execFileSync3 } from "child_process";
-import { Command as Command31 } from "commander";
+import { Command as Command33 } from "commander";
 import { parse as yamlParse } from "yaml";
 
 // src/registry/npm-client.ts
-import * as fs13 from "fs";
-import * as path27 from "path";
+import * as fs14 from "fs";
+import * as path28 from "path";
 import * as os3 from "os";
 var NPM_REGISTRY = "https://registry.npmjs.org";
 var FETCH_TIMEOUT_MS = 3e4;
@@ -3637,10 +3926,10 @@ function extractSkillName(packageName) {
 function readNpmrcToken(registryUrl) {
   const { hostname, pathname } = new URL(registryUrl);
   const registryPath = `//${hostname}${pathname.replace(/\/$/, "")}/:_authToken=`;
-  const candidates = [path27.join(process.cwd(), ".npmrc"), path27.join(os3.homedir(), ".npmrc")];
+  const candidates = [path28.join(process.cwd(), ".npmrc"), path28.join(os3.homedir(), ".npmrc")];
   for (const npmrcPath of candidates) {
     try {
-      const content = fs13.readFileSync(npmrcPath, "utf-8");
+      const content = fs14.readFileSync(npmrcPath, "utf-8");
       for (const line of content.split("\n")) {
         const trimmed = line.trim();
         if (trimmed.startsWith(registryPath)) {
@@ -3735,19 +4024,19 @@ async function searchNpmRegistry(query, registryUrl) {
 }
 
 // src/registry/tarball.ts
-import * as fs14 from "fs";
-import * as path28 from "path";
+import * as fs15 from "fs";
+import * as path29 from "path";
 import * as os4 from "os";
 import { execFileSync as execFileSync2 } from "child_process";
 function extractTarball(tarballBuffer) {
-  const tmpDir = fs14.mkdtempSync(path28.join(os4.tmpdir(), "harness-skill-install-"));
-  const tarballPath = path28.join(tmpDir, "package.tgz");
+  const tmpDir = fs15.mkdtempSync(path29.join(os4.tmpdir(), "harness-skill-install-"));
+  const tarballPath = path29.join(tmpDir, "package.tgz");
   try {
-    fs14.writeFileSync(tarballPath, tarballBuffer);
+    fs15.writeFileSync(tarballPath, tarballBuffer);
     execFileSync2("tar", ["-xzf", tarballPath, "-C", tmpDir], {
       timeout: 3e4
     });
-    fs14.unlinkSync(tarballPath);
+    fs15.unlinkSync(tarballPath);
   } catch (err) {
     cleanupTempDir(tmpDir);
     throw new Error(
@@ -3758,37 +4047,37 @@ function extractTarball(tarballBuffer) {
   return tmpDir;
 }
 function placeSkillContent(extractedPkgDir, communityBaseDir, skillName, platforms) {
-  const files = fs14.readdirSync(extractedPkgDir);
+  const files = fs15.readdirSync(extractedPkgDir);
   for (const platform of platforms) {
-    const targetDir = path28.join(communityBaseDir, platform, skillName);
-    if (fs14.existsSync(targetDir)) {
-      fs14.rmSync(targetDir, { recursive: true, force: true });
+    const targetDir = path29.join(communityBaseDir, platform, skillName);
+    if (fs15.existsSync(targetDir)) {
+      fs15.rmSync(targetDir, { recursive: true, force: true });
     }
-    fs14.mkdirSync(targetDir, { recursive: true });
+    fs15.mkdirSync(targetDir, { recursive: true });
     for (const file of files) {
       if (file === "package.json" || file === "node_modules") continue;
-      const srcPath = path28.join(extractedPkgDir, file);
-      const destPath = path28.join(targetDir, file);
-      const stat = fs14.statSync(srcPath);
+      const srcPath = path29.join(extractedPkgDir, file);
+      const destPath = path29.join(targetDir, file);
+      const stat = fs15.statSync(srcPath);
       if (stat.isDirectory()) {
-        fs14.cpSync(srcPath, destPath, { recursive: true });
+        fs15.cpSync(srcPath, destPath, { recursive: true });
       } else {
-        fs14.copyFileSync(srcPath, destPath);
+        fs15.copyFileSync(srcPath, destPath);
       }
     }
   }
 }
 function removeSkillContent(communityBaseDir, skillName, platforms) {
   for (const platform of platforms) {
-    const targetDir = path28.join(communityBaseDir, platform, skillName);
-    if (fs14.existsSync(targetDir)) {
-      fs14.rmSync(targetDir, { recursive: true, force: true });
+    const targetDir = path29.join(communityBaseDir, platform, skillName);
+    if (fs15.existsSync(targetDir)) {
+      fs15.rmSync(targetDir, { recursive: true, force: true });
     }
   }
 }
 function cleanupTempDir(dirPath) {
   try {
-    fs14.rmSync(dirPath, { recursive: true, force: true });
+    fs15.rmSync(dirPath, { recursive: true, force: true });
   } catch {
   }
 }
@@ -3830,8 +4119,8 @@ function findDependentsOf(lockfile, targetPackageName) {
 }
 
 // src/registry/lockfile.ts
-import * as fs15 from "fs";
-import * as path29 from "path";
+import * as fs16 from "fs";
+import * as path30 from "path";
 function createEmptyLockfile() {
   return { version: 1, skills: {} };
 }
@@ -3851,10 +4140,10 @@ function sortedStringify(obj) {
   );
 }
 function readLockfile2(filePath) {
-  if (!fs15.existsSync(filePath)) {
+  if (!fs16.existsSync(filePath)) {
     return createEmptyLockfile();
   }
-  const raw = fs15.readFileSync(filePath, "utf-8");
+  const raw = fs16.readFileSync(filePath, "utf-8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -3871,9 +4160,9 @@ function readLockfile2(filePath) {
   return parsed;
 }
 function writeLockfile2(filePath, lockfile) {
-  const dir = path29.dirname(filePath);
-  fs15.mkdirSync(dir, { recursive: true });
-  fs15.writeFileSync(filePath, sortedStringify(lockfile) + "\n", "utf-8");
+  const dir = path30.dirname(filePath);
+  fs16.mkdirSync(dir, { recursive: true });
+  fs16.writeFileSync(filePath, sortedStringify(lockfile) + "\n", "utf-8");
 }
 function updateLockfileEntry(lockfile, name, entry) {
   return {
@@ -3896,17 +4185,17 @@ function removeLockfileEntry(lockfile, name) {
 }
 
 // src/registry/bundled-skills.ts
-import * as fs16 from "fs";
-import * as path30 from "path";
+import * as fs17 from "fs";
+import * as path31 from "path";
 function getBundledSkillNames(bundledSkillsDir) {
-  if (!fs16.existsSync(bundledSkillsDir)) {
+  if (!fs17.existsSync(bundledSkillsDir)) {
     return /* @__PURE__ */ new Set();
   }
-  const entries = fs16.readdirSync(bundledSkillsDir);
+  const entries = fs17.readdirSync(bundledSkillsDir);
   const names = /* @__PURE__ */ new Set();
   for (const entry of entries) {
     try {
-      const stat = fs16.statSync(path30.join(bundledSkillsDir, String(entry)));
+      const stat = fs17.statSync(path31.join(bundledSkillsDir, String(entry)));
       if (stat.isDirectory()) {
         names.add(String(entry));
       }
@@ -3933,12 +4222,12 @@ function validateSkillYaml(parsed) {
 function resolveCommunityBase(global) {
   if (global) {
     const communityBase2 = resolveGlobalCommunityBaseDir();
-    return { communityBase: communityBase2, lockfilePath: path31.join(communityBase2, "skills-lock.json") };
+    return { communityBase: communityBase2, lockfilePath: path32.join(communityBase2, "skills-lock.json") };
   }
   const globalDir = resolveGlobalSkillsDir();
-  const skillsDir = path31.dirname(globalDir);
-  const communityBase = path31.join(skillsDir, "community");
-  return { communityBase, lockfilePath: path31.join(communityBase, "skills-lock.json") };
+  const skillsDir = path32.dirname(globalDir);
+  const communityBase = path32.join(skillsDir, "community");
+  return { communityBase, lockfilePath: path32.join(communityBase, "skills-lock.json") };
 }
 function parseGitHubRef(from) {
   const ghPrefix = from.match(/^github:([^/]+)\/([^#]+?)(?:#(.+))?$/);
@@ -3954,7 +4243,7 @@ function parseGitHubRef(from) {
   return null;
 }
 function cloneGitHubRepo(owner, repo, ref) {
-  const tmpDir = fs17.mkdtempSync(path31.join(os5.tmpdir(), "harness-gh-install-"));
+  const tmpDir = fs18.mkdtempSync(path32.join(os5.tmpdir(), "harness-gh-install-"));
   const url = `https://github.com/${owner}/${repo}.git`;
   try {
     const cloneArgs = ["clone", "--depth", "1"];
@@ -3975,43 +4264,43 @@ function discoverSkillDirs(rootDir) {
   const skillDirs = [];
   function scan(dir, depth) {
     if (depth > 3) return;
-    if (!fs17.existsSync(dir)) return;
-    if (fs17.existsSync(path31.join(dir, "skill.yaml"))) {
+    if (!fs18.existsSync(dir)) return;
+    if (fs18.existsSync(path32.join(dir, "skill.yaml"))) {
       skillDirs.push(dir);
       return;
     }
-    const entries = fs17.readdirSync(dir, { withFileTypes: true });
+    const entries = fs18.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-      scan(path31.join(dir, entry.name), depth + 1);
+      scan(path32.join(dir, entry.name), depth + 1);
     }
   }
   scan(rootDir, 0);
   return skillDirs;
 }
 function resolveLocalPkgDir(fromPath) {
-  const resolvedPath = path31.resolve(fromPath);
-  if (!fs17.existsSync(resolvedPath)) {
+  const resolvedPath = path32.resolve(fromPath);
+  if (!fs18.existsSync(resolvedPath)) {
     throw new Error(`--from path does not exist: ${resolvedPath}`);
   }
-  const stat = fs17.statSync(resolvedPath);
+  const stat = fs18.statSync(resolvedPath);
   if (stat.isDirectory()) {
     return { pkgDir: resolvedPath, extractDir: null };
   }
   if (resolvedPath.endsWith(".tgz") || resolvedPath.endsWith(".tar.gz")) {
-    const tarballBuffer = fs17.readFileSync(resolvedPath);
+    const tarballBuffer = fs18.readFileSync(resolvedPath);
     const extractDir = extractTarball(tarballBuffer);
-    return { pkgDir: path31.join(extractDir, "package"), extractDir };
+    return { pkgDir: path32.join(extractDir, "package"), extractDir };
   }
   throw new Error(`--from path must be a directory or .tgz file. Got: ${resolvedPath}`);
 }
 function installSkillDir(pkgDir, resolvedPath, options) {
-  const skillYamlPath = path31.join(pkgDir, "skill.yaml");
-  if (!fs17.existsSync(skillYamlPath)) {
+  const skillYamlPath = path32.join(pkgDir, "skill.yaml");
+  if (!fs18.existsSync(skillYamlPath)) {
     throw new Error(`No skill.yaml found at ${skillYamlPath}`);
   }
-  const skillYaml = validateSkillYaml(yamlParse(fs17.readFileSync(skillYamlPath, "utf-8")));
+  const skillYaml = validateSkillYaml(yamlParse(fs18.readFileSync(skillYamlPath, "utf-8")));
   const shortName = skillYaml.name;
   const { communityBase, lockfilePath } = resolveCommunityBase(options.global ?? false);
   if (!options.global) {
@@ -4039,7 +4328,7 @@ function installSkillDir(pkgDir, resolvedPath, options) {
 async function runLocalInstall(fromPath, options) {
   const { pkgDir, extractDir } = resolveLocalPkgDir(fromPath);
   try {
-    return installSkillDir(pkgDir, path31.resolve(fromPath), options);
+    return installSkillDir(pkgDir, path32.resolve(fromPath), options);
   } finally {
     if (extractDir) cleanupTempDir(extractDir);
   }
@@ -4082,8 +4371,8 @@ async function runInstall(skillName, options) {
         version: installed.map((r) => r.version).join(", ")
       };
     }
-    const resolvedFrom = path31.resolve(options.from);
-    if (fs17.existsSync(resolvedFrom) && fs17.statSync(resolvedFrom).isDirectory() && !fs17.existsSync(path31.join(resolvedFrom, "skill.yaml"))) {
+    const resolvedFrom = path32.resolve(options.from);
+    if (fs18.existsSync(resolvedFrom) && fs18.statSync(resolvedFrom).isDirectory() && !fs18.existsSync(path32.join(resolvedFrom, "skill.yaml"))) {
       const results = await runBulkInstall(resolvedFrom, options);
       const installed = results.filter((r) => r.installed);
       return {
@@ -4124,12 +4413,12 @@ async function runInstall(skillName, options) {
   const extractDir = extractTarball(tarballBuffer);
   let skillYaml;
   try {
-    const extractedPkgDir = path31.join(extractDir, "package");
-    const skillYamlPath = path31.join(extractedPkgDir, "skill.yaml");
-    if (!fs17.existsSync(skillYamlPath)) {
+    const extractedPkgDir = path32.join(extractDir, "package");
+    const skillYamlPath = path32.join(extractedPkgDir, "skill.yaml");
+    if (!fs18.existsSync(skillYamlPath)) {
       throw new Error(`contains invalid skill.yaml: file not found in package`);
     }
-    const rawYaml = fs17.readFileSync(skillYamlPath, "utf-8");
+    const rawYaml = fs18.readFileSync(skillYamlPath, "utf-8");
     const parsed = yamlParse(rawYaml);
     skillYaml = validateSkillYaml(parsed);
     placeSkillContent(extractedPkgDir, communityBase, shortName, skillYaml.platforms);
@@ -4169,7 +4458,7 @@ async function runInstall(skillName, options) {
   return result;
 }
 function createInstallCommand() {
-  const cmd = new Command31("install");
+  const cmd = new Command33("install");
   cmd.description("Install skills from npm registry, local directory, or GitHub repository").argument("<skill>", 'Skill name, @harness-skills/scoped package, or "." for bulk install').option("--version <range>", "Semver range or exact version to install").option("--force", "Force reinstall even if same version is already installed").option(
     "--from <source>",
     "Install from local path, directory, or GitHub (github:owner/repo, https://github.com/owner/repo)"
@@ -4187,6 +4476,12 @@ function createInstallCommand() {
       } else if (result.installed) {
         logger.success(`Installed ${result.name}@${result.version}`);
       }
+      if (result.installed || result.upgraded) {
+        const globalFlag = opts.global ? " --global --include-global" : "";
+        logger.info(
+          `Run \`harness generate-slash-commands${globalFlag}\` to register slash commands.`
+        );
+      }
     } catch (err) {
       logger.error(err instanceof Error ? err.message : String(err));
       process.exit(1);
@@ -4196,15 +4491,15 @@ function createInstallCommand() {
 }
 
 // src/commands/install-constraints.ts
-import * as fs18 from "fs/promises";
-import * as path32 from "path";
-import { Command as Command32 } from "commander";
+import * as fs19 from "fs/promises";
+import * as path33 from "path";
+import { Command as Command34 } from "commander";
 import semver3 from "semver";
 async function runInstallConstraints(options) {
   const { source, configPath, lockfilePath } = options;
   let rawBundle;
   try {
-    rawBundle = await fs18.readFile(source, "utf-8");
+    rawBundle = await fs19.readFile(source, "utf-8");
   } catch (err) {
     if (isNodeError(err) && err.code === "ENOENT") {
       return { ok: false, error: `Bundle file not found: ${source}` };
@@ -4247,7 +4542,7 @@ async function runInstallConstraints(options) {
   }
   let localConfig;
   try {
-    const raw = await fs18.readFile(configPath, "utf-8");
+    const raw = await fs19.readFile(configPath, "utf-8");
     localConfig = JSON.parse(raw);
   } catch (err) {
     return {
@@ -4395,7 +4690,7 @@ function isNodeError(err) {
   return err instanceof Error && "code" in err;
 }
 function resolveConfigPath(opts) {
-  if (opts.config) return path32.resolve(opts.config);
+  if (opts.config) return path33.resolve(opts.config);
   const found = findConfigFile();
   if (!found.ok) {
     logger.error(found.error.message);
@@ -4430,9 +4725,9 @@ function logInstallResult(val, opts) {
 }
 async function handleInstallConstraints(source, opts) {
   const configPath = resolveConfigPath(opts);
-  const projectRoot = path32.dirname(configPath);
-  const lockfilePath = path32.join(projectRoot, ".harness", "constraints.lock.json");
-  const resolvedSource = path32.resolve(source);
+  const projectRoot = path33.dirname(configPath);
+  const lockfilePath = path33.join(projectRoot, ".harness", "constraints.lock.json");
+  const resolvedSource = path33.resolve(source);
   if (opts.forceLocal && opts.forcePackage) {
     logger.error("Cannot use both --force-local and --force-package.");
     process.exit(1);
@@ -4452,18 +4747,18 @@ async function handleInstallConstraints(source, opts) {
   logInstallResult(result.value, opts);
 }
 function createInstallConstraintsCommand() {
-  const cmd = new Command32("install-constraints");
+  const cmd = new Command34("install-constraints");
   cmd.description("Install a constraints bundle into the local harness config").argument("<source>", "Path to a .harness-constraints.json bundle file").option("--force-local", "Resolve all conflicts by keeping local values").option("--force-package", "Resolve all conflicts by using package values").option("--dry-run", "Show what would change without writing files").option("-c, --config <path>", "Path to harness.config.json").action(handleInstallConstraints);
   return cmd;
 }
 
 // src/commands/integrations/index.ts
-import { Command as Command37 } from "commander";
+import { Command as Command39 } from "commander";
 
 // src/commands/integrations/add.ts
-import { Command as Command33 } from "commander";
-import * as fs19 from "fs";
-import * as path33 from "path";
+import { Command as Command35 } from "commander";
+import * as fs20 from "fs";
+import * as path34 from "path";
 import chalk4 from "chalk";
 function buildMcpEntry(def) {
   const entry = { command: def.mcpConfig.command };
@@ -4472,14 +4767,14 @@ function buildMcpEntry(def) {
   return entry;
 }
 function writeMcpEntries(cwd, defName, mcpEntry) {
-  writeMcpEntry(path33.join(cwd, ".mcp.json"), defName, mcpEntry);
-  const geminiDir = path33.join(cwd, ".gemini");
-  if (fs19.existsSync(geminiDir)) {
-    writeMcpEntry(path33.join(geminiDir, "settings.json"), defName, mcpEntry);
+  writeMcpEntry(path34.join(cwd, ".mcp.json"), defName, mcpEntry);
+  const geminiDir = path34.join(cwd, ".gemini");
+  if (fs20.existsSync(geminiDir)) {
+    writeMcpEntry(path34.join(geminiDir, "settings.json"), defName, mcpEntry);
   }
 }
 function updateIntegrationsConfig(cwd, defName) {
-  const configPath = path33.join(cwd, "harness.config.json");
+  const configPath = path34.join(cwd, "harness.config.json");
   const integConfig = readIntegrationsConfig(configPath);
   if (!integConfig.enabled.includes(defName)) integConfig.enabled.push(defName);
   integConfig.dismissed = integConfig.dismissed.filter((d) => d !== defName);
@@ -4525,7 +4820,7 @@ function printAddSuccess(value) {
   }
 }
 function createAddIntegrationCommand() {
-  return new Command33("add").description("Enable an MCP integration").argument("<name>", "Integration name (e.g. perplexity, augment-code)").action(async (name, _opts, cmd) => {
+  return new Command35("add").description("Enable an MCP integration").argument("<name>", "Integration name (e.g. perplexity, augment-code)").action(async (name, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const result = addIntegration(process.cwd(), name);
     if (!result.ok) {
@@ -4539,8 +4834,8 @@ function createAddIntegrationCommand() {
 }
 
 // src/commands/integrations/list.ts
-import { Command as Command34 } from "commander";
-import * as path34 from "path";
+import { Command as Command36 } from "commander";
+import * as path35 from "path";
 import chalk5 from "chalk";
 function printTier0Integrations(tier0, mcpServers) {
   console.log("  Tier 0 (zero-config):");
@@ -4564,8 +4859,8 @@ function printTier1Integrations(tier1, mcpServers, dismissed) {
 }
 async function runListIntegrations(globalOpts) {
   const cwd = process.cwd();
-  const mcpConfig = readMcpConfig(path34.join(cwd, ".mcp.json"));
-  const integConfig = readIntegrationsConfig(path34.join(cwd, "harness.config.json"));
+  const mcpConfig = readMcpConfig(path35.join(cwd, ".mcp.json"));
+  const integConfig = readIntegrationsConfig(path35.join(cwd, "harness.config.json"));
   const mcpServers = mcpConfig.mcpServers ?? {};
   if (globalOpts.json) {
     const entries = INTEGRATION_REGISTRY.map((i) => ({
@@ -4596,13 +4891,13 @@ async function runListIntegrations(globalOpts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createListIntegrationsCommand() {
-  return new Command34("list").description("Show all MCP integrations with status").action(async (_opts, cmd) => runListIntegrations(cmd.optsWithGlobals()));
+  return new Command36("list").description("Show all MCP integrations with status").action(async (_opts, cmd) => runListIntegrations(cmd.optsWithGlobals()));
 }
 
 // src/commands/integrations/remove.ts
-import { Command as Command35 } from "commander";
-import * as fs20 from "fs";
-import * as path35 from "path";
+import { Command as Command37 } from "commander";
+import * as fs21 from "fs";
+import * as path36 from "path";
 function removeIntegration(cwd, name) {
   const def = INTEGRATION_REGISTRY.find((i) => i.name === name);
   if (!def) {
@@ -4613,21 +4908,21 @@ function removeIntegration(cwd, name) {
       )
     );
   }
-  const mcpPath = path35.join(cwd, ".mcp.json");
+  const mcpPath = path36.join(cwd, ".mcp.json");
   removeMcpEntry(mcpPath, def.name);
-  const geminiDir = path35.join(cwd, ".gemini");
-  if (fs20.existsSync(geminiDir)) {
-    const geminiPath = path35.join(geminiDir, "settings.json");
+  const geminiDir = path36.join(cwd, ".gemini");
+  if (fs21.existsSync(geminiDir)) {
+    const geminiPath = path36.join(geminiDir, "settings.json");
     removeMcpEntry(geminiPath, def.name);
   }
-  const configPath = path35.join(cwd, "harness.config.json");
+  const configPath = path36.join(cwd, "harness.config.json");
   const integConfig = readIntegrationsConfig(configPath);
   integConfig.enabled = integConfig.enabled.filter((e) => e !== def.name);
   writeIntegrationsConfig(configPath, integConfig);
   return Ok(def.displayName);
 }
 function createRemoveIntegrationCommand() {
-  return new Command35("remove").description("Remove an MCP integration").argument("<name>", "Integration name (e.g. perplexity, augment-code)").action(async (name, _opts, cmd) => {
+  return new Command37("remove").description("Remove an MCP integration").argument("<name>", "Integration name (e.g. perplexity, augment-code)").action(async (name, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     const result = removeIntegration(cwd, name);
@@ -4648,8 +4943,8 @@ function createRemoveIntegrationCommand() {
 }
 
 // src/commands/integrations/dismiss.ts
-import { Command as Command36 } from "commander";
-import * as path36 from "path";
+import { Command as Command38 } from "commander";
+import * as path37 from "path";
 function dismissIntegration(cwd, name) {
   const def = INTEGRATION_REGISTRY.find((i) => i.name === name);
   if (!def) {
@@ -4660,7 +4955,7 @@ function dismissIntegration(cwd, name) {
       )
     );
   }
-  const configPath = path36.join(cwd, "harness.config.json");
+  const configPath = path37.join(cwd, "harness.config.json");
   const integConfig = readIntegrationsConfig(configPath);
   if (!integConfig.dismissed.includes(def.name)) {
     integConfig.dismissed.push(def.name);
@@ -4670,7 +4965,7 @@ function dismissIntegration(cwd, name) {
   return Ok(def.displayName);
 }
 function createDismissIntegrationCommand() {
-  return new Command36("dismiss").description("Suppress doctor recommendations for an integration").argument("<name>", "Integration name (e.g. perplexity, augment-code)").action(async (name, _opts, cmd) => {
+  return new Command38("dismiss").description("Suppress doctor recommendations for an integration").argument("<name>", "Integration name (e.g. perplexity, augment-code)").action(async (name, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     const result = dismissIntegration(cwd, name);
@@ -4694,7 +4989,7 @@ function createDismissIntegrationCommand() {
 
 // src/commands/integrations/index.ts
 function createIntegrationsCommand() {
-  const command = new Command37("integrations").description(
+  const command = new Command39("integrations").description(
     "Manage MCP peer integrations (add, list, remove, dismiss)"
   );
   command.addCommand(createListIntegrationsCommand());
@@ -4705,13 +5000,13 @@ function createIntegrationsCommand() {
 }
 
 // src/commands/learnings/index.ts
-import { Command as Command39 } from "commander";
+import { Command as Command41 } from "commander";
 
 // src/commands/learnings/prune.ts
-import { Command as Command38 } from "commander";
-import * as path37 from "path";
+import { Command as Command40 } from "commander";
+import * as path38 from "path";
 async function handlePrune(opts) {
-  const projectPath = path37.resolve(opts.path);
+  const projectPath = path38.resolve(opts.path);
   const result = await pruneLearnings(projectPath, opts.stream);
   if (!result.ok) {
     logger.error(result.error.message);
@@ -4750,23 +5045,23 @@ function printPatternProposals(patterns) {
   );
 }
 function createPruneCommand() {
-  return new Command38("prune").description(
+  return new Command40("prune").description(
     "Analyze global learnings for patterns, present improvement proposals, and archive old entries"
   ).option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(handlePrune);
 }
 
 // src/commands/learnings/index.ts
 function createLearningsCommand() {
-  const command = new Command39("learnings").description("Learnings management commands");
+  const command = new Command41("learnings").description("Learnings management commands");
   command.addCommand(createPruneCommand());
   return command;
 }
 
 // src/commands/linter/index.ts
-import { Command as Command42 } from "commander";
+import { Command as Command44 } from "commander";
 
 // src/commands/linter/generate.ts
-import { Command as Command40 } from "commander";
+import { Command as Command42 } from "commander";
 function formatGenerateError(e) {
   switch (e.type) {
     case "parse":
@@ -4810,7 +5105,7 @@ function handleSuccess(result, useJson) {
 Generated ${result.rulesGenerated.length} rules to ${result.outputDir}`);
 }
 function createGenerateCommand2() {
-  return new Command40("generate").description("Generate ESLint rules from harness-linter.yml").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("-o, --output <dir>", "Override output directory").option("--clean", "Remove existing files before generating").option("--dry-run", "Preview without writing files").option("--json", "Output as JSON").option("--verbose", "Show detailed output").action(async (options) => {
+  return new Command42("generate").description("Generate ESLint rules from harness-linter.yml").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("-o, --output <dir>", "Override output directory").option("--clean", "Remove existing files before generating").option("--dry-run", "Preview without writing files").option("--json", "Output as JSON").option("--verbose", "Show detailed output").action(async (options) => {
     try {
       if (options.verbose) logger.info(`Parsing config: ${options.config}`);
       const result = await generate({
@@ -4832,9 +5127,9 @@ function createGenerateCommand2() {
 }
 
 // src/commands/linter/validate.ts
-import { Command as Command41 } from "commander";
+import { Command as Command43 } from "commander";
 function createValidateCommand() {
-  return new Command41("validate").description("Validate harness-linter.yml config").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("--json", "Output as JSON").action(async (options) => {
+  return new Command43("validate").description("Validate harness-linter.yml config").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("--json", "Output as JSON").action(async (options) => {
     try {
       const result = await validate({ configPath: options.config });
       if (options.json) {
@@ -4853,7 +5148,7 @@ function createValidateCommand() {
 
 // src/commands/linter/index.ts
 function createLinterCommand() {
-  const linter = new Command42("linter").description(
+  const linter = new Command44("linter").description(
     "Generate and validate ESLint rules from YAML config"
   );
   linter.addCommand(createGenerateCommand2());
@@ -4862,22 +5157,22 @@ function createLinterCommand() {
 }
 
 // src/commands/mcp.ts
-import { Command as Command43 } from "commander";
+import { Command as Command45 } from "commander";
 function createMcpCommand() {
-  return new Command43("mcp").description("Start the MCP (Model Context Protocol) server on stdio").option("--tools <tools...>", "Only register the specified tools (used by Cursor integration)").action(async (opts) => {
-    const { startServer: startServer2 } = await import("./mcp-HZ6CRAZR.js");
+  return new Command45("mcp").description("Start the MCP (Model Context Protocol) server on stdio").option("--tools <tools...>", "Only register the specified tools (used by Cursor integration)").action(async (opts) => {
+    const { startServer: startServer2 } = await import("./mcp-JZG22CYT.js");
     await startServer2(opts.tools);
   });
 }
 
 // src/commands/orchestrator.ts
-import { Command as Command44 } from "commander";
-import * as path38 from "path";
+import { Command as Command46 } from "commander";
+import * as path39 from "path";
 import { Orchestrator, WorkflowLoader, launchTUI } from "@harness-engineering/orchestrator";
 function createOrchestratorCommand() {
-  const orchestrator = new Command44("orchestrator");
+  const orchestrator = new Command46("orchestrator");
   orchestrator.command("run").description("Run the orchestrator daemon").option("-w, --workflow <path>", "Path to WORKFLOW.md", "WORKFLOW.md").action(async (opts) => {
-    const workflowPath = path38.resolve(process.cwd(), opts.workflow);
+    const workflowPath = path39.resolve(process.cwd(), opts.workflow);
     const loader = new WorkflowLoader();
     const result = await loader.loadWorkflow(workflowPath);
     if (!result.ok) {
@@ -4901,13 +5196,13 @@ function createOrchestratorCommand() {
 }
 
 // src/commands/perf.ts
-import { Command as Command45 } from "commander";
-import * as path39 from "path";
+import { Command as Command47 } from "commander";
+import * as path40 from "path";
 function registerBenchCommand(perf) {
   perf.command("bench [glob]").description("Run benchmarks via vitest bench").action(async (glob, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
-    const { BenchmarkRunner } = await import("./dist-27IJJDWG.js");
+    const { BenchmarkRunner } = await import("./dist-TZQUURSP.js");
     const runner = new BenchmarkRunner();
     const benchFiles = runner.discover(cwd, glob);
     if (benchFiles.length === 0) {
@@ -4971,7 +5266,7 @@ async function runBaselinesShow(globalOpts) {
 }
 async function runBaselinesUpdate(globalOpts) {
   const cwd = process.cwd();
-  const { BenchmarkRunner } = await import("./dist-27IJJDWG.js");
+  const { BenchmarkRunner } = await import("./dist-TZQUURSP.js");
   const runner = new BenchmarkRunner();
   const manager = new BaselineManager(cwd);
   logger.info("Running benchmarks to update baselines...");
@@ -5012,9 +5307,9 @@ function registerReportCommand(perf) {
   perf.command("report").description("Full performance report with metrics, trends, and hotspots").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
-    const { EntropyAnalyzer: EntropyAnalyzer2 } = await import("./dist-27IJJDWG.js");
+    const { EntropyAnalyzer: EntropyAnalyzer2 } = await import("./dist-TZQUURSP.js");
     const analyzer = new EntropyAnalyzer2({
-      rootDir: path39.resolve(cwd),
+      rootDir: path40.resolve(cwd),
       analyze: { complexity: true, coupling: true }
     });
     const result = await analyzer.analyze();
@@ -5073,7 +5368,7 @@ function registerCriticalPathsCommand(perf) {
   });
 }
 function createPerfCommand() {
-  const perf = new Command45("perf").description("Performance benchmark and baseline management");
+  const perf = new Command47("perf").description("Performance benchmark and baseline management");
   registerBenchCommand(perf);
   registerBaselinesCommands(perf);
   registerReportCommand(perf);
@@ -5082,10 +5377,10 @@ function createPerfCommand() {
 }
 
 // src/commands/persona/index.ts
-import { Command as Command48 } from "commander";
+import { Command as Command50 } from "commander";
 
 // src/commands/persona/list.ts
-import { Command as Command46 } from "commander";
+import { Command as Command48 } from "commander";
 function printPersonaList(personas) {
   if (personas.length === 0) {
     logger.info("No personas found.");
@@ -5099,7 +5394,7 @@ function printPersonaList(personas) {
   }
 }
 function createListCommand2() {
-  return new Command46("list").description("List available agent personas").action(async (_opts, cmd) => {
+  return new Command48("list").description("List available agent personas").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const personasDir = resolvePersonasDir();
     const result = listPersonas(personasDir);
@@ -5119,51 +5414,51 @@ function createListCommand2() {
 }
 
 // src/commands/persona/generate.ts
-import { Command as Command47 } from "commander";
-import * as fs21 from "fs";
-import * as path40 from "path";
+import { Command as Command49 } from "commander";
+import * as fs22 from "fs";
+import * as path41 from "path";
 function generatePersonaArtifacts(persona, outputDir, only) {
   const slug = toKebabCase(persona.name);
   const generated = [];
   if (!only || only === "runtime") {
     const result = generateRuntime(persona);
     if (result.ok) {
-      const outPath = path40.join(outputDir, `${slug}.runtime.json`);
-      fs21.mkdirSync(path40.dirname(outPath), { recursive: true });
-      fs21.writeFileSync(outPath, result.value);
+      const outPath = path41.join(outputDir, `${slug}.runtime.json`);
+      fs22.mkdirSync(path41.dirname(outPath), { recursive: true });
+      fs22.writeFileSync(outPath, result.value);
       generated.push(outPath);
     }
   }
   if (!only || only === "agents-md") {
     const result = generateAgentsMd(persona);
     if (result.ok) {
-      const outPath = path40.join(outputDir, `${slug}.agents.md`);
-      fs21.writeFileSync(outPath, result.value);
+      const outPath = path41.join(outputDir, `${slug}.agents.md`);
+      fs22.writeFileSync(outPath, result.value);
       generated.push(outPath);
     }
   }
   if (!only || only === "ci") {
     const result = generateCIWorkflow(persona, "github");
     if (result.ok) {
-      const outPath = path40.join(outputDir, ".github", "workflows", `${slug}.yml`);
-      fs21.mkdirSync(path40.dirname(outPath), { recursive: true });
-      fs21.writeFileSync(outPath, result.value);
+      const outPath = path41.join(outputDir, ".github", "workflows", `${slug}.yml`);
+      fs22.mkdirSync(path41.dirname(outPath), { recursive: true });
+      fs22.writeFileSync(outPath, result.value);
       generated.push(outPath);
     }
   }
   return generated;
 }
 function createGenerateCommand3() {
-  return new Command47("generate").description("Generate artifacts from a persona config").argument("<name>", "Persona name (e.g., architecture-enforcer)").option("--output-dir <dir>", "Output directory", ".").option("--only <type>", "Generate only: ci, agents-md, runtime").action(async (name, opts, cmd) => {
+  return new Command49("generate").description("Generate artifacts from a persona config").argument("<name>", "Persona name (e.g., architecture-enforcer)").option("--output-dir <dir>", "Output directory", ".").option("--only <type>", "Generate only: ci, agents-md, runtime").action(async (name, opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
-    const personaResult = loadPersona(path40.join(resolvePersonasDir(), `${name}.yaml`));
+    const personaResult = loadPersona(path41.join(resolvePersonasDir(), `${name}.yaml`));
     if (!personaResult.ok) {
       logger.error(personaResult.error.message);
       process.exit(ExitCode.ERROR);
     }
     const generated = generatePersonaArtifacts(
       personaResult.value,
-      path40.resolve(opts.outputDir),
+      path41.resolve(opts.outputDir),
       opts.only
     );
     if (!globalOpts.quiet) {
@@ -5176,14 +5471,14 @@ function createGenerateCommand3() {
 
 // src/commands/persona/index.ts
 function createPersonaCommand() {
-  const command = new Command48("persona").description("Agent persona management commands");
+  const command = new Command50("persona").description("Agent persona management commands");
   command.addCommand(createListCommand2());
   command.addCommand(createGenerateCommand3());
   return command;
 }
 
 // src/commands/predict.ts
-import { Command as Command49 } from "commander";
+import { Command as Command51 } from "commander";
 import chalk6 from "chalk";
 var CATEGORY_ORDER = [
   "circular-deps",
@@ -5289,7 +5584,7 @@ function handlePredictError(err, mode) {
   process.exit(ExitCode.ERROR);
 }
 function createPredictCommand() {
-  const command = new Command49("predict").description("Predict which architectural constraints will break and when").option("--category <name>", "Filter to a single metric category").option("--no-roadmap", "Baseline only \u2014 skip roadmap spec impact").option("--horizon <weeks>", "Forecast horizon in weeks (default: 12)", "12").action(async (opts, cmd) => {
+  const command = new Command51("predict").description("Predict which architectural constraints will break and when").option("--category <name>", "Filter to a single metric category").option("--no-roadmap", "Baseline only \u2014 skip roadmap spec impact").option("--horizon <weeks>", "Forecast horizon in weeks (default: 12)", "12").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : OutputMode.TEXT;
     try {
@@ -5312,7 +5607,7 @@ function createPredictCommand() {
 }
 
 // src/commands/recommend.ts
-import { Command as Command50 } from "commander";
+import { Command as Command52 } from "commander";
 import chalk7 from "chalk";
 async function resolveSnapshot(cwd, noCache) {
   if (!noCache) {
@@ -5376,7 +5671,7 @@ function printRecommendations(result) {
   console.log("");
 }
 function createRecommendCommand() {
-  const command = new Command50("recommend").description("Recommend skills based on codebase health analysis").option("--no-cache", "Force fresh health snapshot").option("--top <n>", "Max recommendations (default 5)", "5").action(async (opts, cmd) => {
+  const command = new Command52("recommend").description("Recommend skills based on codebase health analysis").option("--no-cache", "Force fresh health snapshot").option("--top <n>", "Max recommendations (default 5)", "5").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : OutputMode.TEXT;
     try {
@@ -5412,9 +5707,9 @@ function createRecommendCommand() {
 }
 
 // src/commands/scan-config.ts
-import { Command as Command51 } from "commander";
-import { existsSync as existsSync20, readFileSync as readFileSync11, writeFileSync as writeFileSync12 } from "fs";
-import { join as join31, relative as relative2 } from "path";
+import { Command as Command53 } from "commander";
+import { existsSync as existsSync21, readFileSync as readFileSync11, writeFileSync as writeFileSync12 } from "fs";
+import { join as join32, relative as relative2 } from "path";
 var CONFIG_FILES = ["CLAUDE.md", "AGENTS.md", ".gemini/settings.json", "skill.yaml"];
 function stripHighSeverityPatterns(content, injectionFindings) {
   const highLines = /* @__PURE__ */ new Set();
@@ -5447,7 +5742,7 @@ function applyFix(filePath, targetDir, content, injectionFindings) {
   }
 }
 function scanSingleFile(filePath, targetDir, scanner, options) {
-  if (!existsSync20(filePath)) return null;
+  if (!existsSync21(filePath)) return null;
   let content;
   try {
     content = readFileSync11(filePath, "utf8");
@@ -5471,7 +5766,7 @@ async function runScanConfig(targetDir, options) {
   const scanner = new SecurityScanner(parseSecurityConfig({}));
   const results = [];
   for (const configFile of CONFIG_FILES) {
-    const result = scanSingleFile(join31(targetDir, configFile), targetDir, scanner, options);
+    const result = scanSingleFile(join32(targetDir, configFile), targetDir, scanner, options);
     if (result) results.push(result);
   }
   return { exitCode: computeScanExitCode(results), results };
@@ -5501,7 +5796,7 @@ function formatTextOutput(result) {
   }
 }
 function createScanConfigCommand() {
-  const command = new Command51("scan-config").description(
+  const command = new Command53("scan-config").description(
     "Scan CLAUDE.md, AGENTS.md, .gemini/settings.json, and skill.yaml for prompt injection patterns"
   ).option("--path <dir>", "Target directory to scan (default: cwd)").option("--fix", "Strip high-severity patterns from files in-place").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
@@ -5518,24 +5813,24 @@ function createScanConfigCommand() {
 }
 
 // src/commands/setup.ts
-import { Command as Command52 } from "commander";
-import * as fs23 from "fs";
+import { Command as Command54 } from "commander";
+import * as fs24 from "fs";
 import * as os7 from "os";
-import * as path42 from "path";
+import * as path43 from "path";
 import chalk8 from "chalk";
 
 // src/utils/first-run.ts
-import * as fs22 from "fs";
+import * as fs23 from "fs";
 import * as os6 from "os";
-import * as path41 from "path";
-var HARNESS_DIR = path41.join(os6.homedir(), ".harness");
-var MARKER_FILE = path41.join(HARNESS_DIR, ".setup-complete");
+import * as path42 from "path";
+var HARNESS_DIR = path42.join(os6.homedir(), ".harness");
+var MARKER_FILE = path42.join(HARNESS_DIR, ".setup-complete");
 function isFirstRun() {
-  return !fs22.existsSync(MARKER_FILE);
+  return !fs23.existsSync(MARKER_FILE);
 }
 function markSetupComplete() {
-  fs22.mkdirSync(HARNESS_DIR, { recursive: true });
-  fs22.writeFileSync(MARKER_FILE, "", "utf-8");
+  fs23.mkdirSync(HARNESS_DIR, { recursive: true });
+  fs23.writeFileSync(MARKER_FILE, "", "utf-8");
 }
 function printFirstRunWelcome() {
   try {
@@ -5573,7 +5868,7 @@ function runSlashCommandGeneration() {
   }
 }
 function detectClient(dirName) {
-  return fs23.existsSync(path42.join(os7.homedir(), dirName));
+  return fs24.existsSync(path43.join(os7.homedir(), dirName));
 }
 async function runMcpSetup(cwd) {
   const results = [];
@@ -5615,7 +5910,7 @@ function formatStep(result) {
 }
 function configureTier0Integrations(cwd) {
   try {
-    const mcpPath = path42.join(cwd, ".mcp.json");
+    const mcpPath = path43.join(cwd, ".mcp.json");
     const config = readMcpConfig(mcpPath);
     const tier0 = INTEGRATION_REGISTRY.filter((i) => i.tier === 0);
     const added = [];
@@ -5624,9 +5919,9 @@ function configureTier0Integrations(cwd) {
       writeMcpEntry(mcpPath, integration.name, integration.mcpConfig);
       added.push(integration.displayName);
     }
-    const geminiDir = path42.join(cwd, ".gemini");
-    if (fs23.existsSync(geminiDir)) {
-      const geminiPath = path42.join(geminiDir, "settings.json");
+    const geminiDir = path43.join(cwd, ".gemini");
+    if (fs24.existsSync(geminiDir)) {
+      const geminiPath = path43.join(geminiDir, "settings.json");
       const geminiConfig = readMcpConfig(geminiPath);
       for (const integration of tier0) {
         if (!geminiConfig.mcpServers[integration.name]) {
@@ -5666,7 +5961,7 @@ async function runSetup(cwd) {
   return { steps, success };
 }
 function createSetupCommand() {
-  return new Command52("setup").description("Configure harness environment: slash commands, MCP, and more").action(async () => {
+  return new Command54("setup").description("Configure harness environment: slash commands, MCP, and more").action(async () => {
     const cwd = process.cwd();
     console.log("");
     console.log(`  ${chalk8.bold("harness setup")}`);
@@ -5688,15 +5983,15 @@ function createSetupCommand() {
 }
 
 // src/commands/share.ts
-import { Command as Command53 } from "commander";
-import * as fs24 from "fs";
-import * as path43 from "path";
+import { Command as Command55 } from "commander";
+import * as fs25 from "fs";
+import * as path44 from "path";
 import { parse as parseYaml } from "yaml";
 var MANIFEST_FILENAME = "constraints.yaml";
 async function runShareAction(projectPath, options) {
-  const rootDir = path43.resolve(projectPath);
-  const manifestPath = path43.join(rootDir, MANIFEST_FILENAME);
-  if (!fs24.existsSync(manifestPath)) {
+  const rootDir = path44.resolve(projectPath);
+  const manifestPath = path44.join(rootDir, MANIFEST_FILENAME);
+  if (!fs25.existsSync(manifestPath)) {
     logger.error(
       `No ${MANIFEST_FILENAME} found at ${manifestPath}.
 Create a constraints.yaml in your project root to define what to share.`
@@ -5705,7 +6000,7 @@ Create a constraints.yaml in your project root to define what to share.`
   }
   let parsed;
   try {
-    const raw = fs24.readFileSync(manifestPath, "utf-8");
+    const raw = fs25.readFileSync(manifestPath, "utf-8");
     parsed = parseYaml(raw);
   } catch (err) {
     logger.error(
@@ -5719,7 +6014,7 @@ Create a constraints.yaml in your project root to define what to share.`
     process.exit(1);
   }
   const manifest = manifestResult.value;
-  const configResult = resolveConfig(path43.join(rootDir, "harness.config.json"));
+  const configResult = resolveConfig(path44.join(rootDir, "harness.config.json"));
   if (!configResult.ok) {
     logger.error(configResult.error.message);
     process.exit(1);
@@ -5737,8 +6032,8 @@ Create a constraints.yaml in your project root to define what to share.`
     );
     process.exit(1);
   }
-  const outputDir = path43.resolve(options.output);
-  const outputPath = path43.join(outputDir, `${manifest.name}.harness-constraints.json`);
+  const outputDir = path44.resolve(options.output);
+  const outputPath = path44.join(outputDir, `${manifest.name}.harness-constraints.json`);
   const writeResult = await writeConfig(outputPath, bundle);
   if (!writeResult.ok) {
     logger.error(`Failed to write bundle: ${writeResult.error.message}`);
@@ -5747,28 +6042,28 @@ Create a constraints.yaml in your project root to define what to share.`
   logger.success(`Bundle written to ${outputPath}`);
 }
 function createShareCommand() {
-  return new Command53("share").description("Extract and publish a constraints bundle from constraints.yaml").argument("[path]", "Path to the project root", ".").option("-o, --output <dir>", "Output directory for the bundle", ".").action(async (projectPath, options) => {
+  return new Command55("share").description("Extract and publish a constraints bundle from constraints.yaml").argument("[path]", "Path to the project root", ".").option("-o, --output <dir>", "Output directory for the bundle", ".").action(async (projectPath, options) => {
     await runShareAction(projectPath, options);
   });
 }
 
 // src/commands/skill/index.ts
-import { Command as Command61 } from "commander";
+import { Command as Command63 } from "commander";
 
 // src/commands/skill/list.ts
-import { Command as Command54 } from "commander";
-import * as fs25 from "fs";
-import * as path44 from "path";
+import { Command as Command56 } from "commander";
+import * as fs26 from "fs";
+import * as path45 from "path";
 import { parse } from "yaml";
 function scanDirectory(dirPath, source) {
-  if (!fs25.existsSync(dirPath)) return [];
-  const entries = fs25.readdirSync(dirPath, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+  if (!fs26.existsSync(dirPath)) return [];
+  const entries = fs26.readdirSync(dirPath, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
   const skills = [];
   for (const name of entries) {
-    const yamlPath = path44.join(dirPath, name, "skill.yaml");
-    if (!fs25.existsSync(yamlPath)) continue;
+    const yamlPath = path45.join(dirPath, name, "skill.yaml");
+    if (!fs26.existsSync(yamlPath)) continue;
     try {
-      const raw = fs25.readFileSync(yamlPath, "utf-8");
+      const raw = fs26.readFileSync(yamlPath, "utf-8");
       const parsed = parse(raw);
       const result = SkillMetadataSchema.safeParse(parsed);
       if (result.success) {
@@ -5786,10 +6081,10 @@ function scanDirectory(dirPath, source) {
 }
 function collectCommunitySkills(seen, allSkills) {
   const globalDir = resolveGlobalSkillsDir();
-  const skillsDir = path44.dirname(globalDir);
-  const communityBase = path44.join(skillsDir, "community");
-  const communityPlatformDir = path44.join(communityBase, "claude-code");
-  const lockfilePath = path44.join(communityBase, "skills-lock.json");
+  const skillsDir = path45.dirname(globalDir);
+  const communityBase = path45.join(skillsDir, "community");
+  const communityPlatformDir = path45.join(communityBase, "claude-code");
+  const lockfilePath = path45.join(communityBase, "skills-lock.json");
   const lockfile = readLockfile2(lockfilePath);
   const communitySkills = scanDirectory(communityPlatformDir, "community");
   for (const skill of communitySkills) {
@@ -5859,7 +6154,7 @@ function printSkillsVerbose(skills) {
   for (const s of skills) printSkillEntry(s);
 }
 function createListCommand3() {
-  return new Command54("list").description("List available skills").option("--installed", "Show only community-installed skills").option("--local", "Show only project-local skills").option("--all", "Show all skills (default)").action(async (opts, cmd) => {
+  return new Command56("list").description("List available skills").option("--installed", "Show only community-installed skills").option("--local", "Show only project-local skills").option("--all", "Show all skills (default)").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const skills = collectSkills({ filter: resolveFilter(opts) });
     if (globalOpts.json) {
@@ -5874,9 +6169,9 @@ function createListCommand3() {
 }
 
 // src/commands/skill/run.ts
-import { Command as Command55 } from "commander";
-import * as fs26 from "fs";
-import * as path45 from "path";
+import { Command as Command57 } from "commander";
+import * as fs27 from "fs";
+import * as path46 from "path";
 import { parse as parse2 } from "yaml";
 
 // src/skill/complexity.ts
@@ -5972,10 +6267,10 @@ ${options.principles}`);
 
 // src/commands/skill/run.ts
 function loadSkillMetadata(skillDir) {
-  const yamlPath = path45.join(skillDir, "skill.yaml");
-  if (!fs26.existsSync(yamlPath)) return null;
+  const yamlPath = path46.join(skillDir, "skill.yaml");
+  if (!fs27.existsSync(yamlPath)) return null;
   try {
-    const result = SkillMetadataSchema.safeParse(parse2(fs26.readFileSync(yamlPath, "utf-8")));
+    const result = SkillMetadataSchema.safeParse(parse2(fs27.readFileSync(yamlPath, "utf-8")));
     return result.success ? result.data : null;
   } catch {
     return null;
@@ -5987,22 +6282,22 @@ function resolveComplexity(metadata, requested, projectPath) {
   return requested;
 }
 function loadPrinciples(projectPath) {
-  const principlesPath = path45.join(projectPath, "docs", "principles.md");
-  return fs26.existsSync(principlesPath) ? fs26.readFileSync(principlesPath, "utf-8") : void 0;
+  const principlesPath = path46.join(projectPath, "docs", "principles.md");
+  return fs27.existsSync(principlesPath) ? fs27.readFileSync(principlesPath, "utf-8") : void 0;
 }
 function readMostRecentFileInDir(dirPath) {
-  const files = fs26.readdirSync(dirPath).map((f) => ({ name: f, mtime: fs26.statSync(path45.join(dirPath, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
-  if (files.length > 0) return fs26.readFileSync(path45.join(dirPath, files[0].name), "utf-8");
+  const files = fs27.readdirSync(dirPath).map((f) => ({ name: f, mtime: fs27.statSync(path46.join(dirPath, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
+  if (files.length > 0) return fs27.readFileSync(path46.join(dirPath, files[0].name), "utf-8");
   return void 0;
 }
 function loadPriorState(metadata, projectPath) {
   if (!metadata?.state.persistent || metadata.state.files.length === 0) return void 0;
   for (const stateFilePath of metadata.state.files) {
-    const fullPath = path45.join(projectPath, stateFilePath);
-    if (!fs26.existsSync(fullPath)) continue;
-    const stat = fs26.statSync(fullPath);
+    const fullPath = path46.join(projectPath, stateFilePath);
+    if (!fs27.existsSync(fullPath)) continue;
+    const stat = fs27.statSync(fullPath);
     if (stat.isDirectory()) return readMostRecentFileInDir(fullPath);
-    return fs26.readFileSync(fullPath, "utf-8");
+    return fs27.readFileSync(fullPath, "utf-8");
   }
   return void 0;
 }
@@ -6022,9 +6317,9 @@ function resolvePhaseState(metadata, projectPath, phase) {
 }
 function appendProjectState(content, metadata, projectPath, hasPathOpt) {
   if (!metadata?.state.persistent || !hasPathOpt) return content;
-  const stateFile = path45.join(projectPath, ".harness", "state.json");
-  if (!fs26.existsSync(stateFile)) return content;
-  const stateContent = fs26.readFileSync(stateFile, "utf-8");
+  const stateFile = path46.join(projectPath, ".harness", "state.json");
+  if (!fs27.existsSync(stateFile)) return content;
+  const stateContent = fs27.readFileSync(stateFile, "utf-8");
   return content + `
 
 ---
@@ -6036,14 +6331,14 @@ ${stateContent}
 }
 async function runSkill(name, opts) {
   const skillsDir = resolveSkillsDir();
-  const skillDir = path45.join(skillsDir, name);
-  if (!fs26.existsSync(skillDir)) {
+  const skillDir = path46.join(skillsDir, name);
+  if (!fs27.existsSync(skillDir)) {
     logger.error(`Skill not found: ${name}`);
     process.exit(ExitCode.ERROR);
     return;
   }
   const metadata = loadSkillMetadata(skillDir);
-  const projectPath = opts.path ? path45.resolve(opts.path) : process.cwd();
+  const projectPath = opts.path ? path46.resolve(opts.path) : process.cwd();
   const complexity = resolveComplexity(
     metadata,
     opts.complexity ?? "standard",
@@ -6070,14 +6365,14 @@ async function runSkill(name, opts) {
     ...stateWarning !== void 0 && { stateWarning },
     ...opts.party !== void 0 && { party: opts.party }
   });
-  const skillMdPath = path45.join(skillDir, "SKILL.md");
-  if (!fs26.existsSync(skillMdPath)) {
+  const skillMdPath = path46.join(skillDir, "SKILL.md");
+  if (!fs27.existsSync(skillMdPath)) {
     logger.error(`SKILL.md not found for skill: ${name}`);
     process.exit(ExitCode.ERROR);
     return;
   }
   const content = appendProjectState(
-    fs26.readFileSync(skillMdPath, "utf-8"),
+    fs27.readFileSync(skillMdPath, "utf-8"),
     metadata,
     projectPath,
     !!opts.path
@@ -6086,13 +6381,13 @@ async function runSkill(name, opts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createRunCommand2() {
-  return new Command55("run").description("Run a skill (outputs SKILL.md content with context preamble)").argument("<name>", "Skill name (e.g., harness-tdd)").option("--path <path>", "Project root path for context injection").option("--complexity <level>", "Rigor level: fast, standard, thorough", "standard").option("--phase <name>", "Start at a specific phase (for re-entry)").option("--party", "Enable multi-perspective evaluation").action(async (name, opts) => runSkill(name, opts));
+  return new Command57("run").description("Run a skill (outputs SKILL.md content with context preamble)").argument("<name>", "Skill name (e.g., harness-tdd)").option("--path <path>", "Project root path for context injection").option("--complexity <level>", "Rigor level: fast, standard, thorough", "standard").option("--phase <name>", "Start at a specific phase (for re-entry)").option("--party", "Enable multi-perspective evaluation").action(async (name, opts) => runSkill(name, opts));
 }
 
 // src/commands/skill/validate.ts
-import { Command as Command56 } from "commander";
-import * as fs27 from "fs";
-import * as path46 from "path";
+import { Command as Command58 } from "commander";
+import * as fs28 from "fs";
+import * as path47 from "path";
 import { parse as parse3 } from "yaml";
 var BEHAVIORAL_REQUIRED_SECTIONS = [
   "## When to Use",
@@ -6104,11 +6399,11 @@ var BEHAVIORAL_REQUIRED_SECTIONS = [
 ];
 var KNOWLEDGE_REQUIRED_SECTIONS = ["## Instructions"];
 function validateSkillMd(name, skillMdPath, skillType, errors) {
-  if (!fs27.existsSync(skillMdPath)) {
+  if (!fs28.existsSync(skillMdPath)) {
     errors.push(`${name}: missing SKILL.md`);
     return;
   }
-  const mdContent = fs27.readFileSync(skillMdPath, "utf-8");
+  const mdContent = fs28.readFileSync(skillMdPath, "utf-8");
   if (!mdContent.trim().startsWith("# ")) {
     errors.push(`${name}/SKILL.md: must start with an h1 heading`);
   }
@@ -6133,20 +6428,20 @@ function validateSkillMd(name, skillMdPath, skillType, errors) {
   }
 }
 function validateSkillEntry(name, skillsDir, errors) {
-  const skillDir = path46.join(skillsDir, name);
-  const yamlPath = path46.join(skillDir, "skill.yaml");
-  if (!fs27.existsSync(yamlPath)) {
+  const skillDir = path47.join(skillsDir, name);
+  const yamlPath = path47.join(skillDir, "skill.yaml");
+  if (!fs28.existsSync(yamlPath)) {
     errors.push(`${name}: missing skill.yaml`);
     return false;
   }
   try {
-    const raw = fs27.readFileSync(yamlPath, "utf-8");
+    const raw = fs28.readFileSync(yamlPath, "utf-8");
     const result = SkillMetadataSchema.safeParse(parse3(raw));
     if (!result.success) {
       errors.push(`${name}/skill.yaml: ${result.error.message}`);
       return false;
     }
-    validateSkillMd(name, path46.join(skillDir, "SKILL.md"), result.data.type, errors);
+    validateSkillMd(name, path47.join(skillDir, "SKILL.md"), result.data.type, errors);
     return true;
   } catch (e) {
     errors.push(`${name}: parse error \u2014 ${e instanceof Error ? e.message : String(e)}`);
@@ -6154,15 +6449,15 @@ function validateSkillEntry(name, skillsDir, errors) {
   }
 }
 function createValidateCommand2() {
-  return new Command56("validate").description("Validate all skill.yaml files and SKILL.md structure").action(async (_opts, cmd) => {
+  return new Command58("validate").description("Validate all skill.yaml files and SKILL.md structure").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const skillsDir = resolveSkillsDir();
-    if (!fs27.existsSync(skillsDir)) {
+    if (!fs28.existsSync(skillsDir)) {
       logger.info("No skills directory found.");
       process.exit(ExitCode.SUCCESS);
       return;
     }
-    const entries = fs27.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+    const entries = fs28.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
     const errors = [];
     let validated = 0;
     for (const name of entries) {
@@ -6184,24 +6479,24 @@ function createValidateCommand2() {
 }
 
 // src/commands/skill/info.ts
-import { Command as Command57 } from "commander";
-import * as fs28 from "fs";
-import * as path47 from "path";
+import { Command as Command59 } from "commander";
+import * as fs29 from "fs";
+import * as path48 from "path";
 import { parse as parse4 } from "yaml";
 function loadSkillMetadata2(name) {
   const skillsDir = resolveSkillsDir();
-  const skillDir = path47.join(skillsDir, name);
-  if (!fs28.existsSync(skillDir)) {
+  const skillDir = path48.join(skillsDir, name);
+  if (!fs29.existsSync(skillDir)) {
     logger.error(`Skill not found: ${name}`);
     return { ok: false, exitCode: ExitCode.ERROR };
   }
-  const yamlPath = path47.join(skillDir, "skill.yaml");
-  if (!fs28.existsSync(yamlPath)) {
+  const yamlPath = path48.join(skillDir, "skill.yaml");
+  if (!fs29.existsSync(yamlPath)) {
     logger.error(`skill.yaml not found for skill: ${name}`);
     return { ok: false, exitCode: ExitCode.ERROR };
   }
   try {
-    const raw = fs28.readFileSync(yamlPath, "utf-8");
+    const raw = fs29.readFileSync(yamlPath, "utf-8");
     const parsed = parse4(raw);
     const result = SkillMetadataSchema.safeParse(parsed);
     if (!result.success) {
@@ -6230,7 +6525,7 @@ function printSkillInfo(skill) {
   console.log(`Persistent:  ${skill.state.persistent}`);
 }
 function createInfoCommand() {
-  return new Command57("info").description("Show metadata for a skill").argument("<name>", "Skill name (e.g., harness-tdd)").action(async (name, _opts, cmd) => {
+  return new Command59("info").description("Show metadata for a skill").argument("<name>", "Skill name (e.g., harness-tdd)").action(async (name, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const loaded = loadSkillMetadata2(name);
     if (!loaded.ok) {
@@ -6247,7 +6542,7 @@ function createInfoCommand() {
 }
 
 // src/commands/skill/search.ts
-import { Command as Command58 } from "commander";
+import { Command as Command60 } from "commander";
 async function runSearch(query, opts) {
   const results = await searchNpmRegistry(query, opts.registry);
   return results.filter((r) => {
@@ -6292,15 +6587,15 @@ async function runSearchAction(query, opts, globalOpts) {
   }
 }
 function createSearchCommand() {
-  return new Command58("search").description("Search for community skills on the @harness-skills registry").argument("<query>", "Search query").option("--platform <platform>", "Filter by platform (e.g., claude-code)").option("--trigger <trigger>", "Filter by trigger type (e.g., manual, automatic)").option("--registry <url>", "Use a custom npm registry URL").action(async (query, opts, cmd) => {
+  return new Command60("search").description("Search for community skills on the @harness-skills registry").argument("<query>", "Search query").option("--platform <platform>", "Filter by platform (e.g., claude-code)").option("--trigger <trigger>", "Filter by trigger type (e.g., manual, automatic)").option("--registry <url>", "Use a custom npm registry URL").action(async (query, opts, cmd) => {
     await runSearchAction(query, opts, cmd.optsWithGlobals());
   });
 }
 
 // src/commands/skill/create.ts
-import { Command as Command59 } from "commander";
-import * as path48 from "path";
-import * as fs29 from "fs";
+import { Command as Command61 } from "commander";
+import * as path49 from "path";
+import * as fs30 from "fs";
 import YAML from "yaml";
 var KEBAB_CASE_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 function buildReadme(name, description) {
@@ -6384,22 +6679,22 @@ function runCreate(name, opts) {
   if (!KEBAB_CASE_RE.test(name)) {
     throw new Error(`Invalid skill name "${name}". Must be kebab-case (e.g., my-skill).`);
   }
-  const baseDir = opts.outputDir ?? path48.join(process.cwd(), "agents", "skills", "claude-code");
-  const skillDir = path48.join(baseDir, name);
-  if (fs29.existsSync(skillDir)) {
+  const baseDir = opts.outputDir ?? path49.join(process.cwd(), "agents", "skills", "claude-code");
+  const skillDir = path49.join(baseDir, name);
+  if (fs30.existsSync(skillDir)) {
     throw new Error(`Skill directory already exists: ${skillDir}`);
   }
-  fs29.mkdirSync(skillDir, { recursive: true });
+  fs30.mkdirSync(skillDir, { recursive: true });
   const description = opts.description || `A community skill: ${name}`;
   const skillYaml = buildSkillYaml(name, opts);
-  const skillYamlPath = path48.join(skillDir, "skill.yaml");
-  fs29.writeFileSync(skillYamlPath, YAML.stringify(skillYaml));
+  const skillYamlPath = path49.join(skillDir, "skill.yaml");
+  fs30.writeFileSync(skillYamlPath, YAML.stringify(skillYaml));
   const skillMd = buildSkillMd(name, description);
-  const skillMdPath = path48.join(skillDir, "SKILL.md");
-  fs29.writeFileSync(skillMdPath, skillMd);
+  const skillMdPath = path49.join(skillDir, "SKILL.md");
+  fs30.writeFileSync(skillMdPath, skillMd);
   const readme = buildReadme(name, description);
-  const readmePath = path48.join(skillDir, "README.md");
-  fs29.writeFileSync(readmePath, readme);
+  const readmePath = path49.join(skillDir, "README.md");
+  fs30.writeFileSync(readmePath, readme);
   return {
     name,
     directory: skillDir,
@@ -6413,12 +6708,12 @@ function printCreateResult(name, result) {
   }
   logger.info(`
 Next steps:`);
-  logger.info(`  1. Edit ${path48.join(result.directory, "SKILL.md")} with your skill content`);
+  logger.info(`  1. Edit ${path49.join(result.directory, "SKILL.md")} with your skill content`);
   logger.info(`  2. Run: harness skill validate ${name}`);
   logger.info(`  3. Run: harness skills publish`);
 }
 function createCreateCommand() {
-  return new Command59("create").description("Scaffold a new community skill").argument("<name>", "Skill name (kebab-case)").option("--description <desc>", "Skill description").option("--type <type>", "Skill type: rigid or flexible", "flexible").option("--platforms <platforms>", "Comma-separated platforms (default: claude-code)").option("--triggers <triggers>", "Comma-separated triggers (default: manual)").option("--output-dir <dir>", "Output directory (default: agents/skills/claude-code/)").action(async (name, opts, cmd) => {
+  return new Command61("create").description("Scaffold a new community skill").argument("<name>", "Skill name (kebab-case)").option("--description <desc>", "Skill description").option("--type <type>", "Skill type: rigid or flexible", "flexible").option("--platforms <platforms>", "Comma-separated platforms (default: claude-code)").option("--triggers <triggers>", "Comma-separated triggers (default: manual)").option("--output-dir <dir>", "Output directory (default: agents/skills/claude-code/)").action(async (name, opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     try {
       const result = runCreate(name, {
@@ -6441,26 +6736,26 @@ function createCreateCommand() {
 }
 
 // src/commands/skill/publish.ts
-import { Command as Command60 } from "commander";
-import * as fs31 from "fs";
-import * as path50 from "path";
+import { Command as Command62 } from "commander";
+import * as fs32 from "fs";
+import * as path51 from "path";
 import { execFileSync as execFileSync5 } from "child_process";
 
 // src/registry/validator.ts
-import * as fs30 from "fs";
-import * as path49 from "path";
+import * as fs31 from "fs";
+import * as path50 from "path";
 import { parse as parse5 } from "yaml";
 import semver4 from "semver";
 async function validateForPublish(skillDir, registryUrl) {
   const errors = [];
-  const skillYamlPath = path49.join(skillDir, "skill.yaml");
-  if (!fs30.existsSync(skillYamlPath)) {
+  const skillYamlPath = path50.join(skillDir, "skill.yaml");
+  if (!fs31.existsSync(skillYamlPath)) {
     errors.push("skill.yaml not found. Create one with: harness skill create <name>");
     return { valid: false, errors };
   }
   let skillMeta;
   try {
-    const raw = fs30.readFileSync(skillYamlPath, "utf-8");
+    const raw = fs31.readFileSync(skillYamlPath, "utf-8");
     const parsed = parse5(raw);
     const result = SkillMetadataSchema.safeParse(parsed);
     if (!result.success) {
@@ -6482,11 +6777,11 @@ async function validateForPublish(skillDir, registryUrl) {
   if (!skillMeta.triggers || skillMeta.triggers.length === 0) {
     errors.push("At least one trigger is required. Add triggers to skill.yaml.");
   }
-  const skillMdPath = path49.join(skillDir, "SKILL.md");
-  if (!fs30.existsSync(skillMdPath)) {
+  const skillMdPath = path50.join(skillDir, "SKILL.md");
+  if (!fs31.existsSync(skillMdPath)) {
     errors.push("SKILL.md not found. Create it with content describing your skill.");
   } else {
-    const content = fs30.readFileSync(skillMdPath, "utf-8");
+    const content = fs31.readFileSync(skillMdPath, "utf-8");
     if (!content.includes("## When to Use")) {
       errors.push('SKILL.md must contain a "## When to Use" section.');
     }
@@ -6566,11 +6861,11 @@ ${errorList}`);
   }
   const meta = validation.skillMeta;
   const pkg = derivePackageJson(meta);
-  const pkgPath = path50.join(skillDir, "package.json");
-  fs31.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-  const readmePath = path50.join(skillDir, "README.md");
-  if (!fs31.existsSync(readmePath)) {
-    const skillMdContent = fs31.readFileSync(path50.join(skillDir, "SKILL.md"), "utf-8");
+  const pkgPath = path51.join(skillDir, "package.json");
+  fs32.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+  const readmePath = path51.join(skillDir, "README.md");
+  if (!fs32.existsSync(readmePath)) {
+    const skillMdContent = fs32.readFileSync(path51.join(skillDir, "SKILL.md"), "utf-8");
     const readme = `# ${pkg.name}
 
 ${meta.description}
@@ -6584,7 +6879,7 @@ harness install ${meta.name}
 ---
 
 ${skillMdContent}`;
-    fs31.writeFileSync(readmePath, readme);
+    fs32.writeFileSync(readmePath, readme);
   }
   if (opts.dryRun) {
     return {
@@ -6610,7 +6905,7 @@ ${skillMdContent}`;
   };
 }
 function createPublishCommand() {
-  return new Command60("publish").description("Validate and publish a skill to @harness-skills on npm").option("--dry-run", "Run validation and generate package.json without publishing").option("--dir <dir>", "Skill directory (default: current directory)").option("--registry <url>", "Use a custom npm registry URL").action(async (opts, cmd) => {
+  return new Command62("publish").description("Validate and publish a skill to @harness-skills on npm").option("--dry-run", "Run validation and generate package.json without publishing").option("--dir <dir>", "Skill directory (default: current directory)").option("--registry <url>", "Use a custom npm registry URL").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const skillDir = opts.dir || process.cwd();
     try {
@@ -6635,7 +6930,7 @@ function createPublishCommand() {
 
 // src/commands/skill/index.ts
 function createSkillCommand() {
-  const command = new Command61("skill").description("Skill management commands");
+  const command = new Command63("skill").description("Skill management commands");
   command.addCommand(createListCommand3());
   command.addCommand(createRunCommand2());
   command.addCommand(createValidateCommand2());
@@ -6647,7 +6942,7 @@ function createSkillCommand() {
 }
 
 // src/commands/snapshot.ts
-import { Command as Command62 } from "commander";
+import { Command as Command64 } from "commander";
 import { execSync as execSync5 } from "child_process";
 import chalk9 from "chalk";
 function getCommitHash3(cwd) {
@@ -6829,7 +7124,7 @@ function registerListCommand(parent) {
   });
 }
 function createSnapshotCommand() {
-  const command = new Command62("snapshot").description("Architecture timeline snapshot commands");
+  const command = new Command64("snapshot").description("Architecture timeline snapshot commands");
   registerCaptureCommand(command);
   registerTrendsCommand(command);
   registerListCommand(command);
@@ -6837,11 +7132,11 @@ function createSnapshotCommand() {
 }
 
 // src/commands/state/index.ts
-import { Command as Command67 } from "commander";
+import { Command as Command69 } from "commander";
 
 // src/commands/state/show.ts
-import { Command as Command63 } from "commander";
-import * as path51 from "path";
+import { Command as Command65 } from "commander";
+import * as path52 from "path";
 function printStateText(state, stream) {
   if (stream) console.log(`Stream:         ${stream}`);
   console.log(`Schema Version: ${state.schemaVersion}`);
@@ -6865,9 +7160,9 @@ function printStateProgress(progress) {
   }
 }
 function createShowCommand() {
-  return new Command63("show").description("Show current project state").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(async (opts, cmd) => {
+  return new Command65("show").description("Show current project state").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
-    const result = await loadState(path51.resolve(opts.path), opts.stream);
+    const result = await loadState(path52.resolve(opts.path), opts.stream);
     if (!result.ok) {
       logger.error(result.error.message);
       process.exit(ExitCode.ERROR);
@@ -6882,9 +7177,9 @@ function createShowCommand() {
 }
 
 // src/commands/state/reset.ts
-import { Command as Command64 } from "commander";
-import * as fs32 from "fs";
-import * as path52 from "path";
+import { Command as Command66 } from "commander";
+import * as fs33 from "fs";
+import * as path53 from "path";
 import * as readline from "readline";
 async function resolveStatePath(projectPath, stream) {
   if (stream) {
@@ -6893,22 +7188,22 @@ async function resolveStatePath(projectPath, stream) {
       logger.error(streamResult.error.message);
       process.exit(ExitCode.ERROR);
     }
-    return path52.join(streamResult.value, "state.json");
+    return path53.join(streamResult.value, "state.json");
   }
-  return path52.join(projectPath, ".harness", "state.json");
+  return path53.join(projectPath, ".harness", "state.json");
 }
 async function confirmReset() {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve32) => {
-    rl.question("Reset project state? This cannot be undone. [y/N] ", resolve32);
+  const answer = await new Promise((resolve33) => {
+    rl.question("Reset project state? This cannot be undone. [y/N] ", resolve33);
   });
   rl.close();
   return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
 }
 async function runReset(opts) {
-  const projectPath = path52.resolve(opts.path);
+  const projectPath = path53.resolve(opts.path);
   const statePath = await resolveStatePath(projectPath, opts.stream);
-  if (!fs32.existsSync(statePath)) {
+  if (!fs33.existsSync(statePath)) {
     logger.info("No state file found. Nothing to reset.");
     process.exit(ExitCode.SUCCESS);
   }
@@ -6917,7 +7212,7 @@ async function runReset(opts) {
     process.exit(ExitCode.SUCCESS);
   }
   try {
-    fs32.unlinkSync(statePath);
+    fs33.unlinkSync(statePath);
     logger.success("Project state reset.");
   } catch (e) {
     logger.error(`Failed to reset state: ${e instanceof Error ? e.message : String(e)}`);
@@ -6926,15 +7221,15 @@ async function runReset(opts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createResetCommand() {
-  return new Command64("reset").description("Reset project state (deletes .harness/state.json)").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").option("--yes", "Skip confirmation prompt").action(async (opts) => runReset(opts));
+  return new Command66("reset").description("Reset project state (deletes .harness/state.json)").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").option("--yes", "Skip confirmation prompt").action(async (opts) => runReset(opts));
 }
 
 // src/commands/state/learn.ts
-import { Command as Command65 } from "commander";
-import * as path53 from "path";
+import { Command as Command67 } from "commander";
+import * as path54 from "path";
 function createLearnCommand() {
-  return new Command65("learn").description("Append a learning to .harness/learnings.md").argument("<message>", "The learning to record").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(async (message, opts, _cmd) => {
-    const projectPath = path53.resolve(opts.path);
+  return new Command67("learn").description("Append a learning to .harness/learnings.md").argument("<message>", "The learning to record").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(async (message, opts, _cmd) => {
+    const projectPath = path54.resolve(opts.path);
     const result = await appendLearning(projectPath, message, void 0, void 0, opts.stream);
     if (!result.ok) {
       logger.error(result.error.message);
@@ -6947,10 +7242,10 @@ function createLearnCommand() {
 }
 
 // src/commands/state/streams.ts
-import { Command as Command66 } from "commander";
-import * as path54 from "path";
+import { Command as Command68 } from "commander";
+import * as path55 from "path";
 async function runListStreams(opts, globalOpts) {
-  const projectPath = path54.resolve(opts.path);
+  const projectPath = path55.resolve(opts.path);
   const indexResult = await loadStreamIndex(projectPath);
   const result = await listStreams(projectPath);
   if (!result.ok) {
@@ -6971,7 +7266,7 @@ async function runListStreams(opts, globalOpts) {
   process.exit(ExitCode.SUCCESS);
 }
 async function runCreateStream(name, opts) {
-  const result = await createStream(path54.resolve(opts.path), name, opts.branch);
+  const result = await createStream(path55.resolve(opts.path), name, opts.branch);
   if (!result.ok) {
     logger.error(result.error.message);
     process.exit(ExitCode.ERROR);
@@ -6980,7 +7275,7 @@ async function runCreateStream(name, opts) {
   process.exit(ExitCode.SUCCESS);
 }
 async function runArchiveStream(name, opts) {
-  const result = await archiveStream(path54.resolve(opts.path), name);
+  const result = await archiveStream(path55.resolve(opts.path), name);
   if (!result.ok) {
     logger.error(result.error.message);
     process.exit(ExitCode.ERROR);
@@ -6989,7 +7284,7 @@ async function runArchiveStream(name, opts) {
   process.exit(ExitCode.SUCCESS);
 }
 async function runActivateStream(name, opts) {
-  const result = await setActiveStream(path54.resolve(opts.path), name);
+  const result = await setActiveStream(path55.resolve(opts.path), name);
   if (!result.ok) {
     logger.error(result.error.message);
     process.exit(ExitCode.ERROR);
@@ -6998,7 +7293,7 @@ async function runActivateStream(name, opts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createStreamsCommand() {
-  const command = new Command66("streams").description("Manage state streams");
+  const command = new Command68("streams").description("Manage state streams");
   command.command("list").description("List all known streams").option("--path <path>", "Project root path", ".").action(async (opts, cmd) => runListStreams(opts, cmd.optsWithGlobals()));
   command.command("create <name>").description("Create a new stream").option("--path <path>", "Project root path", ".").option("--branch <branch>", "Associate with a git branch").action(async (name, opts) => runCreateStream(name, opts));
   command.command("archive <name>").description("Archive a stream").option("--path <path>", "Project root path", ".").action(async (name, opts) => runArchiveStream(name, opts));
@@ -7008,7 +7303,7 @@ function createStreamsCommand() {
 
 // src/commands/state/index.ts
 function createStateCommand() {
-  const command = new Command67("state").description("Project state management commands");
+  const command = new Command69("state").description("Project state management commands");
   command.addCommand(createShowCommand());
   command.addCommand(createResetCommand());
   command.addCommand(createLearnCommand());
@@ -7017,7 +7312,7 @@ function createStateCommand() {
 }
 
 // src/commands/taint.ts
-import { Command as Command68 } from "commander";
+import { Command as Command70 } from "commander";
 function getProjectRoot() {
   return process.cwd();
 }
@@ -7089,14 +7384,143 @@ function registerStatusCommand(taint) {
   });
 }
 function createTaintCommand() {
-  const taint = new Command68("taint").description("Manage sentinel session taint state");
+  const taint = new Command70("taint").description("Manage sentinel session taint state");
   registerClearCommand(taint);
   registerStatusCommand(taint);
   return taint;
 }
 
+// src/commands/telemetry/index.ts
+import { Command as Command73 } from "commander";
+
+// src/commands/telemetry/identify.ts
+import { Command as Command71 } from "commander";
+import * as fs34 from "fs";
+import * as path56 from "path";
+function telemetryFilePath(cwd) {
+  return path56.join(cwd, ".harness", "telemetry.json");
+}
+function writeTelemetryFile(cwd, data) {
+  const filePath = telemetryFilePath(cwd);
+  const dir = path56.dirname(filePath);
+  fs34.mkdirSync(dir, { recursive: true });
+  fs34.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+var IDENTITY_FIELDS = ["project", "team", "alias"];
+function applyIdentityFields(opts, identity) {
+  for (const field of IDENTITY_FIELDS) {
+    if (opts[field]) identity[field] = opts[field];
+  }
+}
+function printIdentity(identity) {
+  for (const field of IDENTITY_FIELDS) {
+    if (identity[field]) logger.info(`  ${field.padEnd(7)}: ${identity[field]}`);
+  }
+}
+function createIdentifyCommand() {
+  const cmd = new Command71("identify").description("Set or clear telemetry identity fields in .harness/telemetry.json").option("--project <name>", "Project name").option("--team <name>", "Team name").option("--alias <name>", "User alias").option("--clear", "Remove all identity fields").action((opts) => {
+    const cwd = process.cwd();
+    if (opts.clear) {
+      writeTelemetryFile(cwd, { identity: {} });
+      logger.success("Telemetry identity cleared.");
+      return;
+    }
+    const hasField = IDENTITY_FIELDS.some((f) => opts[f]);
+    if (!hasField) {
+      logger.error("Provide at least one of --project, --team, --alias, or --clear.");
+      process.exitCode = 1;
+      return;
+    }
+    const existingIdentity = readIdentity(cwd);
+    const existing = { identity: { ...existingIdentity } };
+    applyIdentityFields(opts, existing.identity);
+    writeTelemetryFile(cwd, existing);
+    logger.success("Telemetry identity updated:");
+    printIdentity(existing.identity);
+  });
+  return cmd;
+}
+
+// src/commands/telemetry/status.ts
+import { Command as Command72 } from "commander";
+function gatherEnvOverrides() {
+  const overrides = {};
+  if (process.env.DO_NOT_TRACK) overrides.DO_NOT_TRACK = process.env.DO_NOT_TRACK;
+  if (process.env.HARNESS_TELEMETRY_OPTOUT)
+    overrides.HARNESS_TELEMETRY_OPTOUT = process.env.HARNESS_TELEMETRY_OPTOUT;
+  return overrides;
+}
+function resolveDisabledReason() {
+  if (process.env.DO_NOT_TRACK === "1") return "DO_NOT_TRACK=1";
+  if (process.env.HARNESS_TELEMETRY_OPTOUT === "1") return "HARNESS_TELEMETRY_OPTOUT=1";
+  return "telemetry.enabled is false in config";
+}
+function printHumanStatus(result) {
+  logger.info(`Telemetry: ${result.consent.allowed ? "enabled" : "disabled"}`);
+  if (!result.consent.allowed && result.consent.reason) {
+    logger.info(`  Reason:  ${result.consent.reason}`);
+  }
+  logger.info(`Install ID: ${result.installId ?? "not yet created"}`);
+  const { identity } = result;
+  const hasIdentity = identity.project || identity.team || identity.alias;
+  if (hasIdentity) {
+    logger.info("Identity:");
+    for (const [key, value] of Object.entries(identity)) {
+      if (value) logger.info(`  ${key.padEnd(7)}: ${value}`);
+    }
+  } else {
+    logger.info("Identity: not configured");
+  }
+  const overrideKeys = Object.keys(result.envOverrides);
+  if (overrideKeys.length > 0) {
+    logger.info("Env overrides:");
+    for (const key of overrideKeys) {
+      logger.info(`  ${key}=${result.envOverrides[key]}`);
+    }
+  }
+}
+function createStatusCommand() {
+  const cmd = new Command72("status").description("Show current telemetry consent state, install ID, and identity").option("--json", "Output as JSON").action((opts) => {
+    const cwd = process.cwd();
+    const envOverrides = gatherEnvOverrides();
+    const consent = resolveConsent(cwd, void 0);
+    let installId = null;
+    let identity = {};
+    if (consent.allowed) {
+      identity = readIdentity(cwd);
+      try {
+        installId = getOrCreateInstallId(cwd);
+      } catch {
+      }
+    }
+    const result = {
+      consent: {
+        allowed: consent.allowed,
+        ...!consent.allowed ? { reason: resolveDisabledReason() } : {}
+      },
+      installId,
+      identity,
+      envOverrides
+    };
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    printHumanStatus(result);
+  });
+  return cmd;
+}
+
+// src/commands/telemetry/index.ts
+function createTelemetryCommand() {
+  const command = new Command73("telemetry").description("Telemetry identity and status management");
+  command.addCommand(createIdentifyCommand());
+  command.addCommand(createStatusCommand());
+  return command;
+}
+
 // src/commands/traceability.ts
-import { Command as Command69 } from "commander";
+import { Command as Command74 } from "commander";
 import chalk10 from "chalk";
 function confidenceLabel(maxConfidence) {
   if (maxConfidence >= 0.8) return "explicit";
@@ -7212,7 +7636,7 @@ async function runTraceability(options) {
   const projectPath = process.cwd();
   const store = await loadGraphStore(projectPath);
   if (!store) handleNoStore(mode);
-  const graphModule = await import("./dist-M6FBUXZD.js");
+  const graphModule = await import("./dist-QW5G3GX3.js");
   const filterOptions = buildFilterOptions(options);
   const results = graphModule.queryTraceability(store, filterOptions);
   if (results.length === 0) handleEmptyResults(mode);
@@ -7227,7 +7651,7 @@ async function runTraceability(options) {
   process.exit(ExitCode.SUCCESS);
 }
 function createTraceabilityCommand() {
-  return new Command69("traceability").description("Show spec-to-implementation traceability from the knowledge graph").option("--spec <path>", "Filter by spec file path").option("--feature <name>", "Filter by feature name").action(async (opts, cmd) => {
+  return new Command74("traceability").description("Show spec-to-implementation traceability from the knowledge graph").option("--spec <path>", "Filter by spec file path").option("--feature <name>", "Filter by feature name").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     await runTraceability({
       spec: opts.spec,
@@ -7240,15 +7664,15 @@ function createTraceabilityCommand() {
 }
 
 // src/commands/uninstall.ts
-import * as path55 from "path";
-import { Command as Command70 } from "commander";
+import * as path57 from "path";
+import { Command as Command75 } from "commander";
 async function runUninstall(skillName, options) {
   const packageName = resolvePackageName(skillName);
   const shortName = extractSkillName(packageName);
   const globalDir = resolveGlobalSkillsDir();
-  const skillsDir = path55.dirname(globalDir);
-  const communityBase = path55.join(skillsDir, "community");
-  const lockfilePath = path55.join(communityBase, "skills-lock.json");
+  const skillsDir = path57.dirname(globalDir);
+  const communityBase = path57.join(skillsDir, "community");
+  const lockfilePath = path57.join(communityBase, "skills-lock.json");
   const lockfile = readLockfile2(lockfilePath);
   const entry = lockfile.skills[packageName];
   if (!entry) {
@@ -7278,7 +7702,7 @@ async function runUninstall(skillName, options) {
   return result;
 }
 function createUninstallCommand() {
-  const cmd = new Command70("uninstall");
+  const cmd = new Command75("uninstall");
   cmd.description("Uninstall a community skill").argument("<skill>", "Skill name or @harness-skills/scoped package name").option("--force", "Remove even if other skills depend on this one").action(async (skill, opts) => {
     try {
       const result = await runUninstall(skill, opts);
@@ -7297,9 +7721,9 @@ function createUninstallCommand() {
 }
 
 // src/commands/uninstall-constraints.ts
-import * as fs33 from "fs/promises";
-import * as path56 from "path";
-import { Command as Command71 } from "commander";
+import * as fs35 from "fs/promises";
+import * as path58 from "path";
+import { Command as Command76 } from "commander";
 async function runUninstallConstraints(options) {
   const { packageName, configPath, lockfilePath } = options;
   const lockfileResult = await readLockfile(lockfilePath);
@@ -7319,7 +7743,7 @@ async function runUninstallConstraints(options) {
   }
   let localConfig;
   try {
-    const raw = await fs33.readFile(configPath, "utf-8");
+    const raw = await fs35.readFile(configPath, "utf-8");
     localConfig = JSON.parse(raw);
   } catch (err) {
     return {
@@ -7356,11 +7780,11 @@ async function runUninstallConstraints(options) {
   };
 }
 function createUninstallConstraintsCommand() {
-  const cmd = new Command71("uninstall-constraints");
+  const cmd = new Command76("uninstall-constraints");
   cmd.description("Remove a previously installed constraints package").argument("<name>", "Name of the constraint package to uninstall").option("-c, --config <path>", "Path to harness.config.json").action(async (name, opts) => {
     let configPath;
     if (opts.config) {
-      configPath = path56.resolve(opts.config);
+      configPath = path58.resolve(opts.config);
     } else {
       const found = findConfigFile();
       if (!found.ok) {
@@ -7369,8 +7793,8 @@ function createUninstallConstraintsCommand() {
       }
       configPath = found.value;
     }
-    const projectRoot = path56.dirname(configPath);
-    const lockfilePath = path56.join(projectRoot, ".harness", "constraints.lock.json");
+    const projectRoot = path58.dirname(configPath);
+    const lockfilePath = path58.join(projectRoot, ".harness", "constraints.lock.json");
     const result = await runUninstallConstraints({
       packageName: name,
       configPath,
@@ -7395,9 +7819,10 @@ function createUninstallConstraintsCommand() {
 }
 
 // src/commands/update.ts
-import { Command as Command72 } from "commander";
-import { execFileSync as execFileSync6 } from "child_process";
+import { Command as Command77 } from "commander";
+import { execFile, execFileSync as execFileSync6 } from "child_process";
 import { realpathSync } from "fs";
+import { promisify } from "util";
 import readline2 from "readline";
 import chalk11 from "chalk";
 function detectPackageManager() {
@@ -7417,25 +7842,32 @@ function detectPackageManager() {
   }
   return "npm";
 }
-function getLatestVersion(pkg = "@harness-engineering/cli") {
-  const output = execFileSync6("npm", ["view", pkg, "dist-tags.latest"], {
+var execFileAsync = promisify(execFile);
+async function getLatestVersionAsync(pkg) {
+  const { stdout } = await execFileAsync("npm", ["view", pkg, "dist-tags.latest"], {
     encoding: "utf-8",
     timeout: 15e3
   });
-  return output.trim();
+  return stdout.trim();
 }
-function getInstalledVersion(pm) {
+function getInstalledVersions(pm, packages) {
+  const versions = {};
   try {
-    const output = execFileSync6(pm, ["list", "-g", "@harness-engineering/cli", "--json"], {
+    const output = execFileSync6(pm, ["list", "-g", "--json"], {
       encoding: "utf-8",
       timeout: 15e3
     });
     const data = JSON.parse(output);
     const deps = data.dependencies ?? {};
-    return deps["@harness-engineering/cli"]?.version ?? null;
+    for (const pkg of packages) {
+      versions[pkg] = deps[pkg]?.version ?? null;
+    }
   } catch {
-    return null;
+    for (const pkg of packages) {
+      versions[pkg] = null;
+    }
   }
+  return versions;
 }
 function getInstalledPackages(pm) {
   try {
@@ -7455,10 +7887,10 @@ function prompt(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve32) => {
+  return new Promise((resolve33) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve32(answer.trim().toLowerCase());
+      resolve33(answer.trim().toLowerCase());
     });
   });
 }
@@ -7477,27 +7909,25 @@ async function offerRegeneration() {
     console.log(`  ${chalk11.cyan(`harness generate${isGlobal ? " --global" : ""}`)}`);
   }
 }
-async function checkForUpdates(_pm, opts, currentVersion) {
-  if (opts.version) return void 0;
+async function checkAllPackages(packages, installedVersions) {
   logger.info("Checking for updates...");
-  let latestCliVersion;
-  try {
-    latestCliVersion = getLatestVersion();
-  } catch {
-    logger.error("Failed to fetch latest version from npm registry");
-    process.exit(ExitCode.ERROR);
-  }
-  if (currentVersion && currentVersion === latestCliVersion) {
-    logger.success(`Already up to date (v${currentVersion})`);
-    process.exit(ExitCode.SUCCESS);
-  }
-  if (currentVersion) {
-    console.log("");
-    logger.info(`Current CLI version: ${chalk11.dim(`v${currentVersion}`)}`);
-    logger.info(`Latest CLI version:  ${chalk11.green(`v${latestCliVersion}`)}`);
-    console.log("");
+  const results = await Promise.allSettled(
+    packages.map(async (pkg) => {
+      const latest = await getLatestVersionAsync(pkg);
+      const current = installedVersions[pkg] ?? null;
+      return { pkg, current, latest, outdated: !current || current !== latest };
+    })
+  );
+  const outdated = [];
+  for (const result of results) {
+    if (result.status === "rejected") {
+      continue;
+    }
+    if (result.value.outdated) {
+      outdated.push(result.value);
+    }
   }
-  return latestCliVersion;
+  return { hasUpdates: outdated.length > 0, outdated };
 }
 function buildInstallPackages(packages, opts) {
   const pm = detectPackageManager();
@@ -7515,12 +7945,30 @@ async function runUpdateAction(opts, globalOpts) {
   if (globalOpts.verbose) {
     logger.info(`Detected package manager: ${pm}`);
   }
-  const currentVersion = getInstalledVersion(pm);
-  await checkForUpdates(pm, opts, currentVersion);
   const packages = getInstalledPackages(pm);
   if (globalOpts.verbose) {
     logger.info(`Installed packages: ${packages.join(", ")}`);
   }
+  if (opts.regenerate) {
+    await offerRegeneration();
+    process.exit(ExitCode.SUCCESS);
+  }
+  if (!opts.version && !opts.force) {
+    const installedVersions = getInstalledVersions(pm, packages);
+    const { hasUpdates, outdated } = await checkAllPackages(packages, installedVersions);
+    if (!hasUpdates) {
+      logger.success("All packages are up to date");
+      await offerRegeneration();
+      process.exit(ExitCode.SUCCESS);
+    }
+    console.log("");
+    for (const { pkg, current, latest } of outdated) {
+      const shortName = pkg.replace("@harness-engineering/", "");
+      const currentStr = current ? chalk11.dim(`v${current}`) : chalk11.dim("not installed");
+      logger.info(`${shortName}: ${currentStr} \u2192 ${chalk11.green(`v${latest}`)}`);
+    }
+    console.log("");
+  }
   const { installPkgs, installCmd } = buildInstallPackages(packages, opts);
   if (globalOpts.verbose) {
     logger.info(`Running: ${installCmd}`);
@@ -7540,16 +7988,19 @@ async function runUpdateAction(opts, globalOpts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createUpdateCommand() {
-  return new Command72("update").description("Update all @harness-engineering packages to the latest version").option("--version <semver>", "Pin @harness-engineering/cli to a specific version").action(async (opts, cmd) => {
+  return new Command77("update").description("Update all @harness-engineering packages to the latest version").option("--version <semver>", "Pin @harness-engineering/cli to a specific version").option("--force", "Force update even if versions match").option(
+    "--regenerate",
+    "Only regenerate slash commands and agent definitions (skip package updates)"
+  ).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     await runUpdateAction(opts, globalOpts);
   });
 }
 
 // src/commands/usage.ts
-import { Command as Command73 } from "commander";
+import { Command as Command78 } from "commander";
 async function loadAndPriceRecords(cwd, includeClaudeSessions = false) {
-  const { readCostRecords, loadPricingData, calculateCost, parseCCRecords } = await import("./dist-27IJJDWG.js");
+  const { readCostRecords, loadPricingData, calculateCost, parseCCRecords } = await import("./dist-TZQUURSP.js");
   const records = readCostRecords(cwd);
   if (includeClaudeSessions) {
     const ccRecords = parseCCRecords();
@@ -7574,6 +8025,13 @@ function formatTokenCount(count) {
   if (count >= 1e3) return (count / 1e3).toFixed(1) + "K";
   return String(count);
 }
+function formatPercent(ratio) {
+  return (ratio * 100).toFixed(1) + "%";
+}
+function computeCacheHitRate(cacheReadTokens, inputTokens) {
+  if (cacheReadTokens == null || cacheReadTokens === 0 || inputTokens === 0) return null;
+  return cacheReadTokens / inputTokens;
+}
 function formatModels(models) {
   if (models.length === 0) return "unknown";
   if (models.length === 1) return models[0] ?? "unknown";
@@ -7593,15 +8051,25 @@ function registerDailyCommand(usage) {
       }
       return;
     }
-    const { aggregateByDay } = await import("./dist-27IJJDWG.js");
+    const { aggregateByDay } = await import("./dist-TZQUURSP.js");
     const dailyData = aggregateByDay(records);
     const limited = dailyData.slice(0, days);
     if (globalOpts.json) {
-      console.log(JSON.stringify(limited, null, 2));
+      const enriched = limited.map((day) => {
+        const hitRate = computeCacheHitRate(day.cacheReadTokens, day.tokens.inputTokens);
+        return {
+          ...day,
+          ...hitRate != null ? { cacheHitRate: Math.round(hitRate * 1e3) / 1e3 } : {}
+        };
+      });
+      console.log(JSON.stringify(enriched, null, 2));
       return;
     }
-    const header = "Date         | Sessions | Input     | Output    | Model(s)                     | Cost";
-    const divider = "-------------|----------|-----------|-----------|------------------------------|--------";
+    const hasCacheData = limited.some((d) => d.cacheReadTokens != null && d.cacheReadTokens > 0);
+    const cacheHeader = hasCacheData ? " | Cache " : "";
+    const cacheDivider = hasCacheData ? " | ------" : "";
+    const header = "Date         | Sessions | Input     | Output    | Model(s)                     | Cost  " + cacheHeader;
+    const divider = "-------------|----------|-----------|-----------|------------------------------|-------" + cacheDivider;
     logger.info(header);
     logger.info(divider);
     for (const day of limited) {
@@ -7611,7 +8079,13 @@ function registerDailyCommand(usage) {
       const output = formatTokenCount(day.tokens.outputTokens).padStart(9);
       const models = formatModels(day.models).padEnd(28);
       const cost = formatMicroUSD(day.costMicroUSD);
-      logger.info(`${date} | ${sessions} | ${input} | ${output} | ${models} | ${cost}`);
+      const cacheCol = hasCacheData ? (() => {
+        const rate = computeCacheHitRate(day.cacheReadTokens, day.tokens.inputTokens);
+        return " | " + (rate != null ? formatPercent(rate).padStart(5) : "    -");
+      })() : "";
+      logger.info(
+        `${date} | ${sessions} | ${input} | ${output} | ${models} | ${cost}${cacheCol}`
+      );
     }
   });
 }
@@ -7629,7 +8103,7 @@ function registerSessionsCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-27IJJDWG.js");
+    const { aggregateBySession } = await import("./dist-TZQUURSP.js");
     const sessionData = aggregateBySession(records);
     const limited = sessionData.slice(0, limit);
     if (globalOpts.json) {
@@ -7688,6 +8162,12 @@ function printSessionDetail(match) {
   if (match.cacheCreationTokens != null) {
     logger.info(`  Cache creation tokens: ${formatTokenCount(match.cacheCreationTokens)}`);
   }
+  const hitRate = computeCacheHitRate(match.cacheReadTokens, match.tokens.inputTokens);
+  if (hitRate != null) {
+    logger.info("");
+    logger.info("Cache Performance:");
+    logger.info(`  Cache hit rate:        ${formatPercent(hitRate)}`);
+  }
   logger.info("");
   logger.info(`Cost: ${formatMicroUSD(match.costMicroUSD)}`);
 }
@@ -7696,7 +8176,7 @@ function registerSessionCommand(usage) {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     const records = await loadAndPriceRecords(cwd, globalOpts.includeClaudeSessions);
-    const { aggregateBySession } = await import("./dist-27IJJDWG.js");
+    const { aggregateBySession } = await import("./dist-TZQUURSP.js");
     const sessionData = aggregateBySession(records);
     const match = sessionData.find((s) => s.sessionId === id);
     if (!match) {
@@ -7705,7 +8185,12 @@ function registerSessionCommand(usage) {
       return;
     }
     if (globalOpts.json) {
-      console.log(JSON.stringify(match, null, 2));
+      const hitRate = computeCacheHitRate(match.cacheReadTokens, match.tokens.inputTokens);
+      const enriched = {
+        ...match,
+        ...hitRate != null ? { cacheHitRate: Math.round(hitRate * 1e3) / 1e3 } : {}
+      };
+      console.log(JSON.stringify(enriched, null, 2));
       return;
     }
     printSessionDetail(match);
@@ -7724,7 +8209,7 @@ function registerLatestCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-27IJJDWG.js");
+    const { aggregateBySession } = await import("./dist-TZQUURSP.js");
     const sessionData = aggregateBySession(records);
     const latest = sessionData[0];
     if (!latest) {
@@ -7750,7 +8235,7 @@ function registerLatestCommand(usage) {
   });
 }
 function createUsageCommand() {
-  const usage = new Command73("usage").description("Token usage and cost tracking");
+  const usage = new Command78("usage").description("Token usage and cost tracking");
   usage.option(
     "--include-claude-sessions",
     "Include Claude Code session data from ~/.claude/projects/"
@@ -7763,15 +8248,15 @@ function createUsageCommand() {
 }
 
 // src/commands/validate.ts
-import { Command as Command74 } from "commander";
-import * as path57 from "path";
+import { Command as Command79 } from "commander";
+import * as path59 from "path";
 async function runValidate(options) {
   const configResult = resolveConfig(options.configPath);
   if (!configResult.ok) {
     return configResult;
   }
   const config = configResult.value;
-  const cwd = options.cwd ?? (options.configPath ? path57.dirname(path57.resolve(options.configPath)) : process.cwd());
+  const cwd = options.cwd ?? (options.configPath ? path59.dirname(path59.resolve(options.configPath)) : process.cwd());
   const result = {
     valid: true,
     checks: {
@@ -7781,7 +8266,7 @@ async function runValidate(options) {
     },
     issues: []
   };
-  const agentsMapPath = path57.resolve(cwd, config.agentsMapPath);
+  const agentsMapPath = path59.resolve(cwd, config.agentsMapPath);
   const agentsResult = await validateAgentsMap(agentsMapPath);
   if (agentsResult.ok) {
     result.checks.agentsMap = true;
@@ -7826,11 +8311,11 @@ function resolveValidateMode(globalOpts) {
   return OutputMode.TEXT;
 }
 async function printCrossCheckWarnings(mode) {
-  const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-WQWFMPXJ.js");
+  const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-M4NP2UF5.js");
   const cwd = process.cwd();
   const crossResult = await runCrossCheck2({
-    specsDir: path57.join(cwd, "docs", "specs"),
-    plansDir: path57.join(cwd, "docs", "plans"),
+    specsDir: path59.join(cwd, "docs", "specs"),
+    plansDir: path59.join(cwd, "docs", "plans"),
     projectPath: cwd
   });
   if (!crossResult.ok || crossResult.value.warnings === 0) return;
@@ -7842,7 +8327,7 @@ async function printCrossCheckWarnings(mode) {
   ${crossResult.value.warnings} warnings`);
 }
 function createValidateCommand3() {
-  const command = new Command74("validate").description("Run all validation checks").option("--cross-check", "Run cross-artifact consistency validation").action(async (opts, cmd) => {
+  const command = new Command79("validate").description("Run all validation checks").option("--cross-check", "Run cross-artifact consistency validation").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = resolveValidateMode(globalOpts);
     const formatter = new OutputFormatter(mode);
@@ -7871,6 +8356,7 @@ function createValidateCommand3() {
 // src/commands/_registry.ts
 var commandCreators = [
   createAddCommand,
+  createAdoptionCommand,
   createAgentCommand,
   createBlueprintCommand,
   createCheckArchCommand,
@@ -7881,6 +8367,7 @@ var commandCreators = [
   createCheckSecurityCommand,
   createCICommand,
   createCleanupCommand,
+  createCleanupSessionsCommand,
   createCreateSkillCommand,
   createDashboardCommand,
   createDoctorCommand,
@@ -7914,6 +8401,7 @@ var commandCreators = [
   createSnapshotCommand,
   createStateCommand,
   createTaintCommand,
+  createTelemetryCommand,
   createTraceabilityCommand,
   createUninstallCommand,
   createUninstallConstraintsCommand,
@@ -7924,7 +8412,7 @@ var commandCreators = [
 
 // src/index.ts
 function createProgram() {
-  const program = new Command75();
+  const program = new Command80();
   program.name("harness").description("CLI for Harness Engineering toolkit").version(CLI_VERSION).option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--verbose", "Verbose output").option("--quiet", "Minimal output");
   for (const creator of commandCreators) {
     program.addCommand(creator());