agentera 3.0.0-dev.5 → 3.0.0-dev.6

package/dist/hooks/compaction/retention.js

@@ -0,0 +1,197 @@
+/**
+ * Retention primitives for compaction: stable sort, recent-vs-older
+ * partitioning, archive sorting, and decision-specific entry
+ * selection (satisfaction-aware). The pure helpers here are reused
+ * by `apply.ts` (which writes the compacted result back to disk)
+ * and by `status.ts` (which counts overflow without writing).
+ */
+import { MAX_FULL_ENTRIES, MAX_ONELINE_ENTRIES, applyRetentionCaps } from "../common.js";
+import { truncateWords } from "./dryRun.js";
+export function overLimitCount(activeCount, archiveCount) {
+    const totalCount = activeCount + archiveCount;
+    return Math.max(Math.max(activeCount - MAX_FULL_ENTRIES, 0), Math.max(archiveCount - MAX_ONELINE_ENTRIES, 0), Math.max(totalCount - 50, 0));
+}
+export function stableSortBy(arr, key, reverse = false) {
+    return arr
+        .map((x, i) => [x, i])
+        .sort((a, b) => {
+        const ka = key(a[0]);
+        const kb = key(b[0]);
+        let cmp = ka < kb ? -1 : ka > kb ? 1 : 0;
+        if (reverse)
+            cmp = -cmp;
+        return cmp !== 0 ? cmp : a[1] - b[1];
+    })
+        .map(([x]) => x);
+}
+export function yamlEntryNumber(entry) {
+    let summary;
+    if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+        const number = entry.number;
+        if (typeof number === "number" && Number.isInteger(number))
+            return number;
+        if (typeof number === "string" && /^\d+$/.test(number))
+            return parseInt(number, 10);
+        summary = String(entry.summary ?? "");
+    }
+    else {
+        summary = String(entry);
+    }
+    const match = /(?:Cycle|Decision|Audit|Experiment|EXP-)\s*(\d+)/.exec(summary);
+    return match ? parseInt(match[1], 10) : 0;
+}
+function yamlEntryTimestamp(entry) {
+    if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+        return String(entry.timestamp || entry.date || "");
+    }
+    return "";
+}
+function yamlSummaryText(entry, ...fields) {
+    for (const field of fields) {
+        const value = entry[field];
+        if (typeof value === "string" && value.trim()) {
+            return truncateWords(value.trim(), 15);
+        }
+        if (value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length > 0) {
+            return truncateWords(Object.entries(value).map(([k, v]) => `${k}: ${v}`).join(", "), 15);
+        }
+    }
+    return "no summary";
+}
+function isEmptyish(v) {
+    return (v === null ||
+        v === undefined ||
+        v === "" ||
+        (Array.isArray(v) && v.length === 0) ||
+        (typeof v === "object" && v !== null && !Array.isArray(v) && Object.keys(v).length === 0));
+}
+export function yamlArchiveEntry(specName, entry) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+        return { summary: String(entry) };
+    }
+    const e = entry;
+    if (specName === "progress") {
+        const number = e.number ?? "?";
+        const date = String(e.timestamp ?? "").split(/\s+/)[0] || "";
+        const datePart = date ? ` (${date})` : "";
+        const summary = yamlSummaryText(e, "what", "type");
+        return { summary: `Cycle ${number}${datePart}: ${summary}` };
+    }
+    if (specName === "decisions") {
+        const number = e.number ?? "?";
+        const date = String(e.date ?? "");
+        const datePart = date ? ` (${date})` : "";
+        const choice = yamlSummaryText(e, "choice", "question");
+        const archiveEntry = { summary: `Decision ${number}${datePart}: ${choice}` };
+        for (const field of ["number", "date", "choice", "outcome", "feeds_into", "satisfaction"]) {
+            const value = e[field];
+            if (!isEmptyish(value))
+                archiveEntry[field] = value;
+        }
+        if (!("outcome" in archiveEntry) && !isEmptyish(archiveEntry.choice)) {
+            archiveEntry.outcome = archiveEntry.choice;
+        }
+        return archiveEntry;
+    }
+    if (specName === "health") {
+        const number = e.number ?? "?";
+        const date = String(e.date ?? "");
+        const datePart = date ? ` (${date})` : "";
+        const summary = yamlSummaryText(e, "trajectory", "grades");
+        return { summary: `Audit ${number}${datePart}: ${summary}` };
+    }
+    if (specName === "session") {
+        return { timestamp: String(e.timestamp ?? ""), summary: yamlSummaryText(e, "summary") };
+    }
+    return { summary: yamlSummaryText(e, "summary") };
+}
+export function yamlSortEntries(entries, specName) {
+    if (specName === "decisions" || specName === "health") {
+        return stableSortBy(entries, yamlEntryNumber);
+    }
+    if (specName === "session") {
+        return stableSortBy(entries, yamlEntryTimestamp, true);
+    }
+    return stableSortBy(entries, yamlEntryNumber, true);
+}
+export function yamlRecentFullAndOlder(entries, specName) {
+    const newestFirst = specName === "session"
+        ? stableSortBy(entries, yamlEntryTimestamp, true)
+        : stableSortBy(entries, yamlEntryNumber, true);
+    const recent = newestFirst.slice(0, MAX_FULL_ENTRIES);
+    const older = newestFirst.slice(MAX_FULL_ENTRIES);
+    return [yamlSortEntries(recent, specName), older];
+}
+function yamlArchiveSortKey(entry) {
+    const timestamp = yamlEntryTimestamp(entry);
+    if (timestamp)
+        return ["timestamp", timestamp];
+    return ["number", yamlEntryNumber(entry)];
+}
+export function yamlArchiveEntries(entries) {
+    // Sort by (tag, value) descending, mirroring Python tuple comparison.
+    return entries
+        .map((x, i) => [x, i])
+        .sort((a, b) => {
+        const ka = yamlArchiveSortKey(a[0]);
+        const kb = yamlArchiveSortKey(b[0]);
+        let cmp = 0;
+        if (ka[0] !== kb[0])
+            cmp = ka[0] < kb[0] ? -1 : 1;
+        else
+            cmp = ka[1] < kb[1] ? -1 : ka[1] > kb[1] ? 1 : 0;
+        cmp = -cmp;
+        return cmp !== 0 ? cmp : a[1] - b[1];
+    })
+        .map(([x]) => x);
+}
+function decisionSatisfactionState(entry) {
+    if (!entry || typeof entry !== "object")
+        return null;
+    const satisfaction = entry.satisfaction;
+    if (!satisfaction || typeof satisfaction !== "object")
+        return null;
+    const state = satisfaction.state;
+    return typeof state === "string" ? state : null;
+}
+function decisionRequiresUserReview(entry) {
+    if (!entry || typeof entry !== "object")
+        return true;
+    const satisfaction = entry.satisfaction;
+    if (!satisfaction || typeof satisfaction !== "object")
+        return true;
+    const confirmation = satisfaction.user_confirmation;
+    return (decisionSatisfactionState(entry) !== "user_confirmed_satisfied" ||
+        !confirmation ||
+        typeof confirmation !== "object" ||
+        Object.keys(confirmation).length === 0);
+}
+export function decisionProtectedOverflowCount(active, archive) {
+    const protectedActive = active.filter((e) => decisionRequiresUserReview(e)).length;
+    const protectedArchive = archive.filter((e) => decisionRequiresUserReview(e)).length;
+    return Math.max(protectedActive - MAX_FULL_ENTRIES, protectedArchive - MAX_ONELINE_ENTRIES, protectedActive + protectedArchive - 50, 0);
+}
+export function selectDecisionActiveEntries(active) {
+    const protectedEntries = active.filter((e) => decisionRequiresUserReview(e));
+    if (protectedEntries.length > MAX_FULL_ENTRIES) {
+        throw new Error("decisions: protected-overflow review pressure; " +
+            `${protectedEntries.length} protected active decision(s) exceed ${MAX_FULL_ENTRIES} full-detail slots`);
+    }
+    const satisfied = active.filter((e) => !decisionRequiresUserReview(e));
+    const newestSatisfied = stableSortBy(satisfied, yamlEntryNumber, true);
+    const keepSatisfied = newestSatisfied.slice(0, MAX_FULL_ENTRIES - protectedEntries.length);
+    const compactSatisfied = newestSatisfied.slice(MAX_FULL_ENTRIES - protectedEntries.length);
+    return [yamlSortEntries([...protectedEntries, ...keepSatisfied], "decisions"), compactSatisfied];
+}
+export function selectDecisionArchiveEntries(archiveCandidates) {
+    const protectedEntries = archiveCandidates.filter((e) => decisionRequiresUserReview(e));
+    if (protectedEntries.length > MAX_ONELINE_ENTRIES) {
+        throw new Error("decisions: protected-overflow review pressure; " +
+            `${protectedEntries.length} protected archived decision(s) exceed ${MAX_ONELINE_ENTRIES} archive slots`);
+    }
+    const satisfied = archiveCandidates.filter((e) => !decisionRequiresUserReview(e));
+    const keepSatisfied = yamlArchiveEntries(satisfied).slice(0, MAX_ONELINE_ENTRIES - protectedEntries.length);
+    return yamlArchiveEntries([...protectedEntries, ...keepSatisfied]);
+}
+export { applyRetentionCaps };
+//# sourceMappingURL=retention.js.map

