@harness-engineering/cli 1.24.0 → 1.24.3

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

@@ -1,6 +1,12 @@
+import {
+  generateAgentsMd
+} from "./chunk-I4QR3HNH.js";
 import {
   generateCIWorkflow
 } from "./chunk-LOUH2LIC.js";
+import {
+  TemplateEngine
+} from "./chunk-FP53DDB5.js";
 import {
   generate,
   validate
@@ -8,15 +14,12 @@ import {
 import {
   generateRuntime
 } from "./chunk-LM5Z2WCA.js";
-import {
-  generateAgentsMd
-} 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 +28,7 @@ import {
   OutputMode,
   createCheckPhaseGateCommand,
   findFiles
-} from "./chunk-LRX6J7IA.js";
+} from "./chunk-SPTKLCKC.js";
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
@@ -38,12 +41,13 @@ import {
   loadPersona
 } from "./chunk-YDRB55Q4.js";
 import {
-  TemplateEngine
-} from "./chunk-FP53DDB5.js";
+  createScanCommand
+} from "./chunk-3XAPHB2Z.js";
 import {
   appendFrameworkAgents,
   captureHealthSnapshot,
   createGenerateSlashCommandsCommand,
+  ensureHarnessGitignore,
   generateSlashCommands,
   handleGetImpact,
   handleOrphanDeletion,
@@ -52,11 +56,11 @@ import {
   loadOrRebuildIndex,
   persistToolingConfig,
   recommend
-} from "./chunk-BH6GUAUS.js";
+} from "./chunk-O6UF33QH.js";
 import {
   findConfigFile,
   resolveConfig
-} from "./chunk-ZOIGL5PP.js";
+} from "./chunk-5PMRARB5.js";
 import {
   VALID_PLATFORMS
 } from "./chunk-3ISINLYT.js";
@@ -70,7 +74,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 +112,7 @@ import {
   diff,
   extractBundle,
   generateSuggestions,
+  getOrCreateInstallId,
   listStreams,
   listTaintedSessions,
   loadState,
@@ -118,10 +123,12 @@ import {
   parseManifest,
   parseSecurityConfig,
   pruneLearnings,
+  readIdentity,
   readLockfile,
   removeContributions,
   removeProvenance,
   requestPeerReview,
+  resolveConsent,
   resolveStreamPath,
   runAll,
   runCIChecks,
@@ -133,20 +140,20 @@ import {
   validateKnowledgeMap,
   writeConfig,
   writeLockfile
-} from "./chunk-WPFFEDTO.js";
+} from "./chunk-H4U2QNY2.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 +161,7 @@ import {
 } from "./chunk-3WGJMBKH.js";
 
 // src/index.ts
-import { Command as Command75 } from "commander";
+import { Command as Command79 } from "commander";
 
 // src/commands/add.ts
 import { Command } from "commander";
