@harness-engineering/cli 1.8.2 → 1.10.0

package/dist/chunk-MDUK2J2O.js

@@ -0,0 +1,67 @@
+// src/skill/schema.ts
+import { z } from "zod";
+var SkillPhaseSchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  required: z.boolean().default(true)
+});
+var SkillCliSchema = z.object({
+  command: z.string(),
+  args: z.array(
+    z.object({
+      name: z.string(),
+      description: z.string(),
+      required: z.boolean().default(false)
+    })
+  ).default([])
+});
+var SkillMcpSchema = z.object({
+  tool: z.string(),
+  input: z.record(z.string())
+});
+var SkillStateSchema = z.object({
+  persistent: z.boolean().default(false),
+  files: z.array(z.string()).default([])
+});
+var ALLOWED_TRIGGERS = [
+  "manual",
+  "on_pr",
+  "on_commit",
+  "on_new_feature",
+  "on_bug_fix",
+  "on_refactor",
+  "on_project_init",
+  "on_review",
+  "on_milestone",
+  "on_task_complete",
+  "on_doc_check"
+];
+var ALLOWED_PLATFORMS = ["claude-code", "gemini-cli"];
+var ALLOWED_COGNITIVE_MODES = [
+  "adversarial-reviewer",
+  "constructive-architect",
+  "meticulous-implementer",
+  "diagnostic-investigator",
+  "advisory-guide",
+  "meticulous-verifier"
+];
+var SkillMetadataSchema = z.object({
+  name: z.string().regex(/^[a-z][a-z0-9-]*$/, "Name must be lowercase with hyphens"),
+  version: z.string().regex(/^\d+\.\d+\.\d+$/, "Version must be semver format"),
+  description: z.string(),
+  cognitive_mode: z.string().regex(/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/, "Cognitive mode must be kebab-case").optional(),
+  triggers: z.array(z.enum(ALLOWED_TRIGGERS)),
+  platforms: z.array(z.enum(ALLOWED_PLATFORMS)),
+  tools: z.array(z.string()),
+  cli: SkillCliSchema.optional(),
+  mcp: SkillMcpSchema.optional(),
+  type: z.enum(["rigid", "flexible"]),
+  phases: z.array(SkillPhaseSchema).optional(),
+  state: SkillStateSchema.default({}),
+  depends_on: z.array(z.string()).default([])
+});
+
+export {
+  ALLOWED_COGNITIVE_MODES,
+  SkillMetadataSchema
+};

package/dist/chunk-MHBMTPW7.js

@@ -0,0 +1,29 @@
+// ../types/dist/index.mjs
+function Ok(value) {
+  return { ok: true, value };
+}
+function Err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok === true;
+}
+function isErr(result) {
+  return result.ok === false;
+}
+var STANDARD_COGNITIVE_MODES = [
+  "adversarial-reviewer",
+  "constructive-architect",
+  "meticulous-implementer",
+  "diagnostic-investigator",
+  "advisory-guide",
+  "meticulous-verifier"
+];
+
+export {
+  Ok,
+  Err,
+  isOk,
+  isErr,
+  STANDARD_COGNITIVE_MODES
+};

package/dist/chunk-MO4YQOMB.js

@@ -0,0 +1,85 @@
+import {
+  resolveProjectConfig
+} from "./chunk-K6XAPGML.js";
+import {
+  resultToMcpResponse
+} from "./chunk-IDZNPTYD.js";
+import {
+  sanitizePath
+} from "./chunk-W6Y7ZW3Y.js";
+
+// src/mcp/tools/architecture.ts
+var checkDependenciesDefinition = {
+  name: "check_dependencies",
+  description: "Validate layer boundaries and detect circular dependencies",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: { type: "string", description: "Path to project root" }
+    },
+    required: ["path"]
+  }
+};
+async function handleCheckDependencies(input) {
+  let projectPath;
+  try {
+    projectPath = sanitizePath(input.path);
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error instanceof Error ? error.message : String(error)}`
+        }
+      ],
+      isError: true
+    };
+  }
+  const configResult = resolveProjectConfig(projectPath);
+  if (!configResult.ok) return resultToMcpResponse(configResult);
+  try {
+    const { validateDependencies, TypeScriptParser } = await import("./dist-PBTNVK6K.js");
+    const config = configResult.value;
+    const rawLayers = Array.isArray(config.layers) ? config.layers : [];
+    const layers = rawLayers.map((l) => ({
+      name: l.name,
+      patterns: [l.pattern],
+      allowedDependencies: l.allowedDependencies
+    }));
+    const parser = new TypeScriptParser();
+    const { loadGraphStore } = await import("./graph-loader-RLO3KRIX.js");
+    const store = await loadGraphStore(projectPath);
+    let graphDependencyData;
+    if (store) {
+      const { GraphConstraintAdapter } = await import("./dist-I7DB5VKB.js");
+      const adapter = new GraphConstraintAdapter(store);
+      const graphData = adapter.computeDependencyGraph();
+      graphDependencyData = {
+        nodes: [...graphData.nodes],
+        edges: graphData.edges.map((e) => ({ ...e }))
+      };
+    }
+    const result = await validateDependencies({
+      layers,
+      rootDir: projectPath,
+      parser,
+      ...graphDependencyData !== void 0 && { graphDependencyData }
+    });
+    return resultToMcpResponse(result);
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error instanceof Error ? error.message : String(error)}`
+        }
+      ],
+      isError: true
+    };
+  }
+}
+
+export {
+  checkDependenciesDefinition,
+  handleCheckDependencies
+};

