@harness-engineering/cli 1.12.0 → 1.13.1

package/dist/{chunk-ZU2UBYBY.js → chunk-Z77YQRQT.js}

@@ -1,23 +1,15 @@
-import {
-  logger
-} from "./chunk-EBJQ6N4M.js";
 import {
   CLIError,
   ExitCode
 } from "./chunk-3WGJMBKH.js";
 import {
   ArchConfigSchema
-} from "./chunk-AE2OWWDH.js";
+} from "./chunk-PQ5YK4AY.js";
 import {
   Err,
   Ok
 } from "./chunk-MHBMTPW7.js";
 
-// src/commands/check-phase-gate.ts
-import { Command } from "commander";
-import * as path2 from "path";
-import * as fs2 from "fs";
-
 // src/config/loader.ts
 import * as fs from "fs";
 import * as path from "path";
@@ -209,6 +201,15 @@ var HarnessConfigSchema = z.object({
   review: ReviewConfigSchema.optional(),
   /** General architectural enforcement settings */
   architecture: ArchConfigSchema.optional(),
+  /** Skill loading, suggestion, and tier override settings */
+  skills: z.object({
+    /** Skills to always suggest in the dispatcher, regardless of scoring */
+    alwaysSuggest: z.array(z.string()).default([]),
+    /** Skills to never suggest in the dispatcher, even if they score highly */
+    neverSuggest: z.array(z.string()).default([]),
+    /** Override the tier of specific skills (e.g., promote a Tier 3 skill to Tier 2) */
+    tierOverrides: z.record(z.string(), z.number().int().min(1).max(3)).default({})
+  }).optional(),
   /** How often (in ms) to check for CLI updates */
   updateCheckInterval: z.number().int().min(0).optional()
 });
@@ -266,205 +267,8 @@ function resolveConfig(configPath) {
   return loadConfig(findResult.value);
 }
 
