cclaw-cli 0.51.14 → 0.51.15

package/dist/content/skills.js

@@ -135,6 +135,9 @@ This is the gate function for completion claims. No "done", "all good", or
 "tests pass" unless fresh evidence from this turn proves it.
 
 - Run verification commands (tests/build/lint/type-check) for the changed scope.
+- Before \`tdd -> review\` and \`review -> ship\`, discover the real test command
+  from repo config (package scripts, pytest/go/cargo/maven/gradle signals) and
+  cite that exact command in the gate evidence.
 - Confirm output directly; do not infer success from prior runs or green memories.
 - If this is a bug fix, capture RED -> GREEN evidence for the regression path.
 - If a command fails, report the failure as diagnostic evidence and stop before completion.

package/dist/content/stages/review.js

@@ -72,7 +72,7 @@ export const REVIEW = {
             { id: "review_layer_coverage_complete", description: "Layer coverage map in 07-review-army.json confirms spec/correctness/security/performance/architecture/external-safety tags were considered." },
             { id: "review_criticals_resolved", description: "No unresolved critical blockers remain." },
             { id: "review_army_json_valid", description: "07-review-army.json passes schema validation (validateReviewArmy)." },
-            { id: "review_trace_matrix_clean", description: "Trace matrix has no orphaned criteria/tasks/test slices for the active run." }
+            { id: "review_trace_matrix_clean", description: "Trace matrix has no orphaned criteria/tasks/test slices for the active run, and evidence cites a discovered real test command before ship handoff." }
         ],
         requiredEvidence: [
             "Artifact written to `.cclaw/artifacts/07-review.md`.",
@@ -82,6 +82,7 @@ export const REVIEW = {
             "Layer 2 sections completed with findings.",
             "Severity log includes critical/important/suggestion buckets.",
             "Explicit final verdict: APPROVED, APPROVED_WITH_CONCERNS, or BLOCKED.",
+            "Fresh verification command discovery recorded, and the command cited in `review_trace_matrix_clean` evidence before ship handoff.",
             "If BLOCKED: include explicit remediation route (`ROUTE_BACK_TO_TDD`) with blocking finding IDs."
         ],
         inputs: ["implementation diff", "spec and plan artifacts", "test/build evidence"],

package/dist/content/templates.js

@@ -754,6 +754,11 @@ Execution rule: complete and verify each batch before starting the next batch.
 - Orphaned tests: 0
 - Evidence ref:
 
+## Verification Command Discovery
+| Source | Discovered command | Result | Evidence ref |
+|---|---|---|---|
+| package.json / pytest / go.mod / Cargo.toml / pom.xml / gradle |  | PASS/FAIL |  |
+
 ## Blocked Route
 - ROUTE_BACK_TO_TDD: only when Final Verdict = BLOCKED
 - Target stage: tdd

package/dist/gate-evidence.js

@@ -44,6 +44,64 @@ function sameStringArray(a, b) {
         return false;
     return a.every((value, index) => value === b[index]);
 }
+async function readJsonFile(filePath) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(filePath, "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function discoverRealTestCommands(projectRoot) {
+    const commands = [];
+    const packageJson = await readJsonFile(path.join(projectRoot, "package.json"));
+    const scripts = packageJson?.scripts;
+    if (scripts && typeof scripts === "object" && !Array.isArray(scripts)) {
+        const scriptNames = Object.keys(scripts).filter((name) => {
+            const value = scripts[name];
+            return typeof value === "string" && (name === "test" || name.startsWith("test:"));
+        });
+        for (const name of scriptNames.sort()) {
+            commands.push(name === "test" ? "npm test" : `npm run ${name}`);
+            commands.push(name === "test" ? "pnpm test" : `pnpm ${name}`);
+            commands.push(name === "test" ? "yarn test" : `yarn ${name}`);
+            commands.push(name === "test" ? "bun test" : `bun run ${name}`);
+        }
+    }
+    if (await exists(path.join(projectRoot, "pyproject.toml")))
+        commands.push("pytest");
+    if (await exists(path.join(projectRoot, "pytest.ini")))
+        commands.push("pytest");
+    if (await exists(path.join(projectRoot, "go.mod")))
+        commands.push("go test ./...");
+    if (await exists(path.join(projectRoot, "Cargo.toml")))
+        commands.push("cargo test");
+    if (await exists(path.join(projectRoot, "pom.xml")))
+        commands.push("mvn test");
+    if (await exists(path.join(projectRoot, "build.gradle")) ||
+        await exists(path.join(projectRoot, "build.gradle.kts"))) {
+        commands.push("gradle test", "./gradlew test");
+    }
+    return unique(commands);
+}
+async function verifyDiscoveredCommandEvidence(projectRoot, stage, gateId, flowState) {
+    if (!(stage === "tdd" && gateId === "tdd_verified_before_complete") &&
+        !(stage === "review" && gateId === "review_trace_matrix_clean")) {
+        return null;
+    }
+    const commands = await discoverRealTestCommands(projectRoot);
+    if (commands.length === 0)
+        return null;
+    const evidence = flowState.guardEvidence[gateId];
+    const normalizedEvidence = typeof evidence === "string" ? evidence.toLowerCase() : "";
+    const matched = commands.some((command) => normalizedEvidence.includes(command.toLowerCase()));
+    if (matched)
+        return null;
+    return `${stage} verification gate blocked (${gateId}): guard evidence must cite one discovered real test command: ${commands.join(", ")}.`;
+}
 const RECONCILIATION_NOTICES_FILE = "reconciliation-notices.json";
 const RECONCILIATION_NOTICES_SCHEMA_VERSION = 1;
 const DESIGN_RESEARCH_REQUIRED_SECTIONS = [
@@ -203,6 +261,11 @@ export async function verifyCurrentStageGateEvidence(projectRoot, flowState) {
         const evidence = flowState.guardEvidence[gateId];
         if (typeof evidence !== "string" || evidence.trim().length === 0) {
             issues.push(`passed gate "${gateId}" is missing guardEvidence entry.`);
+            continue;
+        }
+        const discoveredCommandIssue = await verifyDiscoveredCommandEvidence(projectRoot, stage, gateId, flowState);
+        if (discoveredCommandIssue) {
+            issues.push(discoveredCommandIssue);
         }
     }
     for (const gateId of catalog.blocked) {

package/dist/internal/advance-stage.js

@@ -203,6 +203,15 @@ const GATE_EVIDENCE_VALIDATORS = {
         }
         return null;
     },
+    "review:review_trace_matrix_clean": (evidence) => {
+        if (!TEST_COMMAND_HINT_PATTERN.test(evidence)) {
+            return "must include the fresh verification command that was run before ship handoff (for example `npm test`, `pytest`, `go test`, or equivalent).";
+        }
+        if (!PASS_STATUS_PATTERN.test(evidence)) {
+            return "must include explicit success status (for example `PASS` or `GREEN`).";
+        }
+        return null;
+    },
     "ship:ship_finalization_executed": (evidence) => {
         if (!SHIP_FINALIZATION_MODE_PATTERN.test(evidence)) {
             return `must name the finalization mode that ran (for example ${SHIP_FINALIZATION_MODE_HINT}).`;

package/package.json

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