agentera 3.0.0-dev.5 → 3.0.0-dev.7

package/dist/hooks/compaction/status.js

@@ -0,0 +1,241 @@
+/**
+ * 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 { countTodoResolvedEntries } 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 counts = countTodoResolvedEntries(fs.readFileSync(todoPath, "utf8"));
+        statuses.push(countStatus("todo#Resolved", todoPath, counts.full, counts.oneline));
+    }
+    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 optimizeDir = path.join(projectRoot, ".agentera", "optimize");
+    if (fs.existsSync(optimizeDir) && fs.statSync(optimizeDir).isDirectory()) {
+        const experimentPaths = [];
+        for (const sub of fs.readdirSync(optimizeDir).sort()) {
+            const expPath = path.join(optimizeDir, 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/todoResolved.js

@@ -0,0 +1,137 @@
+/**
+ * TODO.md `## ✓ Resolved` layout helpers for the compaction writer.
+ *
+ * Open items stay in severity bands; resolved items belong only under
+ * `## ✓ Resolved`. Mis-placed resolved rows count toward the 10/40/50
+ * gate and are migrated before retention runs.
+ */
+import { parseTodoMarkdownListItem } from "../../cli/todoMarkdown.js";
+import { parseEntries } from "./parse.js";
+const SEVERITY_HEADING_RE = /^##\s*(⇶|⇉|→|⇢)\s/m;
+const RESOLVED_HEADING_RE = /^##\s*(?:✓\s+)?Resolved\s*$/im;
+const STRIKETHROUGH_ITEM_RE = /^(\s*)-\s+~~(.+?)~~\s*(.*)$/;
+export function isTodoSeveritySectionHeading(line) {
+    return SEVERITY_HEADING_RE.test(line.trim());
+}
+export function isTodoResolvedSectionHeading(line) {
+    return RESOLVED_HEADING_RE.test(line.trim());
+}
+export function classifyTodoSectionHeading(line) {
+    if (isTodoSeveritySectionHeading(line))
+        return "severity";
+    if (isTodoResolvedSectionHeading(line))
+        return "resolved";
+    if (/^##\s/.test(line.trim()))
+        return "other";
+    return "other";
+}
+export function strikethroughTodoLineToCheckbox(line) {
+    const m = STRIKETHROUGH_ITEM_RE.exec(line);
+    if (!m)
+        return null;
+    const tail = m[3]?.trim();
+    const body = m[2].trim();
+    return `${m[1]}- [x] ${body}${tail ? (tail.startsWith("·") ? ` ${tail}` : ` ${tail}`) : ""}`;
+}
+export function isLegacyStrikethroughTodoLine(line) {
+    return /^(\s*)-\s+~~/.test(line);
+}
+export function countTodoResolvedInSeverityBands(content) {
+    let count = 0;
+    let section = "other";
+    for (const line of content.split(/\r\n|\r|\n/)) {
+        const kind = classifyTodoSectionHeading(line);
+        if (kind !== "other" || /^##\s/.test(line.trim())) {
+            section = kind;
+            continue;
+        }
+        if (section !== "severity")
+            continue;
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("-"))
+            continue;
+        const parsed = parseTodoMarkdownListItem(trimmed);
+        if (parsed?.status === "resolved" || isLegacyStrikethroughTodoLine(trimmed)) {
+            count += 1;
+        }
+    }
+    return count;
+}
+export function countTodoResolvedEntries(content) {
+    const resolvedSection = parseEntries(content, "todo-resolved");
+    const misplaced = countTodoResolvedInSeverityBands(content);
+    return {
+        full: resolvedSection.filter((e) => e.kind === "full").length,
+        oneline: resolvedSection.filter((e) => e.kind === "oneline").length + misplaced,
+    };
+}
+/**
+ * Move resolved rows from severity bands into `## ✓ Resolved`, creating the
+ * section when absent. Newly migrated rows are prepended (newest-first folds).
+ */
+export function normalizeTodoResolvedLayout(content) {
+    const lines = content.split(/\r\n|\r|\n/);
+    const beforeResolved = [];
+    const migratedResolved = [];
+    const existingResolved = [];
+    const afterResolved = [];
+    let section = "other";
+    let seenResolvedHeading = false;
+    for (const line of lines) {
+        const headingKind = classifyTodoSectionHeading(line);
+        if (headingKind === "resolved") {
+            seenResolvedHeading = true;
+            section = "resolved";
+            continue;
+        }
+        if (headingKind === "severity") {
+            section = "severity";
+            if (!seenResolvedHeading)
+                beforeResolved.push(line);
+            else
+                afterResolved.push(line);
+            continue;
+        }
+        if (/^##\s/.test(line.trim())) {
+            section = "other";
+            if (!seenResolvedHeading)
+                beforeResolved.push(line);
+            else
+                afterResolved.push(line);
+            continue;
+        }
+        const trimmed = line.trim();
+        if (section === "resolved") {
+            if (trimmed)
+                existingResolved.push(line);
+            continue;
+        }
+        if (section === "severity" && trimmed.startsWith("-")) {
+            const converted = strikethroughTodoLineToCheckbox(line) ?? line;
+            const parsed = parseTodoMarkdownListItem(converted.trim());
+            if (parsed?.status === "resolved" || isLegacyStrikethroughTodoLine(trimmed)) {
+                migratedResolved.push(converted.trim());
+                continue;
+            }
+        }
+        if (!seenResolvedHeading)
+            beforeResolved.push(line);
+        else
+            afterResolved.push(line);
+    }
+    if (migratedResolved.length === 0) {
+        return { text: content, changed: false };
+    }
+    const rebuilt = [...beforeResolved];
+    if (rebuilt.length > 0 && rebuilt[rebuilt.length - 1]?.trim() !== "")
+        rebuilt.push("");
+    rebuilt.push("## ✓ Resolved");
+    rebuilt.push(...migratedResolved, ...existingResolved);
+    if (afterResolved.length > 0) {
+        rebuilt.push("");
+        rebuilt.push(...afterResolved);
+    }
+    const text = rebuilt.join("\n").replace(/\n*$/, "\n");
+    return { text, changed: text !== content };
+}
+//# sourceMappingURL=todoResolved.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todoResolved.js","sourceRoot":"","sources":["../../../src/hooks/compaction/todoResolved.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) {