-// 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 = path2.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 : path2.basename(firstSegment, path2.extname(firstSegment));
-  const specRelative = specPattern.replace("{feature}", feature);
-  return path2.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 ? path2.dirname(path2.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 (!fs2.existsSync(expectedSpec)) {
-        missingSpecs.push({
-          implFile: path2.relative(cwd, implFile).replace(/\\/g, "/"),
-          expectedSpec: path2.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 {
   findConfigFile,
   loadConfig,
-  resolveConfig,
-  OutputMode,
-  OutputFormatter,
-  findFiles,
-  runCheckPhaseGate,
-  createCheckPhaseGateCommand
+  resolveConfig
 };

package/dist/{ci-workflow-NBL4OT4A.js → ci-workflow-EHV65NQB.js}

@@ -1,7 +1,7 @@
 import {
   generateCIWorkflow
 } from "./chunk-VUCPTQ6G.js";
-import "./chunk-AE2OWWDH.js";
+import "./chunk-PQ5YK4AY.js";
 import "./chunk-MHBMTPW7.js";
 export {
   generateCIWorkflow

package/dist/{create-skill-WPXHSLX2.js → create-skill-XSWHMSM5.js}

@@ -1,10 +1,10 @@
 import {
   createCreateSkillCommand,
   generateSkillFiles
-} from "./chunk-6N4R6FVX.js";
+} from "./chunk-YBJ262QL.js";
 import "./chunk-EBJQ6N4M.js";
 import "./chunk-3WGJMBKH.js";
-import "./chunk-VRFZWGMS.js";
+import "./chunk-XYLGHKG6.js";
 export {
   createCreateSkillCommand,
   generateSkillFiles

package/dist/{dist-IJ4J4C5G.js → dist-2B363XUH.js}

@@ -74,6 +74,7 @@ import {
   ViolationSchema,
   addProvenance,
   analyzeDiff,
+  analyzeLearningPatterns,
   appendFailure,
   appendLearning,
   applyFixes,
@@ -82,6 +83,7 @@ import {
   archModule,
   architecture,
   archiveFailures,
+  archiveLearnings,
   archiveStream,
   buildDependencyGraph,
   buildExclusionSet,
@@ -89,6 +91,8 @@ import {
   checkDocCoverage,
   checkEligibility,
   classifyFinding,
+  clearFailuresCache,
+  clearLearningsCache,
   configureFeedback,
   constraintRuleId,
   contextBudget,
@@ -144,16 +148,20 @@ import {
   injectionRules,
   isSmallSuggestion,
   isUpdateCheckEnabled,
+  listActiveSessions,
   listStreams,
+  loadBudgetedLearnings,
   loadFailures,
   loadHandoff,
   loadRelevantLearnings,
+  loadSessionSummary,
   loadState,
   loadStreamIndex,
   logAgentAction,
   migrateToStreams,
   networkRules,
   nodeRules,
+  parseDateFromEntry,
   parseDiff,
   parseManifest,
   parseRoadmap,
@@ -161,6 +169,7 @@ import {
   parseSize,
   pathTraversalRules,
   previewFix,
+  pruneLearnings,
   reactRules,
   readCheckState,
   readLockfile,
@@ -172,6 +181,7 @@ import {
   resolveFileToLayer,
   resolveModelTier,
   resolveRuleSeverity,
+  resolveSessionDir,
   resolveStreamPath,
   resolveThresholds,
   runAll,
@@ -198,6 +208,7 @@ import {
   syncRoadmap,
   touchStream,
   trackAction,
+  updateSessionIndex,
   validateAgentsMap,
   validateBoundaries,
   validateCommitMessage,
@@ -210,8 +221,9 @@ import {
   violationId,
   writeConfig,
   writeLockfile,
+  writeSessionSummary,
   xssRules
-} from "./chunk-AE2OWWDH.js";
+} from "./chunk-PQ5YK4AY.js";
 import {
   Err,
   Ok,
@@ -298,6 +310,7 @@ export {
   ViolationSchema,
   addProvenance,
   analyzeDiff,
+  analyzeLearningPatterns,
   appendFailure,
   appendLearning,
   applyFixes,
@@ -306,6 +319,7 @@ export {
   archModule,
   architecture,
   archiveFailures,
+  archiveLearnings,
   archiveStream,
   buildDependencyGraph,
   buildExclusionSet,
@@ -313,6 +327,8 @@ export {
   checkDocCoverage,
   checkEligibility,
   classifyFinding,
+  clearFailuresCache,
+  clearLearningsCache,
   configureFeedback,
   constraintRuleId,
   contextBudget,
@@ -370,16 +386,20 @@ export {
   isOk,
   isSmallSuggestion,
   isUpdateCheckEnabled,
+  listActiveSessions,
   listStreams,
+  loadBudgetedLearnings,
   loadFailures,
   loadHandoff,
   loadRelevantLearnings,
+  loadSessionSummary,
   loadState,
   loadStreamIndex,
   logAgentAction,
   migrateToStreams,
   networkRules,
   nodeRules,
+  parseDateFromEntry,
   parseDiff,
   parseManifest,
   parseRoadmap,
@@ -387,6 +407,7 @@ export {
   parseSize,
   pathTraversalRules,
   previewFix,
+  pruneLearnings,
   reactRules,
   readCheckState,
   readLockfile,
@@ -398,6 +419,7 @@ export {
   resolveFileToLayer,
   resolveModelTier,
   resolveRuleSeverity,
+  resolveSessionDir,
   resolveStreamPath,
   resolveThresholds,
   runAll,
@@ -424,6 +446,7 @@ export {
   syncRoadmap,
   touchStream,
   trackAction,
+  updateSessionIndex,
   validateAgentsMap,
   validateBoundaries,
   validateCommitMessage,
@@ -436,5 +459,6 @@ export {
   violationId,
   writeConfig,
   writeLockfile,
+  writeSessionSummary,
   xssRules
 };

package/dist/{dist-M6BQODWC.js → dist-HXHWB7SV.js}

@@ -3370,8 +3370,8 @@ var GraphConstraintAdapter = class {
     const { edges } = this.computeDependencyGraph();
     const violations = [];
     for (const edge of edges) {
-      const fromRelative = relative2(rootDir, edge.from);
-      const toRelative = relative2(rootDir, edge.to);
+      const fromRelative = relative2(rootDir, edge.from).replaceAll("\\", "/");
+      const toRelative = relative2(rootDir, edge.to).replaceAll("\\", "/");
       const fromLayer = this.resolveLayer(fromRelative, layers);
       const toLayer = this.resolveLayer(toRelative, layers);
       if (!fromLayer || !toLayer) continue;

package/dist/{docs-CPTMH3VY.js → docs-FZOPM4GK.js}

@@ -1,10 +1,12 @@
 import {
   checkDocsDefinition,
   handleCheckDocs
-} from "./chunk-CTTFXXKJ.js";
+} from "./chunk-ND6PNADU.js";
+import "./chunk-Z77YQRQT.js";
 import "./chunk-IDZNPTYD.js";
 import "./chunk-W6Y7ZW3Y.js";
-import "./chunk-AE2OWWDH.js";
+import "./chunk-3WGJMBKH.js";
+import "./chunk-PQ5YK4AY.js";
 import "./chunk-MHBMTPW7.js";
 export {
   checkDocsDefinition,

package/dist/{engine-BUWPAAGD.js → engine-OL4T6NZS.js}

@@ -1,7 +1,7 @@
 import {
   TemplateEngine
 } from "./chunk-C2ERUR3L.js";
-import "./chunk-AE2OWWDH.js";
+import "./chunk-PQ5YK4AY.js";
 import "./chunk-MHBMTPW7.js";
 export {
   TemplateEngine

package/dist/{entropy-Z4FYVQ7L.js → entropy-LVHJMFGH.js}

@@ -1,10 +1,10 @@
 import {
   detectEntropyDefinition,
   handleDetectEntropy
-} from "./chunk-JLXOEO5C.js";
+} from "./chunk-DZS7CJKL.js";
 import "./chunk-IDZNPTYD.js";
 import "./chunk-W6Y7ZW3Y.js";
-import "./chunk-AE2OWWDH.js";
+import "./chunk-PQ5YK4AY.js";
 import "./chunk-MHBMTPW7.js";
 export {
   detectEntropyDefinition,

package/dist/{feedback-TT6WF5YX.js → feedback-IHLVLMRD.js}

@@ -5,7 +5,7 @@ import {
   handleCreateSelfReview,
   handleRequestPeerReview,
   requestPeerReviewDefinition
-} from "./chunk-FLOEMHDF.js";
+} from "./chunk-IM32EEDM.js";
 import "./chunk-IDZNPTYD.js";
 import "./chunk-W6Y7ZW3Y.js";
 export {

package/dist/{generate-agent-definitions-J5HANRNR.js → generate-agent-definitions-64S3CLEZ.js}

@@ -1,13 +1,13 @@
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
-} from "./chunk-GNGELAXY.js";
+} from "./chunk-TS3XWPW5.js";
 import "./chunk-Q6AB7W5Z.js";
 import "./chunk-KET4QQZB.js";
 import "./chunk-ZOAWBDWU.js";
-import "./chunk-HD4IBGLA.js";
+import "./chunk-N5G5QMS3.js";
 import "./chunk-3WGJMBKH.js";
-import "./chunk-AE2OWWDH.js";
+import "./chunk-PQ5YK4AY.js";
 import "./chunk-MHBMTPW7.js";
 export {
   createGenerateAgentDefinitionsCommand,

package/dist/{glob-helper-5OHBUQAI.js → glob-helper-R5FXNUPS.js}

@@ -31,7 +31,7 @@ async function globFiles(rootDir, exclude) {
     }
     for (const entry of entries) {
       const fullPath = path.join(dir, entry.name);
-      const relativePath = path.relative(rootDir, fullPath);
+      const relativePath = path.relative(rootDir, fullPath).replaceAll("\\", "/");
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (isExcluded(relativePath + "/", excludeRegexes)) continue;

package/dist/{graph-loader-KO4GJ5N2.js → graph-loader-GJZ4FN4Y.js}

@@ -1,7 +1,7 @@
 import {
   clearGraphStoreCache,
   loadGraphStore
-} from "./chunk-2YPZKGAG.js";
+} from "./chunk-IMFVFNJE.js";
 export {
   clearGraphStoreCache,
   loadGraphStore

package/dist/index.d.ts

@@ -164,6 +164,39 @@ interface SkillSource {
     source: 'project' | 'community' | 'global';
 }
 
+interface ImpactPreviewOptions {
+    detailed?: boolean;
+    perFile?: boolean;
+    path?: string;
+}
+declare function runImpactPreview(options: ImpactPreviewOptions): Promise<string>;
+
+interface CheckArchOptions {
+    cwd?: string;
+    configPath?: string;
+    updateBaseline?: boolean;
+    json?: boolean;
+    module?: string;
+}
+interface CheckArchResult {
+    passed: boolean;
+    mode: 'baseline' | 'threshold-only';
+    totalViolations: number;
+    newViolations: Violation[];
+    resolvedViolations: string[];
+    preExisting: string[];
+    regressions: Array<{
+        category: string;
+        baselineValue: number;
+        currentValue: number;
+        delta: number;
+    }>;
+    thresholdViolations: Violation[];
+    baselineUpdated?: boolean;
+    warning?: string;
+}
+declare function runCheckArch(options: CheckArchOptions): Promise<Result<CheckArchResult, CLIError>>;
+
 /**
  * Supported output modes for the CLI.
  */
@@ -637,6 +670,23 @@ declare const HarnessConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         baselinePath?: string | undefined;
     }>>;
+    /** Skill loading, suggestion, and tier override settings */
+    skills: z.ZodOptional<z.ZodObject<{
+        /** Skills to always suggest in the dispatcher, regardless of scoring */
+        alwaysSuggest: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Skills to never suggest in the dispatcher, even if they score highly */
+        neverSuggest: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Override the tier of specific skills (e.g., promote a Tier 3 skill to Tier 2) */
+        tierOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        alwaysSuggest: string[];
+        neverSuggest: string[];
+        tierOverrides: Record<string, number>;
+    }, {
+        alwaysSuggest?: string[] | undefined;
+        neverSuggest?: string[] | undefined;
+        tierOverrides?: Record<string, number> | undefined;
+    }>>;
     /** How often (in ms) to check for CLI updates */
     updateCheckInterval: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -645,6 +695,11 @@ declare const HarnessConfigSchema: z.ZodObject<{
     agentsMapPath: string;
     docsDir: string;
     name?: string | undefined;
+    skills?: {
+        alwaysSuggest: string[];
+        neverSuggest: string[];
+        tierOverrides: Record<string, number>;
+    } | undefined;
     layers?: {
         name: string;
         pattern: string;
@@ -744,6 +799,11 @@ declare const HarnessConfigSchema: z.ZodObject<{
 }, {
     version: 1;
     name?: string | undefined;
+    skills?: {
+        alwaysSuggest?: string[] | undefined;
+        neverSuggest?: string[] | undefined;
+        tierOverrides?: Record<string, number> | undefined;
+    } | undefined;
     rootDir?: string | undefined;
     layers?: {
         name: string;
@@ -1221,39 +1281,6 @@ declare function renderClaudeCodeAgent(def: AgentDefinition): string;
 
 declare function renderGeminiAgent(def: AgentDefinition): string;
 
-interface ImpactPreviewOptions {
-    detailed?: boolean;
-    perFile?: boolean;
-    path?: string;
-}
-declare function runImpactPreview(options: ImpactPreviewOptions): Promise<string>;
-
-interface CheckArchOptions {
-    cwd?: string;
-    configPath?: string;
-    updateBaseline?: boolean;
-    json?: boolean;
-    module?: string;
-}
-interface CheckArchResult {
-    passed: boolean;
-    mode: 'baseline' | 'threshold-only';
-    totalViolations: number;
-    newViolations: Violation[];
-    resolvedViolations: string[];
-    preExisting: string[];
-    regressions: Array<{
-        category: string;
-        baselineValue: number;
-        currentValue: number;
-        delta: number;
-    }>;
-    thresholdViolations: Violation[];
-    baselineUpdated?: boolean;
-    warning?: string;
-}
-declare function runCheckArch(options: CheckArchOptions): Promise<Result<CheckArchResult, CLIError>>;
-
 type ToolDefinition = {
     name: string;
     description: string;