@harness-engineering/cli 1.25.4 → 1.25.6

package/dist/{chunk-2KZAXESR.js → chunk-R7P2FMJT.js}

@@ -1,19 +1,19 @@
 import {
   generateAgentsMd
-} from "./chunk-5BQ5BOJL.js";
+} from "./chunk-7BAGSY5Q.js";
 import {
   generateCIWorkflow
-} from "./chunk-EHRZMOQ2.js";
+} from "./chunk-RKZW3FDF.js";
 import {
   TemplateEngine
-} from "./chunk-FSNPBT74.js";
+} from "./chunk-BUJOMC3O.js";
 import {
   generate,
   validate
 } from "./chunk-CQ553GZO.js";
 import {
   generateRuntime
-} from "./chunk-6VZQJ5CX.js";
+} from "./chunk-FL6A72LV.js";
 import {
   runPersona
 } from "./chunk-GISMXMVL.js";
@@ -28,21 +28,21 @@ import {
   OutputMode,
   createCheckPhaseGateCommand,
   findFiles
-} from "./chunk-FIQL2HND.js";
+} from "./chunk-Y5JA4J2M.js";
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
-} from "./chunk-AT74HEQM.js";
+} from "./chunk-U2OMWI7Z.js";
 import {
   toKebabCase
 } from "./chunk-KET4QQZB.js";
 import {
   listPersonas,
   loadPersona
-} from "./chunk-P7PANON5.js";
+} from "./chunk-VELT5VAG.js";
 import {
   createScanCommand
-} from "./chunk-4NK7Z3BP.js";
+} from "./chunk-R2BI5UPK.js";
 import {
   appendFrameworkAgents,
   captureHealthSnapshot,
@@ -56,11 +56,11 @@ import {
   loadOrRebuildIndex,
   persistToolingConfig,
   recommend
-} from "./chunk-BUYW3SA2.js";
+} from "./chunk-43VBX44J.js";
 import {
   findConfigFile,
   resolveConfig
-} from "./chunk-WIQA4BSH.js";
+} from "./chunk-JUXFYB2K.js";
 import {
   VALID_PLATFORMS
 } from "./chunk-3ISINLYT.js";
@@ -74,7 +74,7 @@ import {
 } from "./chunk-6B6UN6SG.js";
 import {
   loadGraphStore
-} from "./chunk-BOQRTARD.js";
+} from "./chunk-SMY35HJM.js";
 import {
   CLI_VERSION
 } from "./chunk-BM3PWGXQ.js";
