cclaw-cli 0.51.1 → 0.51.2

package/dist/content/skills.js

@@ -216,10 +216,11 @@ function completionParametersBlock(schema, track) {
 - \`artifact\`: \`${RUNTIME_ROOT}/artifacts/${schema.artifactRules.artifactFile}\`
 - \`mandatory delegations\`: ${mandatory}
 - \`completion helper\`: \`node .cclaw/hooks/stage-complete.mjs ${schema.stage}\`
+- \`completion helper with evidence\`: \`node .cclaw/hooks/stage-complete.mjs ${schema.stage} --evidence-json '{"<gate_id>":"<evidence note>"}' --passed=<gate_id>[,<gate_id>]\`
 - 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).
-- Completion protocol: verify required gates, update the artifact, then use the completion helper.
+- Never edit raw \`flow-state.json\` to complete a stage, even in advisory mode; that bypasses validation, gate evidence, and Learnings harvest. If the helper fails, stop and report the exact command/output instead of applying a manual state workaround.
+- Completion protocol: verify required gates, update the artifact, then use the completion helper with \`--evidence-json\` and \`--passed\` for every satisfied gate.
 `;
 }
 function quickStartBlock(stage, track) {

package/dist/internal/advance-stage.js

@@ -309,6 +309,19 @@ function coerceCandidateFlowState(raw, fallback) {
         stageGateCatalog: parseCandidateGateCatalog(typed.stageGateCatalog, fallback.stageGateCatalog)
     };
 }
+function stringifyGateEvidenceValue(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "boolean")
+        return value ? "passed" : "failed";
+    if (typeof value === "number" || typeof value === "bigint")
+        return String(value);
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "object")
+        return JSON.stringify(value);
+    return String(value);
+}
 function parseEvidenceByGate(raw) {
     if (!raw || raw.trim().length === 0) {
         return {};
@@ -325,12 +338,10 @@ function parseEvidenceByGate(raw) {
     }
     const next = {};
     for (const [key, value] of Object.entries(parsed)) {
-        if (typeof value !== "string")
-            continue;
-        const trimmed = value.trim();
-        if (trimmed.length === 0)
+        const normalized = stringifyGateEvidenceValue(value).trim();
+        if (normalized.length === 0)
             continue;
-        next[key] = trimmed;
+        next[key] = normalized;
     }
     return next;
 }
@@ -381,28 +392,62 @@ function parseAdvanceStageArgs(tokens) {
     let waiveDelegations = [];
     let waiverReason;
     let quiet = false;
-    for (const token of flagTokens) {
+    for (let i = 0; i < flagTokens.length; i += 1) {
+        const token = flagTokens[i];
+        const nextToken = flagTokens[i + 1];
         if (token === "--quiet") {
             quiet = true;
             continue;
         }
+        if (token === "--evidence-json") {
+            if (!nextToken || nextToken.startsWith("--")) {
+                throw new Error("--evidence-json requires a JSON object value.");
+            }
+            evidenceJson = nextToken;
+            i += 1;
+            continue;
+        }
         if (token.startsWith("--evidence-json=")) {
-            evidenceJson = token.replace("--evidence-json=", "");
+            evidenceJson = token.slice("--evidence-json=".length);
+            continue;
+        }
+        if (token === "--passed") {
+            if (!nextToken || nextToken.startsWith("--")) {
+                throw new Error("--passed requires a comma-separated gate list.");
+            }
+            passed = [...passed, ...parseCsv(nextToken)];
+            i += 1;
             continue;
         }
         if (token.startsWith("--passed=")) {
-            passed = [...passed, ...parseCsv(token.replace("--passed=", ""))];
+            passed = [...passed, ...parseCsv(token.slice("--passed=".length))];
+            continue;
+        }
+        if (token === "--waive-delegation") {
+            if (!nextToken || nextToken.startsWith("--")) {
+                throw new Error("--waive-delegation requires a comma-separated agent list.");
+            }
+            waiveDelegations = [...waiveDelegations, ...parseCsv(nextToken)];
+            i += 1;
             continue;
         }
         if (token.startsWith("--waive-delegation=")) {
             waiveDelegations = [
                 ...waiveDelegations,
-                ...parseCsv(token.replace("--waive-delegation=", ""))
+                ...parseCsv(token.slice("--waive-delegation=".length))
             ];
             continue;
         }
+        if (token === "--waiver-reason") {
+            if (!nextToken || nextToken.startsWith("--")) {
+                throw new Error("--waiver-reason requires a text value.");
+            }
+            waiverReason = nextToken.trim();
+            i += 1;
+            continue;
+        }
         if (token.startsWith("--waiver-reason=")) {
-            waiverReason = token.replace("--waiver-reason=", "").trim();
+            waiverReason = token.slice("--waiver-reason=".length).trim();
             continue;
         }
         throw new Error(`Unknown flag for internal advance-stage: ${token}`);

package/package.json

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