@harness-engineering/cli 2.3.0 → 2.4.0

package/dist/{chunk-35FI23SO.js → chunk-TCR5PKMU.js}

@@ -1,15 +1,15 @@
 import {
   generateRuntime
-} from "./chunk-KUVPSUG4.js";
+} from "./chunk-TVJZX53C.js";
 import {
   generateAgentsMd
-} from "./chunk-DLBMYLYR.js";
+} from "./chunk-FJJYQWUP.js";
 import {
   generateCIWorkflow
-} from "./chunk-MKPRB4PL.js";
+} from "./chunk-DJRRTZGD.js";
 import {
   TemplateEngine
-} from "./chunk-5KTTKXQN.js";
+} from "./chunk-54JTO4NZ.js";
 import {
   generate,
   validate
@@ -28,22 +28,22 @@ import {
   OutputMode,
   createCheckPhaseGateCommand,
   findFiles
-} from "./chunk-D2LZUJLP.js";
+} from "./chunk-5YOHXTK3.js";
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
-} from "./chunk-GUIX2TMZ.js";
+} from "./chunk-RYVL76ZF.js";
 import {
   toKebabCase
 } from "./chunk-KET4QQZB.js";
 import {
   listPersonas,
   loadPersona
-} from "./chunk-L3CEN42B.js";
+} from "./chunk-JGPOQJ73.js";
 import {
   createScanCommand,
   loadIngestOptions
-} from "./chunk-YG4ZBGEH.js";
+} from "./chunk-7BNK4M23.js";
 import {
   appendFrameworkAgents,
   captureHealthSnapshot,
@@ -57,17 +57,18 @@ import {
   loadCachedSnapshot,
   persistToolingConfig,
   recommend
-} from "./chunk-3LPOTTPX.js";
+} from "./chunk-Q43LM7CO.js";
 import {
   loadGraphStore
-} from "./chunk-KTWKW6KJ.js";
+} from "./chunk-TIQU5VY7.js";
 import {
   loadOrRebuildIndex
 } from "./chunk-27AJKSQY.js";
 import {
+  BranchingConfigSchema,
   findConfigFile,
   resolveConfig
-} from "./chunk-PW3U4YJV.js";
+} from "./chunk-KPWUZSHL.js";
 import {
   VALID_PLATFORMS
 } from "./chunk-3ISINLYT.js";
