@harness-engineering/cli 1.23.1 → 1.24.0

package/dist/chunk-YDRB55Q4.js

@@ -0,0 +1,135 @@
+import {
+  Err,
+  Ok
+} from "./chunk-5LMZA5LZ.js";
+
+// src/persona/loader.ts
+import * as fs from "fs";
+import * as path from "path";
+import YAML from "yaml";
+
+// src/persona/schema.ts
+import { z } from "zod";
+var TriggerContextSchema = z.enum(["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]).default("always");
+var CommandStepSchema = z.object({
+  command: z.string(),
+  when: TriggerContextSchema
+});
+var SkillStepSchema = z.object({
+  skill: z.string(),
+  when: TriggerContextSchema,
+  output: z.enum(["inline", "artifact", "auto"]).default("auto")
+});
+var StepSchema = z.union([CommandStepSchema, SkillStepSchema]);
+var PersonaTriggerSchema = z.discriminatedUnion("event", [
+  z.object({
+    event: z.literal("on_pr"),
+    conditions: z.object({
+      paths: z.array(z.string()).optional(),
+      min_files: z.number().optional()
+    }).optional()
+  }),
+  z.object({
+    event: z.literal("on_commit"),
+    conditions: z.object({ branches: z.array(z.string()).optional() }).optional()
+  }),
+  z.object({
+    event: z.literal("scheduled"),
+    cron: z.string()
+  }),
+  z.object({
+    event: z.literal("manual")
+  })
+]);
+var PersonaConfigSchema = z.object({
+  severity: z.enum(["error", "warning"]).default("error"),
+  autoFix: z.boolean().default(false),
+  timeout: z.number().default(3e5)
+});
+var PersonaOutputsSchema = z.object({
+  "agents-md": z.boolean().default(true),
+  "ci-workflow": z.boolean().default(true),
+  "runtime-config": z.boolean().default(true)
+});
+var PersonaSchemaV1 = z.object({
+  version: z.literal(1),
+  name: z.string(),
+  description: z.string(),
+  role: z.string(),
+  skills: z.array(z.string()),
+  commands: z.array(z.string()),
+  triggers: z.array(PersonaTriggerSchema),
+  config: PersonaConfigSchema.default({}),
+  outputs: PersonaOutputsSchema.default({})
+});
+var PersonaSchemaV2 = z.object({
+  version: z.literal(2),
+  name: z.string(),
+  description: z.string(),
+  role: z.string(),
+  skills: z.array(z.string()),
+  steps: z.array(StepSchema),
+  triggers: z.array(PersonaTriggerSchema),
+  config: PersonaConfigSchema.default({}),
+  outputs: PersonaOutputsSchema.default({})
+});
+var PersonaSchema = z.union([PersonaSchemaV1, PersonaSchemaV2]);
+
+// src/persona/loader.ts
+function normalizePersona(raw) {
+  if (raw.version === 1 && Array.isArray(raw.commands)) {
+    const { commands, ...rest } = raw;
+    return {
+      ...rest,
+      steps: commands.map((cmd) => ({
+        command: cmd,
+        when: "always"
+      }))
+    };
+  }
+  return raw;
+}
+function loadPersona(filePath) {
+  try {
+    if (!fs.existsSync(filePath)) {
+      return Err(new Error(`Persona file not found: ${filePath}`));
+    }
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const parsed = YAML.parse(raw);
+    const result = PersonaSchema.safeParse(parsed);
+    if (!result.success) {
+      return Err(new Error(`Invalid persona ${filePath}: ${result.error.message}`));
+    }
+    return Ok(normalizePersona(result.data));
+  } catch (error) {
+    return Err(
+      new Error(`Failed to load persona: ${error instanceof Error ? error.message : String(error)}`)
+    );
+  }
+}
+function listPersonas(dir) {
+  try {
+    if (!fs.existsSync(dir)) return Ok([]);
+    const entries = fs.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
+    const personas = [];
+    for (const entry of entries) {
+      const filePath = path.join(dir, entry);
+      const result = loadPersona(filePath);
+      if (result.ok) {
+        personas.push({ name: result.value.name, description: result.value.description, filePath });
+      }
+    }
+    return Ok(personas);
+  } catch (error) {
+    return Err(
+      new Error(
+        `Failed to list personas: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+
+export {
+  loadPersona,
+  listPersonas
+};

package/dist/chunk-ZOIGL5PP.js

@@ -0,0 +1,327 @@
+import {
+  ArchConfigSchema
+} from "./chunk-WPFFEDTO.js";
+import {
+  Err,
+  Ok
+} from "./chunk-5LMZA5LZ.js";
+import {
+  CLIError,
+  ExitCode
+} from "./chunk-3WGJMBKH.js";
+
+// 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({
+  /** Human-readable name of the layer */
+  name: z.string(),
+  /** Glob pattern matching files in this layer */
+  pattern: z.string(),
+  /** Names of other layers this layer is allowed to import from */
+  allowedDependencies: z.array(z.string())
+});
+var ForbiddenImportSchema = z.object({
+  /** Glob pattern matching source files this rule applies to */
+  from: z.string(),
+  /** List of modules or patterns that are not allowed to be imported */
+  disallow: z.array(z.string()),
+  /** Optional custom message to display on violation */
+  message: z.string().optional()
+});
+var BoundaryConfigSchema = z.object({
+  /** List of globs where files MUST have a corresponding schema/definition */
+  requireSchema: z.array(z.string())
+});
+var AgentConfigSchema = z.object({
+  /** The execution environment for agents */
+  executor: z.enum(["subprocess", "cloud", "noop"]).default("subprocess"),
+  /** Maximum execution time in milliseconds */
+  timeout: z.number().default(3e5),
+  /** Optional list of skill IDs pre-authorized for the agent */
+  skills: z.array(z.string()).optional()
+});
+var EntropyConfigSchema = z.object({
+  /** Patterns to exclude from entropy analysis */
+  excludePatterns: z.array(z.string()).default(["**/node_modules/**", "**/*.test.ts"]),
+  /** Whether to automatically attempt to fix simple entropy issues */
+  autoFix: z.boolean().default(false)
+});
+var PhaseGateMappingSchema = z.object({
+  /** Pattern for implementation files */
+  implPattern: z.string(),
+  /** Pattern for corresponding specification files */
+  specPattern: z.string(),
+  /** When true, validate that the spec file contains a numbered requirements section */
+  contentValidation: z.boolean().default(false)
+});
+var PhaseGatesConfigSchema = z.object({
+  /** Whether phase gate checks are enabled */
+  enabled: z.boolean().default(false),
+  /** Severity level when a phase gate check fails */
+  severity: z.enum(["error", "warning"]).default("error"),
+  /** List of implementation-to-spec mappings */
+  mappings: z.array(PhaseGateMappingSchema).default([{ implPattern: "src/**/*.ts", specPattern: "docs/changes/{feature}/proposal.md" }])
+});
+var SecurityConfigSchema = z.object({
+  /** Whether security scanning is enabled */
+  enabled: z.boolean().default(true),
+  /** Whether to fail on any security warning */
+  strict: z.boolean().default(false),
+  /** Rule-specific severity overrides */
+  rules: z.record(z.string(), z.enum(["off", "error", "warning", "info"])).optional(),
+  /** Patterns to exclude from security scans */
+  exclude: z.array(z.string()).optional()
+}).passthrough();
+var PerformanceConfigSchema = z.object({
+  /** Complexity thresholds per module or pattern */
+  complexity: z.record(z.unknown()).optional(),
+  /** Coupling limits between modules */
+  coupling: z.record(z.unknown()).optional(),
+  /** Size budget for bundles or directories */
+  sizeBudget: z.record(z.unknown()).optional()
+}).passthrough();
+var DesignConfigSchema = z.object({
+  /** Strictness of design system enforcement */
+  strictness: z.enum(["strict", "standard", "permissive"]).default("standard"),
+  /** Supported target platforms */
+  platforms: z.array(z.enum(["web", "mobile"])).default([]),
+  /** Path to design tokens (e.g. JSON or CSS) */
+  tokenPath: z.string().optional(),
+  /** Brief description of the intended aesthetic direction */
+  aestheticIntent: z.string().optional()
+});
+var I18nCoverageConfigSchema = z.object({
+  /** Minimum required translation percentage */
+  minimumPercent: z.number().min(0).max(100).default(100),
+  /** Whether plural forms are required for all keys */
+  requirePlurals: z.boolean().default(true),
+  /** Whether to detect untranslated strings in source code */
+  detectUntranslated: z.boolean().default(true)
+});
+var I18nMcpConfigSchema = z.object({
+  /** Name or URL of the MCP server */
+  server: z.string(),
+  /** Project ID on the remote i18n platform */
+  projectId: z.string().optional()
+});
+var I18nConfigSchema = z.object({
+  /** Whether i18n management is enabled */
+  enabled: z.boolean().default(false),
+  /** Strictness of i18n rule enforcement */
+  strictness: z.enum(["strict", "standard", "permissive"]).default("standard"),
+  /** The primary language used for development */
+  sourceLocale: z.string().default("en"),
+  /** List of locales that translations are required for */
+  targetLocales: z.array(z.string()).default([]),
+  /** The i18n framework in use */
+  framework: z.enum([
+    "auto",
+    "i18next",
+    "react-intl",
+    "vue-i18n",
+    "flutter-intl",
+    "apple",
+    "android",
+    "custom"
+  ]).default("auto"),
+  /** Storage format for translation files */
+  format: z.string().default("json"),
+  /** Syntax used for message formatting */
+  messageFormat: z.enum(["icu", "i18next", "custom"]).default("icu"),
+  /** Convention for translation keys */
+  keyConvention: z.enum(["dot-notation", "snake_case", "camelCase", "custom"]).default("dot-notation"),
+  /** Mapping of locales to their file paths */
+  translationPaths: z.record(z.string(), z.string()).optional(),
+  /** Platforms targeted by this configuration */
+  platforms: z.array(z.enum(["web", "mobile", "backend"])).default([]),
+  /** Industry vertical (for contextual translations) */
+  industry: z.string().optional(),
+  /** Translation coverage requirements */
+  coverage: I18nCoverageConfigSchema.optional(),
+  /** Locale used for pseudo-localization testing */
+  pseudoLocale: z.string().optional(),
+  /** MCP server for AI-assisted translation */
+  mcp: I18nMcpConfigSchema.optional()
+});
+var ModelTierConfigSchema = z.object({
+  /** Model ID to use for fast/cheap operations */
+  fast: z.string().optional(),
+  /** Model ID to use for standard reasoning tasks */
+  standard: z.string().optional(),
+  /** Model ID to use for complex/critical analysis */
+  strong: z.string().optional()
+});
+var ReviewConfigSchema = z.object({
+  /** Custom model tier mappings for reviewers */
+  model_tiers: ModelTierConfigSchema.optional()
+});
+var IntegrationsConfigSchema = z.object({
+  /** Tier 1 integrations explicitly enabled by the user */
+  enabled: z.array(z.string()).default([]),
+  /** Integrations the user does not want doctor to suggest */
+  dismissed: z.array(z.string()).default([])
+});
+var TrackerConfigSchema = z.object({
+  /** Tracker kind — currently only 'github' is supported */
+  kind: z.literal("github"),
+  /** Repository in "owner/repo" format */
+  repo: z.string().optional(),
+  /** Labels auto-applied to synced issues for filtering */
+  labels: z.array(z.string()).optional(),
+  /** Maps roadmap status -> external status */
+  statusMap: z.record(z.enum(["backlog", "planned", "in-progress", "done", "blocked"]), z.string()),
+  /** Maps external status (optionally with label) -> roadmap status */
+  reverseStatusMap: z.record(z.string(), z.string()).optional()
+});
+var RoadmapConfigSchema = z.object({
+  /** External tracker sync settings */
+  tracker: TrackerConfigSchema.optional()
+});
+var HarnessConfigSchema = z.object({
+  /** Configuration schema version */
+  version: z.literal(1),
+  /** Human-readable name of the project */
+  name: z.string().optional(),
+  /** Root directory of the project, relative to the config file */
+  rootDir: z.string().default("."),
+  /** Layered architecture definitions */
+  layers: z.array(LayerSchema).optional(),
+  /** Rules for forbidden cross-module imports */
+  forbiddenImports: z.array(ForbiddenImportSchema).optional(),
+  /** Boundary enforcement settings */
+  boundaries: BoundaryConfigSchema.optional(),
+  /** Path to the project's knowledge map (AGENTS.md) */
+  agentsMapPath: z.string().default("./AGENTS.md"),
+  /** Directory containing project documentation */
+  docsDir: z.string().default("./docs"),
+  /** Agent orchestration settings */
+  agent: AgentConfigSchema.optional(),
+  /** Drift and stale code management settings */
+  entropy: EntropyConfigSchema.optional(),
+  /** Security scanning configuration */
+  security: SecurityConfigSchema.optional(),
+  /** Performance and complexity budget settings */
+  performance: PerformanceConfigSchema.optional(),
+  /** Project template settings (used by 'harness init') */
+  template: z.object({
+    /** Complexity level of the template (JS/TS only) */
+    level: z.enum(["basic", "intermediate", "advanced"]).optional(),
+    /** Target language */
+    language: z.enum(["typescript", "python", "go", "rust", "java"]).optional(),
+    /** Primary technology framework */
+    framework: z.string().optional(),
+    /** Template version */
+    version: z.number(),
+    /** Language-specific tooling configuration */
+    tooling: z.object({
+      packageManager: z.string().optional(),
+      linter: z.string().optional(),
+      formatter: z.string().optional(),
+      buildTool: z.string().optional(),
+      testRunner: z.string().optional(),
+      lockFile: z.string().optional()
+    }).optional()
+  }).optional(),
+  /** Phase gate and readiness check configuration */
+  phaseGates: PhaseGatesConfigSchema.optional(),
+  /** Design system consistency settings */
+  design: DesignConfigSchema.optional(),
+  /** Internationalization (i18n) settings */
+  i18n: I18nConfigSchema.optional(),
+  /** Code review settings */
+  review: ReviewConfigSchema.optional(),
+  /** MCP peer integration enablement and dismissal */
+  integrations: IntegrationsConfigSchema.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(),
+  /** Spec-to-implementation traceability check settings */
+  traceability: z.object({
+    /** Whether traceability checks are enabled */
+    enabled: z.boolean().default(true),
+    /** Severity level when traceability coverage is below threshold */
+    severity: z.enum(["error", "warning"]).default("warning"),
+    /** Minimum required coverage percentage (0-100) */
+    minCoverage: z.number().min(0).max(100).default(0),
+    /** Glob patterns for specs to include in traceability checks */
+    includeSpecs: z.array(z.string()).default(["docs/changes/*/proposal.md"]),
+    /** Glob patterns for specs to exclude from traceability checks */
+    excludeSpecs: z.array(z.string()).default([])
+  }).optional(),
+  /** Roadmap sync and tracker integration settings */
+  roadmap: RoadmapConfigSchema.optional(),
+  /** How often (in ms) to check for CLI updates */
+  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);
+}
+
+export {
+  TrackerConfigSchema,
+  findConfigFile,
+  loadConfig,
+  resolveConfig
+};

package/dist/ci-workflow-YE7B375K.js

@@ -0,0 +1,9 @@
+import {
+  generateCIWorkflow
+} from "./chunk-LOUH2LIC.js";
+import "./chunk-WPFFEDTO.js";
+import "./chunk-5LMZA5LZ.js";
+import "./chunk-MY5DBCJZ.js";
+export {
+  generateCIWorkflow
+};

package/dist/create-skill-LTLAAJPC.js

@@ -0,0 +1,11 @@
+import {
+  createCreateSkillCommand,
+  generateSkillFiles
+} from "./chunk-ICPZNX6O.js";
+import "./chunk-EBJQ6N4M.js";
+import "./chunk-BKHS7RPB.js";
+import "./chunk-3WGJMBKH.js";
+export {
+  createCreateSkillCommand,
+  generateSkillFiles
+};