cclaw-cli 0.12.0 → 0.13.0

package/dist/cli.d.ts

@@ -14,6 +14,8 @@ interface ParsedArgs {
     doctorQuiet?: boolean;
     doctorOnly?: string[];
     archiveName?: string;
+    archiveSkipRetro?: boolean;
+    archiveSkipRetroReason?: string;
     showHelp?: boolean;
     showVersion?: boolean;
 }

package/dist/cli.js

@@ -39,6 +39,8 @@ Commands:
                     --quiet             Print only failing checks (and totals).
   archive    Move .cclaw/artifacts into .cclaw/runs/<date>-<slug> and reset flow state.
              Flags: --name=<feature>    Feature slug (default: inferred from 00-idea.md).
+                    --skip-retro       Bypass mandatory retro gate (requires --retro-reason).
+                    --retro-reason=<t> Reason for bypassing retro gate.
   upgrade    Refresh generated files in .cclaw without modifying user artifacts.
   uninstall  Remove .cclaw runtime and the generated harness shim files.
 
@@ -368,6 +370,14 @@ function parseArgs(argv) {
         }
         if (flag.startsWith("--name=")) {
             parsed.archiveName = flag.replace("--name=", "").trim();
+            continue;
+        }
+        if (flag === "--skip-retro") {
+            parsed.archiveSkipRetro = true;
+            continue;
+        }
+        if (flag.startsWith("--retro-reason=")) {
+            parsed.archiveSkipRetroReason = flag.replace("--retro-reason=", "").trim();
         }
     }
     return parsed;