package/dist/hooks/compaction/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../../src/hooks/compaction/retention.ts"],"names":[],"mappings":"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"}

package/dist/hooks/compaction/status.js

@@ -0,0 +1,243 @@
+/**
+ * Compaction status reporting (read-only).
+ *
+ * Walks each tracked artifact path, counts active/archive entries, and
+ * builds a `CompactionStatus` per artifact plus a per-status operation
+ * row in `checkCompaction`/`fixCompaction`. The `fixCompaction` path
+ * delegates the actual write to `apply.ts`.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { DEFAULT_ARTIFACT_PATHS, parseDocsYamlMapping } from "../common.js";
+import { loadYamlMapping } from "../../core/yaml.js";
+import { COMPACTABLE_YAML_ARTIFACTS, NON_COMPACTABLE_ARTIFACTS } from "./dryRun.js";
+import { decisionProtectedOverflowCount, overLimitCount, yamlArchiveEntries, } from "./retention.js";
+import { compactFile, compactYamlFile } from "./apply.js";
+import { parseEntries } from "./parse.js";
+import { YAML_SPEC_BY_ARTIFACT } from "./dryRun.js";
+function artifactPaths(projectRoot) {
+    const paths = { ...DEFAULT_ARTIFACT_PATHS };
+    const docsPath = path.join(projectRoot, ".agentera", "docs.yaml");
+    if (fs.existsSync(docsPath)) {
+        Object.assign(paths, parseDocsYamlMapping(fs.readFileSync(docsPath, "utf8")));
+    }
+    const resolved = {};
+    for (const [artifact, rel] of Object.entries(paths)) {
+        resolved[artifact] = path.join(projectRoot, rel);
+    }
+    return resolved;
+}
+function missingStatus(artifact, p, classification) {
+    return {
+        artifact,
+        path: p,
+        classification,
+        active_count: 0,
+        archive_count: 0,
+        total_count: 0,
+        over_limit_count: 0,
+        reason: "artifact path is not present",
+        protected_overflow_count: 0,
+        exists: false,
+    };
+}
+function yamlErrorStatus(artifact, p, message) {
+    return {
+        artifact,
+        path: p,
+        classification: "error",
+        active_count: null,
+        archive_count: null,
+        total_count: null,
+        over_limit_count: null,
+        reason: message.trim() || "invalid YAML mapping root",
+        protected_overflow_count: 0,
+        exists: true,
+    };
+}
+function yamlCounts(p, activeKey, archiveKey) {
+    const data = loadYamlMapping(fs.readFileSync(p, "utf8"));
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return [0, 0];
+    const active = data[activeKey] || [];
+    const archive = data[archiveKey] || [];
+    return [Array.isArray(active) ? active.length : 0, Array.isArray(archive) ? archive.length : 0];
+}
+function yamlLists(p, activeKey, archiveKey) {
+    const data = loadYamlMapping(fs.readFileSync(p, "utf8"));
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return [[], []];
+    const active = data[activeKey] || [];
+    const archive = data[archiveKey] || [];
+    return [Array.isArray(active) ? active : [], Array.isArray(archive) ? archive : []];
+}
+function countStatus(artifact, p, activeCount, archiveCount, protectedOverflowCount = 0) {
+    const totalCount = activeCount + archiveCount;
+    return {
+        artifact,
+        path: p,
+        classification: "compactable",
+        active_count: activeCount,
+        archive_count: archiveCount,
+        total_count: totalCount,
+        over_limit_count: overLimitCount(activeCount, archiveCount),
+        reason: protectedOverflowCount ? "protected-overflow review pressure" : "uniform_10_40_50",
+        protected_overflow_count: protectedOverflowCount,
+        exists: true,
+    };
+}
+export function computeCompactionStatus(projectRoot) {
+    const paths = artifactPaths(projectRoot);
+    const statuses = [];
+    const todoPath = paths.todo;
+    if (fs.existsSync(todoPath)) {
+        const entries = parseEntries(fs.readFileSync(todoPath, "utf8"), "todo-resolved");
+        const activeCount = entries.filter((e) => e.kind === "full").length;
+        const archiveCount = entries.filter((e) => e.kind === "oneline").length;
+        statuses.push(countStatus("todo#Resolved", todoPath, activeCount, archiveCount));
+    }
+    else {
+        statuses.push(missingStatus("todo#Resolved", todoPath, "compactable"));
+    }
+    for (const [artifact, [activeKey, archiveKey]] of Object.entries(COMPACTABLE_YAML_ARTIFACTS)) {
+        const p = paths[artifact];
+        if (fs.existsSync(p)) {
+            let active;
+            let archive;
+            try {
+                [active, archive] = yamlLists(p, activeKey, archiveKey);
+            }
+            catch (exc) {
+                statuses.push(yamlErrorStatus(artifact, p, exc.message));
+                continue;
+            }
+            const protectedOverflowCount = artifact === "decisions" ? decisionProtectedOverflowCount(active, archive) : 0;
+            statuses.push(countStatus(artifact, p, active.length, archive.length, protectedOverflowCount));
+        }
+        else {
+            statuses.push(missingStatus(artifact, p, "compactable"));
+        }
+    }
+    for (const [artifact, [classification, reason]] of Object.entries(NON_COMPACTABLE_ARTIFACTS)) {
+        const p = paths[artifact];
+        statuses.push({
+            artifact,
+            path: p,
+            classification,
+            active_count: null,
+            archive_count: null,
+            total_count: null,
+            over_limit_count: null,
+            reason,
+            protected_overflow_count: 0,
+            exists: fs.existsSync(p),
+        });
+    }
+    const optimeraDir = path.join(projectRoot, ".agentera", "optimera");
+    if (fs.existsSync(optimeraDir) && fs.statSync(optimeraDir).isDirectory()) {
+        const experimentPaths = [];
+        for (const sub of fs.readdirSync(optimeraDir).sort()) {
+            const expPath = path.join(optimeraDir, sub, "experiments.yaml");
+            if (fs.existsSync(expPath))
+                experimentPaths.push(expPath);
+        }
+        for (const expPath of experimentPaths) {
+            let activeCount;
+            let archiveCount;
+            try {
+                [activeCount, archiveCount] = yamlCounts(expPath, "experiments", "archive");
+            }
+            catch (exc) {
+                statuses.push(yamlErrorStatus("experiments", expPath, exc.message));
+                continue;
+            }
+            statuses.push({
+                artifact: "experiments",
+                path: expPath,
+                classification: "protected",
+                active_count: activeCount,
+                archive_count: archiveCount,
+                total_count: activeCount + archiveCount,
+                over_limit_count: overLimitCount(activeCount, archiveCount),
+                reason: "objective-state experiment files are classified but skipped by default",
+                protected_overflow_count: 0,
+                exists: true,
+            });
+        }
+    }
+    // Touch yamlArchiveEntries to keep the export alive in dry builds.
+    void yamlArchiveEntries;
+    return statuses;
+}
+function operationForStatus(status, mode) {
+    const base = (action, message) => ({
+        status,
+        mode,
+        action,
+        changed: false,
+        result: null,
+        message,
+    });
+    if (!status.exists)
+        return base("missing", status.reason);
+    if (status.classification === "error")
+        return base("error", status.reason);
+    if (status.classification !== "compactable")
+        return base("skipped", status.reason);
+    if (status.protected_overflow_count) {
+        return base("protected_overflow", `protected-overflow review pressure by ${status.protected_overflow_count}`);
+    }
+    if (!status.over_limit_count)
+        return base("ok", "within uniform_10_40_50 limits");
+    return base(mode === "check" ? "over_limit" : "pending_fix", `over uniform_10_40_50 limit by ${status.over_limit_count}`);
+}
+export function checkCompaction(projectRoot) {
+    return computeCompactionStatus(projectRoot).map((status) => operationForStatus(status, "check"));
+}
+export function fixCompaction(projectRoot) {
+    const operations = [];
+    for (const status of computeCompactionStatus(projectRoot)) {
+        const baseline = operationForStatus(status, "fix");
+        if (baseline.action !== "pending_fix") {
+            operations.push(baseline);
+            continue;
+        }
+        const p = status.path;
+        let result;
+        try {
+            if (status.artifact === "todo#Resolved") {
+                result = compactFile(p, "todo-resolved");
+            }
+            else if (status.artifact in YAML_SPEC_BY_ARTIFACT) {
+                result = compactYamlFile(p, status.artifact);
+            }
+            else {
+                operations.push({ status, mode: "fix", action: "skipped", changed: false, result: null, message: `no fixer registered for ${status.artifact}` });
+                continue;
+            }
+        }
+        catch (exc) {
+            operations.push({ status, mode: "fix", action: "error", changed: false, result: null, message: exc.message });
+            continue;
+        }
+        operations.push({
+            status,
+            mode: "fix",
+            action: result.changed ? "compacted" : "ok",
+            changed: result.changed,
+            result,
+            message: `full ${result.full_before}->${result.full_after}; ` +
+                `archive ${result.oneline_before}->${result.oneline_after}; ` +
+                `dropped ${result.dropped}`,
+        });
+    }
+    return operations;
+}
+export function runCompaction(projectRoot, mode = "check") {
+    if (mode === "check")
+        return checkCompaction(projectRoot);
+    if (mode === "fix")
+        return fixCompaction(projectRoot);
+    throw new Error(`unknown compaction mode: ${mode}`);
+}
+//# sourceMappingURL=status.js.map

package/dist/hooks/compaction/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/hooks/compaction/status.ts"],"names":[],"mappings":"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"}

package/dist/hooks/compaction/types.js

@@ -0,0 +1,6 @@
+/**
+ * Compaction shared types: the public envelope shapes used by the
+ * status reporting, the apply writers, and the CLI consumers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/compaction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/compaction/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/hooks/compaction.js

@@ -159,21 +159,21 @@ export const SPECS = {
     },
 };
 export const COMPACTABLE_YAML_ARTIFACTS = {
-    "PROGRESS.md": ["cycles", "archive"],
-    "DECISIONS.md": ["decisions", "archive"],
-    "HEALTH.md": ["audits", "archive"],
+    progress: ["cycles", "archive"],
+    decisions: ["decisions", "archive"],
+    health: ["audits", "archive"],
 };
 const YAML_SPEC_BY_ARTIFACT = {
-    "PROGRESS.md": "progress",
-    "DECISIONS.md": "decisions",
-    "HEALTH.md": "health",
+    progress: "progress",
+    decisions: "decisions",
+    health: "health",
 };
 const NON_COMPACTABLE_ARTIFACTS = {
-    "CHANGELOG.md": ["exempt", "public release history is not compacted"],
-    "PLAN.md": ["unsupported", "active plan is lifecycle state, not a uniform retained-entry log"],
-    "DOCS.md": ["unsupported", "docs owns artifact mapping and schema metadata"],
-    "VISION.md": ["protected", "vision state is protected during execution cycles"],
-    "DESIGN.md": ["unsupported", "design is a human-facing identity artifact, not a uniform retained-entry log"],
+    changelog: ["exempt", "public release history is not compacted"],
+    plan: ["unsupported", "active plan is lifecycle state, not a uniform retained-entry log"],
+    docs: ["unsupported", "docs owns artifact mapping and schema metadata"],
+    vision: ["protected", "vision state is protected during execution cycles"],
+    design: ["unsupported", "design is a human-facing identity artifact, not a uniform retained-entry log"],
 };
 function overLimitCount(activeCount, archiveCount) {
     const totalCount = activeCount + archiveCount;
@@ -398,7 +398,7 @@ function decisionProtectedOverflowCount(active, archive) {
 function selectDecisionActiveEntries(active) {
     const protectedEntries = active.filter((e) => decisionRequiresUserReview(e));
     if (protectedEntries.length > MAX_FULL_ENTRIES) {
-        throw new Error("DECISIONS.md: protected-overflow review pressure; " +
+        throw new Error("decisions: protected-overflow review pressure; " +
             `${protectedEntries.length} protected active decision(s) exceed ${MAX_FULL_ENTRIES} full-detail slots`);
     }
     const satisfied = active.filter((e) => !decisionRequiresUserReview(e));
@@ -410,7 +410,7 @@ function selectDecisionActiveEntries(active) {
 function selectDecisionArchiveEntries(archiveCandidates) {
     const protectedEntries = archiveCandidates.filter((e) => decisionRequiresUserReview(e));
     if (protectedEntries.length > MAX_ONELINE_ENTRIES) {
-        throw new Error("DECISIONS.md: protected-overflow review pressure; " +
+        throw new Error("decisions: protected-overflow review pressure; " +
             `${protectedEntries.length} protected archived decision(s) exceed ${MAX_ONELINE_ENTRIES} archive slots`);
     }
     const satisfied = archiveCandidates.filter((e) => !decisionRequiresUserReview(e));
@@ -482,15 +482,15 @@ function countStatus(artifact, p, activeCount, archiveCount, protectedOverflowCo
 export function computeCompactionStatus(projectRoot) {
     const paths = artifactPaths(projectRoot);
     const statuses = [];
-    const todoPath = paths["TODO.md"];
+    const todoPath = paths.todo;
     if (fs.existsSync(todoPath)) {
         const entries = parseEntries(fs.readFileSync(todoPath, "utf8"), "todo-resolved");
         const activeCount = entries.filter((e) => e.kind === "full").length;
         const archiveCount = entries.filter((e) => e.kind === "oneline").length;
-        statuses.push(countStatus("TODO.md#Resolved", todoPath, activeCount, archiveCount));
+        statuses.push(countStatus("todo#Resolved", todoPath, activeCount, archiveCount));
     }
     else {
-        statuses.push(missingStatus("TODO.md#Resolved", todoPath, "compactable"));
+        statuses.push(missingStatus("todo#Resolved", todoPath, "compactable"));
     }
     for (const [artifact, [activeKey, archiveKey]] of Object.entries(COMPACTABLE_YAML_ARTIFACTS)) {
         const p = paths[artifact];
@@ -504,7 +504,7 @@ export function computeCompactionStatus(projectRoot) {
                 statuses.push(yamlErrorStatus(artifact, p, exc.message));
                 continue;
             }
-            const protectedOverflowCount = artifact === "DECISIONS.md" ? decisionProtectedOverflowCount(active, archive) : 0;
+            const protectedOverflowCount = artifact === "decisions" ? decisionProtectedOverflowCount(active, archive) : 0;
             statuses.push(countStatus(artifact, p, active.length, archive.length, protectedOverflowCount));
         }
         else {
@@ -541,11 +541,11 @@ export function computeCompactionStatus(projectRoot) {
                 [activeCount, archiveCount] = yamlCounts(expPath, "experiments", "archive");
             }
             catch (exc) {
-                statuses.push(yamlErrorStatus("EXPERIMENTS.md", expPath, exc.message));
+                statuses.push(yamlErrorStatus("experiments", expPath, exc.message));
                 continue;
             }
             statuses.push({
-                artifact: "EXPERIMENTS.md",
+                artifact: "experiments",
                 path: expPath,
                 classification: "protected",
                 active_count: activeCount,
@@ -596,7 +596,7 @@ export function fixCompaction(projectRoot) {
         const p = status.path;
         let result;
         try {
-            if (status.artifact === "TODO.md#Resolved") {
+            if (status.artifact === "todo#Resolved") {
                 result = compactFile(p, "todo-resolved");
             }
             else if (status.artifact in YAML_SPEC_BY_ARTIFACT) {