cc-agent-harness 0.0.1

package/dist/setup-CWDCKM34.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import {
+  getTemplatesDir
+} from "./chunk-PQWK2OBN.js";
+import {
+  render
+} from "./chunk-JKJ3FP6T.js";
+import {
+  HarnessRuntime,
+  detectLanguage
+} from "./chunk-R6VGYQOH.js";
+import "./chunk-3P72TGGQ.js";
+import "./chunk-LOE6IDTT.js";
+
+// src/cli/setup.ts
+import { mkdir, writeFile, readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { resolve, join, basename } from "path";
+import { stringify as yamlStringify } from "yaml";
+async function runSetup(opts) {
+  const cwd = process.cwd();
+  const harnessDir = resolve(cwd, ".harness");
+  const preRuntime = await HarnessRuntime.create();
+  console.log("Agent Harness Setup");
+  console.log("===================\n");
+  const language = opts.language ?? detectLanguage(cwd);
+  const variant = opts.template ?? "standard";
+  await preRuntime.dispatchHooks("setup.pre", {
+    command: "setup",
+    language,
+    template: variant
+  });
+  console.log(`  Detected language: ${language}`);
+  console.log(`  Template variant:  ${variant}
+`);
+  if (existsSync(harnessDir)) {
+    console.log("  .harness/ directory already exists \u2014 updating configuration.\n");
+  } else {
+    await mkdir(harnessDir, { recursive: true });
+    console.log("  Created .harness/ directory.");
+  }
+  const skillsDir = resolve(harnessDir, "skills");
+  if (!existsSync(skillsDir)) {
+    await mkdir(skillsDir, { recursive: true });
+    console.log("  Created .harness/skills/ directory.");
+  }
+  const configPath = resolve(harnessDir, "harness.config.yaml");
+  const projectName = basename(cwd) || "my-project";
+  const config = {
+    project: {
+      name: projectName,
+      language,
+      description: ""
+    },
+    agents: {
+      delegation_first: true,
+      model_routing: {
+        low: "low",
+        medium: "medium",
+        high: "high"
+      }
+    },
+    skills: {
+      directories: [".harness/skills"],
+      auto_detect: true
+    },
+    workflows: {
+      verification: {
+        checks: ["build", "test", "lint"]
+      }
+    },
+    templates: {
+      agents_md: {
+        variant
+      }
+    }
+  };
+  await writeFile(configPath, yamlStringify(config), "utf-8");
+  console.log("  Generated harness.config.yaml.");
+  const agentsMdPath = resolve(cwd, "AGENTS.md");
+  if (!existsSync(agentsMdPath)) {
+    const templatesDir = getTemplatesDir();
+    const templateFile = join(templatesDir, "agents-md", `${variant}.md.tmpl`);
+    if (existsSync(templateFile)) {
+      const template = await readFile(templateFile, "utf-8");
+      const rendered = render(template, {
+        projectName,
+        language,
+        delegationFirst: "true",
+        customRules: []
+      });
+      await writeFile(agentsMdPath, rendered, "utf-8");
+      console.log(`  Generated AGENTS.md (${variant} variant).`);
+    } else {
+      console.log(`  Template ${variant}.md.tmpl not found \u2014 skipping AGENTS.md generation.`);
+    }
+  } else {
+    console.log("  AGENTS.md already exists \u2014 skipping (use `agent-harness update` to refresh).");
+  }
+  const postRuntime = await HarnessRuntime.create();
+  await postRuntime.dispatchHooks("setup.post", {
+    command: "setup",
+    language,
+    template: variant
+  });
+  await postRuntime.log("setup", "Setup completed", {
+    language,
+    template: variant
+  });
+  console.log("\nSetup complete! Run `agent-harness doctor` to verify.");
+}
+export {
+  runSetup
+};
+//# sourceMappingURL=setup-CWDCKM34.js.map

package/dist/setup-CWDCKM34.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/setup.ts"],"sourcesContent":["import { mkdir, writeFile, readFile } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { resolve, join, basename } from \"node:path\";\nimport { stringify as yamlStringify } from \"yaml\";\nimport { detectLanguage } from \"../adapter/detector.js\";\nimport { render } from \"../template/engine.js\";\nimport { getTemplatesDir } from \"./utils.js\";\nimport { HarnessRuntime } from \"../runtime/harness.js\";\n\nexport interface SetupOptions {\n  language?: string;\n  template?: string;\n}\n\nexport async function runSetup(opts: SetupOptions): Promise<void> {\n  const cwd = process.cwd();\n  const harnessDir = resolve(cwd, \".harness\");\n  const preRuntime = await HarnessRuntime.create();\n\n  console.log(\"Agent Harness Setup\");\n  console.log(\"===================\\n\");\n\n  const language = opts.language ?? detectLanguage(cwd);\n  const variant = opts.template ?? \"standard\";\n\n  await preRuntime.dispatchHooks(\"setup.pre\", {\n    command: \"setup\",\n    language,\n    template: variant,\n  });\n\n  console.log(`  Detected language: ${language}`);\n  console.log(`  Template variant:  ${variant}\\n`);\n\n  if (existsSync(harnessDir)) {\n    console.log(\"  .harness/ directory already exists — updating configuration.\\n\");\n  } else {\n    await mkdir(harnessDir, { recursive: true });\n    console.log(\"  Created .harness/ directory.\");\n  }\n\n  const skillsDir = resolve(harnessDir, \"skills\");\n  if (!existsSync(skillsDir)) {\n    await mkdir(skillsDir, { recursive: true });\n    console.log(\"  Created .harness/skills/ directory.\");\n  }\n\n  const configPath = resolve(harnessDir, \"harness.config.yaml\");\n  const projectName = basename(cwd) || \"my-project\";\n\n  const config = {\n    project: {\n      name: projectName,\n      language,\n      description: \"\",\n    },\n    agents: {\n      delegation_first: true,\n      model_routing: {\n        low: \"low\",\n        medium: \"medium\",\n        high: \"high\",\n      },\n    },\n    skills: {\n      directories: [\".harness/skills\"],\n      auto_detect: true,\n    },\n    workflows: {\n      verification: {\n        checks: [\"build\", \"test\", \"lint\"],\n      },\n    },\n    templates: {\n      agents_md: {\n        variant,\n      },\n    },\n  };\n\n  await writeFile(configPath, yamlStringify(config), \"utf-8\");\n  console.log(\"  Generated harness.config.yaml.\");\n\n  const agentsMdPath = resolve(cwd, \"AGENTS.md\");\n  if (!existsSync(agentsMdPath)) {\n    const templatesDir = getTemplatesDir();\n    const templateFile = join(templatesDir, \"agents-md\", `${variant}.md.tmpl`);\n\n    if (existsSync(templateFile)) {\n      const template = await readFile(templateFile, \"utf-8\");\n      const rendered = render(template, {\n        projectName,\n        language,\n        delegationFirst: \"true\",\n        customRules: [],\n      });\n      await writeFile(agentsMdPath, rendered, \"utf-8\");\n      console.log(`  Generated AGENTS.md (${variant} variant).`);\n    } else {\n      console.log(`  Template ${variant}.md.tmpl not found — skipping AGENTS.md generation.`);\n    }\n  } else {\n    console.log(\"  AGENTS.md already exists — skipping (use `agent-harness update` to refresh).\");\n  }\n\n  const postRuntime = await HarnessRuntime.create();\n  await postRuntime.dispatchHooks(\"setup.post\", {\n    command: \"setup\",\n    language,\n    template: variant,\n  });\n  await postRuntime.log(\"setup\", \"Setup completed\", {\n    language,\n    template: variant,\n  });\n\n  console.log(\"\\nSetup complete! Run `agent-harness doctor` to verify.\");\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA,SAAS,OAAO,WAAW,gBAAgB;AAC3C,SAAS,kBAAkB;AAC3B,SAAS,SAAS,MAAM,gBAAgB;AACxC,SAAS,aAAa,qBAAqB;AAW3C,eAAsB,SAAS,MAAmC;AAChE,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,aAAa,QAAQ,KAAK,UAAU;AAC1C,QAAM,aAAa,MAAM,eAAe,OAAO;AAE/C,UAAQ,IAAI,qBAAqB;AACjC,UAAQ,IAAI,uBAAuB;AAEnC,QAAM,WAAW,KAAK,YAAY,eAAe,GAAG;AACpD,QAAM,UAAU,KAAK,YAAY;AAEjC,QAAM,WAAW,cAAc,aAAa;AAAA,IAC1C,SAAS;AAAA,IACT;AAAA,IACA,UAAU;AAAA,EACZ,CAAC;AAED,UAAQ,IAAI,wBAAwB,QAAQ,EAAE;AAC9C,UAAQ,IAAI,wBAAwB,OAAO;AAAA,CAAI;AAE/C,MAAI,WAAW,UAAU,GAAG;AAC1B,YAAQ,IAAI,uEAAkE;AAAA,EAChF,OAAO;AACL,UAAM,MAAM,YAAY,EAAE,WAAW,KAAK,CAAC;AAC3C,YAAQ,IAAI,gCAAgC;AAAA,EAC9C;AAEA,QAAM,YAAY,QAAQ,YAAY,QAAQ;AAC9C,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,UAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,YAAQ,IAAI,uCAAuC;AAAA,EACrD;AAEA,QAAM,aAAa,QAAQ,YAAY,qBAAqB;AAC5D,QAAM,cAAc,SAAS,GAAG,KAAK;AAErC,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,MACP,MAAM;AAAA,MACN;AAAA,MACA,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,kBAAkB;AAAA,MAClB,eAAe;AAAA,QACb,KAAK;AAAA,QACL,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,QAAQ;AAAA,MACN,aAAa,CAAC,iBAAiB;AAAA,MAC/B,aAAa;AAAA,IACf;AAAA,IACA,WAAW;AAAA,MACT,cAAc;AAAA,QACZ,QAAQ,CAAC,SAAS,QAAQ,MAAM;AAAA,MAClC;AAAA,IACF;AAAA,IACA,WAAW;AAAA,MACT,WAAW;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAU,YAAY,cAAc,MAAM,GAAG,OAAO;AAC1D,UAAQ,IAAI,kCAAkC;AAE9C,QAAM,eAAe,QAAQ,KAAK,WAAW;AAC7C,MAAI,CAAC,WAAW,YAAY,GAAG;AAC7B,UAAM,eAAe,gBAAgB;AACrC,UAAM,eAAe,KAAK,cAAc,aAAa,GAAG,OAAO,UAAU;AAEzE,QAAI,WAAW,YAAY,GAAG;AAC5B,YAAM,WAAW,MAAM,SAAS,cAAc,OAAO;AACrD,YAAM,WAAW,OAAO,UAAU;AAAA,QAChC;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB,aAAa,CAAC;AAAA,MAChB,CAAC;AACD,YAAM,UAAU,cAAc,UAAU,OAAO;AAC/C,cAAQ,IAAI,0BAA0B,OAAO,YAAY;AAAA,IAC3D,OAAO;AACL,cAAQ,IAAI,cAAc,OAAO,0DAAqD;AAAA,IACxF;AAAA,EACF,OAAO;AACL,YAAQ,IAAI,qFAAgF;AAAA,EAC9F;AAEA,QAAM,cAAc,MAAM,eAAe,OAAO;AAChD,QAAM,YAAY,cAAc,cAAc;AAAA,IAC5C,SAAS;AAAA,IACT;AAAA,IACA,UAAU;AAAA,EACZ,CAAC;AACD,QAAM,YAAY,IAAI,SAAS,mBAAmB;AAAA,IAChD;AAAA,IACA,UAAU;AAAA,EACZ,CAAC;AAED,UAAQ,IAAI,yDAAyD;AACvE;","names":[]}