@@ -130,7 +131,7 @@ import {
   generateSuggestions,
   getOrCreateInstallId,
   gitScan,
-  init_dist,
+  init_dist as init_dist2,
   isoWeek,
   listStreams,
   listTaintedSessions,
@@ -163,6 +164,7 @@ import {
   setActiveStream,
   validateAgentConfigs,
   validateAgentsMap,
+  validateBranchName,
   validateDependencies,
   validateKnowledgeMap,
   validatePulseConfig,
@@ -170,11 +172,15 @@ import {
   validateSolutionsDir,
   writeConfig,
   writeLockfile
-} from "./chunk-4DWOMGUM.js";
+} from "./chunk-GDJ2MRYH.js";
 import {
   Err,
   Ok
 } from "./chunk-RL4VMEXL.js";
+import {
+  DEFAULT_SKIP_DIRS,
+  init_dist
+} from "./chunk-XPRGWHBL.js";
 import {
   createCreateSkillCommand
 } from "./chunk-ZP5E7YET.js";
@@ -195,10 +201,10 @@ import {
 } from "./chunk-KFQGP6VL.js";
 
 // src/index.ts
-import { Command as Command93 } from "commander";
+import { Command as Command94 } from "commander";
 
 // src/commands/add.ts
-init_dist();
+init_dist2();
 import { Command } from "commander";
 import * as fs from "fs";
 import * as path from "path";
@@ -384,7 +390,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-I4LWG3IN.js");
+    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-ZJGFXGIB.js");
     const records = readAdoptionRecords(cwd);
     if (records.length === 0) {
       if (globalOpts.json) {
@@ -420,7 +426,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-I4LWG3IN.js");
+    const { readAdoptionRecords } = await import("./dist-ZJGFXGIB.js");
     const records = readAdoptionRecords(cwd);
     if (records.length === 0) {
       if (globalOpts.json) {
@@ -498,7 +504,7 @@ 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-I4LWG3IN.js");
+    const { readAdoptionRecords, aggregateBySkill } = await import("./dist-ZJGFXGIB.js");
     const records = readAdoptionRecords(cwd);
     const skillRecords = records.filter((r) => r.skill === name);
     if (skillRecords.length === 0) {
@@ -529,8 +535,8 @@ function createAdoptionCommand() {
 import { Command as Command5 } from "commander";
 
 // src/commands/agent/run.ts
-init_dist();
-init_dist();
+init_dist2();
+init_dist2();
 import { Command as Command3 } from "commander";
 import * as path2 from "path";
 import * as childProcess from "child_process";
@@ -652,7 +658,7 @@ function createRunCommand() {
 }
 
 // src/commands/agent/review.ts
-init_dist();
+init_dist2();
 import { Command as Command4 } from "commander";
 import { execSync } from "child_process";
 async function runAgentReview(options) {
@@ -789,7 +795,7 @@ function createAgentCommand() {
 }
 
 // src/commands/audit-protected.ts
-init_dist();
+init_dist2();
 import { Command as Command6 } from "commander";
 import * as path3 from "path";
 import * as fs2 from "fs";
@@ -897,7 +903,7 @@ function createAuditProtectedCommand() {
 }
 
 // src/commands/blueprint.ts
-init_dist();
+init_dist2();
 import { Command as Command7 } from "commander";
 import * as path4 from "path";
 function createBlueprintCommand() {
@@ -922,7 +928,7 @@ function createBlueprintCommand() {
 }
 
 // src/commands/check-arch.ts
-init_dist();
+init_dist2();
 import { Command as Command8 } from "commander";
 import { execSync as execSync2 } from "child_process";
 function getCommitHash(cwd) {
@@ -1082,8 +1088,8 @@ function createCheckArchCommand() {
 }
 
 // src/commands/check-deps.ts
-init_dist();
-init_dist();
+init_dist2();
+init_dist2();
 import { Command as Command9 } from "commander";
 import * as path5 from "path";
 async function runCheckDeps(options) {
@@ -1183,8 +1189,8 @@ function createCheckDepsCommand() {
 }
 
 // src/commands/check-docs.ts
-init_dist();
-init_dist();
+init_dist2();
+init_dist2();
 import { Command as Command10 } from "commander";
 import * as path6 from "path";
 async function runCheckDocs(options) {
@@ -1293,7 +1299,7 @@ function createCheckDocsCommand() {
 }
 
 // src/commands/check-perf.ts
-init_dist();
+init_dist2();
 import { Command as Command11 } from "commander";
 import * as path7 from "path";
 async function runCheckPerf(cwd, options) {
@@ -1418,7 +1424,7 @@ function createCheckPerfCommand() {
 }
 
 // src/commands/check-security.ts
-init_dist();
+init_dist2();
 import { Command as Command12 } from "commander";
 import * as path8 from "path";
 import { execSync as execSync3 } from "child_process";
@@ -1540,7 +1546,7 @@ function createCheckSecurityCommand() {
 import { Command as Command16 } from "commander";
 
 // src/commands/ci/check.ts
-init_dist();
+init_dist2();
 import { Command as Command13 } from "commander";
 var VALID_CHECKS = [
   "validate",
@@ -1637,7 +1643,7 @@ function createCheckCommand() {
 }
 
 // src/commands/ci/init.ts
-init_dist();
+init_dist2();
 import { Command as Command14 } from "commander";
 import * as fs3 from "fs";
 import * as path9 from "path";
@@ -1781,7 +1787,7 @@ function createInitCommand() {
 }
 
 // src/commands/ci/notify.ts
-init_dist();
+init_dist2();
 import { Command as Command15 } from "commander";
 import * as fs4 from "fs";
 function loadReport(reportPath) {
@@ -1894,7 +1900,7 @@ function createCICommand() {
 }
 
 // src/commands/cleanup.ts
-init_dist();
+init_dist2();
 import { Command as Command17 } from "commander";
 import * as path10 from "path";
 async function runCleanup(options) {
@@ -1916,7 +1922,7 @@ async function runCleanup(options) {
   const entropyConfig = {
     rootDir,
     ...config.entropy?.entryPoints && { entryPoints: config.entropy.entryPoints },
-    docPaths: [docsDir],
+    docPaths: [path10.join(docsDir, "**/*.md")],
     analyze: {
       drift: type === "all" || type === "drift",
       deadCode: type === "all" || type === "dead-code",
@@ -2014,7 +2020,7 @@ function createCleanupCommand() {
 }
 
 // src/commands/cleanup-sessions.ts
-init_dist();
+init_dist2();
 import { Command as Command18 } from "commander";
 import * as fs5 from "fs";
 import * as path11 from "path";
@@ -2123,9 +2129,9 @@ function createCleanupSessionsCommand() {
 import { Command as Command20 } from "commander";
 
 // src/commands/compound/scan-candidates.ts
-init_dist();
+init_dist2();
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname2, join as join6, resolve as resolve11 } from "path";
+import { dirname as dirname2, join as join7, resolve as resolve11 } from "path";
 import { Command as Command19 } from "commander";
 var HOTSPOT_THRESHOLD = 7;
 var DEFAULT_LOOKBACK = "7d";
@@ -2152,7 +2158,7 @@ async function runCompoundScanCandidatesCommand(opts) {
     isoWeek: week,
     lookback
   });
-  const outputPath = opts.outputPath ?? join6(cwd, "docs/solutions/.candidates", `${formatIsoWeek(week)}.md`);
+  const outputPath = opts.outputPath ?? join7(cwd, "docs/solutions/.candidates", `${formatIsoWeek(week)}.md`);
   mkdirSync3(dirname2(outputPath), { recursive: true });
   writeFileSync3(outputPath, report);
   const candidatesFound = undocumented.length + hotspots.length;
@@ -2216,7 +2222,7 @@ import { Command as Command21 } from "commander";
 import { spawn } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { createRequire } from "module";
-import { dirname as dirname3, join as join7, resolve as resolve12 } from "path";
+import { dirname as dirname3, join as join8, resolve as resolve12 } from "path";
 import { setTimeout } from "timers";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
@@ -2232,20 +2238,20 @@ function resolveServerScript() {
   try {
     const pkgPath = require2.resolve("@harness-engineering/dashboard/package.json");
     const pkgDir = dirname3(pkgPath);
-    const built2 = join7(pkgDir, "dist", "server", "serve.js");
+    const built2 = join8(pkgDir, "dist", "server", "serve.js");
     if (existsSync4(built2)) return { script: built2, dev: false };
-    const dev2 = join7(pkgDir, "src", "server", "serve.ts");
+    const dev2 = join8(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")
+    join8(__dirname, "..", "..", "..", "dashboard", "dist", "server", "serve.js"),
+    join8(__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")
+    join8(__dirname, "..", "..", "..", "dashboard", "src", "server", "serve.ts"),
+    join8(__dirname, "..", "..", "..", "..", "packages", "dashboard", "src", "server", "serve.ts")
   ].find((p) => existsSync4(p));
   return dev ? { script: dev, dev: true } : null;
 }
@@ -2659,7 +2665,7 @@ function createDoctorCommand() {
 }
 
 // src/commands/fix-drift.ts
-init_dist();
+init_dist2();
 import { Command as Command23 } from "commander";
 import * as path14 from "path";
 async function runFixDrift(options) {
@@ -2675,7 +2681,7 @@ async function runFixDrift(options) {
   const entropyConfig = {
     rootDir,
     ...config.entropy?.entryPoints && { entryPoints: config.entropy.entryPoints },
-    docPaths: [docsDir],
+    docPaths: [path14.join(docsDir, "**/*.md")],
     analyze: {
       drift: true,
       deadCode: true,
@@ -2907,7 +2913,7 @@ async function readConnectorSyncStatus(graphDir) {
   return result;
 }
 async function runGraphStatus(projectPath) {
-  const { GraphStore, loadGraphMetadata } = await import("./dist-D27LJR2T.js");
+  const { GraphStore, loadGraphMetadata } = await import("./dist-SQAOKWXM.js");
   const graphDir = path15.join(projectPath, ".harness", "graph");
   const metaResult = await loadGraphMetadata(graphDir);
   if (metaResult.status === "not_found") {
@@ -2959,7 +2965,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-D27LJR2T.js");
+  const { GraphStore } = await import("./dist-SQAOKWXM.js");
   const graphDir = path16.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
@@ -2995,7 +3001,7 @@ import * as path19 from "path";
 import { Command as Command25 } from "commander";
 import * as path17 from "path";
 async function runQuery(projectPath, rootNodeId, opts) {
-  const { GraphStore, ContextQL } = await import("./dist-D27LJR2T.js");
+  const { GraphStore, ContextQL } = await import("./dist-SQAOKWXM.js");
   const store = new GraphStore();
   const graphDir = path17.join(projectPath, ".harness", "graph");
   const loaded = await store.load(graphDir);
@@ -3092,7 +3098,7 @@ async function runIngest(projectPath, source, opts) {
     ConfluenceConnector,
     FigmaConnector,
     MiroConnector
-  } = await import("./dist-D27LJR2T.js");
+  } = await import("./dist-SQAOKWXM.js");
   const graphDir = path18.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   await store.load(graphDir);
@@ -3106,7 +3112,7 @@ async function runIngest(projectPath, source, opts) {
       path18.join(projectPath, "docs", "changes")
     );
     const gitResult = await new GitIngestor(store).ingest(projectPath);
-    const { createExtractionRunner } = await import("./dist-D27LJR2T.js");
+    const { createExtractionRunner } = await import("./dist-SQAOKWXM.js");
     const extractedDir = path18.join(projectPath, ".harness", "knowledge", "extracted");
     const signalsResult = await createExtractionRunner().run(projectPath, store, extractedDir);
     const syncManager = new SyncManager(store, graphDir);
@@ -3152,7 +3158,7 @@ async function runIngest(projectPath, source, opts) {
       );
       break;
     case "business-signals": {
-      const { createExtractionRunner } = await import("./dist-D27LJR2T.js");
+      const { createExtractionRunner } = await import("./dist-SQAOKWXM.js");
       const extractedDir = path18.join(projectPath, ".harness", "knowledge", "extracted");
       result = await createExtractionRunner().run(projectPath, store, extractedDir);
       break;
@@ -3846,7 +3852,7 @@ function createImpactPreviewCommand() {
 }
 
 // src/commands/init.ts
-init_dist();
+init_dist2();
 import { Command as Command35 } from "commander";
 import chalk3 from "chalk";
 import * as fs15 from "fs";
@@ -4660,6 +4666,7 @@ function getBundledSkillNames(bundledSkillsDir) {
 }
 
 // src/commands/install.ts
+init_dist();
 function validateSkillYaml(parsed) {
   const result = SkillMetadataSchema.safeParse(parsed);
   if (!result.success) {
@@ -4726,7 +4733,7 @@ function discoverSkillDirs(rootDir) {
     const entries = fs20.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
-      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      if (entry.name.startsWith(".") || DEFAULT_SKIP_DIRS.has(entry.name)) continue;
       scan(path32.join(dir, entry.name), depth + 1);
     }
   }
@@ -4945,7 +4952,7 @@ function createInstallCommand() {
 }
 
 // src/commands/install-constraints.ts
-init_dist();
+init_dist2();
 import * as fs21 from "fs/promises";
 import * as path33 from "path";
 import { Command as Command37 } from "commander";
@@ -5211,7 +5218,7 @@ function createInstallConstraintsCommand() {
 import { Command as Command42 } from "commander";
 
 // src/commands/integrations/add.ts
-init_dist();
+init_dist2();
 import { Command as Command38 } from "commander";
 import * as fs22 from "fs";
 import * as path34 from "path";
@@ -5351,7 +5358,7 @@ function createListIntegrationsCommand() {
 }
 
 // src/commands/integrations/remove.ts
-init_dist();
+init_dist2();
 import { Command as Command40 } from "commander";
 import * as fs23 from "fs";
 import * as path36 from "path";
@@ -5400,7 +5407,7 @@ function createRemoveIntegrationCommand() {
 }
 
 // src/commands/integrations/dismiss.ts
-init_dist();
+init_dist2();
 import { Command as Command41 } from "commander";
 import * as path37 from "path";
 function dismissIntegration(cwd, name) {
@@ -5469,7 +5476,7 @@ function createKnowledgePipelineCommand() {
       const graphDir = path38.join(projectDir, ".harness", "graph");
       const fs44 = await import("fs/promises");
       await fs44.mkdir(graphDir, { recursive: true });
-      const { GraphStore, KnowledgePipelineRunner } = await import("./dist-D27LJR2T.js");
+      const { GraphStore, KnowledgePipelineRunner } = await import("./dist-SQAOKWXM.js");
       const store = new GraphStore();
       try {
         await store.load(graphDir);
@@ -5629,7 +5636,7 @@ function createKnowledgePipelineCommand() {
 import { Command as Command45 } from "commander";
 
 // src/commands/learnings/prune.ts
-init_dist();
+init_dist2();
 import { Command as Command44 } from "commander";
 import * as path39 from "path";
 async function handlePrune(opts) {
@@ -5811,7 +5818,7 @@ function createMcpCommand() {
     parseBudget
   ).action(async (opts) => {
     const [{ startServer: startServer2, getToolDefinitions: getToolDefinitions2 }, { selectTier }] = await Promise.all([
-      import("./mcp-YW7PLXVQ.js"),
+      import("./mcp-UUNLS3MC.js"),
       import("./tool-tiers-7QGZ3FKY.js")
     ]);
     if (opts.tools && opts.tools.length > 0) {
@@ -5832,6 +5839,7 @@ function createMcpCommand() {
 }
 
 // src/commands/migrate.ts
+init_dist2();
 init_dist();
 import { Command as Command50 } from "commander";
 import * as fs24 from "fs";
@@ -5866,7 +5874,7 @@ function walk(dir, predicate) {
   if (!fs24.existsSync(dir)) return [];
   const out = [];
   for (const entry of fs24.readdirSync(dir, { withFileTypes: true })) {
-    if (entry.name === "node_modules" || entry.name === ".git" || entry.name === "dist") continue;
+    if (DEFAULT_SKIP_DIRS.has(entry.name)) continue;
     const full = path40.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...walk(full, predicate));
     else if (predicate(full)) out.push(full);
@@ -6299,14 +6307,14 @@ function createOrchestratorCommand() {
 }
 
 // src/commands/perf.ts
-init_dist();
+init_dist2();
 import { Command as Command52 } from "commander";
 import * as path42 from "path";
 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-I4LWG3IN.js");
+    const { BenchmarkRunner } = await import("./dist-ZJGFXGIB.js");
     const runner = new BenchmarkRunner();
     const benchFiles = runner.discover(cwd, glob2);
     if (benchFiles.length === 0) {
@@ -6370,7 +6378,7 @@ async function runBaselinesShow(globalOpts) {
 }
 async function runBaselinesUpdate(globalOpts) {
   const cwd = process.cwd();
-  const { BenchmarkRunner } = await import("./dist-I4LWG3IN.js");
+  const { BenchmarkRunner } = await import("./dist-ZJGFXGIB.js");
   const runner = new BenchmarkRunner();
   const manager = new BaselineManager(cwd);
   logger.info("Running benchmarks to update baselines...");
@@ -6401,8 +6409,8 @@ function registerBaselinesCommands(perf) {
 }
 async function getCommitHash2(cwd) {
   try {
-    const { execSync: execSync6 } = await import("child_process");
-    return execSync6("git rev-parse --short HEAD", { cwd, encoding: "utf-8" }).trim();
+    const { execSync: execSync7 } = await import("child_process");
+    return execSync7("git rev-parse --short HEAD", { cwd, encoding: "utf-8" }).trim();
   } catch {
     return "unknown";
   }
@@ -6411,7 +6419,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-I4LWG3IN.js");
+    const { EntropyAnalyzer: EntropyAnalyzer2 } = await import("./dist-ZJGFXGIB.js");
     const analyzer = new EntropyAnalyzer2({
       rootDir: path42.resolve(cwd),
       analyze: { complexity: true, coupling: true }
@@ -6582,7 +6590,7 @@ function createPersonaCommand() {
 }
 
 // src/commands/predict.ts
-init_dist();
+init_dist2();
 import { Command as Command56 } from "commander";
 import chalk8 from "chalk";
 var CATEGORY_ORDER = [
@@ -6715,7 +6723,7 @@ function createPredictCommand() {
 import * as fs26 from "fs";
 import * as path44 from "path";
 import { Command as Command57 } from "commander";
-init_dist();
+init_dist2();
 import {
   renderAnalysisComment,
   loadPublishedIndex,
@@ -6776,7 +6784,7 @@ async function buildNameToExternalIdMap(projectPath) {
     logger.error("No docs/roadmap.md found. Cannot map issue hashes to external IDs.");
     return null;
   }
-  const { parseRoadmap: parseRoadmap2 } = (init_dist(), __toCommonJS(dist_exports));
+  const { parseRoadmap: parseRoadmap2 } = (init_dist2(), __toCommonJS(dist_exports));
   const roadmapParsed = parseRoadmap2(fs26.readFileSync(roadmapFile, "utf-8"));
   if (!roadmapParsed.ok) {
     logger.error("Failed to parse docs/roadmap.md");
@@ -6827,7 +6835,7 @@ async function runPublishAnalyses(opts) {
   const nameToExternalId = await buildNameToExternalIdMap(projectPath);
   if (!nameToExternalId) return process.exit(1);
   const { AnalysisArchive } = await import("@harness-engineering/orchestrator");
-  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-I4LWG3IN.js");
+  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-ZJGFXGIB.js");
   const archive = new AnalysisArchive(path44.join(projectPath, ".harness", "analyses"));
   const analyses = await archive.list();
   if (analyses.length === 0) {
@@ -6869,9 +6877,9 @@ function createPublishAnalysesCommand() {
 import { Command as Command59 } from "commander";
 
 // src/commands/pulse/run.ts
-init_dist();
+init_dist2();
 import { readFileSync as readFileSync15, mkdirSync as mkdirSync13, writeFileSync as writeFileSync14 } from "fs";
-import { dirname as dirname17, join as join33, resolve as resolve28 } from "path";
+import { dirname as dirname17, join as join35, resolve as resolve28 } from "path";
 import { Command as Command58 } from "commander";
 async function runPulseRunCommand(opts) {
   const startedAt = Date.now();
@@ -6903,7 +6911,7 @@ async function runPulseRunCommand(opts) {
   const report = assembleReport(result, productName, lookback);
   const now = /* @__PURE__ */ new Date();
   const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}_${String(now.getHours()).padStart(2, "0")}-${String(now.getMinutes()).padStart(2, "0")}`;
-  const filePath = join33(opts.outputDir, `${ts}.md`);
+  const filePath = join35(opts.outputDir, `${ts}.md`);
   mkdirSync13(dirname17(filePath), { recursive: true });
   writeFileSync14(filePath, report);
   const headlines = extractHeadlines(report);
@@ -7070,7 +7078,7 @@ function createRecommendCommand() {
 import { Command as Command62 } from "commander";
 
 // src/commands/roadmap/migrate.ts
-init_dist();
+init_dist2();
 import { Command as Command61 } from "commander";
 import * as fs28 from "fs";
 import * as path46 from "path";
@@ -7382,10 +7390,10 @@ function createRoadmapCommand() {
 }
 
 // src/commands/scan-config.ts
-init_dist();
+init_dist2();
 import { Command as Command63 } from "commander";
 import { existsSync as existsSync25, readFileSync as readFileSync18, writeFileSync as writeFileSync17 } from "fs";
-import { join as join36, relative as relative3 } from "path";
+import { join as join38, relative as relative3 } from "path";
 var CONFIG_FILES = ["CLAUDE.md", "AGENTS.md", ".gemini/settings.json", "skill.yaml"];
 function stripHighSeverityPatterns(content, injectionFindings) {
   const highLines = /* @__PURE__ */ new Set();
@@ -7442,7 +7450,7 @@ async function runScanConfig(targetDir, options) {
   const scanner = new SecurityScanner(parseSecurityConfig({}));
   const results = [];
   for (const configFile of CONFIG_FILES) {
-    const result = scanSingleFile(join36(targetDir, configFile), targetDir, scanner, options);
+    const result = scanSingleFile(join38(targetDir, configFile), targetDir, scanner, options);
     if (result) results.push(result);
   }
   return { exitCode: computeScanExitCode(results), results };
@@ -7795,7 +7803,7 @@ async function detectLegacyLayout(cwd) {
 }
 async function runInitialGraphScan(cwd) {
   try {
-    const { runScan: runScan2 } = await import("./scan-BIJYHOE7.js");
+    const { runScan: runScan2 } = await import("./scan-SFX5U3TE.js");
     const result = await runScan2(cwd);
     return {
       status: "pass",
@@ -7856,7 +7864,7 @@ function createSetupCommand() {
 }
 
 // src/commands/share.ts
-init_dist();
+init_dist2();
 import { Command as Command65 } from "commander";
 import * as fs32 from "fs";
 import * as path50 from "path";
@@ -8816,7 +8824,7 @@ function createSkillCommand() {
 }
 
 // src/commands/snapshot.ts
-init_dist();
+init_dist2();
 import { Command as Command74 } from "commander";
 import { execSync as execSync5 } from "child_process";
 import chalk13 from "chalk";
@@ -9010,7 +9018,7 @@ function createSnapshotCommand() {
 import { Command as Command79 } from "commander";
 
 // src/commands/state/show.ts
-init_dist();
+init_dist2();
 import { Command as Command75 } from "commander";
 import * as path58 from "path";
 function printStateText(state, stream) {
@@ -9053,7 +9061,7 @@ function createShowCommand() {
 }
 
 // src/commands/state/reset.ts
-init_dist();
+init_dist2();
 import { Command as Command76 } from "commander";
 import * as fs40 from "fs";
 import * as path59 from "path";
@@ -9102,7 +9110,7 @@ function createResetCommand() {
 }
 
 // src/commands/state/learn.ts
-init_dist();
+init_dist2();
 import { Command as Command77 } from "commander";
 import * as path60 from "path";
 function createLearnCommand() {
@@ -9120,7 +9128,7 @@ function createLearnCommand() {
 }
 
 // src/commands/state/streams.ts
-init_dist();
+init_dist2();
 import { Command as Command78 } from "commander";
 import * as path61 from "path";
 async function runListStreams(opts, globalOpts) {
@@ -9194,7 +9202,7 @@ function createStateCommand() {
 import * as fs41 from "fs";
 import * as path62 from "path";
 import { Command as Command80 } from "commander";
-init_dist();
+init_dist2();
 function isValidRecord(record) {
   return typeof record.issueId === "string" && !!record.issueId && typeof record.identifier === "string" && !!record.identifier && typeof record.analyzedAt === "string" && !/[/\\]/.test(record.issueId);
 }
@@ -9267,7 +9275,7 @@ async function loadRoadmapFeatures(projectPath) {
     logger.error("No docs/roadmap.md found. Cannot discover features with externalIds.");
     return null;
   }
-  const { parseRoadmap: parseRoadmap2 } = (init_dist(), __toCommonJS(dist_exports));
+  const { parseRoadmap: parseRoadmap2 } = (init_dist2(), __toCommonJS(dist_exports));
   const roadmapParsed = parseRoadmap2(fs41.readFileSync(roadmapFile, "utf-8"));
   if (!roadmapParsed.ok) {
     logger.error("Failed to parse docs/roadmap.md");
@@ -9319,7 +9327,7 @@ async function runSyncAnalyses(opts) {
     return;
   }
   const { AnalysisArchive, loadPublishedIndex: loadPublishedIndex2, savePublishedIndex: savePublishedIndex2 } = await import("@harness-engineering/orchestrator");
-  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-I4LWG3IN.js");
+  const { GitHubIssuesSyncAdapter: GitHubIssuesSyncAdapter2 } = await import("./dist-ZJGFXGIB.js");
   const adapter = new GitHubIssuesSyncAdapter2({ token, config: trackerConfig });
   const archive = new AnalysisArchive(path62.join(projectPath, ".harness", "analyses"));
   const publishedIndex = loadPublishedIndex2(projectPath);
@@ -9394,7 +9402,7 @@ function createSyncMainCommand() {
 }
 
 // src/commands/taint.ts
-init_dist();
+init_dist2();
 import { Command as Command82 } from "commander";
 function getProjectRoot() {
   return process.cwd();
@@ -9477,7 +9485,7 @@ function createTaintCommand() {
 import { Command as Command86 } from "commander";
 
 // src/commands/telemetry/identify.ts
-init_dist();
+init_dist2();
 import { Command as Command83 } from "commander";
 import * as fs42 from "fs";
 import * as path64 from "path";
@@ -9526,7 +9534,7 @@ function createIdentifyCommand() {
 }
 
 // src/commands/telemetry/status.ts
-init_dist();
+init_dist2();
 import { Command as Command84 } from "commander";
 function gatherEnvOverrides() {
   const overrides = {};
@@ -9601,12 +9609,12 @@ function createStatusCommand() {
 }
 
 // src/commands/telemetry/test.ts
-init_dist();
+init_dist2();
 import { Command as Command85 } from "commander";
 
 // src/bin/command-telemetry.ts
 import { existsSync as existsSync39, readFileSync as readFileSync29, mkdirSync as mkdirSync19, appendFileSync, writeFileSync as writeFileSync23 } from "fs";
-import { join as join51, parse as parsePath, resolve as resolve37 } from "path";
+import { join as join53, parse as parsePath, resolve as resolve37 } from "path";
 import { spawn as spawn2 } from "child_process";
 var POSTHOG_API_KEY = "phc_wNTdCMcfJXZPgdNeDociZW6vwoGGo4nb7vqEfWThFfsG";
 var EXCLUDED_COMMANDS = /* @__PURE__ */ new Set(["help", "completion"]);
@@ -9614,7 +9622,7 @@ function findProjectRoot(cwd) {
   let dir = resolve37(cwd);
   const { root } = parsePath(dir);
   while (dir !== root) {
-    if (existsSync39(join51(dir, "harness.config.json"))) return dir;
+    if (existsSync39(join53(dir, "harness.config.json"))) return dir;
     dir = resolve37(dir, "..");
   }
   return cwd;
@@ -9652,7 +9660,7 @@ function resolveCommandName(cmd) {
 }
 function writeCommandRecordSync(cwd, command, duration, outcome) {
   try {
-    const metricsDir = join51(cwd, ".harness", "metrics");
+    const metricsDir = join53(cwd, ".harness", "metrics");
     mkdirSync19(metricsDir, { recursive: true });
     const record = {
       skill: command,
@@ -9662,13 +9670,13 @@ function writeCommandRecordSync(cwd, command, duration, outcome) {
       outcome,
       phasesReached: []
     };
-    const adoptionFile = join51(metricsDir, "adoption.jsonl");
+    const adoptionFile = join53(metricsDir, "adoption.jsonl");
     appendFileSync(adoptionFile, JSON.stringify(record) + "\n");
   } catch {
   }
 }
 function isTelemetryDisabledByConfig(cwd) {
-  const configPath = join51(cwd, "harness.config.json");
+  const configPath = join53(cwd, "harness.config.json");
   if (!existsSync39(configPath)) return false;
   try {
     const config = JSON.parse(readFileSync29(configPath, "utf-8"));
@@ -9683,10 +9691,10 @@ function isTelemetryOptedOut(cwd) {
 }
 function flushTelemetryBackground(cwd) {
   try {
-    const adoptionFile = join51(cwd, ".harness", "metrics", "adoption.jsonl");
+    const adoptionFile = join53(cwd, ".harness", "metrics", "adoption.jsonl");
     if (!existsSync39(adoptionFile)) return;
     if (isTelemetryOptedOut(cwd)) return;
-    const reporterPath = join51(cwd, ".harness", "hooks", "telemetry-reporter.js");
+    const reporterPath = join53(cwd, ".harness", "hooks", "telemetry-reporter.js");
     if (!existsSync39(reporterPath)) return;
     const child = spawn2(process.execPath, [reporterPath], {
       cwd,
@@ -9890,7 +9898,7 @@ async function runTraceability(options) {
   const projectPath = process.cwd();
   const store = await loadGraphStore(projectPath);
   if (!store) handleNoStore(mode);
-  const graphModule = await import("./dist-D27LJR2T.js");
+  const graphModule = await import("./dist-SQAOKWXM.js");
   const filterOptions = buildFilterOptions(options);
   const results = graphModule.queryTraceability(store, filterOptions);
   if (results.length === 0) handleEmptyResults(mode);
@@ -9975,7 +9983,7 @@ function createUninstallCommand() {
 }
 
 // src/commands/uninstall-constraints.ts
-init_dist();
+init_dist2();
 import * as fs43 from "fs/promises";
 import * as path66 from "path";
 import { Command as Command89 } from "commander";
@@ -10077,10 +10085,11 @@ function createUninstallConstraintsCommand() {
 import { Command as Command90 } from "commander";
 import { execFile, execFileSync as execFileSync7 } from "child_process";
 import { realpathSync, existsSync as existsSync40, readFileSync as readFileSync30 } from "fs";
-import { join as join54 } from "path";
+import { join as join56 } from "path";
 import { promisify } from "util";
 import readline4 from "readline";
 import chalk15 from "chalk";
+var CLI_PACKAGE = "@harness-engineering/cli";
 function detectPackageManager() {
   try {
     const argv1 = process.argv[1];
@@ -10123,6 +10132,9 @@ function getInstalledVersions(pm, packages) {
       versions[pkg] = null;
     }
   }
+  if (packages.includes(CLI_PACKAGE) && versions[CLI_PACKAGE] === null) {
+    versions[CLI_PACKAGE] = CLI_VERSION;
+  }
   return versions;
 }
 function getInstalledPackages(pm) {
@@ -10133,9 +10145,13 @@ function getInstalledPackages(pm) {
     });
     const data = JSON.parse(output);
     const deps = data.dependencies ?? {};
-    return Object.keys(deps).filter((name) => name.startsWith("@harness-engineering/"));
+    const found = Object.keys(deps).filter((name) => name.startsWith("@harness-engineering/"));
+    if (!found.includes(CLI_PACKAGE)) {
+      found.unshift(CLI_PACKAGE);
+    }
+    return found;
   } catch {
-    return ["@harness-engineering/cli", "@harness-engineering/core"];
+    return [CLI_PACKAGE, "@harness-engineering/core"];
   }
 }
 function prompt3(question) {
@@ -10161,10 +10177,10 @@ async function ensureTelemetryIfNeeded() {
 }
 function refreshHooks() {
   const cwd = process.cwd();
-  const configPath = join54(cwd, "harness.config.json");
+  const configPath = join56(cwd, "harness.config.json");
   if (!existsSync40(configPath)) return;
   let profile = "standard";
-  const profilePath = join54(cwd, ".harness", "hooks", "profile.json");
+  const profilePath = join56(cwd, ".harness", "hooks", "profile.json");
   try {
     const data = JSON.parse(readFileSync30(profilePath, "utf-8"));
     if (data.profile && ["minimal", "standard", "strict"].includes(data.profile)) {
@@ -10304,7 +10320,7 @@ function createUpdateCommand() {
 // src/commands/usage.ts
 import { Command as Command91 } from "commander";
 async function loadAndPriceRecords(cwd, includeClaudeSessions = false) {
-  const { readCostRecords, loadPricingData, calculateCost, parseCCRecords } = await import("./dist-I4LWG3IN.js");
+  const { readCostRecords, loadPricingData, calculateCost, parseCCRecords } = await import("./dist-ZJGFXGIB.js");
   const records = readCostRecords(cwd);
   if (includeClaudeSessions) {
     const ccRecords = parseCCRecords();
@@ -10397,7 +10413,7 @@ function registerDailyCommand(usage) {
       else logger.info("No usage data found. Run some harness sessions first.");
       return;
     }
-    const { aggregateByDay } = await import("./dist-I4LWG3IN.js");
+    const { aggregateByDay } = await import("./dist-ZJGFXGIB.js");
     const limited = aggregateByDay(records).slice(0, days);
     if (globalOpts.json) {
       console.log(
@@ -10426,7 +10442,7 @@ function registerSessionsCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-I4LWG3IN.js");
+    const { aggregateBySession } = await import("./dist-ZJGFXGIB.js");
     const sessionData = aggregateBySession(records);
     const limited = sessionData.slice(0, limit);
     if (globalOpts.json) {
@@ -10506,7 +10522,7 @@ function registerSessionCommand(usage) {
       cwd,
       globalOpts.includeClaudeSessions
     );
-    const { aggregateBySession } = await import("./dist-I4LWG3IN.js");
+    const { aggregateBySession } = await import("./dist-ZJGFXGIB.js");
     const sessionData = aggregateBySession(records);
     const match = sessionData.find((s) => s.sessionId === id);
     if (!match) {
@@ -10541,7 +10557,7 @@ function registerLatestCommand(usage) {
       }
       return;
     }
-    const { aggregateBySession } = await import("./dist-I4LWG3IN.js");
+    const { aggregateBySession } = await import("./dist-ZJGFXGIB.js");
     const sessionData = aggregateBySession(records);
     const latest = sessionData[0];
     if (!latest) {
@@ -10580,8 +10596,8 @@ function createUsageCommand() {
 }
 
 // src/commands/validate.ts
-init_dist();
-init_dist();
+init_dist2();
+init_dist2();
 import { Command as Command92 } from "commander";
 import * as path67 from "path";
 async function runValidate(options) {
@@ -10710,7 +10726,7 @@ function resolveValidateMode(globalOpts) {
   return OutputMode.TEXT;
 }
 async function printCrossCheckWarnings(mode) {
-  const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-XRSSAXJP.js");
+  const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-5YEWZ3EW.js");
   const cwd = process.cwd();
   const crossResult = await runCrossCheck2({
     specsDir: path67.join(cwd, "docs", "specs"),
@@ -10773,6 +10789,86 @@ Agent configs checked via ${engineLabel}${note}`);
   }
 }
 
+// src/commands/verify.ts
+init_dist2();
+import { Command as Command93 } from "commander";
+import { execSync as execSync6 } from "child_process";
+function loadBranchingConfig(configPath) {
+  const shouldLoad = configPath !== void 0 || findConfigFile().ok;
+  if (!shouldLoad) {
+    return BranchingConfigSchema.parse({});
+  }
+  const result = resolveConfig(configPath);
+  if (!result.ok) {
+    logger.error(result.error.message);
+    process.exit(result.error.exitCode);
+  }
+  const cfg = result.value.compliance?.branching;
+  return cfg ?? BranchingConfigSchema.parse({});
+}
+function resolveBranchName(explicit) {
+  if (explicit && explicit.length > 0) return explicit;
+  const envBranch = process.env.HARNESS_BRANCH || process.env.GITHUB_HEAD_REF || process.env.CI_COMMIT_REF_NAME || process.env.BUILDKITE_BRANCH;
+  if (envBranch && envBranch.length > 0) return envBranch;
+  try {
+    const out = execSync6("git rev-parse --abbrev-ref HEAD", {
+      stdio: ["ignore", "pipe", "ignore"]
+    }).toString().trim();
+    if (out && out !== "HEAD") return out;
+  } catch {
+    return null;
+  }
+  return null;
+}
+async function runVerify(options) {
+  const branchingConfig = loadBranchingConfig(options.configPath);
+  const branchName = resolveBranchName(options.branch);
+  if (!branchName) {
+    const msg = "Could not determine the current branch name. Pass --branch <name>, set HARNESS_BRANCH/GITHUB_HEAD_REF, or run inside a git checkout.";
+    if (options.json) {
+      console.log(JSON.stringify({ valid: false, branchName: "", message: msg }));
+    } else {
+      logger.error(msg);
+    }
+    process.exit(ExitCode.ERROR);
+  }
+  const result = validateBranchName(branchName, branchingConfig);
+  if (options.json) {
+    const payload = {
+      valid: result.valid,
+      branchName: result.branchName,
+      ...result.message !== void 0 && { message: result.message },
+      ...result.suggestion !== void 0 && { suggestion: result.suggestion }
+    };
+    console.log(JSON.stringify(payload));
+    process.exit(result.valid ? ExitCode.SUCCESS : ExitCode.VALIDATION_FAILED);
+  }
+  if (result.valid) {
+    logger.success(`Branch name "${branchName}" is compliant.`);
+    process.exit(ExitCode.SUCCESS);
+  }
+  logger.error(result.message || `Branch name "${branchName}" is not compliant.`);
+  if (result.suggestion) {
+    logger.info(`Suggestion: ${result.suggestion}`);
+  }
+  process.exit(ExitCode.VALIDATION_FAILED);
+}
+function createVerifyCommand() {
+  return new Command93("verify").description(
+    "Verify project conventions (currently: branch naming). Works with or without a harness.config.json."
+  ).option(
+    "--branch <name>",
+    "Branch name to verify (defaults to HARNESS_BRANCH/GITHUB_HEAD_REF/current branch)"
+  ).option("--json", "Emit machine-readable JSON output").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    await runVerify({
+      ...typeof globalOpts.config === "string" && { configPath: globalOpts.config },
+      ...typeof opts.branch === "string" && { branch: opts.branch },
+      json: opts.json === true || globalOpts.json === true
+    });
+  });
+}
+
 // src/commands/_registry.ts
 var commandCreators = [
   createAddCommand,
@@ -10837,12 +10933,13 @@ var commandCreators = [
   createUninstallConstraintsCommand,
   createUpdateCommand,
   createUsageCommand,
-  createValidateCommand3
+  createValidateCommand3,
+  createVerifyCommand
 ];
 
 // src/index.ts
 function createProgram() {
-  const program = new Command93();
+  const program = new Command94();
   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());