cclaw-cli 0.49.0 → 0.51.0

package/dist/internal/compound-readiness.d.ts

@@ -13,7 +13,7 @@ interface InternalIo {
  */
 export declare function countArchivedRunsSafely(projectRoot: string): Promise<number | undefined>;
 /**
- * Compact one-liner for session-digest / bootstrap surfaces.
+ * Compact one-liner for bootstrap surfaces.
  *
  * Example: `Compound readiness: clusters=12, ready=2 (critical=1)`.
  * When `ready === 0`, emit `Compound readiness: no candidates`.

package/dist/internal/compound-readiness.js

@@ -65,7 +65,7 @@ export async function countArchivedRunsSafely(projectRoot) {
     }
 }
 /**
- * Compact one-liner for session-digest / bootstrap surfaces.
+ * Compact one-liner for bootstrap surfaces.
  *
  * Example: `Compound readiness: clusters=12, ready=2 (critical=1)`.
  * When `ready === 0`, emit `Compound readiness: no candidates`.

package/dist/internal/tdd-loop-status.d.ts

@@ -6,7 +6,7 @@ interface InternalIo {
 }
 /**
  * Produces a one-line "Ralph Loop: iter=X, slices=Y, acClosed=Z, redOpen=..."
- * summary — suitable for session-digest / bootstrap surfaces where the user
+ * summary — suitable for bootstrap surfaces where the user
  * just needs a progress indicator, not the full slice breakdown.
  */
 export declare function formatRalphLoopStatusLine(status: RalphLoopStatus): string;

package/dist/internal/tdd-loop-status.js

@@ -36,7 +36,7 @@ async function readCycleLog(projectRoot) {
 }
 /**
  * Produces a one-line "Ralph Loop: iter=X, slices=Y, acClosed=Z, redOpen=..."
- * summary — suitable for session-digest / bootstrap surfaces where the user
+ * summary — suitable for bootstrap surfaces where the user
  * just needs a progress indicator, not the full slice breakdown.
  */
 export function formatRalphLoopStatusLine(status) {

package/dist/knowledge-store.d.ts

@@ -14,7 +14,7 @@ export interface KnowledgeEntry {
     domain: string | null;
     stage: FlowStage | null;
     origin_stage: FlowStage | null;
-    origin_feature: string | null;
+    origin_run: string | null;
     frequency: number;
     universality: KnowledgeEntryUniversality;
     maturity: KnowledgeEntryMaturity;
@@ -23,6 +23,8 @@ export interface KnowledgeEntry {
     last_seen_ts: string;
     project: string | null;
     source?: KnowledgeEntrySource | null;
+    supersedes?: string[];
+    superseded_by?: string;
 }
 export interface KnowledgeSeedEntry {
     type: KnowledgeEntryType;
@@ -33,6 +35,8 @@ export interface KnowledgeSeedEntry {
     domain?: string | null;
     stage?: FlowStage | null;
     origin_stage?: FlowStage | null;
+    origin_run?: string | null;
+    /** @deprecated Use `origin_run`. Accepted only for legacy JSONL/backfill inputs. */
     origin_feature?: string | null;
     frequency?: number;
     universality?: KnowledgeEntryUniversality;
@@ -42,11 +46,13 @@ export interface KnowledgeSeedEntry {
     last_seen_ts?: string;
     project?: string | null;
     source?: KnowledgeEntrySource | null;
+    supersedes?: string[];
+    superseded_by?: string;
 }
 export interface AppendKnowledgeDefaults {
     stage?: FlowStage | null;
     originStage?: FlowStage | null;
-    originFeature?: string | null;
+    originRun?: string | null;
     project?: string | null;
     source?: KnowledgeEntrySource | null;
     nowIso?: string;
@@ -84,7 +90,7 @@ export interface CompoundReadinessCluster {
     action: string;
     /**
      * Sum of `frequency` across entries in the cluster — matches the
-     * recurrence count used by `/cc-ops compound`.
+     * recurrence count used by compound readiness analysis.
      */
     recurrence: number;
     /** Distinct entry lines contributing to this cluster. */
@@ -140,16 +146,15 @@ export interface ComputeCompoundReadinessOptions {
      * Count of archived runs under `.cclaw/runs/`. When supplied and
      * `< SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD`, the effective threshold
      * is lowered to `min(threshold, SMALL_PROJECT_RECURRENCE_THRESHOLD)`.
-     * Matches the rule documented in `src/content/compound-command.ts`
-     * and `docs/config.md`.
+     * Matches the rule documented in `docs/config.md`.
      */
     archivedRunsCount?: number;
 }
 /**
  * Single source of truth for the small-project relaxation rule.
  *
- * Kept exported so the inline hook mirror, the CLI command, and
- * the `/cc-ops compound` skill all agree on the same numbers.
+ * Kept exported so the inline hook mirror and CLI/runtime paths all agree on
+ * the same numbers.
  */
 export declare const SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD = 5;
 export declare const SMALL_PROJECT_RECURRENCE_THRESHOLD = 2;
@@ -163,9 +168,10 @@ export declare function effectiveCompoundThreshold(baseThreshold: number, archiv
  * for persisting to `.cclaw/state/compound-readiness.json`.
  *
  * Clustering key: `(type, normalizeText(trigger), normalizeText(action))`
- * which mirrors the clustering used by the `/cc-ops compound` skill.
- * Entries with `maturity === "lifted-to-enforcement"` are excluded —
- * they were already promoted and should not re-appear as ready.
+ * which mirrors the compound readiness clustering in runtime state.
+ * Entries with `maturity === "lifted-to-enforcement"` or `superseded_by`
+ * are excluded — they were already promoted/replaced and should not re-appear
+ * as ready.
  */
 export declare function computeCompoundReadiness(entries: KnowledgeEntry[], options?: ComputeCompoundReadinessOptions): CompoundReadiness;
 export declare function validateKnowledgeEntry(entry: unknown): {

package/dist/knowledge-store.js

@@ -8,8 +8,8 @@ const DEFAULT_COMPOUND_READINESS_MAX_READY = 10;
 /**
  * Single source of truth for the small-project relaxation rule.
  *
- * Kept exported so the inline hook mirror, the CLI command, and
- * the `/cc-ops compound` skill all agree on the same numbers.
+ * Kept exported so the inline hook mirror and CLI/runtime paths all agree on
+ * the same numbers.
  */
 export const SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD = 5;
 export const SMALL_PROJECT_RECURRENCE_THRESHOLD = 2;
@@ -31,9 +31,10 @@ export function effectiveCompoundThreshold(baseThreshold, archivedRunsCount) {
  * for persisting to `.cclaw/state/compound-readiness.json`.
  *
  * Clustering key: `(type, normalizeText(trigger), normalizeText(action))`
- * which mirrors the clustering used by the `/cc-ops compound` skill.
- * Entries with `maturity === "lifted-to-enforcement"` are excluded —
- * they were already promoted and should not re-appear as ready.
+ * which mirrors the compound readiness clustering in runtime state.
+ * Entries with `maturity === "lifted-to-enforcement"` or `superseded_by`
+ * are excluded — they were already promoted/replaced and should not re-appear
+ * as ready.
  */
 export function computeCompoundReadiness(entries, options = {}) {
     const thresholdRaw = options.threshold ?? DEFAULT_COMPOUND_RECURRENCE_THRESHOLD;
@@ -53,7 +54,7 @@ export function computeCompoundReadiness(entries, options = {}) {
     const { threshold, relaxationApplied } = effectiveCompoundThreshold(baseThreshold, archivedRunsCount);
     const buckets = new Map();
     for (const entry of entries) {
-        if (entry.maturity === "lifted-to-enforcement")
+        if (entry.maturity === "lifted-to-enforcement" || entry.superseded_by !== undefined)
             continue;
         const key = [
             entry.type,
@@ -160,7 +161,7 @@ const KNOWLEDGE_REQUIRED_KEYS = [
     "domain",
     "stage",
     "origin_stage",
-    "origin_feature",
+    "origin_run",
     "frequency",
     "universality",
     "maturity",
@@ -170,8 +171,11 @@ const KNOWLEDGE_REQUIRED_KEYS = [
     "project"
 ];
 const KNOWLEDGE_ALLOWED_KEYS = new Set(KNOWLEDGE_REQUIRED_KEYS);
+KNOWLEDGE_ALLOWED_KEYS.add("origin_feature");
 KNOWLEDGE_ALLOWED_KEYS.add("source");
 KNOWLEDGE_ALLOWED_KEYS.add("severity");
+KNOWLEDGE_ALLOWED_KEYS.add("supersedes");
+KNOWLEDGE_ALLOWED_KEYS.add("superseded_by");
 function knowledgePath(projectRoot) {
     return path.join(projectRoot, RUNTIME_ROOT, "knowledge.jsonl");
 }
@@ -195,11 +199,13 @@ function dedupeKey(entry) {
         entry.domain === null ? "null" : normalizeText(entry.domain),
         entry.stage ?? "null",
         entry.origin_stage ?? "null",
-        entry.origin_feature === null ? "null" : normalizeText(entry.origin_feature),
+        entry.origin_run === null ? "null" : normalizeText(entry.origin_run),
         entry.universality,
         entry.project === null ? "null" : normalizeText(entry.project),
         entry.source === undefined || entry.source === null ? "null" : entry.source,
-        entry.severity === undefined ? "none" : entry.severity
+        entry.severity === undefined ? "none" : entry.severity,
+        Array.isArray(entry.supersedes) ? entry.supersedes.map(normalizeText).sort().join(",") : "none",
+        entry.superseded_by === undefined ? "none" : normalizeText(entry.superseded_by)
     ].join("|");
 }
 function emptyKnowledgeSnapshot() {
@@ -211,6 +217,13 @@ function emptyKnowledgeSnapshot() {
         entryByIndex: new Map()
     };
 }
+function normalizeLegacyKnowledgeEntry(entry) {
+    const { origin_feature: legacyOriginRun, ...rest } = entry;
+    return {
+        ...rest,
+        origin_run: entry.origin_run ?? legacyOriginRun ?? null
+    };
+}
 function parseKnowledgeSnapshot(raw) {
     const lines = stripBom(raw).split(/\r?\n/u);
     const entries = [];
@@ -228,7 +241,7 @@ function parseKnowledgeSnapshot(raw) {
                 malformedLines += 1;
                 continue;
             }
-            const entry = parsed;
+            const entry = normalizeLegacyKnowledgeEntry(parsed);
             entries.push(entry);
             const key = dedupeKey(entry);
             if (!keyToIndex.has(key)) {
@@ -294,7 +307,9 @@ export function validateKnowledgeEntry(entry) {
     }
     for (const key of KNOWLEDGE_REQUIRED_KEYS) {
         if (!Object.prototype.hasOwnProperty.call(obj, key)) {
-            errors.push(`Missing required key "${key}".`);
+            if (key !== "origin_run" || !Object.prototype.hasOwnProperty.call(obj, "origin_feature")) {
+                errors.push(`Missing required key "${key}".`);
+            }
         }
     }
     if (!KNOWLEDGE_TYPE_SET.has(obj.type)) {
@@ -322,8 +337,11 @@ export function validateKnowledgeEntry(entry) {
     if (!isNullableStage(obj.origin_stage)) {
         errors.push(`origin_stage must be one of ${FLOW_STAGES.join(", ")} or null.`);
     }
-    if (!isNullableString(obj.origin_feature)) {
-        errors.push("origin_feature must be string or null.");
+    const originRun = Object.prototype.hasOwnProperty.call(obj, "origin_run")
+        ? obj.origin_run
+        : obj.origin_feature;
+    if (!isNullableString(originRun)) {
+        errors.push("origin_run must be string or null.");
     }
     if (typeof obj.frequency !== "number" ||
         !Number.isInteger(obj.frequency) ||
@@ -345,6 +363,17 @@ export function validateKnowledgeEntry(entry) {
     if (!isNullableString(obj.project)) {
         errors.push("project must be string or null.");
     }
+    if (obj.supersedes !== undefined) {
+        if (!Array.isArray(obj.supersedes) ||
+            obj.supersedes.length === 0 ||
+            obj.supersedes.some((value) => typeof value !== "string" || value.trim().length === 0)) {
+            errors.push("supersedes must be a non-empty array of strings when present.");
+        }
+    }
+    if (obj.superseded_by !== undefined &&
+        (typeof obj.superseded_by !== "string" || obj.superseded_by.trim().length === 0)) {
+        errors.push("superseded_by must be a non-empty string when present.");
+    }
     if (obj.source !== undefined &&
         obj.source !== null &&
         (typeof obj.source !== "string" || !KNOWLEDGE_SOURCE_SET.has(obj.source))) {
@@ -356,6 +385,7 @@ export function materializeKnowledgeEntry(seed, defaults = {}) {
     const now = normalizeUtcIso(defaults.nowIso ?? nowUtcIso());
     const stage = seed.stage ?? defaults.stage ?? null;
     const originStage = seed.origin_stage ?? defaults.originStage ?? stage ?? null;
+    const originRun = seed.origin_run ?? seed.origin_feature ?? defaults.originRun ?? null;
     const source = seed.source ?? defaults.source ?? null;
     const entry = {
         type: seed.type,
@@ -365,7 +395,7 @@ export function materializeKnowledgeEntry(seed, defaults = {}) {
         domain: seed.domain ?? null,
         stage,
         origin_stage: originStage,
-        origin_feature: seed.origin_feature ?? defaults.originFeature ?? null,
+        origin_run: originRun,
         frequency: seed.frequency ?? 1,
         universality: seed.universality ?? "project",
         maturity: seed.maturity ?? "raw",
@@ -377,6 +407,12 @@ export function materializeKnowledgeEntry(seed, defaults = {}) {
     if (seed.severity !== undefined) {
         entry.severity = seed.severity;
     }
+    if (seed.supersedes !== undefined) {
+        entry.supersedes = seed.supersedes.map((value) => value.trim());
+    }
+    if (seed.superseded_by !== undefined) {
+        entry.superseded_by = seed.superseded_by.trim();
+    }
     if (source !== null) {
         entry.source = source;
     }
@@ -521,7 +557,7 @@ export async function selectRelevantLearnings(projectRoot, options = {}) {
             ...tokenizeText(entry.domain),
             ...tokenizeText(entry.trigger),
             ...tokenizeText(entry.action),
-            ...tokenizeText(entry.origin_feature),
+            ...tokenizeText(entry.origin_run),
             ...tokenizeText(entry.project)
         ];
         const searchSet = new Set(searchable);

package/dist/policy.js

@@ -2,7 +2,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { RUNTIME_ROOT } from "./constants.js";
 import { FLOW_STAGES } from "./types.js";
-import { stageSchema, stagePolicyNeedles } from "./content/stage-schema.js";
+import { stageSchema } from "./content/stage-schema.js";
 import { stageSkillFolder } from "./content/skills.js";
 import { exists } from "./fs-utils.js";
 const POLICY_RULES = [];
@@ -14,32 +14,11 @@ export async function policyChecks(projectRoot, options = {}) {
     for (const stage of FLOW_STAGES) {
         const folder = stageSkillFolder(stage);
         const schema = stageSchema(stage);
-        const commandFile = `${RUNTIME_ROOT}/commands/${stage}.md`;
         const skillFile = `${RUNTIME_ROOT}/skills/${folder}/SKILL.md`;
-        // --- thin command mandatory sections ---
-        for (const heading of [
-            "## HARD-GATE",
-            "## Gates",
-            "## Exit",
-            "## Anchors",
-            "## Context Hydration"
-        ]) {
-            rules.push({
-                filePath: commandFile,
-                needle: heading,
-                name: `command:${stage}:section:${heading.replace(/^## /, "").toLowerCase().replace(/[^a-z0-9]+/g, "_")}`
-            });
-        }
-        // --- command must reference the skill ---
-        rules.push({
-            filePath: commandFile,
-            needle: `${folder}/SKILL.md`,
-            name: `command:${stage}:skill_ref`
-        });
         // --- skill mandatory sections ---
         for (const heading of [
             "## Process",
-            "## Verification",
+            "## Exit Criteria",
             "## Interaction Protocol",
             "## Anti-Patterns & Red Flags",
             "## HARD-GATE",
@@ -73,50 +52,25 @@ export async function policyChecks(projectRoot, options = {}) {
                 name: `skill:${stage}:section:verification_before_completion`
             });
         }
-        // --- policy needles in commands ---
-        for (const needle of stagePolicyNeedles(stage)) {
-            rules.push({
-                filePath: commandFile,
-                needle,
-                name: `command:${stage}:anchor:${needle.toLowerCase().replace(/[^a-z0-9]+/g, "_")}`
-            });
-        }
     }
     // --- utility skill checks ---
     const runtimeFile = (relativePath) => `${RUNTIME_ROOT}/${relativePath}`;
     const utilitySkillChecks = [
         { file: runtimeFile("skills/learnings/SKILL.md"), needle: "strict JSONL schema", name: "utility_skill:learnings:jsonl_schema" },
         { file: runtimeFile("skills/learnings/SKILL.md"), needle: "knowledge.jsonl", name: "utility_skill:learnings:jsonl_store" },
-        { file: runtimeFile("skills/learnings/SKILL.md"), needle: "type, trigger, action, confidence, domain, stage, origin_stage, origin_feature, frequency, universality, maturity, created, first_seen_ts, last_seen_ts, project", name: "utility_skill:learnings:field_order" },
-        { file: runtimeFile("skills/learnings/SKILL.md"), needle: "## Subcommands", name: "utility_skill:learnings:subcommands" },
+        { file: runtimeFile("skills/learnings/SKILL.md"), needle: "type, trigger, action, confidence, domain, stage, origin_stage, origin_run, frequency, universality, maturity, created, first_seen_ts, last_seen_ts, project", name: "utility_skill:learnings:field_order" },
+        { file: runtimeFile("skills/learnings/SKILL.md"), needle: "## Manual Actions", name: "utility_skill:learnings:manual_actions" },
         { file: runtimeFile("skills/learnings/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:learnings:hard_gate" },
-        { file: runtimeFile("commands/learn.md"), needle: "## Subcommands", name: "utility_command:learn:subcommands" },
+        { file: runtimeFile("commands/start.md"), needle: "## Algorithm", name: "utility_command:start:algorithm" },
+        { file: runtimeFile("commands/next.md"), needle: "## Algorithm", name: "utility_command:next:algorithm" },
+        { file: runtimeFile("commands/next.md"), needle: "closeout.shipSubstate", name: "utility_command:next:closeout_chain" },
         { file: runtimeFile("commands/ideate.md"), needle: "## Algorithm", name: "utility_command:ideate:algorithm" },
         { file: runtimeFile("skills/flow-ideate/SKILL.md"), needle: "## Protocol", name: "utility_skill:ideate:protocol" },
         { file: runtimeFile("skills/flow-ideate/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:ideate:hard_gate" },
-        { file: runtimeFile("commands/status.md"), needle: "bar:", name: "utility_command:status:visual_bar" },
-        { file: runtimeFile("commands/status.md"), needle: "/cc-view tree · /cc-view diff", name: "utility_command:status:tree_diff_link" },
-        { file: runtimeFile("commands/tree.md"), needle: "## Algorithm", name: "utility_command:tree:algorithm" },
-        { file: runtimeFile("skills/flow-tree/SKILL.md"), needle: "## Protocol", name: "utility_skill:tree:protocol" },
-        { file: runtimeFile("skills/flow-tree/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:tree:hard_gate" },
-        { file: runtimeFile("commands/diff.md"), needle: "## Algorithm", name: "utility_command:diff:algorithm" },
-        { file: runtimeFile("skills/flow-diff/SKILL.md"), needle: "## Protocol", name: "utility_skill:diff:protocol" },
-        { file: runtimeFile("skills/flow-diff/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:diff:hard_gate" },
-        { file: runtimeFile("commands/feature.md"), needle: "## Subcommands", name: "utility_command:feature:subcommands" },
-        { file: runtimeFile("skills/using-git-worktrees/SKILL.md"), needle: "## Protocol", name: "utility_skill:feature:protocol" },
-        { file: runtimeFile("skills/using-git-worktrees/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:feature:hard_gate" },
-        { file: runtimeFile("commands/tdd-log.md"), needle: "## Subcommands", name: "utility_command:tdd_log:subcommands" },
-        { file: runtimeFile("skills/tdd-cycle-log/SKILL.md"), needle: "## Protocol", name: "utility_skill:tdd_log:protocol" },
-        { file: runtimeFile("skills/tdd-cycle-log/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:tdd_log:hard_gate" },
-        { file: runtimeFile("commands/retro.md"), needle: "## Algorithm", name: "utility_command:retro:algorithm" },
-        { file: runtimeFile("skills/flow-retro/SKILL.md"), needle: "## Protocol", name: "utility_skill:retro:protocol" },
-        { file: runtimeFile("skills/flow-retro/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:retro:hard_gate" },
-        { file: runtimeFile("commands/compound.md"), needle: "## Algorithm", name: "utility_command:compound:algorithm" },
-        { file: runtimeFile("skills/flow-compound/SKILL.md"), needle: "## Protocol", name: "utility_skill:compound:protocol" },
-        { file: runtimeFile("skills/flow-compound/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:compound:hard_gate" },
-        { file: runtimeFile("commands/rewind.md"), needle: "## Algorithm", name: "utility_command:rewind:algorithm" },
-        { file: runtimeFile("skills/flow-rewind/SKILL.md"), needle: "## Protocol", name: "utility_skill:rewind:protocol" },
-        { file: runtimeFile("skills/flow-rewind/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:rewind:hard_gate" },
+        { file: runtimeFile("commands/view.md"), needle: "## Routing", name: "utility_command:view:routing" },
+        { file: runtimeFile("skills/flow-view/SKILL.md"), needle: "## Status Subcommand", name: "utility_skill:view:status_section" },
+        { file: runtimeFile("skills/flow-view/SKILL.md"), needle: "## Tree Subcommand", name: "utility_skill:view:tree_section" },
+        { file: runtimeFile("skills/flow-view/SKILL.md"), needle: "## Diff Subcommand", name: "utility_skill:view:diff_section" },
         { file: runtimeFile("skills/subagent-dev/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:sdd:hard_gate" },
         { file: runtimeFile("skills/subagent-dev/SKILL.md"), needle: "## Status Contract", name: "utility_skill:sdd:status_contract" },
         { file: runtimeFile("skills/subagent-dev/SKILL.md"), needle: "Implementer", name: "utility_skill:sdd:implementer_template" },
@@ -136,57 +90,14 @@ export async function policyChecks(projectRoot, options = {}) {
         { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Routing flow", name: "meta_skill:routing_flow" },
         { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Task classification", name: "meta_skill:task_classification" },
         { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Stage quick map", name: "meta_skill:stage_quick_map" },
-        { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Contextual skill activation", name: "meta_skill:contextual_skills" },
-        { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Protocol references", name: "meta_skill:protocol_refs" },
+        { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Whole flow map", name: "meta_skill:whole_flow_map" },
+        { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "retro -> compound -> archive", name: "meta_skill:closeout_chain" },
+        { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Contextual Skill Activation", name: "meta_skill:contextual_skills" },
+        { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Protocol Behavior", name: "meta_skill:protocol_behavior" },
         { file: runtimeFile("skills/using-cclaw/SKILL.md"), needle: "## Failure guardrails", name: "meta_skill:failure_guardrails" },
-        { file: runtimeFile("references/protocols/decision.md"), needle: "# Decision Protocol", name: "protocol:decision" },
-        { file: runtimeFile("references/protocols/completion.md"), needle: "# Stage Completion Protocol", name: "protocol:completion" },
-        { file: runtimeFile("references/protocols/ethos.md"), needle: "# Engineering Ethos", name: "protocol:ethos" },
-        { file: runtimeFile("references/flow-map.md"), needle: "# cclaw Flow Map", name: "reference:flow_map:header" },
-        { file: runtimeFile("references/flow-map.md"), needle: "## Stages (8)", name: "reference:flow_map:stages" },
-        { file: runtimeFile("references/flow-map.md"), needle: "## Ralph Loop", name: "reference:flow_map:ralph_loop" },
-        { file: runtimeFile("references/flow-map.md"), needle: "## Key state files", name: "reference:flow_map:state_files" },
-        { file: runtimeFile("references/flow-map.md"), needle: "## Compound readiness", name: "reference:flow_map:compound_readiness" },
         { file: runtimeFile("skills/session/SKILL.md"), needle: "## Session Resume Protocol", name: "utility_skill:session:resume" },
-        { file: runtimeFile("skills/brainstorming/SKILL.md"), needle: "common-guidance.md", name: "stage_skill:shared_guidance_reference" },
-        { file: runtimeFile("skills/security/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:security:hard_gate" },
-        { file: runtimeFile("skills/security/SKILL.md"), needle: "## Checklist", name: "utility_skill:security:checklist" },
-        { file: runtimeFile("skills/security/SKILL.md"), needle: "## Severity Classification", name: "utility_skill:security:severity" },
-        { file: runtimeFile("skills/debugging/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:debugging:hard_gate" },
-        { file: runtimeFile("skills/debugging/SKILL.md"), needle: "## The Protocol", name: "utility_skill:debugging:protocol" },
-        { file: runtimeFile("skills/debugging/SKILL.md"), needle: "Step 1 — Reproduce", name: "utility_skill:debugging:reproduce" },
-        { file: runtimeFile("skills/debugging/SKILL.md"), needle: "## Testing-Specific Anti-Patterns", name: "utility_skill:debugging:test_antipatterns" },
-        { file: runtimeFile("skills/performance/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:performance:hard_gate" },
-        { file: runtimeFile("skills/performance/SKILL.md"), needle: "## Workflow", name: "utility_skill:performance:workflow" },
-        { file: runtimeFile("skills/performance/SKILL.md"), needle: "## Core Web Vitals Reference", name: "utility_skill:performance:cwv" },
-        { file: runtimeFile("skills/ci-cd/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:cicd:hard_gate" },
-        { file: runtimeFile("skills/ci-cd/SKILL.md"), needle: "## Quality Gate Pipeline", name: "utility_skill:cicd:pipeline" },
-        { file: runtimeFile("skills/ci-cd/SKILL.md"), needle: "## CI Debugging Protocol", name: "utility_skill:cicd:debugging" },
-        { file: runtimeFile("skills/docs/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:docs:hard_gate" },
-        { file: runtimeFile("skills/docs/SKILL.md"), needle: "## ADR (Architecture Decision Record)", name: "utility_skill:docs:adr" },
-        { file: runtimeFile("skills/docs/SKILL.md"), needle: "## README Guidance", name: "utility_skill:docs:readme" },
-        { file: runtimeFile("skills/executing-plans/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:executing_plans:hard_gate" },
-        { file: runtimeFile("skills/executing-plans/SKILL.md"), needle: "## Execution Protocol", name: "utility_skill:executing_plans:protocol" },
-        { file: runtimeFile("skills/executing-plans/SKILL.md"), needle: "## Batch Checklist", name: "utility_skill:executing_plans:batches" },
-        { file: runtimeFile("skills/verification-before-completion/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:verification_before_completion:hard_gate" },
-        { file: runtimeFile("skills/verification-before-completion/SKILL.md"), needle: "## Protocol", name: "utility_skill:verification_before_completion:protocol" },
-        { file: runtimeFile("skills/finishing-a-development-branch/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:finishing_branch:hard_gate" },
-        { file: runtimeFile("skills/finishing-a-development-branch/SKILL.md"), needle: "## Protocol", name: "utility_skill:finishing_branch:protocol" },
-        { file: runtimeFile("skills/context-engineering/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:context_engineering:hard_gate" },
-        { file: runtimeFile("skills/context-engineering/SKILL.md"), needle: "## Context Modes", name: "utility_skill:context_engineering:modes" },
-        { file: runtimeFile("skills/context-engineering/SKILL.md"), needle: "## Mode Switching Protocol", name: "utility_skill:context_engineering:switch" },
-        { file: runtimeFile("skills/source-driven-development/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:source_driven:hard_gate" },
-        { file: runtimeFile("skills/source-driven-development/SKILL.md"), needle: "## Protocol", name: "utility_skill:source_driven:protocol" },
-        { file: runtimeFile("skills/source-driven-development/SKILL.md"), needle: "## Selection Heuristics", name: "utility_skill:source_driven:heuristics" },
-        { file: runtimeFile("skills/frontend-accessibility/SKILL.md"), needle: "## HARD-GATE", name: "utility_skill:frontend_accessibility:hard_gate" },
-        { file: runtimeFile("skills/frontend-accessibility/SKILL.md"), needle: "## Checklist", name: "utility_skill:frontend_accessibility:checklist" },
-        { file: runtimeFile("skills/frontend-accessibility/SKILL.md"), needle: "## Anti-Patterns", name: "utility_skill:frontend_accessibility:anti_patterns" },
+        { file: runtimeFile("skills/brainstorming/SKILL.md"), needle: "## Shared Stage Guidance", name: "stage_skill:shared_guidance_inline" },
         { file: runtimeFile("hooks/run-hook.mjs"), needle: "activeRunId", name: "hooks:session_start:active_run" },
-        { file: runtimeFile("hooks/run-hook.mjs"), needle: "checkpoint.json", name: "hooks:session_start:checkpoint_ref" },
-        { file: runtimeFile("hooks/run-hook.mjs"), needle: "stage-activity.jsonl", name: "hooks:session_start:activity_ref" },
-        { file: runtimeFile("hooks/run-hook.mjs"), needle: "suggestion-memory.json", name: "hooks:session_start:suggestion_memory" },
-        { file: runtimeFile("hooks/run-hook.mjs"), needle: "context-warnings.jsonl", name: "hooks:session_start:context_warning_ref" },
-        { file: runtimeFile("hooks/run-hook.mjs"), needle: "checkpoint.json", name: "hooks:stop:checkpoint_write" },
         { file: runtimeFile("hooks/run-hook.mjs"), needle: "write_to_cclaw_runtime", name: "hooks:guard:risky_write_advisory" },
         { file: runtimeFile("hooks/run-hook.mjs"), needle: "stage_invocation_without_recent_flow_read", name: "hooks:workflow_guard:flow_read_reason" },
         { file: runtimeFile("hooks/run-hook.mjs"), needle: "stage_jump_", name: "hooks:workflow_guard:stage_jump_reason" },

package/dist/run-archive.d.ts

@@ -9,8 +9,7 @@ export interface ArchiveRunResult {
     archiveId: string;
     archivePath: string;
     archivedAt: string;
-    featureName: string;
-    activeFeature: string;
+    runName: string;
     resetState: FlowState;
     snapshottedStateFiles: string[];
     /** Knowledge curation hint: total active entries + soft threshold (50). */
@@ -29,11 +28,10 @@ export interface ArchiveRunResult {
     };
 }
 export interface ArchiveManifest {
-    version: 1;
+    version: 2;
     archiveId: string;
     archivedAt: string;
-    featureName: string;
-    activeFeature: string;
+    runName: string;
     sourceRunId: string;
     sourceCurrentStage: FlowStage;
     sourceCompletedStages: FlowStage[];
@@ -45,7 +43,7 @@ export interface ArchiveRunOptions {
     skipRetroReason?: string;
 }
 export declare function listRuns(projectRoot: string): Promise<CclawRunMeta[]>;
-export declare function archiveRun(projectRoot: string, featureName?: string, options?: ArchiveRunOptions): Promise<ArchiveRunResult>;
+export declare function archiveRun(projectRoot: string, runName?: string, options?: ArchiveRunOptions): Promise<ArchiveRunResult>;
 /**
  * Counts entries in the canonical JSONL knowledge store. An "active" entry is one
  * non-empty line that parses as JSON with the required `type` field belonging to the

package/dist/run-archive.js

@@ -2,7 +2,6 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { RUNTIME_ROOT } from "./constants.js";
 import { createInitialFlowState } from "./flow-state.js";
-import { readActiveFeature, syncActiveFeatureSnapshot } from "./feature-system.js";
 import { ensureDir, exists, withDirectoryLock, writeFileSafe } from "./fs-utils.js";
 import { readKnowledgeSafely } from "./knowledge-store.js";
 import { evaluateRetroGate } from "./retro-gate.js";
@@ -90,7 +89,7 @@ function toArchiveDate(date = new Date()) {
     const dd = date.getDate().toString().padStart(2, "0");
     return `${yyyy}-${mm}-${dd}`;
 }
-function slugifyFeatureName(value) {
+function slugifyRunName(value) {
     const slug = value
         .toLowerCase()
         .trim()
@@ -98,14 +97,14 @@ function slugifyFeatureName(value) {
         .replace(/^-+/u, "")
         .replace(/-+$/u, "");
     if (slug.length === 0) {
-        return "feature";
+        return "run";
     }
     return slug.slice(0, 64);
 }
-async function inferFeatureNameFromArtifacts(projectRoot) {
+async function inferRunNameFromArtifacts(projectRoot) {
     const ideaPath = path.join(projectRoot, ACTIVE_ARTIFACTS_REL_PATH, "00-idea.md");
     if (!(await exists(ideaPath))) {
-        return "feature";
+        return "run";
     }
     try {
         const raw = await fs.readFile(ideaPath, "utf8");
@@ -114,12 +113,12 @@ async function inferFeatureNameFromArtifacts(projectRoot) {
             .map((line) => line.trim())
             .find((line) => line.length > 0);
         if (!firstMeaningful) {
-            return "feature";
+            return "run";
         }
-        return firstMeaningful.replace(/^[-#*\s]+/u, "").trim() || "feature";
+        return firstMeaningful.replace(/^[-#*\s]+/u, "").trim() || "run";
     }
     catch {
-        return "feature";
+        return "run";
     }
 }
 async function uniqueArchiveId(projectRoot, baseId) {
@@ -159,7 +158,7 @@ export async function listRuns(projectRoot) {
     }
     return runs.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
 }
-export async function archiveRun(projectRoot, featureName, options = {}) {
+export async function archiveRun(projectRoot, runName, options = {}) {
     await ensureRunSystem(projectRoot);
     // Hold BOTH archive.lock and flow-state.lock for the entire archive:
     // the outer archive lock serializes two concurrent archives; the
@@ -168,15 +167,14 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
     // which used to cause lost-update races.
     return withDirectoryLock(archiveLockPath(projectRoot), async () => {
         return withDirectoryLock(flowStateLockPathFor(projectRoot), async () => {
-            const activeFeature = await readActiveFeature(projectRoot);
             const artifactsDir = activeArtifactsPath(projectRoot);
             const runsDir = runsRoot(projectRoot);
             await ensureDir(runsDir);
             await ensureDir(artifactsDir);
-            const feature = (featureName?.trim() && featureName.trim().length > 0)
-                ? featureName.trim()
-                : await inferFeatureNameFromArtifacts(projectRoot);
-            const archiveBaseId = `${toArchiveDate()}-${slugifyFeatureName(feature)}`;
+            const archiveRunName = (runName?.trim() && runName.trim().length > 0)
+                ? runName.trim()
+                : await inferRunNameFromArtifacts(projectRoot);
+            const archiveBaseId = `${toArchiveDate()}-${slugifyRunName(archiveRunName)}`;
             const archiveId = await uniqueArchiveId(projectRoot, archiveBaseId);
             const archivePath = path.join(runsDir, archiveId);
             const archiveArtifactsPath = path.join(archivePath, "artifacts");
@@ -256,11 +254,10 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
                 stateReset = true;
                 await resetCarryoverStateFiles(projectRoot, resetState.activeRunId);
                 const manifest = {
-                    version: 1,
+                    version: 2,
                     archiveId,
                     archivedAt,
-                    featureName: feature,
-                    activeFeature,
+                    runName: archiveRunName,
                     sourceRunId: sourceState.activeRunId,
                     sourceCurrentStage: sourceState.currentStage,
                     sourceCompletedStages: sourceState.completedStages,
@@ -271,13 +268,11 @@ export async function archiveRun(projectRoot, featureName, options = {}) {
                 // Manifest landed — sentinel is no longer needed.
                 await fs.unlink(sentinelPath).catch(() => undefined);
                 const knowledgeStats = await readKnowledgeStats(projectRoot);
-                await syncActiveFeatureSnapshot(projectRoot);
                 return {
                     archiveId,
                     archivePath,
                     archivedAt,
-                    featureName: feature,
-                    activeFeature,
+                    runName: archiveRunName,
                     resetState,
                     snapshottedStateFiles,
                     knowledge: knowledgeStats,

package/dist/run-persistence.d.ts

@@ -21,8 +21,8 @@ export interface WriteFlowStateOptions {
 }
 export interface ReadFlowStateOptions {
     /**
-     * When false, skip feature-system auto-repair writes and read flow-state in
-     * pure diagnostic mode.
+     * Reserved compatibility switch from older runtimes. The repair layer was removed,
+     * so this flag is now a no-op and only preserved for API stability.
      */
     repairFeatureSystem?: boolean;
 }