cclaw-cli 0.32.0 → 0.34.0

package/dist/harness-adapters.js

@@ -54,16 +54,22 @@ export const HARNESS_ADAPTERS = {
         capabilities: {
             nativeSubagentDispatch: "full",
             hookSurface: "full",
-            structuredAsk: "AskUserQuestion"
+            structuredAsk: "AskUserQuestion",
+            subagentFallback: "native"
         }
     },
     cursor: {
         id: "cursor",
         commandDir: ".cursor/commands",
         capabilities: {
-            nativeSubagentDispatch: "partial",
+            // Cursor has a real Task tool with subagent_type (generalPurpose,
+            // explore, shell, browser-use, …) but no user-defined named
+            // subagents. cclaw maps each named agent (planner/reviewer/…) onto
+            // generic dispatch with a role prompt — see the cursor playbook.
+            nativeSubagentDispatch: "generic",
             hookSurface: "full",
-            structuredAsk: "AskQuestion"
+            structuredAsk: "AskQuestion",
+            subagentFallback: "generic-dispatch"
         }
     },
     opencode: {
@@ -72,7 +78,8 @@ export const HARNESS_ADAPTERS = {
         capabilities: {
             nativeSubagentDispatch: "partial",
             hookSurface: "plugin",
-            structuredAsk: "plain-text"
+            structuredAsk: "plain-text",
+            subagentFallback: "role-switch"
         }
     },
     codex: {
@@ -81,7 +88,8 @@ export const HARNESS_ADAPTERS = {
         capabilities: {
             nativeSubagentDispatch: "none",
             hookSurface: "full",
-            structuredAsk: "plain-text"
+            structuredAsk: "plain-text",
+            subagentFallback: "role-switch"
         }
     }
 };
@@ -94,11 +102,22 @@ export function harnessTier(harnessId) {
     }
     if (capabilities.hookSurface === "full" ||
         capabilities.hookSurface === "plugin" ||
+        capabilities.nativeSubagentDispatch === "generic" ||
         capabilities.nativeSubagentDispatch === "partial") {
         return "tier2";
     }
     return "tier3";
 }
+/**
+ * Harness IDs ordered from best (tier1) to least-capable. Stable sort — same
+ * tier preserves declaration order.
+ */
+export function harnessesByTier() {
+    return Object.keys(HARNESS_ADAPTERS).sort((a, b) => {
+        const tierOrder = { tier1: 0, tier2: 1, tier3: 2 };
+        return tierOrder[harnessTier(a)] - tierOrder[harnessTier(b)];
+    });
+}
 function agentsMdBlock() {
     return `${CCLAW_MARKER_START}
 ## Cclaw — Workflow Adapter

package/dist/install.js

@@ -37,6 +37,7 @@ 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 { 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";
 import { ensureDir, exists, writeFileSafe } from "./fs-utils.js";
@@ -293,6 +294,15 @@ async function writeSkills(projectRoot, config) {
         await writeFileSafe(runtimePath(projectRoot, ...doctorRefsDir, fileName), markdown);
     }
     await writeFileSafe(runtimePath(projectRoot, "references", "harnesses.md"), harnessIntegrationDocMarkdown());
+    // 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'
+    // playbooks (see runtime-integrity checks).
+    const playbookDirSegments = HARNESS_PLAYBOOKS_DIR.split("/");
+    await writeFileSafe(runtimePath(projectRoot, ...playbookDirSegments, "README.md"), harnessPlaybooksIndexMarkdown());
+    for (const harness of harnessIds) {
+        await writeFileSafe(runtimePath(projectRoot, ...playbookDirSegments, harnessPlaybookFileName(harness)), harnessPlaybookMarkdown(harness));
+    }
 }
 async function writeUtilityCommands(projectRoot) {
     await writeFileSafe(runtimePath(projectRoot, "commands", "learn.md"), learnCommandContract());
@@ -948,15 +958,40 @@ async function writeHarnessGapsState(projectRoot, harnesses) {
         if (capabilities.structuredAsk === "plain-text") {
             missingCapabilities.push("structuredAsk:none");
         }
+        const remediation = [];
+        switch (capabilities.subagentFallback) {
+            case "native":
+                // nothing to remediate — harness has first-class dispatch
+                break;
+            case "generic-dispatch":
+                remediation.push(`subagent dispatch → map named cclaw agents onto generic Task subagent_type per ${HARNESS_PLAYBOOKS_DIR}/${harness}-playbook.md`);
+                break;
+            case "role-switch":
+                remediation.push(`subagent dispatch → role-switch in-session with evidenceRefs per ${HARNESS_PLAYBOOKS_DIR}/${harness}-playbook.md`);
+                break;
+            case "waiver":
+                remediation.push(`subagent dispatch → record explicit harness_limitation waiver; no parity path available`);
+                break;
+        }
+        if (capabilities.structuredAsk === "plain-text") {
+            remediation.push("structured ask → fall back to a numbered plain-text list; first option is default");
+        }
+        for (const event of missingHookEvents) {
+            remediation.push(`hook event ${event} → schedule the corresponding script manually or accept reduced observability`);
+        }
         return {
             harness,
             tier: harnessTier(harness),
+            subagentFallback: capabilities.subagentFallback,
+            playbookPath: `${RUNTIME_ROOT}/${HARNESS_PLAYBOOKS_DIR}/${harness}-playbook.md`,
             missingCapabilities,
-            missingHookEvents
+            missingHookEvents,
+            remediation
         };
     });
     await writeFileSafe(runtimePath(projectRoot, "state", "harness-gaps.json"), `${JSON.stringify({
         generatedAt: new Date().toISOString(),
+        schemaVersion: 2,
         harnesses: report
     }, null, 2)}\n`);
 }

package/package.json

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