cclaw-cli 0.47.0 → 0.48.0

package/dist/policy.js

@@ -1,6 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { COMMAND_FILE_ORDER, RUNTIME_ROOT } from "./constants.js";
+import { RUNTIME_ROOT } from "./constants.js";
+import { FLOW_STAGES } from "./types.js";
 import { stageSchema, stagePolicyNeedles } from "./content/stage-schema.js";
 import { stageSkillFolder } from "./content/skills.js";
 import { exists } from "./fs-utils.js";
@@ -10,7 +11,7 @@ export async function policyChecks(projectRoot, options = {}) {
     const checks = [];
     const rules = [...POLICY_RULES];
     const activeHarnesses = new Set(options.harnesses && options.harnesses.length > 0 ? options.harnesses : ALL_HARNESSES);
-    for (const stage of COMMAND_FILE_ORDER) {
+    for (const stage of FLOW_STAGES) {
         const folder = stageSkillFolder(stage);
         const schema = stageSchema(stage);
         const commandFile = `${RUNTIME_ROOT}/commands/${stage}.md`;

package/dist/retro-gate.js

@@ -8,6 +8,7 @@ function activeArtifactsPath(projectRoot) {
 function retroArtifactPath(projectRoot) {
     return path.join(activeArtifactsPath(projectRoot), "09-retro.md");
 }
+const RETRO_ARTIFACT_MTIME_FALLBACK_WINDOW_MS = 24 * 60 * 60 * 1000;
 function parseIsoTimestamp(value) {
     if (!value || value.trim().length === 0)
         return null;
@@ -35,8 +36,24 @@ export async function evaluateRetroGate(projectRoot, state) {
         }
     }
     let compoundEntries = state.retro.compoundEntries;
-    const windowStartMs = parseIsoTimestamp(state.closeout.retroDraftedAt);
-    const windowEndMs = parseIsoTimestamp(state.closeout.retroAcceptedAt) ?? parseIsoTimestamp(state.retro.completedAt);
+    let windowStartMs = parseIsoTimestamp(state.closeout.retroDraftedAt);
+    let windowEndMs = parseIsoTimestamp(state.closeout.retroAcceptedAt) ?? parseIsoTimestamp(state.retro.completedAt);
+    if (compoundEntries <= 0 &&
+        hasRetroArtifact &&
+        windowStartMs === null &&
+        windowEndMs === null) {
+        try {
+            const stats = await fs.stat(artifactFile);
+            const anchor = stats.mtimeMs;
+            if (Number.isFinite(anchor) && anchor > 0) {
+                windowStartMs = anchor - RETRO_ARTIFACT_MTIME_FALLBACK_WINDOW_MS;
+                windowEndMs = anchor + RETRO_ARTIFACT_MTIME_FALLBACK_WINDOW_MS;
+            }
+        }
+        catch {
+            // fallback scan remains disabled when mtime cannot be read
+        }
+    }
     const shouldFallbackScan = compoundEntries <= 0 && (windowStartMs !== null || windowEndMs !== null);
     const knowledgeFile = path.join(projectRoot, RUNTIME_ROOT, "knowledge.jsonl");
     if (shouldFallbackScan && (await exists(knowledgeFile))) {

package/dist/run-persistence.js

@@ -1,9 +1,10 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { COMMAND_FILE_ORDER, RUNTIME_ROOT } from "./constants.js";
+import { RUNTIME_ROOT } from "./constants.js";
 import { canTransition, createInitialCloseoutState, createInitialFlowState, isFlowTrack, skippedStagesForTrack, SHIP_SUBSTATES } from "./flow-state.js";
 import { ensureFeatureSystem, syncActiveFeatureSnapshot } from "./feature-system.js";
 import { ensureDir, exists, withDirectoryLock, writeFileSafe } from "./fs-utils.js";
+import { FLOW_STAGES } from "./types.js";
 export class InvalidStageTransitionError extends Error {
     from;
     to;
@@ -17,7 +18,7 @@ export class InvalidStageTransitionError extends Error {
 const FLOW_STATE_REL_PATH = `${RUNTIME_ROOT}/state/flow-state.json`;
 const RUNS_DIR_REL_PATH = `${RUNTIME_ROOT}/runs`;
 const ACTIVE_ARTIFACTS_REL_PATH = `${RUNTIME_ROOT}/artifacts`;
-const FLOW_STAGE_SET = new Set(COMMAND_FILE_ORDER);
+const FLOW_STAGE_SET = new Set(FLOW_STAGES);
 function validateFlowTransition(prev, next) {
     if (prev.activeRunId !== next.activeRunId) {
         // New run — only reset paths may change the runId, but those set allowReset.
@@ -85,7 +86,7 @@ function sanitizeGuardEvidence(value) {
 function sanitizeStageGateCatalog(value, fallback) {
     const uniqueStrings = (items) => [...new Set(items)];
     const next = {};
-    for (const stage of COMMAND_FILE_ORDER) {
+    for (const stage of FLOW_STAGES) {
         const base = fallback[stage];
         next[stage] = {
             required: [...base.required],
@@ -100,7 +101,7 @@ function sanitizeStageGateCatalog(value, fallback) {
         return next;
     }
     const rawCatalog = value;
-    for (const stage of COMMAND_FILE_ORDER) {
+    for (const stage of FLOW_STAGES) {
         const rawStage = rawCatalog[stage];
         if (!rawStage || typeof rawStage !== "object" || Array.isArray(rawStage)) {
             continue;

package/dist/types.d.ts

@@ -109,7 +109,7 @@ export interface TddPathConfig {
 export interface CompoundConfig {
     recurrenceThreshold?: number;
 }
-export interface VibyConfig {
+export interface CclawConfig {
     version: string;
     flowVersion: string;
     harnesses: HarnessId[];
@@ -141,6 +141,7 @@ export interface VibyConfig {
     /**
      * Legacy alias for test-side path detection in workflow-guard.
      * Prefer `tdd.testPathPatterns` in new configs.
+     * @deprecated Use `tdd.testPathPatterns` instead.
      */
     tddTestGlobs?: string[];
     /** Path-pattern routing for TDD test/production write classification. */
@@ -173,6 +174,10 @@ export interface VibyConfig {
      */
     sliceReview?: SliceReviewConfig;
 }
+/**
+ * @deprecated Use `CclawConfig` instead.
+ */
+export type VibyConfig = CclawConfig;
 export interface TransitionRule {
     from: FlowStage;
     to: FlowStage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cclaw-cli",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "Installer-first flow toolkit for coding agents",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:mutation": "stryker run",
     "smoke:runtime": "npm run build && node scripts/smoke-init.mjs",
     "lint:hooks": "npm run build && node scripts/lint-generated-hooks.mjs",
     "build:harness-docs": "npm run build && node scripts/build-harness-docs.mjs",
@@ -44,6 +45,8 @@
     "yaml": "^2.8.1"
   },
   "devDependencies": {
+    "@stryker-mutator/core": "^9.6.1",
+    "@stryker-mutator/vitest-runner": "^9.6.1",
     "@types/node": "^24.7.2",
     "@vitest/coverage-v8": "^3.2.4",
     "typescript": "^5.9.3",