@@ -244,7 +251,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 +331,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-7EBSGAHX.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-7EBSGAHX.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-7EBSGAHX.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 +585,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 +609,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 +703,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 +731,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 +762,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 +892,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 +922,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 +1014,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 +1109,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 +1139,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 +1256,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 +1286,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 +1358,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 +1371,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 +1464,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 +1607,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 +1739,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:${apiPort}`;
+  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 +2012,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 +2043,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 +2082,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 +2091,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 +2121,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 +2136,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 +2157,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 +2194,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 +2244,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 +2269,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 +2279,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 +2402,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 +2432,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 +2492,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 Command23 } 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 +2523,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 +2541,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.");
@@ -2296,50 +2575,11 @@ async function runGraphExport(projectPath, format) {
 // src/commands/graph/index.ts
 import * as path18 from "path";
 
-// src/commands/graph/scan.ts
-import { Command as Command19 } from "commander";
-import * as path15 from "path";
-async function runScan(projectPath) {
-  const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-M6FBUXZD.js");
-  const store = new GraphStore();
-  const start = Date.now();
-  await new CodeIngestor(store).ingest(projectPath);
-  new TopologicalLinker(store).link();
-  const knowledgeIngestor = new KnowledgeIngestor(store);
-  await knowledgeIngestor.ingestAll(projectPath);
-  try {
-    await new GitIngestor(store).ingest(projectPath);
-  } catch {
-  }
-  const graphDir = path15.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);
-    const globalOpts = cmd.optsWithGlobals();
-    try {
-      const result = await runScan(projectPath);
-      if (globalOpts.json) {
-        console.log(JSON.stringify(result));
-      } else {
-        console.log(
-          `Graph built: ${result.nodeCount} nodes, ${result.edgeCount} edges (${result.durationMs}ms)`
-        );
-      }
-    } catch (err) {
-      console.error("Scan failed:", err instanceof Error ? err.message : err);
-      process.exit(2);
-    }
-  });
-}
-
 // src/commands/graph/query.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 import * as path16 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 loaded = await store.load(graphDir);
@@ -2382,23 +2622,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 Command21("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 { Command as Command22 } from "commander";
 import * as path17 from "path";
 async function loadConnectorConfig(projectPath, source) {
   try {
-    const fs34 = await import("fs/promises");
+    const fs36 = 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 config = JSON.parse(await fs36.readFile(configPath, "utf-8"));
+    const connector = config.graph?.connectors?.[source];
+    return connector ?? {};
   } catch {
     return {};
   }
@@ -2432,8 +2670,10 @@ async function runIngest(projectPath, source, opts) {
     GitIngestor,
     SyncManager,
     JiraConnector,
-    SlackConnector
-  } = await import("./dist-M6FBUXZD.js");
+    SlackConnector,
+    CIConnector,
+    ConfluenceConnector
+  } = await import("./dist-QW5G3GX3.js");
   const graphDir = path17.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   await store.load(graphDir);
@@ -2446,7 +2686,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 +2712,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 +2726,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,7 +2741,10 @@ 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 Command22("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);
@@ -2568,18 +2817,18 @@ async function runExportAction(opts, cmd) {
   }
 }
 function createGraphCommand() {
-  const graph = new Command22("graph").description("Knowledge graph management");
+  const graph = new Command23("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 Command28 } from "commander";
 
 // src/commands/hooks/init.ts
-import { Command as Command23 } from "commander";
-import * as fs5 from "fs";
+import { Command as Command24 } from "commander";
+import * as fs6 from "fs";
 import * as path19 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
@@ -2589,6 +2838,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" }
@@ -2612,7 +2863,7 @@ var __dirname2 = path19.dirname(__filename2);
 var VALID_PROFILES = ["minimal", "standard", "strict"];
 function resolveHookSourceDir() {
   const candidate = path19.resolve(__dirname2, "..", "..", "hooks");
-  if (fs5.existsSync(candidate)) {
+  if (fs6.existsSync(candidate)) {
     return candidate;
   }
   throw new Error(`Cannot locate hook scripts directory. Expected at: ${candidate}`);
@@ -2641,11 +2892,11 @@ 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)) {
+  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(path19.join(hooksDestDir, entry));
       }
     }
   }
@@ -2656,20 +2907,20 @@ function initHooks(options) {
   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);
+    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");
+  fs6.writeFileSync(profilePath, JSON.stringify({ profile }, null, 2) + "\n");
   const claudeDir = path19.join(projectDir, ".claude");
-  fs5.mkdirSync(claudeDir, { recursive: true });
+  fs6.mkdirSync(claudeDir, { recursive: true });
   const settingsPath = path19.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 +2930,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 Command24("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)) {
@@ -2719,19 +2970,19 @@ function createInitCommand2() {
 }
 
 // src/commands/hooks/list.ts
-import { Command as Command24 } from "commander";
-import * as fs6 from "fs";
+import { Command as Command25 } from "commander";
+import * as fs7 from "fs";
 import * as path20 from "path";
 function listHooks(projectDir) {
   const hooksDir = path20.join(projectDir, ".harness", "hooks");
   const profilePath = path20.join(hooksDir, "profile.json");
-  if (!fs6.existsSync(profilePath)) {
+  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;
     }
@@ -2752,7 +3003,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 Command25("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 +3024,28 @@ function createListCommand() {
 }
 
 // src/commands/hooks/remove.ts
-import { Command as Command25 } from "commander";
-import * as fs7 from "fs";
+import { Command as Command26 } from "commander";
+import * as fs8 from "fs";
 import * as path21 from "path";
 function removeHooks(projectDir) {
   const hooksDir = path21.join(projectDir, ".harness", "hooks");
   const settingsPath = path21.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 +3054,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 Command26("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,8 +3076,8 @@ function createRemoveCommand() {
 }
 
 // src/commands/hooks/add.ts
-import { Command as Command26 } from "commander";
-import * as fs8 from "fs";
+import { Command as Command27 } from "commander";
+import * as fs9 from "fs";
 import * as path22 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var __dirname3 = path22.dirname(fileURLToPath3(import.meta.url));
@@ -2835,11 +3086,11 @@ var ALIASES = {
 };
 function hookSourceDir() {
   const d = path22.resolve(__dirname3, "..", "..", "hooks");
-  if (fs8.existsSync(d)) return d;
+  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] = [];
@@ -2853,9 +3104,9 @@ function addHooks(hookName, projectDir) {
   const result = { added: [], alreadyInstalled: [], notFound: [] };
   const srcDir = hookSourceDir();
   const destDir = path22.join(projectDir, ".harness", "hooks");
-  fs8.mkdirSync(destDir, { recursive: true });
+  fs9.mkdirSync(destDir, { recursive: true });
   const claudeDir = path22.join(projectDir, ".claude");
-  fs8.mkdirSync(claudeDir, { recursive: true });
+  fs9.mkdirSync(claudeDir, { recursive: true });
   const settingsPath = path22.join(claudeDir, "settings.json");
   const settings = readJson(settingsPath);
   if (!settings.hooks) settings.hooks = {};
@@ -2867,22 +3118,22 @@ function addHooks(hookName, projectDir) {
     }
     const src = path22.join(srcDir, `${name}.js`);
     const dest = path22.join(destDir, `${name}.js`);
-    if (fs8.existsSync(dest)) {
+    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 Command27("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 +3158,7 @@ function createAddCommand2() {
 
 // src/commands/hooks/index.ts
 function createHooksCommand() {
-  const command = new Command27("hooks").description("Manage Claude Code hook configurations");
+  const command = new Command28("hooks").description("Manage Claude Code hook configurations");
   command.addCommand(createInitCommand2());
   command.addCommand(createListCommand());
   command.addCommand(createRemoveCommand());
@@ -2916,10 +3167,10 @@ function createHooksCommand() {
 }
 
 // src/commands/impact-preview.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 import { execSync as execSync4 } from "child_process";
 import * as path23 from "path";
-import * as fs9 from "fs";
+import * as fs10 from "fs";
 function getStagedFiles(cwd) {
   try {
     const output = execSync4("git diff --cached --name-only", {
@@ -2933,7 +3184,7 @@ function getStagedFiles(cwd) {
 }
 function graphExists(projectPath) {
   try {
-    return fs9.existsSync(path23.join(projectPath, ".harness", "graph", "graph.json"));
+    return fs10.existsSync(path23.join(projectPath, ".harness", "graph", "graph.json"));
   } catch {
     return false;
   }
@@ -3115,7 +3366,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 Command29("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 +3379,28 @@ function createImpactPreviewCommand() {
 }
 
 // src/commands/init.ts
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 import chalk3 from "chalk";
-import * as fs12 from "fs";
+import * as fs13 from "fs";
 import * as path26 from "path";
 
 // src/commands/setup-mcp.ts
-import { Command as Command29 } from "commander";
-import * as fs11 from "fs";
+import { Command as Command30 } from "commander";
+import * as fs12 from "fs";
 import * as path25 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 fs11 from "fs";
 import * as path24 from "path";
 function writeTomlMcpEntry(filePath, name, entry) {
   const dir = path24.dirname(filePath);
-  if (!fs10.existsSync(dir)) {
-    fs10.mkdirSync(dir, { recursive: true });
+  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 +3411,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 +3539,8 @@ var ALL_MCP_TOOLS = [
   "predict_failures",
   "recommend_skills",
   "compute_blast_radius",
-  "dispatch_skills"
+  "dispatch_skills",
+  "compact"
 ];
 async function runCursorToolPicker() {
   try {
@@ -3316,20 +3568,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 = path25.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) ?? {};
@@ -3377,8 +3629,8 @@ function setupMcp(cwd, client) {
   if (client === "all" || client === "codex") {
     const configPath = path25.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) {
@@ -3451,7 +3703,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 Command30("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;
@@ -3483,7 +3735,7 @@ function resolveInitDefaults(options) {
 async function runInit(options) {
   const { cwd, name, force } = resolveInitDefaults(options);
   const configPath = path26.join(cwd, "harness.config.json");
-  if (!force && fs12.existsSync(configPath)) {
+  if (!force && fs13.existsSync(configPath)) {
     return Err(
       new CLIError("Project already initialized. Use --force to overwrite.", ExitCode.ERROR)
     );
@@ -3549,6 +3801,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 +3843,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 Command31("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,15 +3858,15 @@ 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 { execFileSync as execFileSync3 } from "child_process";
-import { Command as Command31 } from "commander";
+import { Command as Command32 } from "commander";
 import { parse as yamlParse } from "yaml";
 
 // src/registry/npm-client.ts
-import * as fs13 from "fs";
+import * as fs14 from "fs";
 import * as path27 from "path";
 import * as os3 from "os";
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -3640,7 +3893,7 @@ function readNpmrcToken(registryUrl) {
   const candidates = [path27.join(process.cwd(), ".npmrc"), path27.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 +3988,19 @@ async function searchNpmRegistry(query, registryUrl) {
 }
 
 // src/registry/tarball.ts
-import * as fs14 from "fs";
+import * as fs15 from "fs";
 import * as path28 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 tmpDir = fs15.mkdtempSync(path28.join(os4.tmpdir(), "harness-skill-install-"));
   const tarballPath = path28.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,22 +4011,22 @@ 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 });
+    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 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);
       }
     }
   }
@@ -3781,14 +4034,14 @@ function placeSkillContent(extractedPkgDir, communityBaseDir, skillName, platfor
 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 });
+    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,7 +4083,7 @@ function findDependentsOf(lockfile, targetPackageName) {
 }
 
 // src/registry/lockfile.ts
-import * as fs15 from "fs";
+import * as fs16 from "fs";
 import * as path29 from "path";
 function createEmptyLockfile() {
   return { version: 1, skills: {} };
@@ -3851,10 +4104,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);
@@ -3872,8 +4125,8 @@ function readLockfile2(filePath) {
 }
 function writeLockfile2(filePath, lockfile) {
   const dir = path29.dirname(filePath);
-  fs15.mkdirSync(dir, { recursive: true });
-  fs15.writeFileSync(filePath, sortedStringify(lockfile) + "\n", "utf-8");
+  fs16.mkdirSync(dir, { recursive: true });
+  fs16.writeFileSync(filePath, sortedStringify(lockfile) + "\n", "utf-8");
 }
 function updateLockfileEntry(lockfile, name, entry) {
   return {
@@ -3896,17 +4149,17 @@ function removeLockfileEntry(lockfile, name) {
 }
 
 // src/registry/bundled-skills.ts
-import * as fs16 from "fs";
+import * as fs17 from "fs";
 import * as path30 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(path30.join(bundledSkillsDir, String(entry)));
       if (stat.isDirectory()) {
         names.add(String(entry));
       }
@@ -3954,7 +4207,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(path31.join(os5.tmpdir(), "harness-gh-install-"));
   const url = `https://github.com/${owner}/${repo}.git`;
   try {
     const cloneArgs = ["clone", "--depth", "1"];
@@ -3975,12 +4228,12 @@ 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(path31.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;
@@ -3992,15 +4245,15 @@ function discoverSkillDirs(rootDir) {
 }
 function resolveLocalPkgDir(fromPath) {
   const resolvedPath = path31.resolve(fromPath);
-  if (!fs17.existsSync(resolvedPath)) {
+  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 };
   }
@@ -4008,10 +4261,10 @@ function resolveLocalPkgDir(fromPath) {
 }
 function installSkillDir(pkgDir, resolvedPath, options) {
   const skillYamlPath = path31.join(pkgDir, "skill.yaml");
-  if (!fs17.existsSync(skillYamlPath)) {
+  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) {
@@ -4083,7 +4336,7 @@ async function runInstall(skillName, options) {
       };
     }
     const resolvedFrom = path31.resolve(options.from);
-    if (fs17.existsSync(resolvedFrom) && fs17.statSync(resolvedFrom).isDirectory() && !fs17.existsSync(path31.join(resolvedFrom, "skill.yaml"))) {
+    if (fs18.existsSync(resolvedFrom) && fs18.statSync(resolvedFrom).isDirectory() && !fs18.existsSync(path31.join(resolvedFrom, "skill.yaml"))) {
       const results = await runBulkInstall(resolvedFrom, options);
       const installed = results.filter((r) => r.installed);
       return {
@@ -4126,10 +4379,10 @@ async function runInstall(skillName, options) {
   try {
     const extractedPkgDir = path31.join(extractDir, "package");
     const skillYamlPath = path31.join(extractedPkgDir, "skill.yaml");
-    if (!fs17.existsSync(skillYamlPath)) {
+    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 +4422,7 @@ async function runInstall(skillName, options) {
   return result;
 }
 function createInstallCommand() {
-  const cmd = new Command31("install");
+  const cmd = new Command32("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 +4440,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 +4455,15 @@ function createInstallCommand() {
 }
 
 // src/commands/install-constraints.ts
-import * as fs18 from "fs/promises";
+import * as fs19 from "fs/promises";
 import * as path32 from "path";
-import { Command as Command32 } from "commander";
+import { Command as Command33 } 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 +4506,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 {
@@ -4452,17 +4711,17 @@ async function handleInstallConstraints(source, opts) {
   logInstallResult(result.value, opts);
 }
 function createInstallConstraintsCommand() {
-  const cmd = new Command32("install-constraints");
+  const cmd = new Command33("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 Command38 } from "commander";
 
 // src/commands/integrations/add.ts
-import { Command as Command33 } from "commander";
-import * as fs19 from "fs";
+import { Command as Command34 } from "commander";
+import * as fs20 from "fs";
 import * as path33 from "path";
 import chalk4 from "chalk";
 function buildMcpEntry(def) {
@@ -4474,7 +4733,7 @@ function buildMcpEntry(def) {
 function writeMcpEntries(cwd, defName, mcpEntry) {
   writeMcpEntry(path33.join(cwd, ".mcp.json"), defName, mcpEntry);
   const geminiDir = path33.join(cwd, ".gemini");
-  if (fs19.existsSync(geminiDir)) {
+  if (fs20.existsSync(geminiDir)) {
     writeMcpEntry(path33.join(geminiDir, "settings.json"), defName, mcpEntry);
   }
 }
@@ -4525,7 +4784,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 Command34("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,7 +4798,7 @@ function createAddIntegrationCommand() {
 }
 
 // src/commands/integrations/list.ts
-import { Command as Command34 } from "commander";
+import { Command as Command35 } from "commander";
 import * as path34 from "path";
 import chalk5 from "chalk";
 function printTier0Integrations(tier0, mcpServers) {
@@ -4596,12 +4855,12 @@ 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 Command35("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 { Command as Command36 } from "commander";
+import * as fs21 from "fs";
 import * as path35 from "path";
 function removeIntegration(cwd, name) {
   const def = INTEGRATION_REGISTRY.find((i) => i.name === name);
@@ -4616,7 +4875,7 @@ function removeIntegration(cwd, name) {
   const mcpPath = path35.join(cwd, ".mcp.json");
   removeMcpEntry(mcpPath, def.name);
   const geminiDir = path35.join(cwd, ".gemini");
-  if (fs20.existsSync(geminiDir)) {
+  if (fs21.existsSync(geminiDir)) {
     const geminiPath = path35.join(geminiDir, "settings.json");
     removeMcpEntry(geminiPath, def.name);
   }
@@ -4627,7 +4886,7 @@ function removeIntegration(cwd, name) {
   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 Command36("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,7 +4907,7 @@ function createRemoveIntegrationCommand() {
 }
 
 // src/commands/integrations/dismiss.ts
-import { Command as Command36 } from "commander";
+import { Command as Command37 } from "commander";
 import * as path36 from "path";
 function dismissIntegration(cwd, name) {
   const def = INTEGRATION_REGISTRY.find((i) => i.name === name);
@@ -4670,7 +4929,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 Command37("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 +4953,7 @@ function createDismissIntegrationCommand() {
 
 // src/commands/integrations/index.ts
 function createIntegrationsCommand() {
-  const command = new Command37("integrations").description(
+  const command = new Command38("integrations").description(
     "Manage MCP peer integrations (add, list, remove, dismiss)"
   );
   command.addCommand(createListIntegrationsCommand());
@@ -4705,10 +4964,10 @@ function createIntegrationsCommand() {
 }
 
 // src/commands/learnings/index.ts
-import { Command as Command39 } from "commander";
+import { Command as Command40 } from "commander";
 
 // src/commands/learnings/prune.ts
-import { Command as Command38 } from "commander";
+import { Command as Command39 } from "commander";
 import * as path37 from "path";
 async function handlePrune(opts) {
   const projectPath = path37.resolve(opts.path);
@@ -4750,23 +5009,23 @@ function printPatternProposals(patterns) {
   );
 }
 function createPruneCommand() {
-  return new Command38("prune").description(
+  return new Command39("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 Command40("learnings").description("Learnings management commands");
   command.addCommand(createPruneCommand());
   return command;
 }
 
 // src/commands/linter/index.ts
-import { Command as Command42 } from "commander";
+import { Command as Command43 } from "commander";
 
 // src/commands/linter/generate.ts
-import { Command as Command40 } from "commander";
+import { Command as Command41 } from "commander";
 function formatGenerateError(e) {
   switch (e.type) {
     case "parse":
@@ -4810,7 +5069,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 Command41("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 +5091,9 @@ function createGenerateCommand2() {
 }
 
 // src/commands/linter/validate.ts
-import { Command as Command41 } from "commander";
+import { Command as Command42 } 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 Command42("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 +5112,7 @@ function createValidateCommand() {
 
 // src/commands/linter/index.ts
 function createLinterCommand() {
-  const linter = new Command42("linter").description(
+  const linter = new Command43("linter").description(
     "Generate and validate ESLint rules from YAML config"
   );
   linter.addCommand(createGenerateCommand2());
@@ -4862,20 +5121,20 @@ function createLinterCommand() {
 }
 
 // src/commands/mcp.ts
-import { Command as Command43 } from "commander";
+import { Command as Command44 } 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 Command44("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-LCHC4NZ5.js");
     await startServer2(opts.tools);
   });
 }
 
 // src/commands/orchestrator.ts
-import { Command as Command44 } from "commander";
+import { Command as Command45 } from "commander";
 import * as path38 from "path";
 import { Orchestrator, WorkflowLoader, launchTUI } from "@harness-engineering/orchestrator";
 function createOrchestratorCommand() {
-  const orchestrator = new Command44("orchestrator");
+  const orchestrator = new Command45("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 loader = new WorkflowLoader();
@@ -4901,13 +5160,13 @@ function createOrchestratorCommand() {
 }
 
 // src/commands/perf.ts
-import { Command as Command45 } from "commander";
+import { Command as Command46 } from "commander";
 import * as path39 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-7EBSGAHX.js");
     const runner = new BenchmarkRunner();
     const benchFiles = runner.discover(cwd, glob);
     if (benchFiles.length === 0) {
@@ -4971,7 +5230,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-7EBSGAHX.js");
   const runner = new BenchmarkRunner();
   const manager = new BaselineManager(cwd);
   logger.info("Running benchmarks to update baselines...");
@@ -5012,7 +5271,7 @@ 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-7EBSGAHX.js");
     const analyzer = new EntropyAnalyzer2({
       rootDir: path39.resolve(cwd),
       analyze: { complexity: true, coupling: true }
@@ -5073,7 +5332,7 @@ function registerCriticalPathsCommand(perf) {
   });
 }
 function createPerfCommand() {
-  const perf = new Command45("perf").description("Performance benchmark and baseline management");
+  const perf = new Command46("perf").description("Performance benchmark and baseline management");
   registerBenchCommand(perf);
   registerBaselinesCommands(perf);
   registerReportCommand(perf);
@@ -5082,10 +5341,10 @@ function createPerfCommand() {
 }
 
 // src/commands/persona/index.ts
-import { Command as Command48 } from "commander";
+import { Command as Command49 } from "commander";
 
 // src/commands/persona/list.ts
-import { Command as Command46 } from "commander";
+import { Command as Command47 } from "commander";
 function printPersonaList(personas) {
   if (personas.length === 0) {
     logger.info("No personas found.");
@@ -5099,7 +5358,7 @@ function printPersonaList(personas) {
   }
 }
 function createListCommand2() {
-  return new Command46("list").description("List available agent personas").action(async (_opts, cmd) => {
+  return new Command47("list").description("List available agent personas").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const personasDir = resolvePersonasDir();
     const result = listPersonas(personasDir);
@@ -5119,8 +5378,8 @@ function createListCommand2() {
 }
 
 // src/commands/persona/generate.ts
-import { Command as Command47 } from "commander";
-import * as fs21 from "fs";
+import { Command as Command48 } from "commander";
+import * as fs22 from "fs";
 import * as path40 from "path";
 function generatePersonaArtifacts(persona, outputDir, only) {
   const slug = toKebabCase(persona.name);
@@ -5129,8 +5388,8 @@ function generatePersonaArtifacts(persona, outputDir, only) {
     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);
+      fs22.mkdirSync(path40.dirname(outPath), { recursive: true });
+      fs22.writeFileSync(outPath, result.value);
       generated.push(outPath);
     }
   }
@@ -5138,7 +5397,7 @@ function generatePersonaArtifacts(persona, outputDir, only) {
     const result = generateAgentsMd(persona);
     if (result.ok) {
       const outPath = path40.join(outputDir, `${slug}.agents.md`);
-      fs21.writeFileSync(outPath, result.value);
+      fs22.writeFileSync(outPath, result.value);
       generated.push(outPath);
     }
   }
@@ -5146,15 +5405,15 @@ function generatePersonaArtifacts(persona, outputDir, only) {
     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);
+      fs22.mkdirSync(path40.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 Command48("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`));
     if (!personaResult.ok) {
@@ -5176,14 +5435,14 @@ function createGenerateCommand3() {
 
 // src/commands/persona/index.ts
 function createPersonaCommand() {
-  const command = new Command48("persona").description("Agent persona management commands");
+  const command = new Command49("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 Command50 } from "commander";
 import chalk6 from "chalk";
 var CATEGORY_ORDER = [
   "circular-deps",
@@ -5289,7 +5548,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 Command50("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 +5571,7 @@ function createPredictCommand() {
 }
 
 // src/commands/recommend.ts
-import { Command as Command50 } from "commander";
+import { Command as Command51 } from "commander";
 import chalk7 from "chalk";
 async function resolveSnapshot(cwd, noCache) {
   if (!noCache) {
@@ -5376,7 +5635,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 Command51("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,8 +5671,8 @@ 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 { Command as Command52 } from "commander";
+import { existsSync as existsSync21, readFileSync as readFileSync11, writeFileSync as writeFileSync12 } from "fs";
 import { join as join31, relative as relative2 } from "path";
 var CONFIG_FILES = ["CLAUDE.md", "AGENTS.md", ".gemini/settings.json", "skill.yaml"];
 function stripHighSeverityPatterns(content, injectionFindings) {
@@ -5447,7 +5706,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");
@@ -5501,7 +5760,7 @@ function formatTextOutput(result) {
   }
 }
 function createScanConfigCommand() {
-  const command = new Command51("scan-config").description(
+  const command = new Command52("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 +5777,24 @@ function createScanConfigCommand() {
 }
 
 // src/commands/setup.ts
-import { Command as Command52 } from "commander";
-import * as fs23 from "fs";
+import { Command as Command53 } from "commander";
+import * as fs24 from "fs";
 import * as os7 from "os";
 import * as path42 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");
 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 +5832,7 @@ function runSlashCommandGeneration() {
   }
 }
 function detectClient(dirName) {
-  return fs23.existsSync(path42.join(os7.homedir(), dirName));
+  return fs24.existsSync(path42.join(os7.homedir(), dirName));
 }
 async function runMcpSetup(cwd) {
   const results = [];
@@ -5625,7 +5884,7 @@ function configureTier0Integrations(cwd) {
       added.push(integration.displayName);
     }
     const geminiDir = path42.join(cwd, ".gemini");
-    if (fs23.existsSync(geminiDir)) {
+    if (fs24.existsSync(geminiDir)) {
       const geminiPath = path42.join(geminiDir, "settings.json");
       const geminiConfig = readMcpConfig(geminiPath);
       for (const integration of tier0) {
@@ -5646,6 +5905,44 @@ function configureTier0Integrations(cwd) {
     return { status: "fail", message: `Tier 0 integration configuration failed \u2014 ${msg}` };
   }
 }
+function ensureHooks(cwd) {
+  const configPath = path42.join(cwd, "harness.config.json");
+  if (!fs24.existsSync(configPath)) {
+    return { status: "warn", message: "Not a harness project \u2014 skipped hook installation" };
+  }
+  let profile = "standard";
+  const profilePath = path42.join(cwd, ".harness", "hooks", "profile.json");
+  try {
+    const data = JSON.parse(fs24.readFileSync(profilePath, "utf-8"));
+    if (data.profile && ["minimal", "standard", "strict"].includes(data.profile)) {
+      profile = data.profile;
+    }
+  } catch {
+  }
+  try {
+    const result = initHooks({ profile, projectDir: cwd });
+    return {
+      status: "pass",
+      message: `Installed ${result.copiedScripts.length} hooks (${profile} profile)`
+    };
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return { status: "warn", message: `Hook installation skipped \u2014 ${msg}` };
+  }
+}
+async function runInitialGraphScan(cwd) {
+  try {
+    const { runScan: runScan2 } = await import("./scan-U67OKDRS.js");
+    const result = await runScan2(cwd);
+    return {
+      status: "pass",
+      message: `Built knowledge graph: ${result.nodeCount} nodes, ${result.edgeCount} edges`
+    };
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return { status: "warn", message: `Knowledge graph creation skipped \u2014 ${msg}` };
+  }
+}
 async function runSetup(cwd) {
   const steps = [];
   const nodeResult = checkNodeVersion3();
@@ -5659,6 +5956,10 @@ async function runSetup(cwd) {
   steps.push(...mcpResults);
   const tier0Result = configureTier0Integrations(cwd);
   steps.push(tier0Result);
+  const hooksResult = ensureHooks(cwd);
+  steps.push(hooksResult);
+  const graphResult = await runInitialGraphScan(cwd);
+  steps.push(graphResult);
   const success = steps.every((s) => s.status !== "fail");
   if (success) {
     markSetupComplete();
@@ -5666,7 +5967,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 Command53("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 +5989,15 @@ function createSetupCommand() {
 }
 
 // src/commands/share.ts
-import { Command as Command53 } from "commander";
-import * as fs24 from "fs";
+import { Command as Command54 } from "commander";
+import * as fs25 from "fs";
 import * as path43 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)) {
+  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 +6006,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(
@@ -5747,28 +6048,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 Command54("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 Command62 } from "commander";
 
 // src/commands/skill/list.ts
-import { Command as Command54 } from "commander";
-import * as fs25 from "fs";
+import { Command as Command55 } from "commander";
+import * as fs26 from "fs";
 import * as path44 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;
+    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) {
@@ -5859,7 +6160,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 Command55("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,8 +6175,8 @@ function createListCommand3() {
 }
 
 // src/commands/skill/run.ts
-import { Command as Command55 } from "commander";
-import * as fs26 from "fs";
+import { Command as Command56 } from "commander";
+import * as fs27 from "fs";
 import * as path45 from "path";
 import { parse as parse2 } from "yaml";
 
@@ -5973,9 +6274,9 @@ ${options.principles}`);
 // src/commands/skill/run.ts
 function loadSkillMetadata(skillDir) {
   const yamlPath = path45.join(skillDir, "skill.yaml");
-  if (!fs26.existsSync(yamlPath)) return null;
+  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;
@@ -5988,21 +6289,21 @@ function resolveComplexity(metadata, requested, projectPath) {
 }
 function loadPrinciples(projectPath) {
   const principlesPath = path45.join(projectPath, "docs", "principles.md");
-  return fs26.existsSync(principlesPath) ? fs26.readFileSync(principlesPath, "utf-8") : void 0;
+  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(path45.join(dirPath, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
+  if (files.length > 0) return fs27.readFileSync(path45.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);
+    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;
 }
@@ -6023,8 +6324,8 @@ 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");
+  if (!fs27.existsSync(stateFile)) return content;
+  const stateContent = fs27.readFileSync(stateFile, "utf-8");
   return content + `
 
 ---
@@ -6037,7 +6338,7 @@ ${stateContent}
 async function runSkill(name, opts) {
   const skillsDir = resolveSkillsDir();
   const skillDir = path45.join(skillsDir, name);
-  if (!fs26.existsSync(skillDir)) {
+  if (!fs27.existsSync(skillDir)) {
     logger.error(`Skill not found: ${name}`);
     process.exit(ExitCode.ERROR);
     return;
@@ -6071,13 +6372,13 @@ async function runSkill(name, opts) {
     ...opts.party !== void 0 && { party: opts.party }
   });
   const skillMdPath = path45.join(skillDir, "SKILL.md");
-  if (!fs26.existsSync(skillMdPath)) {
+  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,12 +6387,12 @@ 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 Command56("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 { Command as Command57 } from "commander";
+import * as fs28 from "fs";
 import * as path46 from "path";
 import { parse as parse3 } from "yaml";
 var BEHAVIORAL_REQUIRED_SECTIONS = [
@@ -6104,11 +6405,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`);
   }
@@ -6135,12 +6436,12 @@ 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)) {
+  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}`);
@@ -6154,15 +6455,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 Command57("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 +6485,24 @@ function createValidateCommand2() {
 }
 
 // src/commands/skill/info.ts
-import { Command as Command57 } from "commander";
-import * as fs28 from "fs";
+import { Command as Command58 } from "commander";
+import * as fs29 from "fs";
 import * as path47 from "path";
 import { parse as parse4 } from "yaml";
 function loadSkillMetadata2(name) {
   const skillsDir = resolveSkillsDir();
   const skillDir = path47.join(skillsDir, name);
-  if (!fs28.existsSync(skillDir)) {
+  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)) {
+  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 +6531,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 Command58("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 +6548,7 @@ function createInfoCommand() {
 }
 
 // src/commands/skill/search.ts
-import { Command as Command58 } from "commander";
+import { Command as Command59 } from "commander";
 async function runSearch(query, opts) {
   const results = await searchNpmRegistry(query, opts.registry);
   return results.filter((r) => {
@@ -6292,15 +6593,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 Command59("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 { Command as Command60 } from "commander";
 import * as path48 from "path";
-import * as fs29 from "fs";
+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) {
@@ -6386,20 +6687,20 @@ function runCreate(name, opts) {
   }
   const baseDir = opts.outputDir ?? path48.join(process.cwd(), "agents", "skills", "claude-code");
   const skillDir = path48.join(baseDir, name);
-  if (fs29.existsSync(skillDir)) {
+  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));
+  fs30.writeFileSync(skillYamlPath, YAML.stringify(skillYaml));
   const skillMd = buildSkillMd(name, description);
   const skillMdPath = path48.join(skillDir, "SKILL.md");
-  fs29.writeFileSync(skillMdPath, skillMd);
+  fs30.writeFileSync(skillMdPath, skillMd);
   const readme = buildReadme(name, description);
   const readmePath = path48.join(skillDir, "README.md");
-  fs29.writeFileSync(readmePath, readme);
+  fs30.writeFileSync(readmePath, readme);
   return {
     name,
     directory: skillDir,
@@ -6418,7 +6719,7 @@ Next steps:`);
   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 Command60("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 +6742,26 @@ function createCreateCommand() {
 }
 
 // src/commands/skill/publish.ts
-import { Command as Command60 } from "commander";
-import * as fs31 from "fs";
+import { Command as Command61 } from "commander";
+import * as fs32 from "fs";
 import * as path50 from "path";
 import { execFileSync as execFileSync5 } from "child_process";
 
 // src/registry/validator.ts
-import * as fs30 from "fs";
+import * as fs31 from "fs";
 import * as path49 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)) {
+  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) {
@@ -6483,10 +6784,10 @@ async function validateForPublish(skillDir, registryUrl) {
     errors.push("At least one trigger is required. Add triggers to skill.yaml.");
   }
   const skillMdPath = path49.join(skillDir, "SKILL.md");
-  if (!fs30.existsSync(skillMdPath)) {
+  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.');
     }
@@ -6567,10 +6868,10 @@ ${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");
+  fs32.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");
+  if (!fs32.existsSync(readmePath)) {
+    const skillMdContent = fs32.readFileSync(path50.join(skillDir, "SKILL.md"), "utf-8");
     const readme = `# ${pkg.name}
 
 ${meta.description}
@@ -6584,7 +6885,7 @@ harness install ${meta.name}
 ---
 
 ${skillMdContent}`;
-    fs31.writeFileSync(readmePath, readme);
+    fs32.writeFileSync(readmePath, readme);
   }
   if (opts.dryRun) {
     return {
@@ -6610,7 +6911,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 Command61("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 +6936,7 @@ function createPublishCommand() {
 
 // src/commands/skill/index.ts
 function createSkillCommand() {
-  const command = new Command61("skill").description("Skill management commands");
+  const command = new Command62("skill").description("Skill management commands");
   command.addCommand(createListCommand3());
   command.addCommand(createRunCommand2());
   command.addCommand(createValidateCommand2());
@@ -6647,7 +6948,7 @@ function createSkillCommand() {
 }
 
 // src/commands/snapshot.ts
-import { Command as Command62 } from "commander";
+import { Command as Command63 } from "commander";
 import { execSync as execSync5 } from "child_process";
 import chalk9 from "chalk";
 function getCommitHash3(cwd) {
@@ -6829,7 +7130,7 @@ function registerListCommand(parent) {
   });
 }
 function createSnapshotCommand() {
-  const command = new Command62("snapshot").description("Architecture timeline snapshot commands");
+  const command = new Command63("snapshot").description("Architecture timeline snapshot commands");
   registerCaptureCommand(command);
   registerTrendsCommand(command);
   registerListCommand(command);
@@ -6837,10 +7138,10 @@ function createSnapshotCommand() {
 }
 
 // src/commands/state/index.ts
-import { Command as Command67 } from "commander";
+import { Command as Command68 } from "commander";
 
 // src/commands/state/show.ts
-import { Command as Command63 } from "commander";
+import { Command as Command64 } from "commander";
 import * as path51 from "path";
 function printStateText(state, stream) {
   if (stream) console.log(`Stream:         ${stream}`);
@@ -6865,7 +7166,7 @@ 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 Command64("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);
     if (!result.ok) {
@@ -6882,8 +7183,8 @@ function createShowCommand() {
 }
 
 // src/commands/state/reset.ts
-import { Command as Command64 } from "commander";
-import * as fs32 from "fs";
+import { Command as Command65 } from "commander";
+import * as fs33 from "fs";
 import * as path52 from "path";
 import * as readline from "readline";
 async function resolveStatePath(projectPath, stream) {
@@ -6908,7 +7209,7 @@ async function confirmReset() {
 async function runReset(opts) {
   const projectPath = path52.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 +7218,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,14 +7227,14 @@ 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 Command65("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 { Command as Command66 } from "commander";
 import * as path53 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) => {
+  return new Command66("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);
     const result = await appendLearning(projectPath, message, void 0, void 0, opts.stream);
     if (!result.ok) {
@@ -6947,7 +7248,7 @@ function createLearnCommand() {
 }
 
 // src/commands/state/streams.ts
-import { Command as Command66 } from "commander";
+import { Command as Command67 } from "commander";
 import * as path54 from "path";
 async function runListStreams(opts, globalOpts) {
   const projectPath = path54.resolve(opts.path);
@@ -6998,7 +7299,7 @@ async function runActivateStream(name, opts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createStreamsCommand() {
-  const command = new Command66("streams").description("Manage state streams");
+  const command = new Command67("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 +7309,7 @@ function createStreamsCommand() {
 
 // src/commands/state/index.ts
 function createStateCommand() {
-  const command = new Command67("state").description("Project state management commands");
+  const command = new Command68("state").description("Project state management commands");
   command.addCommand(createShowCommand());
   command.addCommand(createResetCommand());
   command.addCommand(createLearnCommand());
@@ -7017,7 +7318,7 @@ function createStateCommand() {
 }
 
 // src/commands/taint.ts
-import { Command as Command68 } from "commander";
+import { Command as Command69 } from "commander";
 function getProjectRoot() {
   return process.cwd();
 }
@@ -7089,14 +7390,143 @@ function registerStatusCommand(taint) {
   });
 }
 function createTaintCommand() {
-  const taint = new Command68("taint").description("Manage sentinel session taint state");
+  const taint = new Command69("taint").description("Manage sentinel session taint state");
   registerClearCommand(taint);
   registerStatusCommand(taint);
   return taint;
 }
 
+// src/commands/telemetry/index.ts
+import { Command as Command72 } from "commander";
+
+// src/commands/telemetry/identify.ts
+import { Command as Command70 } from "commander";
+import * as fs34 from "fs";
+import * as path55 from "path";
+function telemetryFilePath(cwd) {
+  return path55.join(cwd, ".harness", "telemetry.json");
+}
+function writeTelemetryFile(cwd, data) {
+  const filePath = telemetryFilePath(cwd);
+  const dir = path55.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 Command70("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 Command71 } 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 Command71("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 Command72("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 Command73 } from "commander";
 import chalk10 from "chalk";
 function confidenceLabel(maxConfidence) {
   if (maxConfidence >= 0.8) return "explicit";
@@ -7212,7 +7642,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 +7657,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 Command73("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 +7670,15 @@ function createTraceabilityCommand() {
 }
 
 // src/commands/uninstall.ts
-import * as path55 from "path";
-import { Command as Command70 } from "commander";
+import * as path56 from "path";
+import { Command as Command74 } 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 = path56.dirname(globalDir);
+  const communityBase = path56.join(skillsDir, "community");
+  const lockfilePath = path56.join(communityBase, "skills-lock.json");
   const lockfile = readLockfile2(lockfilePath);
   const entry = lockfile.skills[packageName];
   if (!entry) {
@@ -7278,7 +7708,7 @@ async function runUninstall(skillName, options) {
   return result;
 }
 function createUninstallCommand() {
-  const cmd = new Command70("uninstall");
+  const cmd = new Command74("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 +7727,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 path57 from "path";
+import { Command as Command75 } from "commander";
 async function runUninstallConstraints(options) {
   const { packageName, configPath, lockfilePath } = options;
   const lockfileResult = await readLockfile(lockfilePath);
@@ -7319,7 +7749,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 +7786,11 @@ async function runUninstallConstraints(options) {
   };
 }
 function createUninstallConstraintsCommand() {
-  const cmd = new Command71("uninstall-constraints");
+  const cmd = new Command75("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 = path57.resolve(opts.config);
     } else {
       const found = findConfigFile();
       if (!found.ok) {
@@ -7369,8 +7799,8 @@ function createUninstallConstraintsCommand() {
       }
       configPath = found.value;
     }
-    const projectRoot = path56.dirname(configPath);
-    const lockfilePath = path56.join(projectRoot, ".harness", "constraints.lock.json");
+    const projectRoot = path57.dirname(configPath);
+    const lockfilePath = path57.join(projectRoot, ".harness", "constraints.lock.json");
     const result = await runUninstallConstraints({
       packageName: name,
       configPath,
@@ -7395,9 +7825,11 @@ function createUninstallConstraintsCommand() {
 }
 
 // src/commands/update.ts
-import { Command as Command72 } from "commander";
-import { execFileSync as execFileSync6 } from "child_process";
-import { realpathSync } from "fs";
+import { Command as Command76 } from "commander";
+import { execFile, execFileSync as execFileSync6 } from "child_process";
+import { realpathSync, existsSync as existsSync33, readFileSync as readFileSync20 } from "fs";
+import { join as join46 } from "path";
+import { promisify } from "util";
 import readline2 from "readline";
 import chalk11 from "chalk";
 function detectPackageManager() {
@@ -7417,25 +7849,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 {
@@ -7462,9 +7901,41 @@ function prompt(question) {
     });
   });
 }
+function refreshHooks() {
+  const cwd = process.cwd();
+  const configPath = join46(cwd, "harness.config.json");
+  if (!existsSync33(configPath)) return;
+  let profile = "standard";
+  const profilePath = join46(cwd, ".harness", "hooks", "profile.json");
+  try {
+    const data = JSON.parse(readFileSync20(profilePath, "utf-8"));
+    if (data.profile && ["minimal", "standard", "strict"].includes(data.profile)) {
+      profile = data.profile;
+    }
+  } catch {
+  }
+  try {
+    const result = initHooks({ profile, projectDir: cwd });
+    logger.success(`Refreshed ${result.copiedScripts.length} hooks (${profile} profile)`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.warn(`Hook refresh failed: ${msg}`);
+  }
+}
+function runLocalGraphScan() {
+  try {
+    logger.info("Scanning codebase to rebuild knowledge graph...");
+    execFileSync6("harness", ["graph", "scan", "."], { stdio: "inherit" });
+  } catch {
+    logger.warn("Graph scan failed. Run manually:");
+    console.log(`  ${chalk11.cyan("harness graph scan .")}`);
+  }
+}
 async function offerRegeneration() {
   console.log("");
-  const regenAnswer = await prompt("Regenerate slash commands and agent definitions? (Y/n) ");
+  const regenAnswer = await prompt(
+    "Regenerate slash commands, agent definitions, and knowledge graph? (Y/n) "
+  );
   if (regenAnswer === "n" || regenAnswer === "no") return;
   const scopeAnswer = await prompt("Generate for (G)lobal or (l)ocal project? (G/l) ");
   const isGlobal = scopeAnswer !== "l" && scopeAnswer !== "local";
@@ -7476,28 +7947,29 @@ async function offerRegeneration() {
     logger.warn("Generation failed. Run manually:");
     console.log(`  ${chalk11.cyan(`harness generate${isGlobal ? " --global" : ""}`)}`);
   }
+  if (!isGlobal) {
+    runLocalGraphScan();
+  }
 }
-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 +7987,31 @@ 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");
+      refreshHooks();
+      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}`);
@@ -7536,20 +8027,24 @@ async function runUpdateAction(opts, globalOpts) {
     console.log(`  ${chalk11.cyan(installCmd)}`);
     process.exit(ExitCode.ERROR);
   }
+  refreshHooks();
   await offerRegeneration();
   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 Command76("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 Command77 } 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-7EBSGAHX.js");
   const records = readCostRecords(cwd);
   if (includeClaudeSessions) {
     const ccRecords = parseCCRecords();
@@ -7574,6 +8069,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 +8095,25 @@ function registerDailyCommand(usage) {
       }
       return;
     }
-    const { aggregateByDay } = await import("./dist-27IJJDWG.js");
+    const { aggregateByDay } = await import("./dist-7EBSGAHX.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 +8123,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 +8147,7 @@ function registerSessionsCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-27IJJDWG.js");
+    const { aggregateBySession } = await import("./dist-7EBSGAHX.js");
     const sessionData = aggregateBySession(records);
     const limited = sessionData.slice(0, limit);
     if (globalOpts.json) {
@@ -7688,6 +8206,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 +8220,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-7EBSGAHX.js");
     const sessionData = aggregateBySession(records);
     const match = sessionData.find((s) => s.sessionId === id);
     if (!match) {
@@ -7705,7 +8229,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 +8253,7 @@ function registerLatestCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-27IJJDWG.js");
+    const { aggregateBySession } = await import("./dist-7EBSGAHX.js");
     const sessionData = aggregateBySession(records);
     const latest = sessionData[0];
     if (!latest) {
@@ -7750,7 +8279,7 @@ function registerLatestCommand(usage) {
   });
 }
 function createUsageCommand() {
-  const usage = new Command73("usage").description("Token usage and cost tracking");
+  const usage = new Command77("usage").description("Token usage and cost tracking");
   usage.option(
     "--include-claude-sessions",
     "Include Claude Code session data from ~/.claude/projects/"
@@ -7763,15 +8292,15 @@ function createUsageCommand() {
 }
 
 // src/commands/validate.ts
-import { Command as Command74 } from "commander";
-import * as path57 from "path";
+import { Command as Command78 } from "commander";
+import * as path58 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 ? path58.dirname(path58.resolve(options.configPath)) : process.cwd());
   const result = {
     valid: true,
     checks: {
@@ -7781,7 +8310,7 @@ async function runValidate(options) {
     },
     issues: []
   };
-  const agentsMapPath = path57.resolve(cwd, config.agentsMapPath);
+  const agentsMapPath = path58.resolve(cwd, config.agentsMapPath);
   const agentsResult = await validateAgentsMap(agentsMapPath);
   if (agentsResult.ok) {
     result.checks.agentsMap = true;
@@ -7826,11 +8355,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-Y4PDR63C.js");
   const cwd = process.cwd();
   const crossResult = await runCrossCheck2({
-    specsDir: path57.join(cwd, "docs", "specs"),
-    plansDir: path57.join(cwd, "docs", "plans"),
+    specsDir: path58.join(cwd, "docs", "specs"),
+    plansDir: path58.join(cwd, "docs", "plans"),
     projectPath: cwd
   });
   if (!crossResult.ok || crossResult.value.warnings === 0) return;
@@ -7842,7 +8371,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 Command78("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 +8400,7 @@ function createValidateCommand3() {
 // src/commands/_registry.ts
 var commandCreators = [
   createAddCommand,
+  createAdoptionCommand,
   createAgentCommand,
   createBlueprintCommand,
   createCheckArchCommand,
@@ -7881,6 +8411,7 @@ var commandCreators = [
   createCheckSecurityCommand,
   createCICommand,
   createCleanupCommand,
+  createCleanupSessionsCommand,
   createCreateSkillCommand,
   createDashboardCommand,
   createDoctorCommand,
@@ -7914,6 +8445,7 @@ var commandCreators = [
   createSnapshotCommand,
   createStateCommand,
   createTaintCommand,
+  createTelemetryCommand,
   createTraceabilityCommand,
   createUninstallCommand,
   createUninstallConstraintsCommand,
@@ -7924,7 +8456,7 @@ var commandCreators = [
 
 // src/index.ts
 function createProgram() {
-  const program = new Command75();
+  const program = new Command79();
   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());
@@ -7936,7 +8468,6 @@ export {
   runCheckArch,
   runGraphStatus,
   runGraphExport,
-  runScan,
   runQuery,
   runIngest,
   runImpactPreview,