@harness-engineering/cli 1.13.0 → 1.13.1

package/dist/{chunk-WPPDRIJL.js → chunk-QY4T6YAZ.js}

@@ -38,7 +38,7 @@ async function handleCheckDependencies(input) {
   const configResult = resolveProjectConfig(projectPath);
   if (!configResult.ok) return resultToMcpResponse(configResult);
   try {
-    const { validateDependencies, TypeScriptParser } = await import("./dist-WF4C7A4A.js");
+    const { validateDependencies, TypeScriptParser } = await import("./dist-2B363XUH.js");
     const config = configResult.value;
     const rawLayers = Array.isArray(config.layers) ? config.layers : [];
     const layers = rawLayers.map((l) => ({
@@ -47,11 +47,11 @@ async function handleCheckDependencies(input) {
       allowedDependencies: l.allowedDependencies
     }));
     const parser = new TypeScriptParser();
-    const { loadGraphStore } = await import("./graph-loader-KO4GJ5N2.js");
+    const { loadGraphStore } = await import("./graph-loader-GJZ4FN4Y.js");
     const store = await loadGraphStore(projectPath);
     let graphDependencyData;
     if (store) {
-      const { GraphConstraintAdapter } = await import("./dist-M6BQODWC.js");
+      const { GraphConstraintAdapter } = await import("./dist-HXHWB7SV.js");
       const adapter = new GraphConstraintAdapter(store);
       const graphData = adapter.computeDependencyGraph();
       graphDependencyData = {

package/dist/{chunk-RZSUJBZZ.js → chunk-SSKDAOX5.js}

@@ -5,14 +5,12 @@ import {
   OutputFormatter,
   OutputMode,
   createCheckPhaseGateCommand,
-  findConfigFile,
-  findFiles,
-  resolveConfig
-} from "./chunk-3KOLLWWE.js";
+  findFiles
+} from "./chunk-UAX4I5ZE.js";
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
-} from "./chunk-GNGELAXY.js";
+} from "./chunk-TS3XWPW5.js";
 import {
   listPersonas,
   loadPersona
@@ -22,13 +20,13 @@ import {
 } from "./chunk-TRAPF4IX.js";
 import {
   executeSkill
-} from "./chunk-L2KLU56K.js";
+} from "./chunk-AOZRDOIP.js";
 import {
   ALLOWED_PERSONA_COMMANDS
 } from "./chunk-TEFCFC4H.js";
 import {
   createCreateSkillCommand
-} from "./chunk-6N4R6FVX.js";
+} from "./chunk-YBJ262QL.js";
 import {
   logger
 } from "./chunk-EBJQ6N4M.js";
@@ -50,17 +48,21 @@ import {
   generateSlashCommands,
   handleGetImpact,
   handleOrphanDeletion
-} from "./chunk-7KQSUZVG.js";
+} from "./chunk-NERR4TAO.js";
 import {
   VALID_PLATFORMS
 } from "./chunk-ZOAWBDWU.js";
+import {
+  findConfigFile,
+  resolveConfig
+} from "./chunk-Z77YQRQT.js";
 import {
   resolveGlobalSkillsDir,
   resolvePersonasDir,
   resolveProjectSkillsDir,
   resolveSkillsDir,
   resolveTemplatesDir
-} from "./chunk-HD4IBGLA.js";
+} from "./chunk-N5G5QMS3.js";
 import {
   CLIError,
   ExitCode,
@@ -68,7 +70,7 @@ import {
 } from "./chunk-3WGJMBKH.js";
 import {
   SkillMetadataSchema
-} from "./chunk-VRFZWGMS.js";
+} from "./chunk-XYLGHKG6.js";
 import {
   CLI_VERSION
 } from "./chunk-BM3PWGXQ.js";
