cclaw-cli 0.48.30 → 0.48.31

package/dist/content/skills.js

@@ -1,22 +1,20 @@
 import { RUNTIME_ROOT, STAGE_TO_SKILL_FOLDER } from "../constants.js";
-import { STAGE_EXAMPLES_REFERENCE_DIR, stageDomainExamples, stageExamples, stageGoodBadExamples } from "./examples.js";
+import { STAGE_EXAMPLES_REFERENCE_DIR, stageExamples } from "./examples.js";
 import { STAGE_COMMON_GUIDANCE_REL_PATH } from "./stage-common-guidance.js";
 import { stageAutoSubagentDispatch, stageSchema } from "./stage-schema.js";
 const VERIFICATION_STAGES = ["tdd", "review", "ship"];
 const DECISION_PROTOCOL_PATH = `${RUNTIME_ROOT}/references/protocols/decision.md`;
 const COMPLETION_PROTOCOL_PATH = `${RUNTIME_ROOT}/references/protocols/completion.md`;
-function whenNotToUseBlock(stage, track) {
-    const schema = stageSchema(stage, track);
-    if (schema.whenNotToUse.length === 0) {
+function whenNotToUseBlock(items) {
+    if (items.length === 0) {
         return "";
     }
     return `## When Not to Use
-${schema.whenNotToUse.map((item) => `- ${item}`).join("\n")}
+${items.map((item) => `- ${item}`).join("\n")}
 
 `;
 }
-function contextLoadingBlock(stage, track) {
-    const trace = stageSchema(stage, track).crossStageTrace;
+function contextLoadingBlock(trace) {
     const readLines = trace.readsFrom.length > 0
         ? trace.readsFrom.map((value) => `- \`${value}\``).join("\n")
         : "- (first stage — no upstream artifacts)";
@@ -54,8 +52,7 @@ Mandatory delegations for this stage: ${mandatoryList}.
 Record completion/waiver in \`${delegationLogRel}\` before stage completion.
 `;
 }
-function researchPlaybooksBlock(stage, track) {
-    const playbooks = stageSchema(stage, track).researchPlaybooks ?? [];
+function researchPlaybooksBlock(playbooks) {
     if (playbooks.length === 0)
         return "";
     const rows = playbooks
@@ -70,11 +67,10 @@ and record outcomes in the stage artifact when relevant.
 ${rows}
 `;
 }
-function reviewSectionsBlock(stage, track) {
-    const schema = stageSchema(stage, track);
-    if (schema.reviewSections.length === 0)
+function reviewSectionsBlock(sectionsInput) {
+    if (sectionsInput.length === 0)
         return "";
-    const sections = schema.reviewSections
+    const sections = sectionsInput
         .map((sec) => {
         const points = sec.evaluationPoints.map((p) => `- ${p}`).join("\n");
         const title = sec.stopGate ? `${sec.title} (STOP gate)` : sec.title;
@@ -116,8 +112,7 @@ Detailed walkthrough:
 \`.cclaw/${STAGE_EXAMPLES_REFERENCE_DIR}/tdd-batch-walkthrough.md\`
 `;
 }
-function crossStageTraceBlock(stage, track) {
-    const trace = stageSchema(stage, track).crossStageTrace;
+function crossStageTraceBlock(trace) {
     const reads = trace.readsFrom.length > 0
         ? trace.readsFrom.map((r) => `- ${r}`).join("\n")
         : "- (first stage — no upstream artifacts)";
@@ -135,8 +130,7 @@ ${writes}
 Rule: ${trace.traceabilityRule}
 `;
 }
-function artifactValidationBlock(stage, track) {
-    const validations = stageSchema(stage, track).artifactValidation;
+function artifactValidationBlock(validations) {
     if (validations.length === 0)
         return "";
     const rows = validations
@@ -152,10 +146,10 @@ function artifactValidationBlock(stage, track) {
 ${rows}
 `;
 }
-function mergedAntiPatterns(schema) {
+function mergedAntiPatterns(philosophy, execution) {
     const merged = [];
     const seen = new Set();
-    for (const item of [...schema.commonRationalizations, ...schema.blockers]) {
+    for (const item of [...philosophy.commonRationalizations, ...execution.blockers]) {
         const key = item.trim().toLowerCase();
         if (seen.has(key))
             continue;
@@ -205,9 +199,9 @@ function stageSpecificSeeAlso(stage) {
     return refs[stage];
 }
 function completionParametersBlock(schema, track) {
-    const gateList = schema.requiredGates.map((g) => `\`${g.id}\``).join(", ");
-    const mandatory = schema.mandatoryDelegations.length > 0
-        ? schema.mandatoryDelegations.map((a) => `\`${a}\``).join(", ")
+    const gateList = schema.executionModel.requiredGates.map((g) => `\`${g.id}\``).join(", ");
+    const mandatory = schema.reviewLens.mandatoryDelegations.length > 0
+        ? schema.reviewLens.mandatoryDelegations.map((a) => `\`${a}\``).join(", ")
         : "none";
     const nextStage = schema.next === "done" ? "done" : schema.next;
     const nextDescription = schema.next === "done"
@@ -218,25 +212,24 @@ function completionParametersBlock(schema, track) {
 - \`stage\`: \`${schema.stage}\`
 - \`next\`: \`${nextStage}\` (${nextDescription})
 - \`gates\`: ${gateList}
-- \`artifact\`: \`${RUNTIME_ROOT}/artifacts/${schema.artifactFile}\`
+- \`artifact\`: \`${RUNTIME_ROOT}/artifacts/${schema.artifactRules.artifactFile}\`
 - \`mandatory delegations\`: ${mandatory}
 - \`completion helper\`: \`node .cclaw/hooks/stage-complete.mjs ${schema.stage}\`
 - Fill \`## Learnings\` before closeout: either \`- None this stage.\` or JSON bullets with required keys \`type\`, \`trigger\`, \`action\`, \`confidence\` (knowledge-schema compatible).
 - Record mandatory delegation completion/waiver in \`${RUNTIME_ROOT}/state/delegation-log.json\` with rationale as needed.
 - Use the completion helper instead of raw \`flow-state.json\` edits (legacy direct edits trigger workflow-guard warnings or strict-mode blocks).
-Apply shared completion logic from:
-\`${COMPLETION_PROTOCOL_PATH}\`
+- Completion protocol reference: \`${COMPLETION_PROTOCOL_PATH}\`
 `;
 }
 function quickStartBlock(stage, track) {
     const schema = stageSchema(stage, track);
-    const gatePreview = schema.requiredGates.slice(0, 3).map((g) => `\`${g.id}\``).join(", ");
+    const gatePreview = schema.executionModel.requiredGates.slice(0, 3).map((g) => `\`${g.id}\``).join(", ");
     return `## Quick Start
 
-1. Announce at start: "Using \`${schema.skillName}\` to ${schema.purpose}".
+1. Announce at start: "Using \`${schema.skillName}\` to ${schema.philosophy.purpose}".
 2. Obey HARD-GATE and Iron Law.
-3. Execute checklist in order and persist \`${RUNTIME_ROOT}/artifacts/${schema.artifactFile}\`.
-4. Satisfy gates (${gatePreview}${schema.requiredGates.length > 3 ? ` +${schema.requiredGates.length - 3}` : ""}).
+3. Execute checklist in order and persist \`${RUNTIME_ROOT}/artifacts/${schema.artifactRules.artifactFile}\`.
+4. Satisfy gates (${gatePreview}${schema.executionModel.requiredGates.length > 3 ? ` +${schema.executionModel.requiredGates.length - 3}` : ""}).
 `;
 }
 /**
@@ -325,21 +318,26 @@ function dedupeGuidance(items, blockedBy) {
 }
 export function stageSkillMarkdown(stage, track = "standard") {
     const schema = stageSchema(stage, track);
-    const gateList = schema.requiredGates
+    const philosophy = schema.philosophy;
+    const executionModel = schema.executionModel;
+    const artifactRules = schema.artifactRules;
+    const reviewLens = schema.reviewLens;
+    const mandatoryDelegations = reviewLens.mandatoryDelegations;
+    const gateList = executionModel.requiredGates
         .map((g) => `- \`${g.id}\` — ${g.description}`)
         .join("\n");
-    const evidenceList = schema.requiredEvidence
+    const evidenceList = executionModel.requiredEvidence
         .map((e) => `- [ ] ${e}`)
         .join("\n");
-    const checklistItems = schema.checklist
+    const checklistItems = executionModel.checklist
         .map((item, i) => `${i + 1}. ${item}`)
         .join("\n");
-    const interactionFocus = dedupeGuidance(schema.interactionProtocol, [...schema.checklist, ...schema.process]).slice(0, 5);
-    const processSummary = dedupeGuidance(schema.process, schema.checklist).slice(0, 5);
-    const processNote = schema.process.length > processSummary.length
-        ? `- Follow the Checklist above for remaining execution detail (+${schema.process.length - processSummary.length} condensed step${schema.process.length - processSummary.length === 1 ? "" : "s"}).`
-        : "";
+    const interactionFocus = dedupeGuidance(executionModel.interactionProtocol, [...executionModel.checklist, ...executionModel.process]).slice(0, 5);
+    const processSummary = dedupeGuidance(executionModel.process, executionModel.checklist).slice(0, 5);
     const stageRefs = stageSpecificSeeAlso(stage);
+    const mandatoryDelegationSummary = mandatoryDelegations.length > 0
+        ? mandatoryDelegations.map((name) => `\`${name}\``).join(", ")
+        : "none";
     return `---
 name: ${schema.skillName}
 description: "${schema.skillDescription}"
@@ -349,7 +347,7 @@ description: "${schema.skillDescription}"
 
 <EXTREMELY-IMPORTANT>
 
-**IRON LAW — ${stage.toUpperCase()}:** ${schema.ironLaw}
+**IRON LAW — ${stage.toUpperCase()}:** ${philosophy.ironLaw}
 
 If you are about to violate the Iron Law, STOP. No amount of urgency, partial progress, or clever reinterpretation overrides it. Escalate via the Decision Protocol or abandon the stage.
 
@@ -357,28 +355,35 @@ If you are about to violate the Iron Law, STOP. No amount of urgency, partial pr
 
 ${quickStartBlock(stage, track)}
 
-## Overview
-${schema.purpose}
+## Philosophy
+${philosophy.purpose}
+
+## Complexity Tier
+- Active tier: \`${schema.complexityTier}\`
+- Mandatory delegations at this tier: ${mandatoryDelegationSummary}
 
 ## When to Use
-${schema.whenToUse.map((item) => `- ${item}`).join("\n")}
+${philosophy.whenToUse.map((item) => `- ${item}`).join("\n")}
+
+${whenNotToUseBlock(philosophy.whenNotToUse)}
+## HARD-GATE
+${philosophy.hardGate}
+
+## Anti-Patterns & Red Flags
+${mergedAntiPatterns(philosophy, executionModel)}
+
+## Process
+${processSummary.length > 0 ? processSummary.map((item, i) => `${i + 1}. ${item}`).join("\n") : "1. Execute the Checklist in order.\n2. Satisfy every required gate.\n3. Complete verification before stage closeout."}
 
-${whenNotToUseBlock(stage, track)}
 ## Inputs
-${schema.inputs.length > 0 ? schema.inputs.map((item) => `- ${item}`).join("\n") : "- (first stage — no required inputs)"}
+${executionModel.inputs.length > 0 ? executionModel.inputs.map((item) => `- ${item}`).join("\n") : "- (first stage — no required inputs)"}
 
 ## Required Context
-${schema.requiredContext.length > 0 ? schema.requiredContext.map((item) => `- ${item}`).join("\n") : "- None beyond this skill"}
+${executionModel.requiredContext.length > 0 ? executionModel.requiredContext.map((item) => `- ${item}`).join("\n") : "- None beyond this skill"}
 
-${contextLoadingBlock(stage, track)}
+${contextLoadingBlock(artifactRules.crossStageTrace)}
 ${autoSubagentDispatchBlock(stage, track)}
-${researchPlaybooksBlock(stage, track)}
-
-## Outputs
-${schema.outputs.map((item) => `- ${item}`).join("\n")}
-
-## HARD-GATE
-${schema.hardGate}
+${researchPlaybooksBlock(executionModel.researchPlaybooks ?? [])}
 
 ## Checklist
 
@@ -386,15 +391,12 @@ You MUST complete these steps in order:
 
 ${checklistItems}
 
-${stageGoodBadExamples(stage)}
-${stageDomainExamples(stage)}
 ${stageExamples(stage)}
 
 ## Interaction Protocol
 ${interactionFocus.length > 0 ? interactionFocus.map((item, i) => `${i + 1}. ${item}`).join("\n") : "- Keep communication concise and decision-focused; rely on the Checklist for execution order."}
 
-Shared decision/ask-user protocol:
-\`${DECISION_PROTOCOL_PATH}\`
+Decision protocol reference: \`${DECISION_PROTOCOL_PATH}\`
 
 ${batchExecutionModeBlock(stage, track)}
 ## Required Gates
@@ -403,22 +405,24 @@ ${gateList}
 ## Required Evidence
 ${evidenceList}
 
-## Process
-${processSummary.length > 0 ? processSummary.map((item, i) => `${i + 1}. ${item}`).join("\n") : "1. Execute the Checklist in order.\n2. Satisfy every required gate.\n3. Complete verification before stage closeout."}
-${processNote.length > 0 ? `\n${processNote}` : ""}
-
-${reviewSectionsBlock(stage, track)}
 ${verificationBlock(stage)}
-${crossStageTraceBlock(stage, track)}
-${artifactValidationBlock(stage, track)}
-
-## Anti-Patterns & Red Flags
-${mergedAntiPatterns(schema)}
 
 ## Verification
-${schema.exitCriteria.map((item) => `- [ ] ${item}`).join("\n")}
+${executionModel.exitCriteria.map((item) => `- [ ] ${item}`).join("\n")}
 
 ${completionParametersBlock(schema, track)}
+## Artifact Rules
+- Artifact target: \`${RUNTIME_ROOT}/artifacts/${artifactRules.artifactFile}\`
+
+${crossStageTraceBlock(artifactRules.crossStageTrace)}
+${artifactValidationBlock(artifactRules.artifactValidation)}
+
+## Review Lens
+## Outputs
+${reviewLens.outputs.map((item) => `- ${item}`).join("\n")}
+
+${reviewSectionsBlock(reviewLens.reviewSections)}
+
 ## Shared Stage Guidance
 See:
 - \`${STAGE_COMMON_GUIDANCE_REL_PATH}\`

package/package.json

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