cclaw-cli 0.46.0 → 0.46.2

package/dist/runs.js

@@ -374,6 +374,19 @@ async function uniqueArchiveId(projectRoot, baseId) {
 function retroArtifactPath(projectRoot) {
     return path.join(activeArtifactsPath(projectRoot), "09-retro.md");
 }
+function parseIsoTimestamp(value) {
+    if (!value || value.trim().length === 0)
+        return null;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function inInclusiveWindow(timestamp, windowStartMs, windowEndMs) {
+    if (windowStartMs !== null && timestamp < windowStartMs)
+        return false;
+    if (windowEndMs !== null && timestamp > windowEndMs)
+        return false;
+    return true;
+}
 async function evaluateRetroGate(projectRoot, state) {
     const required = state.completedStages.includes("ship");
     const artifactFile = retroArtifactPath(projectRoot);
@@ -387,18 +400,33 @@ async function evaluateRetroGate(projectRoot, state) {
             hasRetroArtifact = false;
         }
     }
+    let compoundEntries = state.retro.compoundEntries;
+    const windowStartMs = parseIsoTimestamp(state.closeout.retroDraftedAt);
+    const windowEndMs = parseIsoTimestamp(state.closeout.retroAcceptedAt) ?? parseIsoTimestamp(state.retro.completedAt);
+    const shouldFallbackScan = compoundEntries <= 0 && (windowStartMs !== null || windowEndMs !== null);
     const knowledgeFile = path.join(projectRoot, RUNTIME_ROOT, "knowledge.jsonl");
-    let compoundEntries = 0;
-    if (await exists(knowledgeFile)) {
+    if (shouldFallbackScan && (await exists(knowledgeFile))) {
         try {
             const raw = await fs.readFile(knowledgeFile, "utf8");
+            compoundEntries = 0;
             for (const line of raw.split(/\r?\n/)) {
                 const trimmed = line.trim();
                 if (!trimmed)
                     continue;
                 try {
                     const parsed = JSON.parse(trimmed);
-                    if (parsed.type === "compound") {
+                    if (parsed.type !== "compound") {
+                        continue;
+                    }
+                    const created = typeof parsed.created === "string" ? parseIsoTimestamp(parsed.created) : null;
+                    if (created === null || !inInclusiveWindow(created, windowStartMs, windowEndMs)) {
+                        continue;
+                    }
+                    const source = typeof parsed.source === "string"
+                        ? parsed.source.trim().toLowerCase()
+                        : null;
+                    const legacyRetroStage = parsed.stage === "retro";
+                    if (source === "retro" || legacyRetroStage) {
                         compoundEntries += 1;
                     }
                 }
@@ -563,6 +591,7 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
     const archiveArtifactsPath = path.join(archivePath, "artifacts");
     let sourceState = await readFlowState(projectRoot);
     const retroGate = await evaluateRetroGate(projectRoot, sourceState);
+    const shipCompleted = sourceState.completedStages.includes("ship");
     const skipRetro = options.skipRetro === true;
     const skipRetroReason = options.skipRetroReason?.trim();
     if (skipRetro && (!skipRetroReason || skipRetroReason.length === 0)) {
@@ -571,6 +600,12 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
     const retroSkippedInCloseout = sourceState.closeout.retroSkipped === true &&
         typeof sourceState.closeout.retroSkipReason === "string" &&
         sourceState.closeout.retroSkipReason.trim().length > 0;
+    const readyForArchive = sourceState.closeout.shipSubstate === "ready_to_archive";
+    if (shipCompleted && !readyForArchive && !skipRetro) {
+        throw new Error("Archive blocked: closeout is not ready_to_archive. " +
+            "Resume /cc-next until closeout reaches ready_to_archive, " +
+            "or run `cclaw archive --skip-retro --retro-reason=<text>` for CLI-only flows.");
+    }
     if (retroGate.required && !retroGate.completed && !skipRetro && !retroSkippedInCloseout) {
         throw new Error("Archive blocked: retro gate is required after ship completion. " +
             "Run /cc-next (auto-runs retro) or, for CLI-only flows, re-run `cclaw archive --skip-retro --retro-reason=<text>`.");
@@ -590,8 +625,12 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
     const retroSummary = {
         required: retroGate.required,
         completed: retroGate.completed,
-        skipped: skipRetro,
-        skipReason: skipRetro ? skipRetroReason : undefined,
+        skipped: skipRetro || retroSkippedInCloseout,
+        skipReason: skipRetro
+            ? skipRetroReason
+            : retroSkippedInCloseout
+                ? sourceState.closeout.retroSkipReason
+                : undefined,
         compoundEntries: retroGate.compoundEntries
     };
     await ensureDir(archivePath);

package/dist/tdd-cycle.js

@@ -48,6 +48,14 @@ export function validateTddCycleOrder(entries, options = {}) {
         let state = "need_red";
         for (const entry of sliceEntries) {
             if (entry.phase === "red") {
+                if (entry.exitCode === undefined) {
+                    issues.push(`slice ${slice}: red entry must record a non-zero exitCode`);
+                    continue;
+                }
+                if (entry.exitCode === 0) {
+                    issues.push(`slice ${slice}: red entry exitCode must be non-zero`);
+                    continue;
+                }
                 if (state === "red_open") {
                     issues.push(`slice ${slice}: duplicate red before green`);
                     continue;
@@ -56,6 +64,14 @@ export function validateTddCycleOrder(entries, options = {}) {
                 continue;
             }
             if (entry.phase === "green") {
+                if (entry.exitCode === undefined) {
+                    issues.push(`slice ${slice}: green entry must record exitCode 0`);
+                    continue;
+                }
+                if (entry.exitCode !== 0) {
+                    issues.push(`slice ${slice}: green entry exitCode must be 0`);
+                    continue;
+                }
                 if (state !== "red_open") {
                     issues.push(`slice ${slice}: green logged before red`);
                     continue;

package/package.json

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