@@ -148,7 +148,7 @@ import {
   validateKnowledgeMap,
   writeConfig,
   writeLockfile
-} from "./chunk-MI6MA6OP.js";
+} from "./chunk-42ZZLMYD.js";
 import {
   Err,
   Ok
@@ -173,7 +173,7 @@ import {
 } from "./chunk-KFQGP6VL.js";
 
 // src/index.ts
-import { Command as Command83 } from "commander";
+import { Command as Command84 } from "commander";
 
 // src/commands/add.ts
 init_dist();
@@ -362,7 +362,7 @@ function registerSkillsCommand(adoption) {
     const globalOpts = cmd.optsWithGlobals();
     const limit = Math.max(parseInt(opts.limit, 10) || 20, 1);
     const cwd = process.cwd();
-    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-WCSJHQPK.js");
+    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-T3DGV5UN.js");
     const records = readAdoptionRecords(cwd);
     if (records.length === 0) {
       if (globalOpts.json) {
@@ -398,7 +398,7 @@ function registerRecentCommand(adoption) {
     const globalOpts = cmd.optsWithGlobals();
     const limit = Math.max(parseInt(opts.limit, 10) || 20, 1);
     const cwd = process.cwd();
-    const { readAdoptionRecords } = await import("./dist-WCSJHQPK.js");
+    const { readAdoptionRecords } = await import("./dist-T3DGV5UN.js");
     const records = readAdoptionRecords(cwd);
     if (records.length === 0) {
       if (globalOpts.json) {
@@ -431,62 +431,68 @@ function registerRecentCommand(adoption) {
 Showing ${limited.length} of ${records.length} invocations`);
   });
 }
+function computePhaseRates(skillRecords) {
+  const phaseMap = /* @__PURE__ */ new Map();
+  for (const r of skillRecords) {
+    for (const phase of r.phasesReached) {
+      phaseMap.set(phase, (phaseMap.get(phase) ?? 0) + 1);
+    }
+  }
+  return Array.from(phaseMap.entries()).map(([phase, count]) => ({ phase, count, rate: count / skillRecords.length })).sort((a, b) => b.count - a.count);
+}
+function computeOutcomes(skillRecords) {
+  const outcomes = { completed: 0, failed: 0, abandoned: 0 };
+  for (const r of skillRecords) {
+    if (r.outcome in outcomes) {
+      outcomes[r.outcome]++;
+    }
+  }
+  return outcomes;
+}
+function printSkillDetail(name, summary, phaseRates, skillRecords) {
+  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 = computeOutcomes(skillRecords);
+  console.log("\nOutcome breakdown:");
+  console.log(`  Completed: ${outcomes.completed}`);
+  console.log(`  Failed: ${outcomes.failed}`);
+  console.log(`  Abandoned: ${outcomes.abandoned}`);
+}
 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-WCSJHQPK.js");
+    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-T3DGV5UN.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}".`);
-      }
+      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);
+    const summary = aggregateBySkill(skillRecords)[0];
+    const phaseRates = computePhaseRates(skillRecords);
     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}`);
+    printSkillDetail(name, summary, phaseRates, skillRecords);
   });
 }
 function createAdoptionCommand() {
@@ -2052,6 +2058,12 @@ async function runCleanupSessions(options) {
   }
   return Ok(result);
 }
+function printSessionList(label, sessions) {
+  if (sessions.length === 0) return;
+  console.log(`
+${label} (${sessions.length}):`);
+  for (const s of sessions) console.log(`  - ${s}`);
+}
 function printResult(result, dryRun, asJson) {
   const { removed, kept } = result;
   if (asJson) {
@@ -2062,17 +2074,9 @@ function printResult(result, dryRun, asJson) {
     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}`);
-  }
+  const removeLabel = dryRun ? "Stale (would remove)" : "Removed";
+  printSessionList(removeLabel, removed);
+  printSessionList("Kept", kept);
   if (!dryRun && removed.length > 0) {
     console.log(`
 Cleaned up ${removed.length} stale session(s).`);
@@ -2146,16 +2150,7 @@ function spawnDashboardServer(server, env) {
   });
   return child;
 }
-function runDashboard(opts) {
-  const clientPort = Number(opts.port ?? DEFAULT_CLIENT_PORT);
-  const apiPort = Number(opts.apiPort ?? DEFAULT_API_PORT);
-  const projectPath = resolve11(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);
-  }
+function buildDashboardEnv(opts, clientPort, apiPort, projectPath) {
   const env = {
     ...process.env,
     DASHBOARD_API_PORT: String(apiPort),
@@ -2167,6 +2162,19 @@ function runDashboard(opts) {
   } else if (!env["ORCHESTRATOR_URL"] && !env["ORCHESTRATOR_PORT"]) {
     env["ORCHESTRATOR_PORT"] = "8080";
   }
+  return env;
+}
+function runDashboard(opts) {
+  const clientPort = Number(opts.port ?? DEFAULT_CLIENT_PORT);
+  const apiPort = Number(opts.apiPort ?? DEFAULT_API_PORT);
+  const projectPath = resolve11(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 = buildDashboardEnv(opts, clientPort, apiPort, projectPath);
   spawnDashboardServer(server, env);
   console.log(`Dashboard API starting on http://localhost:${apiPort}`);
   console.log(`Open ${url} (pass --no-open to suppress)`);
@@ -2757,7 +2765,7 @@ import { Command as Command25 } from "commander";
 // src/commands/graph/status.ts
 import * as path15 from "path";
 async function runGraphStatus(projectPath) {
-  const { GraphStore } = await import("./dist-RADHOOXG.js");
+  const { GraphStore } = await import("./dist-GRW3X2ZQ.js");
   const graphDir = path15.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
@@ -2797,7 +2805,7 @@ async function runGraphStatus(projectPath) {
 // src/commands/graph/export.ts
 import * as path16 from "path";
 async function runGraphExport(projectPath, format) {
-  const { GraphStore } = await import("./dist-RADHOOXG.js");
+  const { GraphStore } = await import("./dist-GRW3X2ZQ.js");
   const graphDir = path16.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
@@ -2833,7 +2841,7 @@ import * as path19 from "path";
 import { Command as Command23 } from "commander";
 import * as path17 from "path";
 async function runQuery(projectPath, rootNodeId, opts) {
-  const { GraphStore, ContextQL } = await import("./dist-RADHOOXG.js");
+  const { GraphStore, ContextQL } = await import("./dist-GRW3X2ZQ.js");
   const store = new GraphStore();
   const graphDir = path17.join(projectPath, ".harness", "graph");
   const loaded = await store.load(graphDir);
@@ -2927,7 +2935,7 @@ async function runIngest(projectPath, source, opts) {
     SlackConnector,
     CIConnector,
     ConfluenceConnector
-  } = await import("./dist-RADHOOXG.js");
+  } = await import("./dist-GRW3X2ZQ.js");
   const graphDir = path18.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   await store.load(graphDir);
@@ -5428,7 +5436,7 @@ function createMcpCommand() {
     parseBudget
   ).action(async (opts) => {
     const [{ startServer: startServer2, getToolDefinitions: getToolDefinitions2 }, { selectTier }] = await Promise.all([
-      import("./mcp-JZ7YB7TD.js"),
+      import("./mcp-GGNFWKVC.js"),
       import("./tool-tiers-7QGZ3FKY.js")
     ]);
     if (opts.tools && opts.tools.length > 0) {
@@ -5494,7 +5502,7 @@ function registerBenchCommand(perf) {
   perf.command("bench [glob]").description("Run benchmarks via vitest bench").action(async (glob2, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
-    const { BenchmarkRunner } = await import("./dist-WCSJHQPK.js");
+    const { BenchmarkRunner } = await import("./dist-T3DGV5UN.js");
     const runner = new BenchmarkRunner();
     const benchFiles = runner.discover(cwd, glob2);
     if (benchFiles.length === 0) {
@@ -5558,7 +5566,7 @@ async function runBaselinesShow(globalOpts) {
 }
 async function runBaselinesUpdate(globalOpts) {
   const cwd = process.cwd();
-  const { BenchmarkRunner } = await import("./dist-WCSJHQPK.js");
+  const { BenchmarkRunner } = await import("./dist-T3DGV5UN.js");
   const runner = new BenchmarkRunner();
   const manager = new BaselineManager(cwd);
   logger.info("Running benchmarks to update baselines...");
@@ -5599,7 +5607,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-WCSJHQPK.js");
+    const { EntropyAnalyzer: EntropyAnalyzer2 } = await import("./dist-T3DGV5UN.js");
     const analyzer = new EntropyAnalyzer2({
       rootDir: path40.resolve(cwd),
       analyze: { complexity: true, coupling: true }
@@ -5990,7 +5998,7 @@ async function runPublishAnalyses(opts) {
   const nameToExternalId = buildNameToExternalIdMap(projectPath);
   if (!nameToExternalId) return process.exit(1);
   const { AnalysisArchive } = await import("@harness-engineering/orchestrator");
-  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-WCSJHQPK.js");
+  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-T3DGV5UN.js");
   const archive = new AnalysisArchive(path42.join(projectPath, ".harness", "analyses"));
   const analyses = await archive.list();
   if (analyses.length === 0) {
@@ -6275,10 +6283,10 @@ function prompt(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve35) => {
+  return new Promise((resolve36) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve35(answer.trim().toLowerCase());
+      resolve36(answer.trim().toLowerCase());
     });
   });
 }
@@ -6287,10 +6295,10 @@ function promptRaw(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve35) => {
+  return new Promise((resolve36) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve35(answer.trim());
+      resolve36(answer.trim());
     });
   });
 }
@@ -6516,7 +6524,7 @@ function ensureHooks(cwd) {
 }
 async function runInitialGraphScan(cwd) {
   try {
-    const { runScan: runScan2 } = await import("./scan-MPJ6JHUY.js");
+    const { runScan: runScan2 } = await import("./scan-DXQUHGTT.js");
     const result = await runScan2(cwd);
     return {
       status: "pass",
@@ -7790,8 +7798,8 @@ async function resolveStatePath(projectPath, stream) {
 }
 async function confirmReset() {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve35) => {
-    rl.question("Reset project state? This cannot be undone. [y/N] ", resolve35);
+  const answer = await new Promise((resolve36) => {
+    rl.question("Reset project state? This cannot be undone. [y/N] ", resolve36);
   });
   rl.close();
   return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
@@ -8019,7 +8027,7 @@ async function runSyncAnalyses(opts) {
     return;
   }
   const { AnalysisArchive, loadPublishedIndex: loadPublishedIndex2, savePublishedIndex: savePublishedIndex2 } = await import("@harness-engineering/orchestrator");
-  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-WCSJHQPK.js");
+  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-T3DGV5UN.js");
   const adapter = new GitHubIssuesSyncAdapter2({ token, config: trackerConfig });
   const archive = new AnalysisArchive(path58.join(projectPath, ".harness", "analyses"));
   const publishedIndex = loadPublishedIndex2(projectPath);
@@ -8135,7 +8143,7 @@ function createTaintCommand() {
 }
 
 // src/commands/telemetry/index.ts
-import { Command as Command76 } from "commander";
+import { Command as Command77 } from "commander";
 
 // src/commands/telemetry/identify.ts
 init_dist();
@@ -8201,29 +8209,33 @@ function resolveDisabledReason() {
   if (process.env.HARNESS_TELEMETRY_OPTOUT === "1") return "HARNESS_TELEMETRY_OPTOUT=1";
   return "telemetry.enabled is false in config";
 }
+function printIdentity2(identity) {
+  const hasIdentity = identity.project || identity.team || identity.alias;
+  if (!hasIdentity) {
+    logger.info("Identity: not configured");
+    return;
+  }
+  logger.info("Identity:");
+  for (const [key, value] of Object.entries(identity)) {
+    if (value) logger.info(`  ${key.padEnd(7)}: ${value}`);
+  }
+}
+function printEnvOverrides(overrides) {
+  const keys = Object.keys(overrides);
+  if (keys.length === 0) return;
+  logger.info("Env overrides:");
+  for (const key of keys) {
+    logger.info(`  ${key}=${overrides[key]}`);
+  }
+}
 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]}`);
-    }
-  }
+  printIdentity2(result.identity);
+  printEnvOverrides(result.envOverrides);
 }
 function createStatusCommand() {
   const cmd = new Command75("status").description("Show current telemetry consent state, install ID, and identity").option("--json", "Output as JSON").action((opts) => {
@@ -8257,16 +8269,176 @@ function createStatusCommand() {
   return cmd;
 }
 
+// src/commands/telemetry/test.ts
+init_dist();
+import { Command as Command76 } from "commander";
+
+// src/bin/command-telemetry.ts
+import { existsSync as existsSync36, readFileSync as readFileSync25, mkdirSync as mkdirSync15, appendFileSync, writeFileSync as writeFileSync18 } from "fs";
+import { join as join45, parse as parsePath, resolve as resolve33 } from "path";
+import { spawn as spawn2 } from "child_process";
+var POSTHOG_API_KEY = "phc_wNTdCMcfJXZPgdNeDociZW6vwoGGo4nb7vqEfWThFfsG";
+var EXCLUDED_COMMANDS = /* @__PURE__ */ new Set(["help", "completion"]);
+function findProjectRoot(cwd) {
+  let dir = resolve33(cwd);
+  const { root } = parsePath(dir);
+  while (dir !== root) {
+    if (existsSync36(join45(dir, "harness.config.json"))) return dir;
+    dir = resolve33(dir, "..");
+  }
+  return cwd;
+}
+var commandName = "";
+var startTime = 0;
+var recorded = false;
+function installCommandTelemetry(program, cwd) {
+  if (typeof program.hook !== "function") return;
+  const projectRoot = findProjectRoot(cwd);
+  flushTelemetryBackground(projectRoot);
+  program.hook("preAction", (_thisCommand, actionCommand) => {
+    commandName = resolveCommandName(actionCommand);
+    startTime = Date.now();
+  });
+  process.on("exit", (code) => {
+    if (recorded || !commandName || EXCLUDED_COMMANDS.has(commandName)) return;
+    recorded = true;
+    const duration = Date.now() - startTime;
+    const outcome = code === 0 ? "completed" : "failed";
+    writeCommandRecordSync(projectRoot, commandName, duration, outcome);
+  });
+}
+function resolveCommandName(cmd) {
+  const parts = [];
+  let current = cmd;
+  while (current) {
+    const name = current.name();
+    if (name && name !== "harness") {
+      parts.unshift(name);
+    }
+    current = current.parent;
+  }
+  return parts.length > 0 ? `cli/${parts.join(".")}` : "";
+}
+function writeCommandRecordSync(cwd, command, duration, outcome) {
+  try {
+    const metricsDir = join45(cwd, ".harness", "metrics");
+    mkdirSync15(metricsDir, { recursive: true });
+    const record = {
+      skill: command,
+      session: `cli-${Date.now()}`,
+      startedAt: new Date(Date.now() - duration).toISOString(),
+      duration,
+      outcome,
+      phasesReached: []
+    };
+    const adoptionFile = join45(metricsDir, "adoption.jsonl");
+    appendFileSync(adoptionFile, JSON.stringify(record) + "\n");
+  } catch {
+  }
+}
+function isTelemetryDisabledByConfig(cwd) {
+  const configPath = join45(cwd, "harness.config.json");
+  if (!existsSync36(configPath)) return false;
+  try {
+    const config = JSON.parse(readFileSync25(configPath, "utf-8"));
+    return config?.telemetry?.enabled === false;
+  } catch {
+    return false;
+  }
+}
+function isTelemetryOptedOut(cwd) {
+  if (isTelemetryDisabledByConfig(cwd)) return true;
+  return process.env.DO_NOT_TRACK === "1" || process.env.HARNESS_TELEMETRY_OPTOUT === "1";
+}
+function flushTelemetryBackground(cwd) {
+  try {
+    const adoptionFile = join45(cwd, ".harness", "metrics", "adoption.jsonl");
+    if (!existsSync36(adoptionFile)) return;
+    if (isTelemetryOptedOut(cwd)) return;
+    const reporterPath = join45(cwd, ".harness", "hooks", "telemetry-reporter.js");
+    if (!existsSync36(reporterPath)) return;
+    const child = spawn2(process.execPath, [reporterPath], {
+      cwd,
+      stdio: ["pipe", "ignore", "ignore"],
+      detached: true
+    });
+    child.stdin?.write("{}");
+    child.stdin?.end();
+    child.unref();
+  } catch {
+  }
+}
+
+// src/commands/telemetry/test.ts
+var POSTHOG_BATCH_URL = "https://app.posthog.com/batch";
+function buildTestEvent(distinctId, installId, identity) {
+  return {
+    event: "telemetry_test",
+    distinct_id: distinctId,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    properties: {
+      installId,
+      os: process.platform,
+      nodeVersion: process.version,
+      test: true,
+      ...identity.project ? { project: identity.project } : {},
+      ...identity.team ? { team: identity.team } : {}
+    }
+  };
+}
+function reportTestSuccess(status, distinctId, identity) {
+  logger.success(`PostHog responded ${status} OK \u2014 telemetry is working`);
+  logger.info(`  distinct_id: ${distinctId}`);
+  if (identity.project) logger.info(`  project:     ${identity.project}`);
+  if (identity.team) logger.info(`  team:        ${identity.team}`);
+}
+function createTestCommand() {
+  return new Command76("test").description("Send a test event to PostHog and verify connectivity").action(async () => {
+    const cwd = process.cwd();
+    const consent = resolveConsent(cwd, void 0);
+    if (!consent.allowed) {
+      logger.error("Telemetry is disabled. Run `harness telemetry status` for details.");
+      process.exitCode = 1;
+      return;
+    }
+    const { installId, identity } = consent;
+    const distinctId = identity.alias ?? installId;
+    const event = buildTestEvent(distinctId, installId, identity);
+    const payload = JSON.stringify({ api_key: POSTHOG_API_KEY, batch: [event] });
+    logger.info(`Sending test event as "${distinctId}"...`);
+    try {
+      const res = await fetch(POSTHOG_BATCH_URL, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: payload,
+        signal: AbortSignal.timeout(1e4)
+      });
+      const body = await res.text();
+      if (res.ok) {
+        reportTestSuccess(res.status, distinctId, identity);
+      } else {
+        logger.error(`PostHog responded ${res.status}: ${body}`);
+        process.exitCode = 1;
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      logger.error(`Failed to reach PostHog: ${msg}`);
+      process.exitCode = 1;
+    }
+  });
+}
+
 // src/commands/telemetry/index.ts
 function createTelemetryCommand() {
-  const command = new Command76("telemetry").description("Telemetry identity and status management");
+  const command = new Command77("telemetry").description("Telemetry identity and status management");
   command.addCommand(createIdentifyCommand());
   command.addCommand(createStatusCommand());
+  command.addCommand(createTestCommand());
   return command;
 }
 
 // src/commands/traceability.ts
-import { Command as Command77 } from "commander";
+import { Command as Command78 } from "commander";
 import chalk11 from "chalk";
 function confidenceLabel(maxConfidence) {
   if (maxConfidence >= 0.8) return "explicit";
@@ -8382,7 +8554,7 @@ async function runTraceability(options) {
   const projectPath = process.cwd();
   const store = await loadGraphStore(projectPath);
   if (!store) handleNoStore(mode);
-  const graphModule = await import("./dist-RADHOOXG.js");
+  const graphModule = await import("./dist-GRW3X2ZQ.js");
   const filterOptions = buildFilterOptions(options);
   const results = graphModule.queryTraceability(store, filterOptions);
   if (results.length === 0) handleEmptyResults(mode);
@@ -8397,7 +8569,7 @@ async function runTraceability(options) {
   process.exit(ExitCode.SUCCESS);
 }
 function createTraceabilityCommand() {
-  return new Command77("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 Command78("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,
@@ -8411,7 +8583,7 @@ function createTraceabilityCommand() {
 
 // src/commands/uninstall.ts
 import * as path60 from "path";
-import { Command as Command78 } from "commander";
+import { Command as Command79 } from "commander";
 async function runUninstall(skillName, options) {
   const packageName = resolvePackageName(skillName);
   const shortName = extractSkillName(packageName);
@@ -8448,7 +8620,7 @@ async function runUninstall(skillName, options) {
   return result;
 }
 function createUninstallCommand() {
-  const cmd = new Command78("uninstall");
+  const cmd = new Command79("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);
@@ -8470,7 +8642,7 @@ function createUninstallCommand() {
 init_dist();
 import * as fs40 from "fs/promises";
 import * as path61 from "path";
-import { Command as Command79 } from "commander";
+import { Command as Command80 } from "commander";
 async function runUninstallConstraints(options) {
   const { packageName, configPath, lockfilePath } = options;
   const lockfileResult = await readLockfile(lockfilePath);
@@ -8527,7 +8699,7 @@ async function runUninstallConstraints(options) {
   };
 }
 function createUninstallConstraintsCommand() {
-  const cmd = new Command79("uninstall-constraints");
+  const cmd = new Command80("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) {
@@ -8566,10 +8738,10 @@ function createUninstallConstraintsCommand() {
 }
 
 // src/commands/update.ts
-import { Command as Command80 } from "commander";
+import { Command as Command81 } from "commander";
 import { execFile, execFileSync as execFileSync6 } from "child_process";
-import { realpathSync, existsSync as existsSync36, readFileSync as readFileSync25 } from "fs";
-import { join as join47 } from "path";
+import { realpathSync, existsSync as existsSync37, readFileSync as readFileSync26 } from "fs";
+import { join as join48 } from "path";
 import { promisify } from "util";
 import readline3 from "readline";
 import chalk12 from "chalk";
@@ -8635,10 +8807,10 @@ function prompt2(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve35) => {
+  return new Promise((resolve36) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve35(answer.trim().toLowerCase());
+      resolve36(answer.trim().toLowerCase());
     });
   });
 }
@@ -8653,12 +8825,12 @@ async function ensureTelemetryIfNeeded() {
 }
 function refreshHooks() {
   const cwd = process.cwd();
-  const configPath = join47(cwd, "harness.config.json");
-  if (!existsSync36(configPath)) return;
+  const configPath = join48(cwd, "harness.config.json");
+  if (!existsSync37(configPath)) return;
   let profile = "standard";
-  const profilePath = join47(cwd, ".harness", "hooks", "profile.json");
+  const profilePath = join48(cwd, ".harness", "hooks", "profile.json");
   try {
-    const data = JSON.parse(readFileSync25(profilePath, "utf-8"));
+    const data = JSON.parse(readFileSync26(profilePath, "utf-8"));
     if (data.profile && ["minimal", "standard", "strict"].includes(data.profile)) {
       profile = data.profile;
     }
@@ -8784,7 +8956,7 @@ async function runUpdateAction(opts, globalOpts) {
   process.exit(ExitCode.SUCCESS);
 }
 function createUpdateCommand() {
-  return new Command80("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(
+  return new Command81("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) => {
@@ -8794,9 +8966,9 @@ function createUpdateCommand() {
 }
 
 // src/commands/usage.ts
-import { Command as Command81 } from "commander";
+import { Command as Command82 } from "commander";
 async function loadAndPriceRecords(cwd, includeClaudeSessions = false) {
-  const { readCostRecords, loadPricingData, calculateCost, parseCCRecords } = await import("./dist-WCSJHQPK.js");
+  const { readCostRecords, loadPricingData, calculateCost, parseCCRecords } = await import("./dist-T3DGV5UN.js");
   const records = readCostRecords(cwd);
   if (includeClaudeSessions) {
     const ccRecords = parseCCRecords();
@@ -8840,6 +9012,41 @@ function formatModels(models) {
   if (models.length === 1) return models[0] ?? "unknown";
   return `${models[0] ?? "unknown"} and ${models.length - 1} other${models.length - 1 > 1 ? "s" : ""}`;
 }
+function enrichDayForJson(day, pricingData) {
+  const hitRate = computeCacheHitRate(day.cacheReadTokens, day.tokens.inputTokens);
+  const savings = computeCacheSavings(day.cacheReadTokens, day.models[0], pricingData);
+  return {
+    ...day,
+    ...hitRate != null ? { cacheHitRate: Math.round(hitRate * 1e3) / 1e3 } : {},
+    ...savings != null ? { cacheSavingsMicroUSD: savings } : {}
+  };
+}
+function formatDayCacheColumns(day, pricingData) {
+  const rate = computeCacheHitRate(day.cacheReadTokens, day.tokens.inputTokens);
+  const savings = computeCacheSavings(day.cacheReadTokens, day.models[0], pricingData);
+  const rateStr = rate != null ? formatPercent(rate).padStart(5) : "    -";
+  const savingsStr = savings != null ? formatMicroUSD(savings).padStart(7) : "    N/A";
+  return " | " + rateStr + " | " + savingsStr;
+}
+function printDailyTable(limited, pricingData) {
+  const hasCacheData = limited.some((d) => d.cacheReadTokens != null && d.cacheReadTokens > 0);
+  const cacheHeader = hasCacheData ? " | Cache  | Saved  " : "";
+  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) {
+    const date = day.date.padEnd(12);
+    const sessions = String(day.sessionCount).padStart(8);
+    const input = formatTokenCount(day.tokens.inputTokens).padStart(9);
+    const output = formatTokenCount(day.tokens.outputTokens).padStart(9);
+    const models = formatModels(day.models).padEnd(28);
+    const cost = formatMicroUSD(day.costMicroUSD);
+    const cacheCol = hasCacheData ? formatDayCacheColumns(day, pricingData) : "";
+    logger.info(`${date} | ${sessions} | ${input} | ${output} | ${models} | ${cost}${cacheCol}`);
+  }
+}
 function registerDailyCommand(usage) {
   usage.command("daily").description("Show per-day token usage and cost").option("--days <n>", "Number of days to show (default: 7, max: 90)", "7").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
@@ -8850,54 +9057,23 @@ function registerDailyCommand(usage) {
       globalOpts.includeClaudeSessions
     );
     if (records.length === 0) {
-      if (globalOpts.json) {
-        console.log(JSON.stringify([]));
-      } else {
-        logger.info("No usage data found. Run some harness sessions first.");
-      }
+      if (globalOpts.json) console.log(JSON.stringify([]));
+      else logger.info("No usage data found. Run some harness sessions first.");
       return;
     }
-    const { aggregateByDay } = await import("./dist-WCSJHQPK.js");
-    const dailyData = aggregateByDay(records);
-    const limited = dailyData.slice(0, days);
+    const { aggregateByDay } = await import("./dist-T3DGV5UN.js");
+    const limited = aggregateByDay(records).slice(0, days);
     if (globalOpts.json) {
-      const enriched = limited.map((day) => {
-        const hitRate = computeCacheHitRate(day.cacheReadTokens, day.tokens.inputTokens);
-        const savings = computeCacheSavings(day.cacheReadTokens, day.models[0], pricingData);
-        return {
-          ...day,
-          ...hitRate != null ? { cacheHitRate: Math.round(hitRate * 1e3) / 1e3 } : {},
-          ...savings != null ? { cacheSavingsMicroUSD: savings } : {}
-        };
-      });
-      console.log(JSON.stringify(enriched, null, 2));
-      return;
-    }
-    const hasCacheData = limited.some((d) => d.cacheReadTokens != null && d.cacheReadTokens > 0);
-    const cacheHeader = hasCacheData ? " | Cache  | Saved  " : "";
-    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) {
-      const date = day.date.padEnd(12);
-      const sessions = String(day.sessionCount).padStart(8);
-      const input = formatTokenCount(day.tokens.inputTokens).padStart(9);
-      const output = formatTokenCount(day.tokens.outputTokens).padStart(9);
-      const models = formatModels(day.models).padEnd(28);
-      const cost = formatMicroUSD(day.costMicroUSD);
-      const cacheCol = hasCacheData ? (() => {
-        const rate = computeCacheHitRate(day.cacheReadTokens, day.tokens.inputTokens);
-        const savings = computeCacheSavings(day.cacheReadTokens, day.models[0], pricingData);
-        const rateStr = rate != null ? formatPercent(rate).padStart(5) : "    -";
-        const savingsStr = savings != null ? formatMicroUSD(savings).padStart(7) : "    N/A";
-        return " | " + rateStr + " | " + savingsStr;
-      })() : "";
-      logger.info(
-        `${date} | ${sessions} | ${input} | ${output} | ${models} | ${cost}${cacheCol}`
+      console.log(
+        JSON.stringify(
+          limited.map((d) => enrichDayForJson(d, pricingData)),
+          null,
+          2
+        )
       );
+      return;
     }
+    printDailyTable(limited, pricingData);
   });
 }
 function registerSessionsCommand(usage) {
@@ -8914,7 +9090,7 @@ function registerSessionsCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-WCSJHQPK.js");
+    const { aggregateBySession } = await import("./dist-T3DGV5UN.js");
     const sessionData = aggregateBySession(records);
     const limited = sessionData.slice(0, limit);
     if (globalOpts.json) {
@@ -8994,7 +9170,7 @@ function registerSessionCommand(usage) {
       cwd,
       globalOpts.includeClaudeSessions
     );
-    const { aggregateBySession } = await import("./dist-WCSJHQPK.js");
+    const { aggregateBySession } = await import("./dist-T3DGV5UN.js");
     const sessionData = aggregateBySession(records);
     const match = sessionData.find((s) => s.sessionId === id);
     if (!match) {
@@ -9029,7 +9205,7 @@ function registerLatestCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-WCSJHQPK.js");
+    const { aggregateBySession } = await import("./dist-T3DGV5UN.js");
     const sessionData = aggregateBySession(records);
     const latest = sessionData[0];
     if (!latest) {
@@ -9055,7 +9231,7 @@ function registerLatestCommand(usage) {
   });
 }
 function createUsageCommand() {
-  const usage = new Command81("usage").description("Token usage and cost tracking");
+  const usage = new Command82("usage").description("Token usage and cost tracking");
   usage.option(
     "--include-claude-sessions",
     "Include Claude Code session data from ~/.claude/projects/"
@@ -9070,7 +9246,7 @@ function createUsageCommand() {
 // src/commands/validate.ts
 init_dist();
 init_dist();
-import { Command as Command82 } from "commander";
+import { Command as Command83 } from "commander";
 import * as path62 from "path";
 async function runValidate(options) {
   const configResult = resolveConfig(options.configPath);
@@ -9153,7 +9329,7 @@ function resolveValidateMode(globalOpts) {
   return OutputMode.TEXT;
 }
 async function printCrossCheckWarnings(mode) {
-  const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-ZOWFA3DB.js");
+  const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-LJKXBQYH.js");
   const cwd = process.cwd();
   const crossResult = await runCrossCheck2({
     specsDir: path62.join(cwd, "docs", "specs"),
@@ -9169,7 +9345,7 @@ async function printCrossCheckWarnings(mode) {
   ${crossResult.value.warnings} warnings`);
 }
 function createValidateCommand3() {
-  const command = new Command82("validate").description("Run all validation checks").option("--cross-check", "Run cross-artifact consistency validation").option(
+  const command = new Command83("validate").description("Run all validation checks").option("--cross-check", "Run cross-artifact consistency validation").option(
     "--agent-configs",
     "Validate agent configs (CLAUDE.md, hooks, skills) via agnix or built-in fallback rules"
   ).option("--strict", "Treat warnings as errors (applies to --agent-configs)").option("--agnix-bin <path>", "Override the agnix binary path discovered on PATH").action(async (opts, cmd) => runValidateAction(opts, cmd.optsWithGlobals()));
@@ -9278,7 +9454,7 @@ var commandCreators = [
 
 // src/index.ts
 function createProgram() {
-  const program = new Command83();
+  const program = new Command84();
   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());
@@ -9298,6 +9474,7 @@ export {
   printFirstRunWelcome,
   buildPreamble,
   runSnapshotCapture,
+  installCommandTelemetry,
   runUninstall,
   runUninstallConstraints,
   createProgram