package/dist/update-CTPDQCLU.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import {
+  getTemplatesDir
+} from "./chunk-PQWK2OBN.js";
+import {
+  render
+} from "./chunk-JKJ3FP6T.js";
+import {
+  HarnessRuntime
+} from "./chunk-R6VGYQOH.js";
+import {
+  projectConfigExists
+} from "./chunk-3P72TGGQ.js";
+import "./chunk-LOE6IDTT.js";
+
+// src/cli/update.ts
+import { readFile, writeFile } from "fs/promises";
+import { existsSync } from "fs";
+import { resolve, join } from "path";
+async function runUpdate(opts) {
+  const cwd = process.cwd();
+  const dryRun = opts.check ?? false;
+  console.log(`Agent Harness Update${dryRun ? " (dry-run)" : ""}`);
+  console.log("====================\n");
+  if (!projectConfigExists(cwd)) {
+    console.log("  No harness configuration found. Run `agent-harness setup` first.");
+    return;
+  }
+  const runtime = await HarnessRuntime.create({ requireProjectConfig: true });
+  const config = runtime.config;
+  const templatesDir = getTemplatesDir();
+  if (!config) {
+    throw new Error("Runtime expected configuration but none was loaded.");
+  }
+  await runtime.dispatchHooks("update.pre", {
+    command: "update",
+    dryRun,
+    template: opts.template ?? null
+  });
+  if (!opts.template || opts.template === "agents-md") {
+    await updateAgentsMd(cwd, config, templatesDir, dryRun);
+  }
+  await runtime.dispatchHooks("update.post", {
+    command: "update",
+    dryRun,
+    template: opts.template ?? null
+  });
+  await runtime.log("update", dryRun ? "Update dry-run completed" : "Update completed", {
+    dryRun,
+    template: opts.template ?? null
+  });
+  console.log(dryRun ? "\nDry-run complete. No files modified." : "\nUpdate complete.");
+}
+async function updateAgentsMd(cwd, config, templatesDir, dryRun) {
+  const variant = config.templates.agents_md.variant;
+  const templateFile = join(templatesDir, "agents-md", `${variant}.md.tmpl`);
+  if (!existsSync(templateFile)) {
+    console.log(`  Template ${variant}.md.tmpl not found \u2014 skipping AGENTS.md.`);
+    return;
+  }
+  const template = await readFile(templateFile, "utf-8");
+  const rendered = render(template, {
+    projectName: config.project.name,
+    language: config.project.language,
+    delegationFirst: String(config.agents.delegation_first),
+    customRules: config.templates.agents_md.custom_rules
+  });
+  const agentsMdPath = resolve(cwd, "AGENTS.md");
+  if (existsSync(agentsMdPath)) {
+    const current = await readFile(agentsMdPath, "utf-8");
+    if (current === rendered) {
+      console.log("  AGENTS.md is up to date.");
+      return;
+    }
+    console.log(`  AGENTS.md would be updated (${variant} variant).`);
+  } else {
+    console.log(`  AGENTS.md would be created (${variant} variant).`);
+  }
+  if (!dryRun) {
+    await writeFile(agentsMdPath, rendered, "utf-8");
+    console.log("  AGENTS.md updated.");
+  }
+}
+export {
+  runUpdate
+};
+//# sourceMappingURL=update-CTPDQCLU.js.map

