@harness-engineering/cli 1.9.0 → 1.10.0

package/dist/chunk-4PFMY3H7.js

@@ -0,0 +1,248 @@
+import {
+  resultToMcpResponse
+} from "./chunk-IDZNPTYD.js";
+import {
+  sanitizePath
+} from "./chunk-W6Y7ZW3Y.js";
+
+// src/mcp/tools/feedback.ts
+var createSelfReviewDefinition = {
+  name: "create_self_review",
+  description: "Generate a checklist-based code review from a git diff, checking harness constraints, custom rules, and diff patterns",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "Path to project root" },
+      diff: { type: "string", description: "Git diff string to review" },
+      customRules: {
+        type: "array",
+        items: { type: "object" },
+        description: "Optional custom rules to apply during review"
+      },
+      maxFileSize: {
+        type: "number",
+        description: "Maximum number of lines changed per file before flagging"
+      },
+      maxFileCount: {
+        type: "number",
+        description: "Maximum number of changed files before flagging"
+      }
+    },
+    required: ["path", "diff"]
+  }
+};
+async function handleCreateSelfReview(input) {
+  try {
+    const { parseDiff, createSelfReview } = await import("./dist-PBTNVK6K.js");
+    const parseResult = parseDiff(input.diff);
+    if (!parseResult.ok) {
+      return resultToMcpResponse(parseResult);
+    }
+    const projectPath = sanitizePath(input.path);
+    const config = {
+      rootDir: projectPath,
+      harness: {
+        context: true,
+        constraints: true,
+        entropy: true
+      },
+      ...input.customRules ? { customRules: input.customRules } : {},
+      diffAnalysis: {
+        enabled: true,
+        ...input.maxFileSize !== void 0 ? { maxFileSize: input.maxFileSize } : {},
+        ...input.maxFileCount !== void 0 ? { maxChangedFiles: input.maxFileCount } : {}
+      }
+    };
+    const { loadGraphStore } = await import("./graph-loader-RLO3KRIX.js");
+    const store = await loadGraphStore(projectPath);
+    let graphData;
+    if (store) {
+      const { GraphFeedbackAdapter } = await import("./dist-I7DB5VKB.js");
+      const adapter = new GraphFeedbackAdapter(store);
+      const changedFiles = parseResult.value.files.map((f) => f.path);
+      const impact = adapter.computeImpactData(changedFiles);
+      const harness = adapter.computeHarnessCheckData();
+      graphData = {
+        impact: {
+          affectedTests: [...impact.affectedTests],
+          affectedDocs: [...impact.affectedDocs],
+          impactScope: impact.impactScope
+        },
+        harness: { ...harness }
+      };
+    }
+    const result = await createSelfReview(
+      parseResult.value,
+      config,
+      graphData
+    );
+    return resultToMcpResponse(result);
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error instanceof Error ? error.message : String(error)}`
+        }
+      ],
+      isError: true
+    };
+  }
+}
+var analyzeDiffDefinition = {
+  name: "analyze_diff",
+  description: "Parse a git diff and check for forbidden patterns, oversized files, and missing test coverage",
+  inputSchema: {
+    type: "object",
+    properties: {
+      diff: { type: "string", description: "Git diff string to analyze" },
+      path: {
+        type: "string",
+        description: "Path to project root (enables graph-enhanced analysis)"
+      },
+      forbiddenPatterns: {
+        type: "array",
+        items: { type: "string" },
+        description: "List of regex patterns that are forbidden in the diff"
+      },
+      maxFileSize: {
+        type: "number",
+        description: "Maximum number of lines changed per file before flagging"
+      },
+      maxFileCount: {
+        type: "number",
+        description: "Maximum number of changed files before flagging"
+      }
+    },
+    required: ["diff"]
+  }
+};
+async function handleAnalyzeDiff(input) {
+  try {
+    const { parseDiff, analyzeDiff } = await import("./dist-PBTNVK6K.js");
+    const parseResult = parseDiff(input.diff);
+    if (!parseResult.ok) {
+      return resultToMcpResponse(parseResult);
+    }
+    const options = {
+      enabled: true,
+      ...input.forbiddenPatterns ? {
+        forbiddenPatterns: input.forbiddenPatterns.map((pattern) => ({
+          pattern,
+          message: `Forbidden pattern matched: ${pattern}`,
+          severity: "warning"
+        }))
+      } : {},
+      ...input.maxFileSize !== void 0 ? { maxFileSize: input.maxFileSize } : {},
+      ...input.maxFileCount !== void 0 ? { maxChangedFiles: input.maxFileCount } : {}
+    };
+    let graphImpactData;
+    if (input.path) {
+      try {
+        const { loadGraphStore } = await import("./graph-loader-RLO3KRIX.js");
+        const store = await loadGraphStore(sanitizePath(input.path));
+        if (store) {
+          const { GraphFeedbackAdapter } = await import("./dist-I7DB5VKB.js");
+          const adapter = new GraphFeedbackAdapter(store);
+          const changedFiles = parseResult.value.files.map((f) => f.path);
+          const impact = adapter.computeImpactData(changedFiles);
+          graphImpactData = {
+            affectedTests: [...impact.affectedTests],
+            affectedDocs: [...impact.affectedDocs],
+            impactScope: impact.impactScope
+          };
+        }
+      } catch {
+      }
+    }
+    const result = await analyzeDiff(parseResult.value, options, graphImpactData);
+    return resultToMcpResponse(result);
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error instanceof Error ? error.message : String(error)}`
+        }
+      ],
+      isError: true
+    };
+  }
+}
+var requestPeerReviewDefinition = {
+  name: "request_peer_review",
+  description: "Spawn an agent subprocess to perform code review. Returns structured feedback with approval status. Timeout: 120 seconds.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "Path to project root" },
+      agentType: {
+        type: "string",
+        enum: [
+          "architecture-enforcer",
+          "documentation-maintainer",
+          "test-reviewer",
+          "entropy-cleaner",
+          "custom"
+        ],
+        description: "Type of agent to use for the peer review"
+      },
+      diff: { type: "string", description: "Git diff string to review" },
+      context: { type: "string", description: "Optional additional context for the reviewer" }
+    },
+    required: ["path", "agentType", "diff"]
+  }
+};
+async function handleRequestPeerReview(input) {
+  try {
+    const { parseDiff, requestPeerReview } = await import("./dist-PBTNVK6K.js");
+    const parseResult = parseDiff(input.diff);
+    if (!parseResult.ok) {
+      return resultToMcpResponse(parseResult);
+    }
+    const reviewContext = {
+      files: parseResult.value.files.map((f) => f.path),
+      diff: input.diff,
+      ...input.context ? { metadata: { context: input.context } } : {}
+    };
+    try {
+      const { loadGraphStore } = await import("./graph-loader-RLO3KRIX.js");
+      const store = await loadGraphStore(sanitizePath(input.path));
+      if (store) {
+        const { GraphFeedbackAdapter } = await import("./dist-I7DB5VKB.js");
+        const adapter = new GraphFeedbackAdapter(store);
+        const changedFiles = parseResult.value.files.map((f) => f.path);
+        const impactData = adapter.computeImpactData(changedFiles);
+        reviewContext.metadata = {
+          ...reviewContext.metadata,
+          graphContext: impactData
+        };
+      }
+    } catch {
+    }
+    const result = await requestPeerReview(input.agentType, reviewContext, {
+      timeout: 12e4,
+      wait: true
+    });
+    return resultToMcpResponse(result);
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error instanceof Error ? error.message : String(error)}`
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
+export {
+  createSelfReviewDefinition,
+  handleCreateSelfReview,
+  analyzeDiffDefinition,
+  handleAnalyzeDiff,
+  requestPeerReviewDefinition,
+  handleRequestPeerReview
+};

package/dist/{chunk-6JIT7CEM.js → chunk-72GHBOL2.js}

@@ -1,6 +1,6 @@
 import {
   Ok
-} from "./chunk-CGSHUJES.js";
+} from "./chunk-MHBMTPW7.js";
 
 // src/commands/validate-cross-check.ts
 import * as fs from "fs";

package/dist/chunk-7X7ZAYMY.js

@@ -0,0 +1,373 @@
+import {
+  logger
+} from "./chunk-HIOXKZYF.js";
+import {
+  CLIError,
+  ExitCode
+} from "./chunk-B7HFEHWP.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";
+
+// src/config/schema.ts
+import { z } from "zod";
+var LayerSchema = z.object({
+  name: z.string(),
+  pattern: z.string(),
+  allowedDependencies: z.array(z.string())
+});
+var ForbiddenImportSchema = z.object({
+  from: z.string(),
+  disallow: z.array(z.string()),
+  message: z.string().optional()
+});
+var BoundaryConfigSchema = z.object({
+  requireSchema: z.array(z.string())
+});
+var AgentConfigSchema = z.object({
+  executor: z.enum(["subprocess", "cloud", "noop"]).default("subprocess"),
+  timeout: z.number().default(3e5),
+  skills: z.array(z.string()).optional()
+});
+var EntropyConfigSchema = z.object({
+  excludePatterns: z.array(z.string()).default(["**/node_modules/**", "**/*.test.ts"]),
+  autoFix: z.boolean().default(false)
+});
+var PhaseGateMappingSchema = z.object({
+  implPattern: z.string(),
+  specPattern: z.string()
+});
+var PhaseGatesConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  severity: z.enum(["error", "warning"]).default("error"),
+  mappings: z.array(PhaseGateMappingSchema).default([{ implPattern: "src/**/*.ts", specPattern: "docs/changes/{feature}/proposal.md" }])
+});
+var SecurityConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  strict: z.boolean().default(false),
+  rules: z.record(z.string(), z.enum(["off", "error", "warning", "info"])).optional(),
+  exclude: z.array(z.string()).optional()
+}).passthrough();
+var PerformanceConfigSchema = z.object({
+  complexity: z.record(z.unknown()).optional(),
+  coupling: z.record(z.unknown()).optional(),
+  sizeBudget: z.record(z.unknown()).optional()
+}).passthrough();
+var DesignConfigSchema = z.object({
+  strictness: z.enum(["strict", "standard", "permissive"]).default("standard"),
+  platforms: z.array(z.enum(["web", "mobile"])).default([]),
+  tokenPath: z.string().optional(),
+  aestheticIntent: z.string().optional()
+});
+var I18nCoverageConfigSchema = z.object({
+  minimumPercent: z.number().min(0).max(100).default(100),
+  requirePlurals: z.boolean().default(true),
+  detectUntranslated: z.boolean().default(true)
+});
+var I18nMcpConfigSchema = z.object({
+  server: z.string(),
+  projectId: z.string().optional()
+});
+var I18nConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  strictness: z.enum(["strict", "standard", "permissive"]).default("standard"),
+  sourceLocale: z.string().default("en"),
+  targetLocales: z.array(z.string()).default([]),
+  framework: z.enum([
+    "auto",
+    "i18next",
+    "react-intl",
+    "vue-i18n",
+    "flutter-intl",
+    "apple",
+    "android",
+    "custom"
+  ]).default("auto"),
+  format: z.string().default("json"),
+  messageFormat: z.enum(["icu", "i18next", "custom"]).default("icu"),
+  keyConvention: z.enum(["dot-notation", "snake_case", "camelCase", "custom"]).default("dot-notation"),
+  translationPaths: z.record(z.string(), z.string()).optional(),
+  platforms: z.array(z.enum(["web", "mobile", "backend"])).default([]),
+  industry: z.string().optional(),
+  coverage: I18nCoverageConfigSchema.optional(),
+  pseudoLocale: z.string().optional(),
+  mcp: I18nMcpConfigSchema.optional()
+});
+var ModelTierConfigSchema = z.object({
+  fast: z.string().optional(),
+  standard: z.string().optional(),
+  strong: z.string().optional()
+});
+var ReviewConfigSchema = z.object({
+  model_tiers: ModelTierConfigSchema.optional()
+});
+var HarnessConfigSchema = z.object({
+  version: z.literal(1),
+  name: z.string().optional(),
+  rootDir: z.string().default("."),
+  layers: z.array(LayerSchema).optional(),
+  forbiddenImports: z.array(ForbiddenImportSchema).optional(),
+  boundaries: BoundaryConfigSchema.optional(),
+  agentsMapPath: z.string().default("./AGENTS.md"),
+  docsDir: z.string().default("./docs"),
+  agent: AgentConfigSchema.optional(),
+  entropy: EntropyConfigSchema.optional(),
+  security: SecurityConfigSchema.optional(),
+  performance: PerformanceConfigSchema.optional(),
+  template: z.object({
+    level: z.enum(["basic", "intermediate", "advanced"]),
+    framework: z.string().optional(),
+    version: z.number()
+  }).optional(),
+  phaseGates: PhaseGatesConfigSchema.optional(),
+  design: DesignConfigSchema.optional(),
+  i18n: I18nConfigSchema.optional(),
+  review: ReviewConfigSchema.optional(),
+  updateCheckInterval: z.number().int().min(0).optional()
+});
+
+// src/config/loader.ts
+var CONFIG_FILENAMES = ["harness.config.json"];
+function findConfigFile(startDir = process.cwd()) {
+  let currentDir = path.resolve(startDir);
+  const root = path.parse(currentDir).root;
+  while (currentDir !== root) {
+    for (const filename of CONFIG_FILENAMES) {
+      const configPath = path.join(currentDir, filename);
+      if (fs.existsSync(configPath)) {
+        return Ok(configPath);
+      }
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  return Err(
+    new CLIError('No harness.config.json found. Run "harness init" to create one.', ExitCode.ERROR)
+  );
+}
+function loadConfig(configPath) {
+  if (!fs.existsSync(configPath)) {
+    return Err(new CLIError(`Config file not found: ${configPath}`, ExitCode.ERROR));
+  }
+  let rawConfig;
+  try {
+    const content = fs.readFileSync(configPath, "utf-8");
+    rawConfig = JSON.parse(content);
+  } catch (error) {
+    return Err(
+      new CLIError(
+        `Failed to parse config: ${error instanceof Error ? error.message : "Unknown error"}`,
+        ExitCode.ERROR
+      )
+    );
+  }
+  const parsed = HarnessConfigSchema.safeParse(rawConfig);
+  if (!parsed.success) {
+    const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+    return Err(new CLIError(`Invalid config:
+${issues}`, ExitCode.ERROR));
+  }
+  return Ok(parsed.data);
+}
+function resolveConfig(configPath) {
+  if (configPath) {
+    return loadConfig(configPath);
+  }
+  const findResult = findConfigFile();
+  if (!findResult.ok) {
+    return findResult;
+  }
+  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 = {
+  JSON: "json",
+  TEXT: "text",
+  QUIET: "quiet",
+  VERBOSE: "verbose"
+};
+var OutputFormatter = class {
+  constructor(mode = OutputMode.TEXT) {
+    this.mode = mode;
+  }
+  /**
+   * Format raw data (for JSON mode)
+   */
+  format(data) {
+    if (this.mode === OutputMode.JSON) {
+      return JSON.stringify(data, null, 2);
+    }
+    return String(data);
+  }
+  /**
+   * Format validation result
+   */
+  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");
+  }
+  /**
+   * Format a summary line
+   */
+  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
+};

package/dist/chunk-B7HFEHWP.js

@@ -0,0 +1,35 @@
+// src/utils/errors.ts
+var ExitCode = {
+  SUCCESS: 0,
+  VALIDATION_FAILED: 1,
+  ERROR: 2
+};
+var CLIError = class extends Error {
+  exitCode;
+  constructor(message, exitCode = ExitCode.ERROR) {
+    super(message);
+    this.name = "CLIError";
+    this.exitCode = exitCode;
+  }
+};
+function formatError(error) {
+  if (error instanceof CLIError) {
+    return `Error: ${error.message}`;
+  }
+  if (error instanceof Error) {
+    return `Error: ${error.message}`;
+  }
+  return `Error: ${String(error)}`;
+}
+function handleError(error) {
+  const message = formatError(error);
+  console.error(message);
+  const exitCode = error instanceof CLIError ? error.exitCode : ExitCode.ERROR;
+  process.exit(exitCode);
+}
+
+export {
+  ExitCode,
+  CLIError,
+  handleError
+};

package/dist/chunk-BM3PWGXQ.js

@@ -0,0 +1,14 @@
+// src/version.ts
+import { createRequire } from "module";
+var require_ = createRequire(import.meta.url);
+var resolved;
+try {
+  resolved = require_("../package.json").version ?? "0.0.0";
+} catch {
+  resolved = "0.0.0";
+}
+var CLI_VERSION = resolved;
+
+export {
+  CLI_VERSION
+};