cclaw-cli 0.46.2 → 0.46.3

package/dist/content/stage-schema.js

@@ -43,7 +43,7 @@ const REQUIRED_GATE_IDS = {
         "tdd_red_test_written",
         "tdd_green_full_suite",
         "tdd_refactor_completed",
-        "tdd_traceable_to_plan"
+        "tdd_verified_before_complete"
     ],
     review: [
         "review_layer1_spec_compliance",

package/dist/content/stages/tdd.js

@@ -27,6 +27,7 @@ export const TDD = {
         "Dispatch `test-author` subagent in `BUILD_GREEN_REFACTOR` mode — minimal implementation + full-suite GREEN + refactor notes.",
         "GREEN: Run full suite — execute ALL tests, not just the ones you wrote. The full suite must be GREEN.",
         "GREEN: Verify no regressions — if any existing test breaks, fix the regression before proceeding.",
+        "Run verification-before-completion discipline for the slice — capture a fresh test command, commit SHA, and explicit PASS/FAIL status before completion claims.",
         "REFACTOR: Improve code quality — without changing behavior. Document what you changed and why.",
         "Record evidence — capture RED failure, GREEN output, and REFACTOR notes in the TDD artifact.",
         "Annotate traceability — link to plan task ID and spec criterion.",
@@ -40,6 +41,7 @@ export const TDD = {
         "Capture and store failing output as RED evidence.",
         "Apply minimal change to satisfy RED tests (GREEN).",
         "Run full suite, not partial checks, for GREEN validation.",
+        "Before declaring the slice complete, run a fresh verification check and record command + commit SHA + PASS/FAIL.",
         "Refactor without changing behavior and document rationale (REFACTOR).",
         "Stop if regressions appear and fix before proceeding.",
         "If a test passes unexpectedly, investigate: does the behavior already exist, or is the test wrong?",
@@ -51,6 +53,7 @@ export const TDD = {
         "Run tests and capture failure output.",
         "Dispatch `test-author` in BUILD_GREEN_REFACTOR mode and implement smallest change needed for GREEN.",
         "Run full tests and build checks.",
+        "Run a fresh verification-before-completion check and capture command + commit SHA + PASS/FAIL in guard evidence.",
         "Perform refactor pass preserving behavior.",
         "Record RED, GREEN, and REFACTOR evidence in artifact.",
         "Annotate traceability to plan task and spec criterion; on `sliceReview` triggers, append a Per-Slice Review entry before closing the slice."
@@ -59,12 +62,14 @@ export const TDD = {
         { id: "tdd_red_test_written", description: "Failing tests exist before implementation changes." },
         { id: "tdd_green_full_suite", description: "Full relevant suite passes in GREEN state." },
         { id: "tdd_refactor_completed", description: "Refactor pass completed with behavior preservation verified." },
+        { id: "tdd_verified_before_complete", description: "Fresh verification evidence includes test command, commit SHA, and explicit pass/fail status." },
         { id: "tdd_traceable_to_plan", description: "Change traceability to plan slice is explicit." }
     ],
     requiredEvidence: [
         "Artifact updated at `.cclaw/artifacts/06-tdd.md` with RED, GREEN, and REFACTOR sections.",
         "Failing command output captured (RED).",
         "Full test/build output recorded (GREEN).",
+        "Fresh verification evidence recorded with command, commit SHA, and PASS/FAIL status before completion.",
         "Acceptance mapping documented.",
         "Failure reason analysis recorded.",
         "Refactor rationale captured.",

package/dist/internal/advance-stage.js

@@ -13,6 +13,25 @@ import { FLOW_STAGES } from "../types.js";
 function unique(values) {
     return [...new Set(values)];
 }
+const TEST_COMMAND_HINT_PATTERN = /\b(?:npm test|pnpm test|yarn test|bun test|vitest|jest|pytest|go test|cargo test|mvn test|gradle test|dotnet test)\b/iu;
+const SHA_WITH_LABEL_PATTERN = /\b(?:sha|commit)(?:\s*[:=]|\s+)\s*[0-9a-f]{7,40}\b/iu;
+const PASS_STATUS_PATTERN = /\b(?:pass|passed|green|ok)\b/iu;
+function validateGateEvidenceShape(stage, gateId, evidence) {
+    if (stage !== "tdd" || gateId !== "tdd_verified_before_complete") {
+        return null;
+    }
+    const trimmed = evidence.trim();
+    if (!TEST_COMMAND_HINT_PATTERN.test(trimmed)) {
+        return "must include the fresh verification command that was run (for example `npm test`, `pytest`, `go test`, or equivalent).";
+    }
+    if (!SHA_WITH_LABEL_PATTERN.test(trimmed)) {
+        return "must include a commit SHA token prefixed with `sha` or `commit` (for example `sha: abc1234`).";
+    }
+    if (!PASS_STATUS_PATTERN.test(trimmed)) {
+        return "must include explicit success status (for example `PASS` or `GREEN`).";
+    }
+    return null;
+}
 function parseStringList(raw) {
     if (!Array.isArray(raw))
         return [];
@@ -392,6 +411,21 @@ async function runAdvanceStage(projectRoot, args, io) {
         io.stderr.write(`cclaw internal advance-stage: missing --evidence-json entries for passed gates: ${missingGuardEvidence.join(", ")}.\n`);
         return 1;
     }
+    const malformedGateEvidence = nextPassed.flatMap((gateId) => {
+        const provided = args.evidenceByGate[gateId];
+        const existing = flowState.guardEvidence[gateId];
+        const effectiveEvidence = typeof provided === "string" && provided.trim().length > 0
+            ? provided
+            : typeof existing === "string" && existing.trim().length > 0
+                ? existing
+                : "";
+        const issue = validateGateEvidenceShape(args.stage, gateId, effectiveEvidence);
+        return issue ? [`${gateId}: ${issue}`] : [];
+    });
+    if (malformedGateEvidence.length > 0) {
+        io.stderr.write(`cclaw internal advance-stage: gate evidence format check failed: ${malformedGateEvidence.join(" | ")}.\n`);
+        return 1;
+    }
     const nextGuardEvidence = { ...flowState.guardEvidence };
     for (const gateId of nextPassed) {
         const provided = args.evidenceByGate[gateId];

package/package.json

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