package/dist/update-CTPDQCLU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/update.ts"],"sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { resolve, join } from \"node:path\";\nimport { projectConfigExists } from \"../config/loader.js\";\nimport type { HarnessConfig } from \"../config/loader.js\";\nimport { render } from \"../template/engine.js\";\nimport { getTemplatesDir } from \"./utils.js\";\nimport { HarnessRuntime } from \"../runtime/harness.js\";\n\nexport interface UpdateOptions {\n  check?: boolean;\n  template?: string;\n}\n\nexport async function runUpdate(opts: UpdateOptions): Promise<void> {\n  const cwd = process.cwd();\n  const dryRun = opts.check ?? false;\n\n  console.log(`Agent Harness Update${dryRun ? \" (dry-run)\" : \"\"}`);\n  console.log(\"====================\\n\");\n\n  if (!projectConfigExists(cwd)) {\n    console.log(\"  No harness configuration found. Run `agent-harness setup` first.\");\n    return;\n  }\n\n  const runtime = await HarnessRuntime.create({ requireProjectConfig: true });\n  const config = runtime.config;\n  const templatesDir = getTemplatesDir();\n\n  if (!config) {\n    throw new Error(\"Runtime expected configuration but none was loaded.\");\n  }\n\n  await runtime.dispatchHooks(\"update.pre\", {\n    command: \"update\",\n    dryRun,\n    template: opts.template ?? null,\n  });\n\n  if (!opts.template || opts.template === \"agents-md\") {\n    await updateAgentsMd(cwd, config, templatesDir, dryRun);\n  }\n\n  await runtime.dispatchHooks(\"update.post\", {\n    command: \"update\",\n    dryRun,\n    template: opts.template ?? null,\n  });\n  await runtime.log(\"update\", dryRun ? \"Update dry-run completed\" : \"Update completed\", {\n    dryRun,\n    template: opts.template ?? null,\n  });\n\n  console.log(dryRun ? \"\\nDry-run complete. No files modified.\" : \"\\nUpdate complete.\");\n}\n\nasync function updateAgentsMd(\n  cwd: string,\n  config: HarnessConfig,\n  templatesDir: string,\n  dryRun: boolean,\n): Promise<void> {\n  const variant = config.templates.agents_md.variant;\n  const templateFile = join(templatesDir, \"agents-md\", `${variant}.md.tmpl`);\n\n  if (!existsSync(templateFile)) {\n    console.log(`  Template ${variant}.md.tmpl not found — skipping AGENTS.md.`);\n    return;\n  }\n\n  const template = await readFile(templateFile, \"utf-8\");\n  const rendered = render(template, {\n    projectName: config.project.name,\n    language: config.project.language,\n    delegationFirst: String(config.agents.delegation_first),\n    customRules: config.templates.agents_md.custom_rules,\n  });\n\n  const agentsMdPath = resolve(cwd, \"AGENTS.md\");\n  if (existsSync(agentsMdPath)) {\n    const current = await readFile(agentsMdPath, \"utf-8\");\n    if (current === rendered) {\n      console.log(\"  AGENTS.md is up to date.\");\n      return;\n    }\n    console.log(`  AGENTS.md would be updated (${variant} variant).`);\n  } else {\n    console.log(`  AGENTS.md would be created (${variant} variant).`);\n  }\n\n  if (!dryRun) {\n    await writeFile(agentsMdPath, rendered, \"utf-8\");\n    console.log(\"  AGENTS.md updated.\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS,UAAU,iBAAiB;AACpC,SAAS,kBAAkB;AAC3B,SAAS,SAAS,YAAY;AAY9B,eAAsB,UAAU,MAAoC;AAClE,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,SAAS,KAAK,SAAS;AAE7B,UAAQ,IAAI,uBAAuB,SAAS,eAAe,EAAE,EAAE;AAC/D,UAAQ,IAAI,wBAAwB;AAEpC,MAAI,CAAC,oBAAoB,GAAG,GAAG;AAC7B,YAAQ,IAAI,oEAAoE;AAChF;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,eAAe,OAAO,EAAE,sBAAsB,KAAK,CAAC;AAC1E,QAAM,SAAS,QAAQ;AACvB,QAAM,eAAe,gBAAgB;AAErC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AAEA,QAAM,QAAQ,cAAc,cAAc;AAAA,IACxC,SAAS;AAAA,IACT;AAAA,IACA,UAAU,KAAK,YAAY;AAAA,EAC7B,CAAC;AAED,MAAI,CAAC,KAAK,YAAY,KAAK,aAAa,aAAa;AACnD,UAAM,eAAe,KAAK,QAAQ,cAAc,MAAM;AAAA,EACxD;AAEA,QAAM,QAAQ,cAAc,eAAe;AAAA,IACzC,SAAS;AAAA,IACT;AAAA,IACA,UAAU,KAAK,YAAY;AAAA,EAC7B,CAAC;AACD,QAAM,QAAQ,IAAI,UAAU,SAAS,6BAA6B,oBAAoB;AAAA,IACpF;AAAA,IACA,UAAU,KAAK,YAAY;AAAA,EAC7B,CAAC;AAED,UAAQ,IAAI,SAAS,2CAA2C,oBAAoB;AACtF;AAEA,eAAe,eACb,KACA,QACA,cACA,QACe;AACf,QAAM,UAAU,OAAO,UAAU,UAAU;AAC3C,QAAM,eAAe,KAAK,cAAc,aAAa,GAAG,OAAO,UAAU;AAEzE,MAAI,CAAC,WAAW,YAAY,GAAG;AAC7B,YAAQ,IAAI,cAAc,OAAO,+CAA0C;AAC3E;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,SAAS,cAAc,OAAO;AACrD,QAAM,WAAW,OAAO,UAAU;AAAA,IAChC,aAAa,OAAO,QAAQ;AAAA,IAC5B,UAAU,OAAO,QAAQ;AAAA,IACzB,iBAAiB,OAAO,OAAO,OAAO,gBAAgB;AAAA,IACtD,aAAa,OAAO,UAAU,UAAU;AAAA,EAC1C,CAAC;AAED,QAAM,eAAe,QAAQ,KAAK,WAAW;AAC7C,MAAI,WAAW,YAAY,GAAG;AAC5B,UAAM,UAAU,MAAM,SAAS,cAAc,OAAO;AACpD,QAAI,YAAY,UAAU;AACxB,cAAQ,IAAI,4BAA4B;AACxC;AAAA,IACF;AACA,YAAQ,IAAI,iCAAiC,OAAO,YAAY;AAAA,EAClE,OAAO;AACL,YAAQ,IAAI,iCAAiC,OAAO,YAAY;AAAA,EAClE;AAEA,MAAI,CAAC,QAAQ;AACX,UAAM,UAAU,cAAc,UAAU,OAAO;AAC/C,YAAQ,IAAI,sBAAsB;AAAA,EACpC;AACF;","names":[]}

