agentera 3.0.0-dev.1 → 3.0.0-dev.10

package/dist/hooks/compaction/retention.js

@@ -0,0 +1,199 @@
+/**
+ * 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;
+    // cast: decision record fields read from parsed decisions.yaml
+    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;
+    // cast: decision record fields read from parsed decisions.yaml
+    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 yamlSortEntries([...protectedEntries, ...keepSatisfied], "decisions");
+}
+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,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/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/cursorPreToolUse.js

@@ -1,4 +1,4 @@
-import { HookCliAdapter } from "./validateArtifact.js";
+import { HookCliAdapter } from "./validateArtifact/index.js";
 import { pyJsonInline } from "../core/pyjson.js";
 /**
  * Cursor preToolUse hook: block invalid reconstructable Write/Edit candidates.

package/dist/hooks/cursorPreToolUse.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursorPreToolUse.js","sourceRoot":"","sources":["../../src/hooks/cursorPreToolUse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AAEH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAqE,EAAE;IAEvE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IACxE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC;QAC5F,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"cursorPreToolUse.js","sourceRoot":"","sources":["../../src/hooks/cursorPreToolUse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AAEH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAqE,EAAE;IAEvE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IACxE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC;QAC5F,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/hooks/cursorSessionStart.js

@@ -1,7 +1,8 @@
+import os from "node:os";
 import path from "node:path";
 import { resolvePath } from "../core/paths.js";
 import { resolveSourceRoot } from "../core/sourceRoot.js";
-import { classifyResolvedRoot } from "../state/installRoot.js";
+import { classifyResolvedRoot, resolveCandidate } from "../state/installRoot.js";
 import { buildDigest } from "./sessionStart.js";
 import { pyJsonInline } from "../core/pyjson.js";
 export function pluginRootDefault() {
@@ -13,7 +14,8 @@ export function resolveInstallRoot(cwd, opts = {}) {
     const envRoot = env.AGENTERA_HOME;
     if (envRoot) {
         const candidate = resolvePath(envRoot);
-        if (classifyResolvedRoot(candidate, { source: "env" }).kind === "managed_fresh") {
+        const kind = classifyResolvedRoot(candidate, { source: "environment" }).kind;
+        if (kind === "managed_fresh" || kind === "managed_stale") {
             return candidate;
         }
     }
@@ -31,6 +33,12 @@ export function resolveInstallRoot(cwd, opts = {}) {
     if (classifyResolvedRoot(pluginRoot, { source: "plugin" }).kind === "managed_fresh") {
         return resolvePath(pluginRoot);
     }
+    const home = env.HOME ?? process.env.HOME ?? os.homedir();
+    const [defaultRoot] = resolveCandidate(null, { env, home });
+    const defaultKind = classifyResolvedRoot(defaultRoot, { source: "default" }).kind;
+    if (defaultKind === "managed_fresh" || defaultKind === "managed_stale") {
+        return defaultRoot;
+    }
     return null;
 }
 export function runCursorSessionStart(rawStdin, opts = {}) {

package/dist/hooks/cursorSessionStart.js.map

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

package/dist/hooks/sessionStart.js

@@ -83,9 +83,11 @@ export function extractLatestProgressYaml(data) {
     const latest = cycles[0] && typeof cycles[0] === "object" ? cycles[0] : null;
     if (!latest)
         return null;
+    // cast: progress-cycle fields read from parsed progress.yaml
+    const obj = latest;
     const parts = [];
     for (const key of ["number", "phase", "what", "verified", "next"]) {
-        const value = latest[key];
+        const value = obj[key];
         if (value !== null && value !== undefined && value !== "") {
             parts.push(`${key}: ${value}`);
         }
@@ -98,6 +100,7 @@ export function extractHealthGradesYaml(data) {
     const audits = data.audits;
     if (!Array.isArray(audits) || audits.length === 0 || typeof audits[0] !== "object")
         return null;
+    // cast: audit grades read from parsed health.yaml
     const grades = audits[0].grades;
     if (!grades || typeof grades !== "object" || Array.isArray(grades) || Object.keys(grades).length === 0)
         return null;
@@ -112,10 +115,12 @@ export function extractNextPlanTaskYaml(data) {
     for (const task of tasks) {
         if (!task || typeof task !== "object")
             continue;
-        if (String(task.status ?? "").toLowerCase() === "complete")
+        // cast: plan-task fields read from parsed plan.yaml
+        const taskObj = task;
+        if (String(taskObj.status ?? "").toLowerCase() === "complete")
             continue;
-        const number = task.number;
-        const name = task.name ?? "unnamed task";
+        const number = taskObj.number;
+        const name = taskObj.name ?? "unnamed task";
         return number !== null && number !== undefined ? `Task ${number}: ${name}` : String(name);
     }
     return null;
@@ -127,9 +132,11 @@ export function extractSessionSummaryYaml(data) {
     if (!Array.isArray(bookmarks) || bookmarks.length === 0 || typeof bookmarks[0] !== "object")
         return null;
     const latest = bookmarks[0];
-    const timestamp = latest.timestamp ?? "";
-    const summary = latest.summary ?? "";
-    const artifacts = latest.artifacts ?? [];
+    // cast: session bookmark fields read from parsed session bookmark yaml
+    const latestObj = latest;
+    const timestamp = latestObj.timestamp ?? "";
+    const summary = latestObj.summary ?? "";
+    const artifacts = latestObj.artifacts ?? [];
     const lines = [];
     if (timestamp)
         lines.push(String(timestamp));
@@ -143,7 +150,7 @@ export function extractSessionSummaryYaml(data) {
 export function buildDigest(projectRoot, env = process.env) {
     const overrides = loadArtifactOverrides(projectRoot);
     const sections = [];
-    const progressPath = resolveArtifactPath(projectRoot, "PROGRESS.md", overrides);
+    const progressPath = resolveArtifactPath(projectRoot, "progress", overrides);
     if (fs.existsSync(progressPath)) {
         const entry = progressPath.endsWith(".yaml")
             ? extractLatestProgressYaml(loadYaml(progressPath))
@@ -151,7 +158,7 @@ export function buildDigest(projectRoot, env = process.env) {
         if (entry)
             sections.push(`## Latest progress\n${entry}`);
     }
-    const healthPath = resolveArtifactPath(projectRoot, "HEALTH.md", overrides);
+    const healthPath = resolveArtifactPath(projectRoot, "health", overrides);
     if (fs.existsSync(healthPath)) {
         const grades = healthPath.endsWith(".yaml")
             ? extractHealthGradesYaml(loadYaml(healthPath))
@@ -159,7 +166,7 @@ export function buildDigest(projectRoot, env = process.env) {
         if (grades)
             sections.push(`## Health\n${grades}`);
     }
-    const planPath = resolveArtifactPath(projectRoot, "PLAN.md", overrides);
+    const planPath = resolveArtifactPath(projectRoot, "plan", overrides);
     if (fs.existsSync(planPath)) {
         const task = planPath.endsWith(".yaml")
             ? extractNextPlanTaskYaml(loadYaml(planPath))
@@ -167,7 +174,7 @@ export function buildDigest(projectRoot, env = process.env) {
         if (task)
             sections.push(`## Next task\n${task}`);
     }
-    const todoPath = resolveArtifactPath(projectRoot, "TODO.md", overrides);
+    const todoPath = resolveArtifactPath(projectRoot, "todo", overrides);
     if (fs.existsSync(todoPath)) {
         const critical = extractCriticalTodos(fs.readFileSync(todoPath, "utf8"));
         if (critical.length > 0)