cclaw-cli 0.46.9 → 0.46.10

package/dist/content/harnesses-doc.d.ts

@@ -1 +1,2 @@
 export declare function harnessIntegrationDocMarkdown(): string;
+export declare function harnessDocsOverviewMarkdown(): string;

package/dist/content/harnesses-doc.js

@@ -1,6 +1,7 @@
 import { HARNESS_ADAPTERS, harnessTier } from "../harness-adapters.js";
 import { HOOK_EVENTS_BY_HARNESS, HOOK_SEMANTIC_EVENTS } from "./hook-events.js";
 import { HARNESS_PLAYBOOKS_DIR, harnessPlaybookFileName } from "./harness-playbooks.js";
+import { HARNESS_TOOL_REFS_DIR } from "./harness-tool-refs.js";
 function harnessTitle(harness) {
     switch (harness) {
         case "claude":
@@ -123,3 +124,37 @@ Harness-specific additions:
 - \`cclaw doctor\` validates shim, hook, and lifecycle surfaces against this capability model.
 `;
 }
+export function harnessDocsOverviewMarkdown() {
+    const harnesses = Object.keys(HARNESS_ADAPTERS);
+    const rows = harnesses
+        .map((harness) => {
+        const tier = harnessTier(harness);
+        const toolMap = `\`.cclaw/${HARNESS_TOOL_REFS_DIR}/${harness}.md\``;
+        const playbook = `\`.cclaw/${HARNESS_PLAYBOOKS_DIR}/${harnessPlaybookFileName(harness)}\``;
+        return `| ${harnessTitle(harness)} | \`${harness}\` | \`${tier}\` | ${toolMap} | ${playbook} |`;
+    })
+        .join("\n");
+    return `# Harness Docs Overview
+
+Single entrypoint for harness-specific references generated by cclaw sync.
+
+## Core references
+
+- Integration matrix: \`.cclaw/references/harnesses.md\`
+- Tool-map index: \`.cclaw/references/${HARNESS_TOOL_REFS_DIR}/README.md\`
+- Playbook index: \`.cclaw/references/${HARNESS_PLAYBOOKS_DIR}/README.md\`
+
+## Per-harness quick links
+
+| Harness | ID | Tier | Tool map | Playbook |
+|---|---|---|---|---|
+${rows}
+
+## How to use this pack
+
+1. Start with \`harnesses.md\` to understand capability/tier differences.
+2. Open the harness-specific tool map before writing stage logic that depends on tool names.
+3. Open the harness-specific playbook before asserting delegation parity behavior.
+4. If docs disagree, treat \`harnesses.md\` + harness adapter capabilities as source of truth and regenerate.
+`;
+}

package/dist/install.js

@@ -36,7 +36,7 @@ import { LANGUAGE_RULE_PACK_DIR, LANGUAGE_RULE_PACK_FILES, LANGUAGE_RULE_PACK_GE
 import { RESEARCH_PLAYBOOKS } from "./content/research-playbooks.js";
 import { HARNESS_TOOL_REFS_DIR, HARNESS_TOOL_REFS_INDEX_MD, harnessToolRefMarkdown } from "./content/harness-tool-refs.js";
 import { DOCTOR_REFERENCE_MARKDOWN } from "./content/doctor-references.js";
-import { harnessIntegrationDocMarkdown } from "./content/harnesses-doc.js";
+import { harnessDocsOverviewMarkdown, harnessIntegrationDocMarkdown } from "./content/harnesses-doc.js";
 import { HARNESS_PLAYBOOKS_DIR, harnessPlaybookFileName, harnessPlaybookMarkdown, harnessPlaybooksIndexMarkdown } from "./content/harness-playbooks.js";
 import { HOOK_EVENTS_BY_HARNESS, HOOK_SEMANTIC_EVENTS } from "./content/hook-events.js";
 import { createInitialFlowState } from "./flow-state.js";
@@ -294,6 +294,7 @@ async function writeSkills(projectRoot, config) {
         await writeFileSafe(runtimePath(projectRoot, ...doctorRefsDir, fileName), markdown);
     }
     await writeFileSafe(runtimePath(projectRoot, "references", "harnesses.md"), harnessIntegrationDocMarkdown());
+    await writeFileSafe(runtimePath(projectRoot, "references", "harnesses-overview.md"), harnessDocsOverviewMarkdown());
     // Per-harness parity playbooks. Generated for every supported harness
     // regardless of which harnesses the project installed — the index always
     // resolves, and doctor only asserts presence of the installed harnesses'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cclaw-cli",
-  "version": "0.46.9",
+  "version": "0.46.10",
   "description": "Installer-first flow toolkit for coding agents",
   "type": "module",
   "bin": {