package/dist/verify-NI3VCE2H.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import {
+  HarnessRuntime
+} from "./chunk-R6VGYQOH.js";
+import "./chunk-3P72TGGQ.js";
+import "./chunk-LOE6IDTT.js";
+
+// src/cli/verify.ts
+import { execSync } from "child_process";
+async function runVerify(opts) {
+  const runtime = await HarnessRuntime.create({ requireProjectConfig: true });
+  const config = runtime.config;
+  if (!config) {
+    throw new Error("Runtime expected configuration but none was loaded.");
+  }
+  const globalFailFast = opts.failFast ?? config.workflows.verification.fail_fast;
+  const stages = buildPipeline(config, runtime.listTasks());
+  if (stages.length === 0) {
+    if (opts.json) {
+      console.log(JSON.stringify({ results: [], summary: { pass: 0, fail: 0, skip: 0, totalMs: 0 } }, null, 2));
+    } else {
+      console.log("Agent Harness Verification");
+      console.log("==========================\n");
+      console.log("  No verification stages configured.");
+    }
+    return;
+  }
+  if (!opts.json) {
+    console.log("Agent Harness Verification");
+    console.log("==========================\n");
+  }
+  await runtime.dispatchHooks("verify.pre", {
+    command: "verify",
+    stages: stages.map((stage) => stage.name)
+  });
+  const results = [];
+  let failed = false;
+  for (const stage of stages) {
+    if (!stage.command) {
+      if (!opts.json) {
+        console.log(`  [SKIP] ${stage.name} \u2014 no command configured`);
+      }
+      results.push({
+        stage: stage.name,
+        command: "",
+        source: stage.source,
+        status: "skip",
+        durationMs: 0
+      });
+      continue;
+    }
+    const start = Date.now();
+    try {
+      execSync(stage.command, { cwd: runtime.cwd, stdio: "pipe", timeout: 12e4 });
+      const durationMs = Date.now() - start;
+      if (!opts.json) {
+        console.log(`  [PASS] ${stage.name} \u2014 ${stage.command} (${durationMs}ms)`);
+      }
+      results.push({
+        stage: stage.name,
+        command: stage.command,
+        source: stage.source,
+        status: "pass",
+        durationMs
+      });
+    } catch (err) {
+      const durationMs = Date.now() - start;
+      const output = err instanceof Error ? err.stderr?.toString() ?? err.message : String(err);
+      if (!opts.json) {
+        console.log(`  [FAIL] ${stage.name} \u2014 ${stage.command} (${durationMs}ms)`);
+      }
+      results.push({
+        stage: stage.name,
+        command: stage.command,
+        source: stage.source,
+        status: "fail",
+        durationMs,
+        output
+      });
+      failed = true;
+      const shouldStop = globalFailFast || stage.failFast;
+      if (shouldStop) {
+        if (!opts.json) {
+          console.log(`
+  Stopping: fail_fast enabled for stage "${stage.name}".`);
+        }
+        break;
+      }
+    }
+  }
+  const passed = results.filter((r) => r.status === "pass").length;
+  const failures = results.filter((r) => r.status === "fail").length;
+  const skipped = results.filter((r) => r.status === "skip").length;
+  const totalMs = results.reduce((sum, r) => sum + r.durationMs, 0);
+  const summary = { pass: passed, fail: failures, skip: skipped, totalMs };
+  await runtime.dispatchHooks("verify.post", {
+    command: "verify",
+    summary,
+    status: failed ? "fail" : "pass"
+  });
+  await runtime.log("verify", "Verification run completed", {
+    summary,
+    failed
+  });
+  if (opts.json) {
+    console.log(JSON.stringify({ results, summary }, null, 2));
+  } else {
+    console.log(`
+Verification: ${passed} passed, ${failures} failed, ${skipped} skipped (${totalMs}ms total)`);
+  }
+  if (failed) {
+    process.exitCode = 1;
+  }
+}
+function buildPipeline(config, tasks) {
+  const verification = config.workflows.verification;
+  const commandMap = new Map(tasks.map((task) => [task.name, task]));
+  if (verification.pipeline && verification.pipeline.length > 0) {
+    return verification.pipeline.map((s) => ({
+      name: s.name,
+      command: s.command ?? commandMap.get(s.name)?.command ?? config.workflows.commands[s.name],
+      source: s.command ? "pipeline" : commandMap.get(s.name)?.source ?? "workflow",
+      failFast: s.fail_fast
+    }));
+  }
+  return verification.checks.map((check) => ({
+    name: check,
+    command: commandMap.get(check)?.command ?? config.workflows.commands[check],
+    source: commandMap.get(check)?.source ?? "workflow",
+    failFast: verification.fail_fast
+  }));
+}
+export {
+  runVerify
+};
+//# sourceMappingURL=verify-NI3VCE2H.js.map