@@ -123,7 +125,7 @@ import {
   validateKnowledgeMap,
   writeConfig,
   writeLockfile
-} from "./chunk-KELT6K6M.js";
+} from "./chunk-PQ5YK4AY.js";
 import {
   Err,
   Ok
@@ -209,7 +211,7 @@ function createValidateCommand() {
       process.exit(result.error.exitCode);
     }
     if (opts.crossCheck) {
-      const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-EDQ5QGTM.js");
+      const { runCrossCheck: runCrossCheck2 } = await import("./validate-cross-check-STFHYMAZ.js");
       const cwd = process.cwd();
       const specsDir = path.join(cwd, "docs", "specs");
       const plansDir = path.join(cwd, "docs", "plans");
@@ -567,7 +569,7 @@ function createPerfCommand() {
   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-WF4C7A4A.js");
+    const { BenchmarkRunner } = await import("./dist-2B363XUH.js");
     const runner = new BenchmarkRunner();
     const benchFiles = runner.discover(cwd, glob);
     if (benchFiles.length === 0) {
@@ -636,7 +638,7 @@ Results (${result.results.length} benchmarks):`);
   baselines.command("update").description("Update baselines from latest benchmark run").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
-    const { BenchmarkRunner } = await import("./dist-WF4C7A4A.js");
+    const { BenchmarkRunner } = await import("./dist-2B363XUH.js");
     const runner = new BenchmarkRunner();
     const manager = new BaselineManager(cwd);
     logger.info("Running benchmarks to update baselines...");
@@ -664,7 +666,7 @@ Results (${result.results.length} benchmarks):`);
   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-WF4C7A4A.js");
+    const { EntropyAnalyzer: EntropyAnalyzer2 } = await import("./dist-2B363XUH.js");
     const analyzer = new EntropyAnalyzer2({
       rootDir: path5.resolve(cwd),
       analyze: { complexity: true, coupling: true }
@@ -1607,7 +1609,8 @@ async function runAdd(componentType, name, options) {
         break;
       }
       case "doc": {
-        const docsDir = path12.join(cwd, "docs");
+        const configDocsDir = configResult.ok ? configResult.value.docsDir : "./docs";
+        const docsDir = path12.resolve(cwd, configDocsDir);
         if (!fs3.existsSync(docsDir)) {
           fs3.mkdirSync(docsDir, { recursive: true });
         }
@@ -1616,11 +1619,11 @@ async function runAdd(componentType, name, options) {
           return Err(new CLIError(`Doc ${name} already exists`, ExitCode.ERROR));
         }
         fs3.writeFileSync(docPath, DOC_TEMPLATE(name));
-        created.push(`docs/${name}.md`);
+        created.push(`${configDocsDir.replace(/^\.[\\/]/, "")}/${name}.md`);
         break;
       }
       case "skill": {
-        const { generateSkillFiles: generateSkillFiles2 } = await import("./create-skill-WPXHSLX2.js");
+        const { generateSkillFiles: generateSkillFiles2 } = await import("./create-skill-XSWHMSM5.js");
         generateSkillFiles2({
           name,
           description: `${name} skill`,
@@ -3028,8 +3031,8 @@ function createResetCommand() {
     }
     if (!opts.yes) {
       const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      const answer = await new Promise((resolve28) => {
-        rl.question("Reset project state? This cannot be undone. [y/N] ", resolve28);
+      const answer = await new Promise((resolve29) => {
+        rl.question("Reset project state? This cannot be undone. [y/N] ", resolve29);
       });
       rl.close();
       if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
@@ -3436,10 +3439,10 @@ function prompt(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve28) => {
+  return new Promise((resolve29) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve28(answer.trim().toLowerCase());
+      resolve29(answer.trim().toLowerCase());
     });
   });
 }
@@ -3579,7 +3582,7 @@ function createGenerateCommand3() {
 import { Command as Command39 } from "commander";
 import * as path29 from "path";
 async function runScan(projectPath) {
-  const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-M6BQODWC.js");
+  const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-HXHWB7SV.js");
   const store = new GraphStore();
   const start = Date.now();
   await new CodeIngestor(store).ingest(projectPath);
@@ -3660,7 +3663,7 @@ async function runIngest(projectPath, source, opts) {
     SyncManager,
     JiraConnector,
     SlackConnector
-  } = await import("./dist-M6BQODWC.js");
+  } = await import("./dist-HXHWB7SV.js");
   const graphDir = path30.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   await store.load(graphDir);
@@ -3753,7 +3756,7 @@ function createIngestCommand() {
 import { Command as Command41 } from "commander";
 import * as path31 from "path";
 async function runQuery(projectPath, rootNodeId, opts) {
-  const { GraphStore, ContextQL } = await import("./dist-M6BQODWC.js");
+  const { GraphStore, ContextQL } = await import("./dist-HXHWB7SV.js");
   const store = new GraphStore();
   const graphDir = path31.join(projectPath, ".harness", "graph");
   const loaded = await store.load(graphDir);
@@ -3802,7 +3805,7 @@ import { Command as Command42 } from "commander";
 // src/commands/graph/status.ts
 import * as path32 from "path";
 async function runGraphStatus(projectPath) {
-  const { GraphStore } = await import("./dist-M6BQODWC.js");
+  const { GraphStore } = await import("./dist-HXHWB7SV.js");
   const graphDir = path32.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
@@ -3842,7 +3845,7 @@ async function runGraphStatus(projectPath) {
 // src/commands/graph/export.ts
 import * as path33 from "path";
 async function runGraphExport(projectPath, format) {
-  const { GraphStore } = await import("./dist-M6BQODWC.js");
+  const { GraphStore } = await import("./dist-HXHWB7SV.js");
   const graphDir = path33.join(projectPath, ".harness", "graph");
   const store = new GraphStore();
   const loaded = await store.load(graphDir);
@@ -3921,7 +3924,7 @@ function createGraphCommand() {
 import { Command as Command43 } from "commander";
 function createMcpCommand() {
   return new Command43("mcp").description("Start the MCP (Model Context Protocol) server on stdio").action(async () => {
-    const { startServer: startServer2 } = await import("./mcp-KQHEL5IF.js");
+    const { startServer: startServer2 } = await import("./mcp-JQUI7BVZ.js");
     await startServer2();
   });
 }

package/dist/{chunk-2VU4MFM3.js → chunk-TKJZKICB.js}

@@ -27,7 +27,7 @@ var checkPerformanceDefinition = {
 };
 async function handleCheckPerformance(input) {
   try {
-    const { EntropyAnalyzer } = await import("./dist-WF4C7A4A.js");
+    const { EntropyAnalyzer } = await import("./dist-2B363XUH.js");
     const typeFilter = input.type ?? "all";
     const projectPath = sanitizePath(input.path);
     const analyzer = new EntropyAnalyzer({
@@ -40,10 +40,10 @@ async function handleCheckPerformance(input) {
     });
     let graphOptions;
     try {
-      const { loadGraphStore } = await import("./graph-loader-KO4GJ5N2.js");
+      const { loadGraphStore } = await import("./graph-loader-GJZ4FN4Y.js");
       const store = await loadGraphStore(projectPath);
       if (store) {
-        const { GraphComplexityAdapter, GraphCouplingAdapter } = await import("./dist-M6BQODWC.js");
+        const { GraphComplexityAdapter, GraphCouplingAdapter } = await import("./dist-HXHWB7SV.js");
         const complexityAdapter = new GraphComplexityAdapter(store);
         const couplingAdapter = new GraphCouplingAdapter(store);
         graphOptions = {
@@ -80,7 +80,7 @@ var getPerfBaselinesDefinition = {
 };
 async function handleGetPerfBaselines(input) {
   try {
-    const { BaselineManager } = await import("./dist-WF4C7A4A.js");
+    const { BaselineManager } = await import("./dist-2B363XUH.js");
     const manager = new BaselineManager(sanitizePath(input.path));
     const baselines = manager.load();
     return resultToMcpResponse(
@@ -128,7 +128,7 @@ var updatePerfBaselinesDefinition = {
 };
 async function handleUpdatePerfBaselines(input) {
   try {
-    const { BaselineManager } = await import("./dist-WF4C7A4A.js");
+    const { BaselineManager } = await import("./dist-2B363XUH.js");
     const manager = new BaselineManager(sanitizePath(input.path));
     manager.save(input.results, input.commitHash);
     const updated = manager.load();
@@ -158,7 +158,7 @@ var getCriticalPathsDefinition = {
 };
 async function handleGetCriticalPaths(input) {
   try {
-    const { CriticalPathResolver } = await import("./dist-WF4C7A4A.js");
+    const { CriticalPathResolver } = await import("./dist-2B363XUH.js");
     const resolver = new CriticalPathResolver(sanitizePath(input.path));
     const result = await resolver.resolve();
     return resultToMcpResponse(Ok(result));

package/dist/{chunk-GNGELAXY.js → chunk-TS3XWPW5.js}

@@ -14,7 +14,7 @@ import {
 import {
   resolvePersonasDir,
   resolveSkillsDir
-} from "./chunk-HD4IBGLA.js";
+} from "./chunk-N5G5QMS3.js";
 import {
   CLIError,
   ExitCode,

package/dist/chunk-UAX4I5ZE.js

@@ -0,0 +1,217 @@
+import {
+  logger
+} from "./chunk-EBJQ6N4M.js";
+import {
+  resolveConfig
+} from "./chunk-Z77YQRQT.js";
+import {
+  ExitCode
+} from "./chunk-3WGJMBKH.js";
+import {
+  Ok
+} from "./chunk-MHBMTPW7.js";
+
+// src/commands/check-phase-gate.ts
+import { Command } from "commander";
+import * as path from "path";
+import * as fs from "fs";
+
+// src/utils/files.ts
+import { glob } from "glob";
+async function findFiles(pattern, cwd = process.cwd()) {
+  return glob(pattern, { cwd, absolute: true });
+}
+
+// src/output/formatter.ts
+import chalk from "chalk";
+var OutputMode = {
+  /** Output as formatted JSON */
+  JSON: "json",
+  /** Output as human-readable text */
+  TEXT: "text",
+  /** Minimal output, only errors and successes */
+  QUIET: "quiet",
+  /** Full output with detailed context and suggestions */
+  VERBOSE: "verbose"
+};
+var OutputFormatter = class {
+  /**
+   * Creates a new OutputFormatter.
+   *
+   * @param mode - The output mode to use. Defaults to TEXT.
+   */
+  constructor(mode = OutputMode.TEXT) {
+    this.mode = mode;
+  }
+  /**
+   * Formats raw data for output.
+   *
+   * @param data - The data to format.
+   * @returns A string representation of the data based on the current mode.
+   */
+  format(data) {
+    if (this.mode === OutputMode.JSON) {
+      return JSON.stringify(data, null, 2);
+    }
+    return String(data);
+  }
+  /**
+   * Formats a validation result into a user-friendly string.
+   *
+   * @param result - The validation result to format.
+   * @returns A formatted string containing the validation status and any issues.
+   */
+  formatValidation(result) {
+    if (this.mode === OutputMode.JSON) {
+      return JSON.stringify(result, null, 2);
+    }
+    if (this.mode === OutputMode.QUIET) {
+      if (result.valid) return "";
+      return result.issues.map((i) => `${i.file ?? ""}: ${i.message}`).join("\n");
+    }
+    const lines = [];
+    if (result.valid) {
+      lines.push(chalk.green("v validation passed"));
+    } else {
+      lines.push(chalk.red(`x Validation failed (${result.issues.length} issues)`));
+      lines.push("");
+      for (const issue of result.issues) {
+        const location = issue.file ? issue.line ? `${issue.file}:${issue.line}` : issue.file : "unknown";
+        lines.push(`  ${chalk.yellow("*")} ${chalk.dim(location)}`);
+        lines.push(`    ${issue.message}`);
+        if (issue.suggestion && this.mode === OutputMode.VERBOSE) {
+          lines.push(`    ${chalk.dim("->")} ${issue.suggestion}`);
+        }
+      }
+    }
+    return lines.join("\n");
+  }
+  /**
+   * Formats a summary line with a success/failure icon and label.
+   *
+   * @param label - The name of the field to summarize.
+   * @param value - The value to display.
+   * @param success - Whether the summary represents a success or failure state.
+   * @returns A formatted summary string, or an empty string in JSON or QUIET modes.
+   */
+  formatSummary(label, value, success) {
+    if (this.mode === OutputMode.JSON || this.mode === OutputMode.QUIET) {
+      return "";
+    }
+    const icon = success ? chalk.green("v") : chalk.red("x");
+    return `${icon} ${label}: ${value}`;
+  }
+};
+
+// src/commands/check-phase-gate.ts
+function resolveSpecPath(implFile, implPattern, specPattern, cwd) {
+  const relImpl = path.relative(cwd, implFile).replace(/\\/g, "/");
+  const implBase = (implPattern.split("*")[0] ?? "").replace(/\/+$/, "");
+  const afterBase = relImpl.startsWith(implBase + "/") ? relImpl.slice(implBase.length + 1) : relImpl;
+  const segments = afterBase.split("/");
+  const firstSegment = segments[0] ?? "";
+  const feature = segments.length > 1 ? firstSegment : path.basename(firstSegment, path.extname(firstSegment));
+  const specRelative = specPattern.replace("{feature}", feature);
+  return path.resolve(cwd, specRelative);
+}
+async function runCheckPhaseGate(options) {
+  const configResult = resolveConfig(options.configPath);
+  if (!configResult.ok) {
+    return configResult;
+  }
+  const config = configResult.value;
+  const cwd = options.cwd ?? (options.configPath ? path.dirname(path.resolve(options.configPath)) : process.cwd());
+  if (!config.phaseGates?.enabled) {
+    return Ok({
+      pass: true,
+      skipped: true,
+      missingSpecs: [],
+      checkedFiles: 0
+    });
+  }
+  const phaseGates = config.phaseGates;
+  const missingSpecs = [];
+  let checkedFiles = 0;
+  for (const mapping of phaseGates.mappings) {
+    const implFiles = await findFiles(mapping.implPattern, cwd);
+    for (const implFile of implFiles) {
+      checkedFiles++;
+      const expectedSpec = resolveSpecPath(implFile, mapping.implPattern, mapping.specPattern, cwd);
+      if (!fs.existsSync(expectedSpec)) {
+        missingSpecs.push({
+          implFile: path.relative(cwd, implFile).replace(/\\/g, "/"),
+          expectedSpec: path.relative(cwd, expectedSpec).replace(/\\/g, "/")
+        });
+      }
+    }
+  }
+  const pass = missingSpecs.length === 0;
+  return Ok({
+    pass,
+    skipped: false,
+    severity: phaseGates.severity,
+    missingSpecs,
+    checkedFiles
+  });
+}
+function createCheckPhaseGateCommand() {
+  const command = new Command("check-phase-gate").description("Verify that implementation files have matching spec documents").action(async (_opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
+    const formatter = new OutputFormatter(mode);
+    const result = await runCheckPhaseGate({
+      configPath: globalOpts.config,
+      json: globalOpts.json,
+      verbose: globalOpts.verbose,
+      quiet: globalOpts.quiet
+    });
+    if (!result.ok) {
+      if (mode === OutputMode.JSON) {
+        console.log(JSON.stringify({ error: result.error.message }));
+      } else {
+        logger.error(result.error.message);
+      }
+      process.exit(result.error.exitCode);
+    }
+    const value = result.value;
+    if (value.skipped) {
+      if (mode === OutputMode.JSON) {
+        console.log(formatter.format(value));
+      } else if (mode !== OutputMode.QUIET) {
+        logger.dim("Phase gates not enabled, skipping.");
+      }
+      process.exit(ExitCode.SUCCESS);
+    }
+    const output = formatter.formatValidation({
+      valid: value.pass,
+      issues: value.missingSpecs.map((m) => ({
+        file: m.implFile,
+        message: `Missing spec: ${m.expectedSpec}`
+      }))
+    });
+    if (output) {
+      console.log(output);
+    }
+    const summary = formatter.formatSummary(
+      "Phase gate check",
+      `${value.checkedFiles} files checked, ${value.missingSpecs.length} missing specs`,
+      value.pass
+    );
+    if (summary) {
+      console.log(summary);
+    }
+    if (!value.pass && value.severity === "error") {
+      process.exit(ExitCode.VALIDATION_FAILED);
+    }
+    process.exit(ExitCode.SUCCESS);
+  });
+  return command;
+}
+
+export {
+  OutputMode,
+  OutputFormatter,
+  findFiles,
+  runCheckPhaseGate,
+  createCheckPhaseGateCommand
+};

package/dist/{chunk-VRFZWGMS.js → chunk-XYLGHKG6.js}

@@ -59,7 +59,11 @@ var SkillMetadataSchema = z.object({
   phases: z.array(SkillPhaseSchema).optional(),
   state: SkillStateSchema.default({}),
   depends_on: z.array(z.string()).default([]),
-  repository: z.string().url().optional()
+  repository: z.string().url().optional(),
+  tier: z.number().int().min(1).max(3).optional(),
+  internal: z.boolean().default(false),
+  keywords: z.array(z.string()).default([]),
+  stack_signals: z.array(z.string()).default([])
 });
 
 export {

package/dist/{chunk-6N4R6FVX.js → chunk-YBJ262QL.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-3WGJMBKH.js";
 import {
   ALLOWED_COGNITIVE_MODES
-} from "./chunk-VRFZWGMS.js";
+} from "./chunk-XYLGHKG6.js";
 
 // src/commands/create-skill.ts
 import { Command } from "commander";