package/dist/chunk-NKDM3FMH.js

@@ -0,0 +1,52 @@
+import {
+  Err,
+  Ok
+} from "./chunk-MHBMTPW7.js";
+
+// src/persona/generators/agents-md.ts
+function formatTrigger(trigger) {
+  switch (trigger.event) {
+    case "on_pr": {
+      const paths = trigger.conditions?.paths?.join(", ") ?? "all files";
+      return `On PR (${paths})`;
+    }
+    case "on_commit": {
+      const branches = trigger.conditions?.branches?.join(", ") ?? "all branches";
+      return `On commit (${branches})`;
+    }
+    case "scheduled":
+      return `Scheduled (cron: ${trigger.cron})`;
+    case "manual":
+      return "Manual";
+  }
+}
+function generateAgentsMd(persona) {
+  try {
+    const triggers = persona.triggers.map(formatTrigger).join(", ");
+    const skills = persona.skills.join(", ");
+    const commands = persona.steps.filter((s) => "command" in s).map((s) => `\`harness ${s.command}\``).join(", ");
+    const stepSkills = persona.steps.filter((s) => "skill" in s).map((s) => `\`harness skill run ${s.skill}\``).join(", ");
+    const allCommands = [commands, stepSkills].filter(Boolean).join(", ");
+    const fragment = `## ${persona.name} Agent
+
+**Role:** ${persona.role}
+
+**Triggers:** ${triggers}
+
+**Skills:** ${skills}
+
+**When this agent flags an issue:** Fix violations before merging. Run ${allCommands} locally to validate.
+`;
+    return Ok(fragment);
+  } catch (error) {
+    return Err(
+      new Error(
+        `Failed to generate AGENTS.md fragment: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+}
+
+export {
+  generateAgentsMd
+};

package/dist/{chunk-SAB3VXOW.js → chunk-NX6DSZSM.js}

@@ -1,24 +1,7 @@
-// ../types/dist/index.mjs
-function Ok(value) {
-  return { ok: true, value };
-}
-function Err(error) {
-  return { ok: false, error };
-}
-function isOk(result) {
-  return result.ok === true;
-}
-function isErr(result) {
-  return result.ok === false;
-}
-var STANDARD_COGNITIVE_MODES = [
-  "adversarial-reviewer",
-  "constructive-architect",
-  "meticulous-implementer",
-  "diagnostic-investigator",
-  "advisory-guide",
-  "meticulous-verifier"
-];
+import {
+  Err,
+  Ok
+} from "./chunk-MHBMTPW7.js";
 
 // ../core/dist/index.mjs
 import { access, constants, readFile } from "fs";
@@ -4969,6 +4952,15 @@ var FAILURES_FILE = "failures.md";
 var HANDOFF_FILE = "handoff.json";
 var GATE_CONFIG_FILE = "gate.json";
 var INDEX_FILE2 = "index.json";
+var MAX_CACHE_ENTRIES = 8;
+var learningsCacheMap = /* @__PURE__ */ new Map();
+var failuresCacheMap = /* @__PURE__ */ new Map();
+function evictIfNeeded(map) {
+  if (map.size > MAX_CACHE_ENTRIES) {
+    const oldest = map.keys().next().value;
+    if (oldest !== void 0) map.delete(oldest);
+  }
+}
 async function getStateDir(projectPath, stream) {
   const streamsIndexPath = path3.join(projectPath, HARNESS_DIR2, "streams", INDEX_FILE2);
   const hasStreams = fs4.existsSync(streamsIndexPath);
@@ -5048,6 +5040,7 @@ ${entry}`);
     } else {
       fs4.appendFileSync(learningsPath, entry);
     }
+    learningsCacheMap.delete(learningsPath);
     return Ok(void 0);
   } catch (error) {
     return Err(
@@ -5066,25 +5059,35 @@ async function loadRelevantLearnings(projectPath, skillName, stream) {
     if (!fs4.existsSync(learningsPath)) {
       return Ok([]);
     }
-    const content = fs4.readFileSync(learningsPath, "utf-8");
-    const lines = content.split("\n");
-    const entries = [];
-    let currentBlock = [];
-    for (const line of lines) {
-      if (line.startsWith("# ")) continue;
-      const isDatedBullet = /^- \*\*\d{4}-\d{2}-\d{2}/.test(line);
-      const isHeading = /^## \d{4}-\d{2}-\d{2}/.test(line);
-      if (isDatedBullet || isHeading) {
-        if (currentBlock.length > 0) {
-          entries.push(currentBlock.join("\n"));
+    const stats = fs4.statSync(learningsPath);
+    const cacheKey = learningsPath;
+    const cached = learningsCacheMap.get(cacheKey);
+    let entries;
+    if (cached && cached.mtimeMs === stats.mtimeMs) {
+      entries = cached.entries;
+    } else {
+      const content = fs4.readFileSync(learningsPath, "utf-8");
+      const lines = content.split("\n");
+      entries = [];
+      let currentBlock = [];
+      for (const line of lines) {
+        if (line.startsWith("# ")) continue;
+        const isDatedBullet = /^- \*\*\d{4}-\d{2}-\d{2}/.test(line);
+        const isHeading = /^## \d{4}-\d{2}-\d{2}/.test(line);
+        if (isDatedBullet || isHeading) {
+          if (currentBlock.length > 0) {
+            entries.push(currentBlock.join("\n"));
+          }
+          currentBlock = [line];
+        } else if (line.trim() !== "" && currentBlock.length > 0) {
+          currentBlock.push(line);
         }
-        currentBlock = [line];
-      } else if (line.trim() !== "" && currentBlock.length > 0) {
-        currentBlock.push(line);
       }
-    }
-    if (currentBlock.length > 0) {
-      entries.push(currentBlock.join("\n"));
+      if (currentBlock.length > 0) {
+        entries.push(currentBlock.join("\n"));
+      }
+      learningsCacheMap.set(cacheKey, { mtimeMs: stats.mtimeMs, entries });
+      evictIfNeeded(learningsCacheMap);
     }
     if (!skillName) {
       return Ok(entries);
@@ -5117,6 +5120,7 @@ ${entry}`);
     } else {
       fs4.appendFileSync(failuresPath, entry);
     }
+    failuresCacheMap.delete(failuresPath);
     return Ok(void 0);
   } catch (error) {
     return Err(
@@ -5135,6 +5139,12 @@ async function loadFailures(projectPath, stream) {
     if (!fs4.existsSync(failuresPath)) {
       return Ok([]);
     }
+    const stats = fs4.statSync(failuresPath);
+    const cacheKey = failuresPath;
+    const cached = failuresCacheMap.get(cacheKey);
+    if (cached && cached.mtimeMs === stats.mtimeMs) {
+      return Ok(cached.entries);
+    }
     const content = fs4.readFileSync(failuresPath, "utf-8");
     const entries = [];
     for (const line of content.split("\n")) {
@@ -5148,6 +5158,8 @@ async function loadFailures(projectPath, stream) {
         });
       }
     }
+    failuresCacheMap.set(cacheKey, { mtimeMs: stats.mtimeMs, entries });
+    evictIfNeeded(failuresCacheMap);
     return Ok(entries);
   } catch (error) {
     return Err(
@@ -5176,6 +5188,7 @@ async function archiveFailures(projectPath, stream) {
       counter++;
     }
     fs4.renameSync(failuresPath, path3.join(archiveDir, archiveName));
+    failuresCacheMap.delete(failuresPath);
     return Ok(void 0);
   } catch (error) {
     return Err(
@@ -6199,14 +6212,22 @@ async function runCIChecks(input) {
   const { projectRoot, config, skip = [], failOn = "error" } = input;
   try {
     const checks = [];
-    for (const name of ALL_CHECKS) {
-      if (skip.includes(name)) {
-        checks.push({ name, status: "skip", issues: [], durationMs: 0 });
-      } else {
-        const result = await runSingleCheck(name, projectRoot, config);
-        checks.push(result);
-      }
+    const skippedSet = new Set(skip);
+    if (skippedSet.has("validate")) {
+      checks.push({ name: "validate", status: "skip", issues: [], durationMs: 0 });
+    } else {
+      checks.push(await runSingleCheck("validate", projectRoot, config));
     }
+    const remainingChecks = ALL_CHECKS.slice(1);
+    const phase2Results = await Promise.all(
+      remainingChecks.map(async (name) => {
+        if (skippedSet.has(name)) {
+          return { name, status: "skip", issues: [], durationMs: 0 };
+        }
+        return runSingleCheck(name, projectRoot, config);
+      })
+    );
+    checks.push(...phase2Results);
     const summary = buildSummary(checks);
     const exitCode = determineExitCode(summary, failOn);
     const report = {
@@ -6328,76 +6349,93 @@ async function runMechanicalChecks(options) {
       });
     }
   }
+  const parallelChecks = [];
   if (!skip.includes("check-docs")) {
-    try {
-      const docsDir = path6.join(projectRoot, config.docsDir ?? "docs");
-      const result = await checkDocCoverage("project", { docsDir });
-      if (!result.ok) {
-        statuses["check-docs"] = "warn";
-        findings.push({
-          tool: "check-docs",
-          file: docsDir,
-          message: result.error.message,
-          severity: "warning"
-        });
-      } else if (result.value.gaps && result.value.gaps.length > 0) {
-        statuses["check-docs"] = "warn";
-        for (const gap of result.value.gaps) {
-          findings.push({
+    parallelChecks.push(
+      (async () => {
+        const localFindings = [];
+        try {
+          const docsDir = path6.join(projectRoot, config.docsDir ?? "docs");
+          const result = await checkDocCoverage("project", { docsDir });
+          if (!result.ok) {
+            statuses["check-docs"] = "warn";
+            localFindings.push({
+              tool: "check-docs",
+              file: docsDir,
+              message: result.error.message,
+              severity: "warning"
+            });
+          } else if (result.value.gaps && result.value.gaps.length > 0) {
+            statuses["check-docs"] = "warn";
+            for (const gap of result.value.gaps) {
+              localFindings.push({
+                tool: "check-docs",
+                file: gap.file,
+                message: `Undocumented: ${gap.file} (suggested: ${gap.suggestedSection})`,
+                severity: "warning"
+              });
+            }
+          } else {
+            statuses["check-docs"] = "pass";
+          }
+        } catch (err) {
+          statuses["check-docs"] = "warn";
+          localFindings.push({
             tool: "check-docs",
-            file: gap.file,
-            message: `Undocumented: ${gap.file} (suggested: ${gap.suggestedSection})`,
+            file: path6.join(projectRoot, "docs"),
+            message: err instanceof Error ? err.message : String(err),
             severity: "warning"
           });
         }
-      } else {
-        statuses["check-docs"] = "pass";
-      }
-    } catch (err) {
-      statuses["check-docs"] = "warn";
-      findings.push({
-        tool: "check-docs",
-        file: path6.join(projectRoot, "docs"),
-        message: err instanceof Error ? err.message : String(err),
-        severity: "warning"
-      });
-    }
+        return localFindings;
+      })()
+    );
   }
   if (!skip.includes("security-scan")) {
-    try {
-      const securityConfig = parseSecurityConfig(config.security);
-      if (!securityConfig.enabled) {
-        statuses["security-scan"] = "skip";
-      } else {
-        const scanner = new SecurityScanner(securityConfig);
-        scanner.configureForProject(projectRoot);
-        const filesToScan = changedFiles ?? [];
-        const scanResult = await scanner.scanFiles(filesToScan);
-        if (scanResult.findings.length > 0) {
-          statuses["security-scan"] = "warn";
-          for (const f of scanResult.findings) {
-            findings.push({
-              tool: "security-scan",
-              file: f.file,
-              line: f.line,
-              ruleId: f.ruleId,
-              message: f.message,
-              severity: f.severity === "info" ? "warning" : f.severity
-            });
+    parallelChecks.push(
+      (async () => {
+        const localFindings = [];
+        try {
+          const securityConfig = parseSecurityConfig(config.security);
+          if (!securityConfig.enabled) {
+            statuses["security-scan"] = "skip";
+          } else {
+            const scanner = new SecurityScanner(securityConfig);
+            scanner.configureForProject(projectRoot);
+            const filesToScan = changedFiles ?? [];
+            const scanResult = await scanner.scanFiles(filesToScan);
+            if (scanResult.findings.length > 0) {
+              statuses["security-scan"] = "warn";
+              for (const f of scanResult.findings) {
+                localFindings.push({
+                  tool: "security-scan",
+                  file: f.file,
+                  line: f.line,
+                  ruleId: f.ruleId,
+                  message: f.message,
+                  severity: f.severity === "info" ? "warning" : f.severity
+                });
+              }
+            } else {
+              statuses["security-scan"] = "pass";
+            }
           }
-        } else {
-          statuses["security-scan"] = "pass";
+        } catch (err) {
+          statuses["security-scan"] = "warn";
+          localFindings.push({
+            tool: "security-scan",
+            file: projectRoot,
+            message: err instanceof Error ? err.message : String(err),
+            severity: "warning"
+          });
         }
-      }
-    } catch (err) {
-      statuses["security-scan"] = "warn";
-      findings.push({
-        tool: "security-scan",
-        file: projectRoot,
-        message: err instanceof Error ? err.message : String(err),
-        severity: "warning"
-      });
-    }
+        return localFindings;
+      })()
+    );
+  }
+  const parallelResults = await Promise.all(parallelChecks);
+  for (const result of parallelResults) {
+    findings.push(...result);
   }
   const hasErrors = findings.some((f) => f.severity === "error");
   const stopPipeline = statuses.validate === "fail" || statuses["check-deps"] === "fail";
@@ -8203,11 +8241,6 @@ Run "harness update" to upgrade.`;
 var VERSION = "1.8.2";
 
 export {
-  Ok,
-  Err,
-  isOk,
-  isErr,
-  STANDARD_COGNITIVE_MODES,
   createError,
   validateFileStructure,
   validateConfig,

package/dist/chunk-OPXH4CQN.js

@@ -0,0 +1,62 @@
+// src/mcp/utils/graph-loader.ts
+import * as path from "path";
+import { stat } from "fs/promises";
+var MAX_CACHE_ENTRIES = 8;
+var cache = /* @__PURE__ */ new Map();
+var pending = /* @__PURE__ */ new Map();
+function clearGraphStoreCache() {
+  cache.clear();
+  pending.clear();
+}
+function evictIfNeeded() {
+  if (cache.size > MAX_CACHE_ENTRIES) {
+    const oldest = cache.keys().next().value;
+    if (oldest !== void 0) cache.delete(oldest);
+  }
+}
+async function doLoadGraphStore(projectRoot) {
+  const { GraphStore } = await import("./dist-I7DB5VKB.js");
+  const graphDir = path.join(projectRoot, ".harness", "graph");
+  const store = new GraphStore();
+  const loaded = await store.load(graphDir);
+  if (!loaded) return null;
+  return store;
+}
+async function loadGraphStore(projectRoot) {
+  const graphDir = path.join(projectRoot, ".harness", "graph");
+  const graphPath = path.join(graphDir, "graph.json");
+  let mtimeMs;
+  try {
+    const stats = await stat(graphPath);
+    mtimeMs = stats.mtimeMs;
+  } catch {
+    return null;
+  }
+  const cached = cache.get(projectRoot);
+  if (cached && cached.mtimeMs === mtimeMs) {
+    return cached.store;
+  }
+  const pendingLoad = pending.get(projectRoot);
+  let promise;
+  if (pendingLoad && pendingLoad.mtimeMs === mtimeMs) {
+    promise = pendingLoad.promise;
+  } else {
+    promise = doLoadGraphStore(projectRoot);
+    pending.set(projectRoot, { promise, mtimeMs });
+  }
+  const store = await promise;
+  const currentPending = pending.get(projectRoot);
+  if (currentPending && currentPending.promise === promise) {
+    pending.delete(projectRoot);
+  }
+  if (store !== null) {
+    cache.set(projectRoot, { store, mtimeMs });
+    evictIfNeeded();
+  }
+  return store;
+}
+
+export {
+  clearGraphStoreCache,
+  loadGraphStore
+};