package/dist/verify-NI3VCE2H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/verify.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { HarnessRuntime, type RuntimeTask } from \"../runtime/harness.js\";\n\nexport interface VerifyOptions {\n  failFast?: boolean;\n  json?: boolean;\n}\n\nexport interface StageResult {\n  stage: string;\n  command: string;\n  source?: RuntimeTask[\"source\"] | \"pipeline\";\n  status: \"pass\" | \"fail\" | \"skip\";\n  durationMs: number;\n  output?: string;\n}\n\nexport async function runVerify(opts: VerifyOptions): Promise<void> {\n  const runtime = await HarnessRuntime.create({ requireProjectConfig: true });\n  const config = runtime.config;\n\n  if (!config) {\n    throw new Error(\"Runtime expected configuration but none was loaded.\");\n  }\n\n  const globalFailFast = opts.failFast ?? config.workflows.verification.fail_fast;\n  const stages = buildPipeline(config, runtime.listTasks());\n\n  if (stages.length === 0) {\n    if (opts.json) {\n      console.log(JSON.stringify({ results: [], summary: { pass: 0, fail: 0, skip: 0, totalMs: 0 } }, null, 2));\n    } else {\n      console.log(\"Agent Harness Verification\");\n      console.log(\"==========================\\n\");\n      console.log(\"  No verification stages configured.\");\n    }\n    return;\n  }\n\n  if (!opts.json) {\n    console.log(\"Agent Harness Verification\");\n    console.log(\"==========================\\n\");\n  }\n\n  await runtime.dispatchHooks(\"verify.pre\", {\n    command: \"verify\",\n    stages: stages.map((stage) => stage.name),\n  });\n\n  const results: StageResult[] = [];\n  let failed = false;\n\n  for (const stage of stages) {\n    if (!stage.command) {\n      if (!opts.json) {\n        console.log(`  [SKIP] ${stage.name} — no command configured`);\n      }\n      results.push({\n        stage: stage.name,\n        command: \"\",\n        source: stage.source,\n        status: \"skip\",\n        durationMs: 0,\n      });\n      continue;\n    }\n\n    const start = Date.now();\n    try {\n      execSync(stage.command, { cwd: runtime.cwd, stdio: \"pipe\", timeout: 120_000 });\n      const durationMs = Date.now() - start;\n      if (!opts.json) {\n        console.log(`  [PASS] ${stage.name} — ${stage.command} (${durationMs}ms)`);\n      }\n      results.push({\n        stage: stage.name,\n        command: stage.command,\n        source: stage.source,\n        status: \"pass\",\n        durationMs,\n      });\n    } catch (err) {\n      const durationMs = Date.now() - start;\n      const output = err instanceof Error ? (err as { stderr?: Buffer }).stderr?.toString() ?? err.message : String(err);\n      if (!opts.json) {\n        console.log(`  [FAIL] ${stage.name} — ${stage.command} (${durationMs}ms)`);\n      }\n      results.push({\n        stage: stage.name,\n        command: stage.command,\n        source: stage.source,\n        status: \"fail\",\n        durationMs,\n        output,\n      });\n      failed = true;\n\n      const shouldStop = globalFailFast || stage.failFast;\n      if (shouldStop) {\n        if (!opts.json) {\n          console.log(`\\n  Stopping: fail_fast enabled for stage \"${stage.name}\".`);\n        }\n        break;\n      }\n    }\n  }\n\n  const passed = results.filter((r) => r.status === \"pass\").length;\n  const failures = results.filter((r) => r.status === \"fail\").length;\n  const skipped = results.filter((r) => r.status === \"skip\").length;\n  const totalMs = results.reduce((sum, r) => sum + r.durationMs, 0);\n\n  const summary = { pass: passed, fail: failures, skip: skipped, totalMs };\n  await runtime.dispatchHooks(\"verify.post\", {\n    command: \"verify\",\n    summary,\n    status: failed ? \"fail\" : \"pass\",\n  });\n  await runtime.log(\"verify\", \"Verification run completed\", {\n    summary,\n    failed,\n  });\n\n  if (opts.json) {\n    console.log(JSON.stringify({ results, summary }, null, 2));\n  } else {\n    console.log(`\\nVerification: ${passed} passed, ${failures} failed, ${skipped} skipped (${totalMs}ms total)`);\n  }\n\n  if (failed) {\n    process.exitCode = 1;\n  }\n}\n\ninterface PipelineStage {\n  name: string;\n  command: string | undefined;\n  source?: RuntimeTask[\"source\"] | \"pipeline\";\n  failFast: boolean;\n}\n\nfunction buildPipeline(\n  config: NonNullable<HarnessRuntime[\"config\"]>,\n  tasks: RuntimeTask[],\n): PipelineStage[] {\n  const verification = config.workflows.verification;\n  const commandMap = new Map(tasks.map((task) => [task.name, task] as const));\n\n  if (verification.pipeline && verification.pipeline.length > 0) {\n    return verification.pipeline.map((s) => ({\n      name: s.name,\n      command: s.command ?? commandMap.get(s.name)?.command ?? config.workflows.commands[s.name],\n      source: s.command ? \"pipeline\" : commandMap.get(s.name)?.source ?? \"workflow\",\n      failFast: s.fail_fast,\n    }));\n  }\n\n  return verification.checks.map((check) => ({\n    name: check,\n    command: commandMap.get(check)?.command ?? config.workflows.commands[check],\n    source: commandMap.get(check)?.source ?? \"workflow\",\n    failFast: verification.fail_fast,\n  }));\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "cc-agent-harness",
+  "version": "0.0.1",
+  "description": "Universal development pipeline harness — configuration, templates, skill management, and health checks for AI-assisted projects.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KwokJay/cc-agent-harness.git"
+  },
+  "homepage": "https://github.com/KwokJay/cc-agent-harness#readme",
+  "bugs": {
+    "url": "https://github.com/KwokJay/cc-agent-harness/issues"
+  },
+  "keywords": [
+    "agent",
+    "harness",
+    "cli",
+    "ai",
+    "workflow",
+    "context-engineering",
+    "developer-tools"
+  ],
+  "bin": {
+    "agent-harness": "./dist/harness.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "clean": "rm -rf dist",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm lint && pnpm test && pnpm build"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.1.0"
+  }
+}