@@ -466,7 +476,10 @@ async function runCommand(parsed, ctx) {
         return 0;
     }
     if (command === "archive") {
-        const archived = await archiveRun(ctx.cwd, parsed.archiveName);
+        const archived = await archiveRun(ctx.cwd, parsed.archiveName, {
+            skipRetro: parsed.archiveSkipRetro === true,
+            skipRetroReason: parsed.archiveSkipRetroReason
+        });
         const snapshotSummary = archived.snapshottedStateFiles.length > 0
             ? ` Snapshotted ${archived.snapshottedStateFiles.length} state file(s) under ${archived.archivePath}/state and wrote archive-manifest.json.`
             : "";

package/dist/config.js

@@ -17,6 +17,8 @@ const ALLOWED_CONFIG_KEYS = new Set([
     "harnesses",
     "autoAdvance",
     "promptGuardMode",
+    "tddEnforcement",
+    "tddTestGlobs",
     "gitHookGuards",
     "defaultTrack",
     "languageRulePacks",
@@ -60,6 +62,8 @@ export function createDefaultConfig(harnesses = DEFAULT_HARNESSES, defaultTrack
         harnesses,
         autoAdvance: false,
         promptGuardMode: "advisory",
+        tddEnforcement: "advisory",
+        tddTestGlobs: ["**/*.test.*", "**/*.spec.*", "**/test/**"],
         gitHookGuards: false,
         defaultTrack,
         languageRulePacks: []
@@ -79,6 +83,7 @@ export function createProfileConfig(profile, overrides = {}) {
                 harnesses: overrides.harnesses ?? ["claude"],
                 autoAdvance: false,
                 promptGuardMode: "advisory",
+                tddEnforcement: "advisory",
                 gitHookGuards: false,
                 defaultTrack: overrides.defaultTrack ?? "medium",
                 languageRulePacks: overrides.languageRulePacks ?? []
@@ -89,6 +94,7 @@ export function createProfileConfig(profile, overrides = {}) {
                 harnesses: overrides.harnesses ?? DEFAULT_HARNESSES,
                 autoAdvance: false,
                 promptGuardMode: "advisory",
+                tddEnforcement: "advisory",
                 gitHookGuards: false,
                 defaultTrack: overrides.defaultTrack ?? "standard",
                 languageRulePacks: overrides.languageRulePacks ?? []
@@ -99,6 +105,7 @@ export function createProfileConfig(profile, overrides = {}) {
                 harnesses: overrides.harnesses ?? DEFAULT_HARNESSES,
                 autoAdvance: false,
                 promptGuardMode: "strict",
+                tddEnforcement: "strict",
                 gitHookGuards: true,
                 defaultTrack: overrides.defaultTrack ?? "standard",
                 languageRulePacks: overrides.languageRulePacks ?? [...LANGUAGE_RULE_PACKS]
@@ -149,6 +156,16 @@ export async function readConfig(projectRoot) {
         throw configValidationError(fullPath, `"promptGuardMode" must be "advisory" or "strict"`);
     }
     const promptGuardMode = promptGuardModeRaw === "strict" ? "strict" : "advisory";
+    const tddEnforcementRaw = parsed.tddEnforcement;
+    if (Object.prototype.hasOwnProperty.call(parsed, "tddEnforcement") &&
+        tddEnforcementRaw !== "advisory" &&
+        tddEnforcementRaw !== "strict") {
+        throw configValidationError(fullPath, `"tddEnforcement" must be "advisory" or "strict"`);
+    }
+    const tddEnforcement = tddEnforcementRaw === "strict" ? "strict" : "advisory";
+    const tddTestGlobsRaw = parsed.tddTestGlobs;
+    const tddTestGlobs = validateStringArray(tddTestGlobsRaw, "tddTestGlobs", fullPath)
+        ?? ["**/*.test.*", "**/*.spec.*", "**/test/**"];
     const gitHookGuardsRaw = parsed.gitHookGuards;
     if (Object.prototype.hasOwnProperty.call(parsed, "gitHookGuards") &&
         typeof gitHookGuardsRaw !== "boolean") {
@@ -246,6 +263,8 @@ export async function readConfig(projectRoot) {
         harnesses,
         autoAdvance,
         promptGuardMode,
+        tddEnforcement,
+        tddTestGlobs,
         gitHookGuards,
         defaultTrack,
         languageRulePacks,

package/dist/constants.d.ts

@@ -4,9 +4,9 @@ export declare const RUNTIME_ROOT = ".cclaw";
 export declare const CCLAW_VERSION = "0.1.1";
 export declare const FLOW_VERSION = "1.0.0";
 export declare const DEFAULT_HARNESSES: HarnessId[];
-export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/contexts", ".cclaw/templates", ".cclaw/artifacts", ".cclaw/state", ".cclaw/runs", ".cclaw/rules", ".cclaw/adapters", ".cclaw/agents", ".cclaw/hooks", ".cclaw/custom-skills"];
+export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/contexts", ".cclaw/templates", ".cclaw/artifacts", ".cclaw/features", ".cclaw/state", ".cclaw/runs", ".cclaw/rules", ".cclaw/adapters", ".cclaw/agents", ".cclaw/hooks", ".cclaw/custom-skills"];
 export declare const REQUIRED_GITIGNORE_PATTERNS: readonly ["# cclaw generated artifacts", ".cclaw/", ".claude/commands/cc-*.md", ".claude/commands/cc.md", ".cursor/commands/cc-*.md", ".cursor/commands/cc.md", ".opencode/commands/cc-*.md", ".opencode/commands/cc.md", ".codex/commands/cc-*.md", ".codex/commands/cc.md", ".claude/hooks/hooks.json", ".cursor/hooks.json", ".codex/hooks.json", ".opencode/plugins/cclaw-plugin.mjs", ".cursor/rules/cclaw-workflow.mdc"];
 export declare const COMMAND_FILE_ORDER: FlowStage[];
-export declare const UTILITY_COMMANDS: readonly ["learn", "next", "status"];
+export declare const UTILITY_COMMANDS: readonly ["learn", "next", "status", "tree", "diff", "feature", "tdd-log", "retro", "rewind", "rewind-ack"];
 export declare const SUBAGENT_SKILL_FOLDERS: readonly ["subagent-dev", "parallel-dispatch"];
 export type UtilityCommand = (typeof UTILITY_COMMANDS)[number];

package/dist/constants.js

@@ -15,6 +15,7 @@ export const REQUIRED_DIRS = [
     `${RUNTIME_ROOT}/contexts`,
     `${RUNTIME_ROOT}/templates`,
     `${RUNTIME_ROOT}/artifacts`,
+    `${RUNTIME_ROOT}/features`,
     `${RUNTIME_ROOT}/state`,
     `${RUNTIME_ROOT}/runs`,
     `${RUNTIME_ROOT}/rules`,
@@ -50,7 +51,18 @@ export const COMMAND_FILE_ORDER = [
     "review",
     "ship"
 ];
-export const UTILITY_COMMANDS = ["learn", "next", "status"];
+export const UTILITY_COMMANDS = [
+    "learn",
+    "next",
+    "status",
+    "tree",
+    "diff",
+    "feature",
+    "tdd-log",
+    "retro",
+    "rewind",
+    "rewind-ack"
+];
 export const SUBAGENT_SKILL_FOLDERS = [
     "subagent-dev",
     "parallel-dispatch"

package/dist/content/diff-command.d.ts

@@ -0,0 +1,2 @@
+export declare function diffCommandContract(): string;
+export declare function diffCommandSkillMarkdown(): string;

package/dist/content/diff-command.js

@@ -0,0 +1,83 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const DIFF_SKILL_FOLDER = "flow-diff";
+const DIFF_SKILL_NAME = "flow-diff";
+function flowStatePath() {
+    return `${RUNTIME_ROOT}/state/flow-state.json`;
+}
+function snapshotPath() {
+    return `${RUNTIME_ROOT}/state/flow-state.snapshot.json`;
+}
+export function diffCommandContract() {
+    return `# /cc-diff
+
+## Purpose
+
+Show a visual before/after diff map for flow-state progression.
+
+## HARD-GATE
+
+- Compare against \`${snapshotPath()}\` first; do not overwrite baseline before rendering.
+- If no snapshot exists, initialize baseline and report "baseline created" explicitly.
+
+## Algorithm
+
+1. Read current state from \`${flowStatePath()}\`.
+2. Read baseline from \`${snapshotPath()}\` (if missing -> create baseline from current state and stop).
+3. Compute deltas:
+   - stage transition (\`from -> to\`)
+   - completed stage additions/removals
+   - skipped stage additions/removals
+   - stale stage additions/removals
+   - current-stage gate \`passed\` and \`blocked\` changes
+4. Render a compact diff map (added \`+\`, removed \`-\`, changed \`->\`).
+5. Persist current state back to \`${snapshotPath()}\` as new baseline with \`capturedAt\`.
+
+## Diff Map Format
+
+\`\`\`
+cclaw flow diff
+  stage: design -> spec
+  completed: +design
+  stale: -design
+  gates(spec): +spec_contract_complete  -spec_open_questions_closed
+  blocked(spec): +spec_trace_matrix_missing
+\`\`\`
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${DIFF_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function diffCommandSkillMarkdown() {
+    return `---
+name: ${DIFF_SKILL_NAME}
+description: "Compare current flow-state against saved snapshot and render gate/stage deltas."
+---
+
+# /cc-diff
+
+## HARD-GATE
+
+Never lose baseline visibility: render deltas before writing a new snapshot.
+
+## Protocol
+
+1. Read \`${flowStatePath()}\`.
+2. Read \`${snapshotPath()}\`.
+3. If snapshot missing:
+   - write baseline snapshot from current state,
+   - print \`flow diff baseline created\`,
+   - stop.
+4. Build deltas for stage, completed/skipped/stale sets, and current-stage gate arrays.
+5. Print a compact diff map with explicit \`+\`, \`-\`, and \`->\` markers.
+6. Write updated snapshot with:
+   - \`capturedAt\` (ISO)
+   - \`state\` (full current flow-state object)
+
+## Validation
+
+- Diff output must be deterministic for identical states ("no changes").
+- Snapshot file stays valid JSON after every run.
+- Do not suppress removed values; removals are first-class evidence.
+`;
+}

package/dist/content/feature-command.d.ts

@@ -0,0 +1,2 @@
+export declare function featureCommandContract(): string;
+export declare function featureCommandSkillMarkdown(): string;

package/dist/content/feature-command.js

@@ -0,0 +1,120 @@
+import { RUNTIME_ROOT } from "../constants.js";
+const FEATURE_SKILL_FOLDER = "feature-workspaces";
+const FEATURE_SKILL_NAME = "feature-workspaces";
+function activeFeaturePath() {
+    return `${RUNTIME_ROOT}/state/active-feature.json`;
+}
+function featuresRoot() {
+    return `${RUNTIME_ROOT}/features`;
+}
+function runtimeArtifactsPath() {
+    return `${RUNTIME_ROOT}/artifacts`;
+}
+function runtimeStatePath() {
+    return `${RUNTIME_ROOT}/state`;
+}
+export function featureCommandContract() {
+    return `# /cc-feature
+
+## Purpose
+
+Manage multi-feature workspaces without flow-state/artifact collisions.
+
+The active runtime remains:
+- \`${runtimeArtifactsPath()}\` (active artifacts)
+- \`${runtimeStatePath()}\` (active state)
+
+Feature snapshots live under \`${featuresRoot()}/<feature-id>/\`.
+
+## HARD-GATE
+
+- Never overwrite another feature snapshot silently.
+- Before switching feature, snapshot the current active runtime first.
+- Keep \`${activeFeaturePath()}\` as the single source of "current feature".
+
+## Subcommands
+
+### \`/cc-feature status\`
+Show active feature id and snapshot location.
+
+### \`/cc-feature list\`
+List all feature ids in \`${featuresRoot()}/\` (directory names).
+
+### \`/cc-feature new <feature-id>\`
+Create \`${featuresRoot()}/<feature-id>/artifacts\` and \`${featuresRoot()}/<feature-id>/state\`.
+
+Optional flag:
+- \`--clone-active\`: clone current active runtime into the new feature snapshot.
+
+### \`/cc-feature switch <feature-id>\`
+1. Snapshot current active runtime into \`${featuresRoot()}/<active>/\`.
+2. Restore target snapshot from \`${featuresRoot()}/<feature-id>/\` into active runtime:
+   - \`${runtimeArtifactsPath()}\`
+   - \`${runtimeStatePath()}\` (preserve \`active-feature.json\`)
+3. Update \`${activeFeaturePath()}\` with \`activeFeature=<feature-id>\`.
+
+If the target snapshot is empty, initialize runtime as a fresh flow.
+
+## Output
+
+Always print:
+- active feature before
+- active feature after
+- whether snapshot/restore changed files
+
+## Primary skill
+
+**${RUNTIME_ROOT}/skills/${FEATURE_SKILL_FOLDER}/SKILL.md**
+`;
+}
+export function featureCommandSkillMarkdown() {
+    return `---
+name: ${FEATURE_SKILL_NAME}
+description: "Manage cclaw multi-feature workspaces (status/list/new/switch) while preserving active flow runtime."
+---
+
+# /cc-feature — Feature Workspace Manager
+
+## HARD-GATE
+
+Do not switch feature by editing only \`active-feature.json\`. A valid switch must snapshot current runtime and restore target runtime.
+
+## Paths
+
+- Active pointer: \`${activeFeaturePath()}\`
+- Feature snapshots: \`${featuresRoot()}/<feature-id>/\`
+- Active runtime artifacts: \`${runtimeArtifactsPath()}\`
+- Active runtime state: \`${runtimeStatePath()}\`
+
+## Protocol
+
+### status
+1. Read \`${activeFeaturePath()}\`.
+2. Print active feature id and its snapshot folder.
+
+### list
+1. Enumerate directories in \`${featuresRoot()}/\`.
+2. Mark the active one.
+
+### new <feature-id> [--clone-active]
+1. Validate \`feature-id\` (lowercase slug, letters/numbers/dashes).
+2. Create snapshot dirs:
+   - \`${featuresRoot()}/<feature-id>/artifacts\`
+   - \`${featuresRoot()}/<feature-id>/state\`
+3. If \`--clone-active\`: copy active runtime artifacts/state into the new snapshot.
+4. Do not change active feature unless the user explicitly requests switch.
+
+### switch <feature-id>
+1. Read current active feature id.
+2. Snapshot current runtime into current feature snapshot.
+3. Restore target snapshot into active runtime.
+4. Update \`${activeFeaturePath()}\`.
+5. Report stage/run after restore (\`flow-state.json\`).
+
+## Safety checks
+
+- If target feature does not exist: block and suggest \`/cc-feature new <id>\`.
+- If snapshot copy fails: abort switch, keep current active feature unchanged.
+- Preserve global pointer file \`active-feature.json\` when restoring state.
+`;
+}

package/dist/content/harnesses-doc.js

@@ -66,6 +66,14 @@ All harnesses receive the same utility commands:
 - \`/cc\` - flow entry and resume
 - \`/cc-next\` - stage progression
 - \`/cc-learn\` - knowledge capture/lookup
+- \`/cc-status\` - read-only visual flow snapshot
+- \`/cc-tree\` - deep flow tree (stages, artifacts, stale markers)
+- \`/cc-diff\` - before/after flow-state diff map
+- \`/cc-feature\` - multi-feature workspace management
+- \`/cc-tdd-log\` - explicit RED/GREEN/REFACTOR evidence log
+- \`/cc-retro\` - mandatory retrospective gate before archive
+- \`/cc-rewind\` - rewind flow and invalidate downstream stages
+- \`/cc-rewind-ack\` - clear stale stage markers after redo
 
 Stage order remains canonical:
 \`brainstorm -> scope -> design -> spec -> plan -> tdd -> review -> ship\`

package/dist/content/hooks.js

@@ -45,6 +45,7 @@ set -euo pipefail
 ${DETECT_ROOT}
 
 STATE_FILE="$ROOT/${RUNTIME_ROOT}/state/flow-state.json"
+ACTIVE_FEATURE_FILE="$ROOT/${RUNTIME_ROOT}/state/active-feature.json"
 CHECKPOINT_FILE="$ROOT/${RUNTIME_ROOT}/state/checkpoint.json"
 ACTIVITY_FILE="$ROOT/${RUNTIME_ROOT}/state/stage-activity.jsonl"
 SUGGESTION_MEMORY_FILE="$ROOT/${RUNTIME_ROOT}/state/suggestion-memory.json"
@@ -59,13 +60,16 @@ META_SKILL="$ROOT/${RUNTIME_ROOT}/skills/${META_SKILL_NAME}/SKILL.md"
 STAGE="none"
 COMPLETED="0"
 ACTIVE_RUN="none"
+ACTIVE_FEATURE="default"
 ACTIVE_CONTEXT_MODE="default"
+STALE_STAGES=""
 CONTEXT_MODE_NOTE=""
 if [ -f "$STATE_FILE" ]; then
   if command -v jq >/dev/null 2>&1; then
     STAGE=$(jq -r '.currentStage // "none"' "$STATE_FILE" 2>/dev/null || echo "none")
     COMPLETED=$(jq -r '(.completedStages | length) // 0' "$STATE_FILE" 2>/dev/null || echo "0")
     ACTIVE_RUN=$(jq -r '.activeRunId // "none"' "$STATE_FILE" 2>/dev/null || echo "none")
+    STALE_STAGES=$(jq -r '(.staleStages // {} | keys | join(", "))' "$STATE_FILE" 2>/dev/null || echo "")
   else
     if command -v python3 >/dev/null 2>&1; then
       STAGE=$(python3 - "$STATE_FILE" <<'PY'
@@ -115,6 +119,22 @@ except Exception:
     pass
 print(run)
 PY
+)
+      STALE_STAGES=$(python3 - "$STATE_FILE" <<'PY'
+import json
+import sys
+value = ""
+try:
+    with open(sys.argv[1], "r", encoding="utf-8") as fh:
+        data = json.load(fh)
+    stale = data.get("staleStages", {})
+    if isinstance(stale, dict):
+        keys = [k for k, v in stale.items() if isinstance(v, dict)]
+        value = ", ".join(keys)
+except Exception:
+    pass
+print(value)
+PY
 )
     else
       STAGE=$(grep -o '"currentStage"[[:space:]]*:[[:space:]]*"[^"]*"' "$STATE_FILE" 2>/dev/null | head -1 | sed 's/.*"\\([^"]*\\)"$/\\1/' || echo "none")
@@ -129,6 +149,28 @@ PY
   fi
 fi
 
+if [ -f "$ACTIVE_FEATURE_FILE" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    ACTIVE_FEATURE=$(jq -r '.activeFeature // "default"' "$ACTIVE_FEATURE_FILE" 2>/dev/null || echo "default")
+  elif command -v python3 >/dev/null 2>&1; then
+    ACTIVE_FEATURE=$(python3 - "$ACTIVE_FEATURE_FILE" <<'PY'
+import json
+import sys
+feature = "default"
+try:
+    with open(sys.argv[1], "r", encoding="utf-8") as fh:
+        data = json.load(fh)
+    value = data.get("activeFeature")
+    if isinstance(value, str) and value:
+        feature = value
+except Exception:
+    pass
+print(feature)
+PY
+)
+  fi
+fi
+
 if [ -f "$CONTEXT_MODE_FILE" ]; then
   if command -v jq >/dev/null 2>&1; then
     ACTIVE_CONTEXT_MODE=$(jq -r '.activeMode // "default"' "$CONTEXT_MODE_FILE" 2>/dev/null || echo "default")
@@ -415,7 +457,7 @@ if [ -n "$ROUTING_MISSING" ]; then
 fi
 
 # --- Build context message ---
-CTX="cclaw loaded. Flow: stage=$STAGE ($COMPLETED/8 completed, run=$ACTIVE_RUN). Active artifacts: ${RUNTIME_ROOT}/artifacts/. Learnings: $LEARNINGS_COUNT entries."
+CTX="cclaw loaded. Flow: stage=$STAGE ($COMPLETED/8 completed, run=$ACTIVE_RUN, feature=$ACTIVE_FEATURE). Active artifacts: ${RUNTIME_ROOT}/artifacts/. Feature snapshots: ${RUNTIME_ROOT}/features/$ACTIVE_FEATURE/. Learnings: $LEARNINGS_COUNT entries."
 if [ -n "$VERSION_NOTE" ]; then
   CTX="$CTX
 $VERSION_NOTE"
@@ -452,6 +494,10 @@ if [ -n "$STAGE_SUGGESTION" ]; then
 $STAGE_SUGGESTION
 To disable suggestions persistently set ${RUNTIME_ROOT}/state/suggestion-memory.json -> enabled=false."
 fi
+if [ -n "$STALE_STAGES" ]; then
+  CTX="$CTX
+Stale stages pending acknowledgement: $STALE_STAGES (use /cc-rewind-ack <stage> after redo)."
+fi
 if [ -n "$KNOWLEDGE_DIGEST" ]; then
   CTX="$CTX
 Knowledge digest (top relevant entries):

package/dist/content/meta-skill.js

@@ -3,7 +3,7 @@ export const META_SKILL_NAME = "using-cclaw";
 export function usingCclawSkillMarkdown() {
     return `---
 name: using-cclaw
-description: "Routing brain for cclaw. Decide whether to start/resume a stage, answer directly, or use /cc-learn."
+description: "Routing brain for cclaw. Decide whether to start/resume a stage, answer directly, or use utility commands like /cc-learn, /cc-status, /cc-tree, and /cc-diff."
 ---
 
 # Using Cclaw
@@ -26,7 +26,8 @@ Task arrives
   ├─ Pure question / non-software ask? -> answer directly (no stage)
   ├─ New software work? -> /cc <idea>
   ├─ Resume existing flow? -> /cc or /cc-next
-  └─ Knowledge operation? -> /cc-learn
+  ├─ Knowledge operation? -> /cc-learn
+  └─ Workspace operation? -> /cc-status, /cc-tree, /cc-diff, /cc-feature, /cc-tdd-log, /cc-retro, /cc-rewind
 \`\`\`
 
 ## Task classification

package/dist/content/next-command.js

@@ -39,11 +39,12 @@ This is the only progression command the user needs to drive the entire flow. St
 
 1. Read **\`${flowPath}\`**. If missing → **BLOCKED** (state missing).
 2. Parse JSON. Capture \`currentStage\` and \`stageGateCatalog[currentStage]\`.
-3. Let \`G\` = \`requiredGates\` for **\`currentStage\`** from the stage schema.
-4. Let \`catalog\` = \`stageGateCatalog[currentStage]\` from flow state.
-5. **Satisfied** for gate id \`g\`: \`g\` in \`catalog.passed\` and \`g\` not in \`catalog.blocked\`.
-6. Let \`M\` = \`mandatoryDelegations\` for \`currentStage\`.
-7. If \`M\` is non-empty, inspect **\`${delegationPath}\`**. Treat as satisfied only if the agent is **completed** or **waived**.
+3. If \`staleStages[currentStage]\` exists, do not advance automatically. Re-run the stage artifact work, then clear the marker with \`/cc-rewind-ack <currentStage>\`.
+4. Let \`G\` = \`requiredGates\` for **\`currentStage\`** from the stage schema.
+5. Let \`catalog\` = \`stageGateCatalog[currentStage]\` from flow state.
+6. **Satisfied** for gate id \`g\`: \`g\` in \`catalog.passed\` and \`g\` not in \`catalog.blocked\`.
+7. Let \`M\` = \`mandatoryDelegations\` for \`currentStage\`.
+8. If \`M\` is non-empty, inspect **\`${delegationPath}\`**. Treat as satisfied only if the agent is **completed** or **waived**.
 
 ### Path A: Current stage is NOT complete (any gate unmet or delegation missing)
 
@@ -120,7 +121,8 @@ Do **not** mark gates satisfied from memory alone. Cite **artifact evidence** (p
 
 1. Open **\`${flowPath}\`**.
 2. Record \`currentStage\` and \`stageGateCatalog[currentStage]\`.
-3. If the file is missing or invalid JSON → **BLOCKED** (report and stop).
+3. If \`staleStages[currentStage]\` exists, re-run the stage and clear marker via \`/cc-rewind-ack <currentStage>\` before advancing.
+4. If the file is missing or invalid JSON → **BLOCKED** (report and stop).
 
 ### Step 2: Evaluate gates
 

package/dist/content/observe.d.ts

@@ -9,7 +9,11 @@ export interface PromptGuardOptions {
     strictMode?: boolean;
 }
 export declare function promptGuardScript(options?: PromptGuardOptions): string;
-export declare function workflowGuardScript(): string;
+export interface WorkflowGuardOptions {
+    tddEnforcementMode?: "advisory" | "strict";
+    tddTestGlobs?: string[];
+}
+export declare function workflowGuardScript(options?: WorkflowGuardOptions): string;
 export declare function observeScript(): string;
 export declare function contextMonitorScript(): string;
 export declare function summarizeObservationsRuntimeModule(): string;