package/templates/agents-md/full.md.tmpl

@@ -0,0 +1,98 @@
+# {{projectName}}
+
+## Project Info
+
+- **Language**: {{language}}
+
+## Coding Guidelines
+
+- Follow established project conventions and style guides.
+- Write clear, self-documenting code with minimal comments.
+- Prefer editing existing files over creating new ones.
+- Run tests after making changes to verify correctness.
+- Run linters/formatters before finalizing changes.
+- Do not create small helper methods referenced only once.
+- Prefer exhaustive match/switch statements over wildcard arms.
+{{#each customRules}}
+- {{.}}
+{{/each}}
+
+## Delegation-First Philosophy
+
+**Your job is to ORCHESTRATE specialists, not to do work yourself.**
+
+| Action | Do Directly | Delegate |
+|--------|-------------|----------|
+| Read files for context | Yes | — |
+| Quick status checks | Yes | — |
+| Communicate with user | Yes | — |
+| Code changes | NEVER | executor |
+| Complex debugging | NEVER | architect |
+| UI/frontend work | NEVER | designer |
+| Documentation | NEVER | writer |
+| Deep analysis | NEVER | architect / analyst |
+
+## Smart Model Routing
+
+| Task Complexity | Tier | When to Use |
+|-----------------|------|-------------|
+| Simple lookup | low | "What does this return?" |
+| Standard work | medium | "Add error handling" |
+| Complex reasoning | high | "Debug race condition" |
+
+## Verification Protocol
+
+**Iron Law: NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE.**
+
+Before ANY agent says "done", "fixed", or "complete":
+
+| Step | Action |
+|------|--------|
+| 1 | IDENTIFY: What command proves this claim? |
+| 2 | RUN: Execute verification command |
+| 3 | READ: Check output — did it pass? |
+| 4 | CLAIM: Make claim WITH evidence |
+
+Required evidence:
+
+| Claim | Required Evidence |
+|-------|-------------------|
+| "Fixed" | Test showing it passes now |
+| "Implemented" | Build clean + tests pass |
+| "Refactored" | All tests still pass |
+| "Debugged" | Root cause identified with file:line |
+
+## Parallelization Rules
+
+- 2+ independent tasks with >30s work → Run in parallel
+- Sequential dependencies → Run in order
+- Quick tasks (<10s) → Do directly
+
+## Skills
+
+Skills are discovered from:
+
+- `.harness/skills/`
+
+## Agent Catalog
+
+### Analysis
+- `architect-low` (low) / `architect-medium` (medium) / `architect` (high)
+
+### Execution
+- `executor-low` (low) / `executor` (medium) / `executor-high` (high)
+
+### Search
+- `explore` (low) / `explore-medium` (medium) / `explore-high` (high)
+
+### Frontend
+- `designer-low` (low) / `designer` (medium) / `designer-high` (high)
+
+### Testing
+- `qa-tester` (medium) / `qa-tester-high` (high)
+
+### Code Review
+- `code-reviewer-low` (low) / `code-reviewer` (high)
+
+### Security
+- `security-reviewer-low` (low) / `security-reviewer` (high)

package/templates/agents-md/minimal.md.tmpl

@@ -0,0 +1,20 @@
+# {{projectName}}
+
+## Project Info
+
+- **Language**: {{language}}
+
+## Coding Guidelines
+
+- Follow established project conventions.
+- Write clear, self-documenting code.
+- Prefer editing existing files over creating new ones.
+{{#each customRules}}
+- {{.}}
+{{/each}}
+{{#if delegationFirst}}
+
+## Agent Delegation
+
+When working on this project, prefer delegating complex tasks to specialized agents.
+{{/if}}

package/templates/agents-md/standard.md.tmpl

@@ -0,0 +1,43 @@
+# {{projectName}}
+
+## Project Info
+
+- **Language**: {{language}}
+
+## Coding Guidelines
+
+- Follow established project conventions and style guides.
+- Write clear, self-documenting code with minimal comments.
+- Prefer editing existing files over creating new ones.
+- Run tests after making changes to verify correctness.
+- Run linters/formatters before finalizing changes.
+{{#each customRules}}
+- {{.}}
+{{/each}}
+
+## Agent Delegation
+
+Prefer delegating substantive work to specialized agents:
+
+| Task Type | Recommended Agent | Tier |
+|-----------|-------------------|------|
+| Quick lookup | explore | low |
+| Feature implementation | executor | medium |
+| Complex debugging | architect | high |
+| UI/frontend work | designer | medium |
+| Documentation | writer | low |
+| Code review | code-reviewer | high |
+
+## Verification Protocol
+
+Before claiming any task is complete:
+
+1. Run the build to check for compilation errors.
+2. Run relevant tests to verify correctness.
+3. Run linter to check for style issues.
+
+## Skills
+
+Skills are discovered from these directories:
+
+- `.harness/skills/`

package/templates/configs/harness.config.yaml.tmpl

@@ -0,0 +1,28 @@
+project:
+  name: "{{projectName}}"
+  language: "{{language}}"
+  description: ""
+
+agents:
+  delegation_first: true
+  model_routing:
+    low: "low"
+    medium: "medium"
+    high: "high"
+  providers: {}
+
+skills:
+  directories:
+    - ".harness/skills"
+  auto_detect: true
+
+workflows:
+  verification:
+    checks:
+      - build
+      - test
+      - lint
+
+templates:
+  agents_md:
+    variant: "{{variant}}"

package/templates/skills/basic/SKILL.md.tmpl

@@ -0,0 +1,14 @@
+---
+name: {{name}}
+description: {{description}}
+---
+
+# {{displayName}}
+
+## Overview
+
+TODO: Describe what this skill does.
+
+## Usage
+
+TODO: Describe how to use this skill.