agentera 3.0.0-dev.2 → 3.0.0-dev.20

package/dist/cli/orientation/corpusCoverage.js

@@ -0,0 +1,71 @@
+import fs from "node:fs";
+import { corpusTooLargeReason } from "../../analytics/usageStats.js";
+import { statsCorpusPath } from "../commands/report.js";
+function emptyCoverageSummary(path, status) {
+    return {
+        path,
+        status,
+        available_runtimes: [],
+        selected_runtimes: [],
+        available_but_not_selected: [],
+    };
+}
+function parseCoverageGap(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const item = value;
+    const runtime = item.runtime;
+    const reason = item.reason;
+    if (typeof runtime !== "string" || typeof reason !== "string")
+        return null;
+    const gap = { runtime, reason };
+    if (typeof item.store_path === "string")
+        gap.store_path = item.store_path;
+    return gap;
+}
+export function corpusCoverageSummary(env = process.env, platform = process.platform) {
+    const corpusPath = statsCorpusPath(env, platform);
+    if (!fs.existsSync(corpusPath))
+        return emptyCoverageSummary(corpusPath, "missing");
+    const tooLarge = corpusTooLargeReason(corpusPath);
+    if (tooLarge)
+        return emptyCoverageSummary(corpusPath, "too_large");
+    let data;
+    try {
+        data = JSON.parse(fs.readFileSync(corpusPath, "utf8"));
+    }
+    catch {
+        return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    const metadata = data && typeof data === "object" && !Array.isArray(data) && "metadata" in data
+        ? data.metadata
+        : null;
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+        return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    const md = metadata;
+    const availableRuntimes = Array.isArray(md.available_runtimes)
+        ? md.available_runtimes.filter((item) => typeof item === "string")
+        : [];
+    const selectedRuntimes = Array.isArray(md.selected_runtimes)
+        ? md.selected_runtimes.filter((item) => typeof item === "string")
+        : [];
+    const skipped = Array.isArray(md.available_but_not_selected)
+        ? md.available_but_not_selected.map(parseCoverageGap).filter((item) => item !== null)
+        : [];
+    return {
+        path: corpusPath,
+        status: "loaded",
+        available_runtimes: availableRuntimes,
+        selected_runtimes: selectedRuntimes,
+        available_but_not_selected: skipped,
+    };
+}
+export function corpusCoverageAttention(summary) {
+    if (summary.available_but_not_selected.length === 0)
+        return null;
+    const skipped = summary.available_but_not_selected.map((item) => `${item.runtime} (${item.reason})`).join(", ");
+    return (`flagged: corpus coverage loss (EX2): available runtimes skipped (${skipped}); ` +
+        "suggest running profile stats refresh without --no-* flags");
+}
+//# sourceMappingURL=corpusCoverage.js.map

package/dist/cli/orientation/corpusCoverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpusCoverage.js","sourceRoot":"","sources":["../../../src/cli/orientation/corpusCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAkBxD,SAAS,oBAAoB,CAAC,IAAY,EAAE,MAAuC;IACjF,OAAO;QACL,IAAI;QACJ,MAAM;QACN,kBAAkB,EAAE,EAAE;QACtB,iBAAiB,EAAE,EAAE;QACrB,0BAA0B,EAAE,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,GAAG,GAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;QAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAC1E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAW,OAAO,CAAC,GAAG,EAAE,WAA4B,OAAO,CAAC,QAAQ;IACxG,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,oBAAoB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,QAAQ;QAAE,OAAO,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACnE,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,QAAQ,GACZ,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,IAAI,IAAI;QAC5E,CAAC,CAAE,IAA+B,CAAC,QAAQ;QAC3C,CAAC,CAAC,IAAI,CAAC;IACX,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,OAAO,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,EAAE,GAAG,QAAmC,CAAC;IAC/C,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAAC;QAC5D,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAClF,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC;QAC1D,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QACjF,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,0BAA0B,CAAC;QAC1D,CAAC,CAAC,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAA6B,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;QAChH,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,QAAQ;QAChB,kBAAkB,EAAE,iBAAiB;QACrC,iBAAiB,EAAE,gBAAgB;QACnC,0BAA0B,EAAE,OAAO;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA8B;IACpE,IAAI,OAAO,CAAC,0BAA0B,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChH,OAAO,CACL,oEAAoE,OAAO,KAAK;QAChF,4DAA4D,CAC7D,CAAC;AACJ,CAAC"}

package/dist/cli/orientation.js

@@ -2,39 +2,33 @@ import fs from "node:fs";
 import path from "node:path";
 import { resolveArtifactPath, } from "../registries/artifactRegistry.js";
 import { activeObjectiveName, artifactPath, loadRegistryForSchemas, } from "./appContext.js";
-import { asList, extractEntries, firstPresent, loadArtifact, recentCycles, truncate, } from "./stateQuery.js";
-import { decisionContextEntry, latestHealthAudit, normalizeSeverity } from "./commands/state.js";
+import { asList, extractEntries, firstPresent, loadArtifact, progressEntriesForOutput, recentCycles, truncate, } from "./stateQuery.js";
+import { decisionContextEntry, latestHealthAudit, normalizeSeverity } from "./commands/state/index.js";
+import { isResolvedTodoMarkdownStatus, parseTodoMarkdownListItem } from "./todoMarkdown.js";
+import { TODO_SEVERITY_ORDER, TODO_SEVERITY_ORDER_KEYS } from "./todoSeverity.js";
+import { capabilityStartupComplete } from "./startupCompletenessContract.js";
+import { discoverPlanArtifacts, planCatalogEntry, planDocumentParts } from "./planArtifacts.js";
+import { planLifecycleState } from "./planLifecycleState.js";
+import { dependencyReadyTasks } from "./capabilityContext/planState.js";
+/**
+ * Orientation summaries layer for prime/status. Faithful port of the
+ * scripts/agentera `_*_summary`, `_load_todo_items`, `_issue_counts`,
+ * `_decision_*`, `_select_status_next_action`, and staleness helpers.
+ */
 export const DONE_STATUSES = new Set(["complete", "completed", "closed", "done", "resolved", "retired"]);
 export const BLOCKED_STATUSES = new Set(["blocked", "stuck"]);
 export const DECISION_ATTENTION_MAX_ENTRIES = 3;
-export const STARTUP_COMPLETENESS_MISSING_STATE = [];
-const TODO_SEVERITY_ORDER = {
-    critical: 0,
-    degraded: 1,
-    warning: 1,
-    normal: 2,
-    info: 3,
-    annoying: 3,
-};
-const TODO_SECTION_SEVERITIES = {
-    critical: "critical",
-    degraded: "degraded",
-    warning: "warning",
-    normal: "normal",
-    info: "info",
-    annoying: "annoying",
-};
-const TODO_ITEM_RE = /^- \[([^\]]+)\]\s+(.*)/;
-const TODO_PLANERA_SIGNALS = new Set([
+const TODO_SECTION_SEVERITIES = Object.fromEntries(TODO_SEVERITY_ORDER_KEYS.map((key) => [key, key]));
+const TODO_PLAN_SIGNALS = new Set([
     "acceptance", "artifact", "capability", "capability-context", "compatibility", "contract",
     "cross-capability", "docs", "metadata", "migration", "schema", "startup", "surface", "test", "validation",
 ]);
-const PROFILERA_STALE_DAYS_ENV = "AGENTERA_PROFILERA_MAX_AGE_DAYS";
-const DEFAULT_PROFILERA_STALE_DAYS = 7;
-const INSPEKTERA_STALE_DAYS_ENV = "AGENTERA_INSPEKTERA_MAX_AGE_DAYS";
-const DEFAULT_INSPEKTERA_STALE_DAYS = 30;
-const INSPEKTERA_STALE_CYCLES_ENV = "AGENTERA_INSPEKTERA_MAX_CYCLES";
-const DEFAULT_INSPEKTERA_STALE_CYCLES = 10;
+const PROFILE_STALE_DAYS_ENV = "AGENTERA_PROFILE_MAX_AGE_DAYS";
+const DEFAULT_PROFILE_STALE_DAYS = 7;
+const AUDIT_STALE_DAYS_ENV = "AGENTERA_AUDIT_MAX_AGE_DAYS";
+const DEFAULT_AUDIT_STALE_DAYS = 30;
+const AUDIT_STALE_CYCLES_ENV = "AGENTERA_AUDIT_MAX_CYCLES";
+const DEFAULT_AUDIT_STALE_CYCLES = 10;
 function intEnv(env, key, def) {
     const raw = env[key] ?? String(def);
     const n = parseInt(raw, 10);
@@ -77,14 +71,35 @@ export function loadNamedArtifact(schemas, name) {
         return null;
     return loadArtifact(artifactPath(info, name));
 }
-export function registryArtifactPath(artifactId, schemasDir) {
+export function registryArtifactPath(artifactId, schemasDir, env = process.env) {
     const record = loadRegistryForSchemas(schemasDir).get(artifactId);
     if (record === undefined)
         throw new Error(`artifact registry does not define '${artifactId}'`);
-    return resolveArtifactPath(record, process.cwd(), activeObjectiveName());
+    return resolveArtifactPath(record, process.cwd(), activeObjectiveName(), env);
 }
 // ── staleness ───────────────────────────────────────────────────────
-export function checkProfileraStaleness(profilePath, env = process.env) {
+const PROFILE_GENERATED_RE = /<!-- Generated:\s*(\d{4}-\d{2}-\d{2})/;
+const PROFILE_VALIDATED_RE = /Validated:\s*(\d{4}-\d{2}-\d{2})/;
+export function parseProfileHeaderDates(text) {
+    const genMatch = PROFILE_GENERATED_RE.exec(text);
+    const generatedDate = genMatch ? genMatch[1] : null;
+    const generatedUtc = generatedDate ? dateFromIso(generatedDate) : null;
+    const valMatch = PROFILE_VALIDATED_RE.exec(text);
+    const validatedDate = valMatch ? valMatch[1] : null;
+    const validatedUtc = validatedDate ? dateFromIso(validatedDate) : null;
+    return { generatedDate, validatedDate, generatedUtc, validatedUtc };
+}
+function profileRefreshAnchorUtc(text) {
+    const { generatedUtc, validatedUtc } = parseProfileHeaderDates(text);
+    if (generatedUtc === null && validatedUtc === null)
+        return null;
+    if (generatedUtc === null)
+        return validatedUtc;
+    if (validatedUtc === null)
+        return generatedUtc;
+    return Math.max(generatedUtc, validatedUtc);
+}
+export function checkProfileStaleness(profilePath, env = process.env) {
     if (!fs.existsSync(profilePath))
         return null;
     let text;
@@ -95,14 +110,11 @@ export function checkProfileraStaleness(profilePath, env = process.env) {
         process.stderr.write(`warning: failed to read profile path ${profilePath}: ${exc.message}\n`);
         return null;
     }
-    const m = /<!-- Generated:\s*(\d{4}-\d{2}-\d{2})/.exec(text);
-    if (!m)
+    const anchor = profileRefreshAnchorUtc(text);
+    if (anchor === null)
         return null;
-    const gen = dateFromIso(m[1]);
-    if (gen === null)
-        return null;
-    const staleDays = intEnv(env, PROFILERA_STALE_DAYS_ENV, DEFAULT_PROFILERA_STALE_DAYS);
-    const since = daysSince(gen);
+    const staleDays = intEnv(env, PROFILE_STALE_DAYS_ENV, DEFAULT_PROFILE_STALE_DAYS);
+    const since = daysSince(anchor);
     return [since >= staleDays, since, staleDays];
 }
 export function healthAuditDate(entry) {
@@ -139,11 +151,11 @@ function cyclesSinceHealthAudit(schemas, auditDate) {
     }
     return count;
 }
-function checkInspekteraAuditStaleness(schemas, latest, auditDate, env = process.env) {
+function checkAuditStaleness(schemas, latest, auditDate, env = process.env) {
     if (latest === null || auditDate === null)
         return null;
-    const staleDaysThreshold = intEnv(env, INSPEKTERA_STALE_DAYS_ENV, DEFAULT_INSPEKTERA_STALE_DAYS);
-    const staleCyclesThreshold = intEnv(env, INSPEKTERA_STALE_CYCLES_ENV, DEFAULT_INSPEKTERA_STALE_CYCLES);
+    const staleDaysThreshold = intEnv(env, AUDIT_STALE_DAYS_ENV, DEFAULT_AUDIT_STALE_DAYS);
+    const staleCyclesThreshold = intEnv(env, AUDIT_STALE_CYCLES_ENV, DEFAULT_AUDIT_STALE_CYCLES);
     const since = daysSince(auditDate);
     const cyclesSince = cyclesSinceHealthAudit(schemas, auditDate);
     const timeStale = since >= staleDaysThreshold;
@@ -168,7 +180,7 @@ function checkInspekteraAuditStaleness(schemas, latest, auditDate, env = process
     if (cyclesSince !== null)
         result.cycles_since_audit = cyclesSince;
     if (isStale)
-        result.suggested_action = "Run inspektera to refresh health audit";
+        result.suggested_action = "Run audit to refresh health audit";
     return result;
 }
 // ── todo items + issue counts ───────────────────────────────────────
@@ -217,9 +229,12 @@ export function loadTodoItems(schemas) {
             continue;
         }
         if (currentSeverity) {
-            const m = TODO_ITEM_RE.exec(stripped);
-            if (m)
-                items.push({ severity: currentSeverity, status: "open", text: m[2].trim() });
+            const parsed = parseTodoMarkdownListItem(stripped);
+            if (!parsed || isResolvedTodoMarkdownStatus(parsed.status))
+                continue;
+            if (!parsed.description)
+                continue;
+            items.push({ severity: currentSeverity, status: parsed.status, text: parsed.description });
         }
     }
     return items;
@@ -239,72 +254,95 @@ export function issueCounts(todoItems) {
     }
     return counts;
 }
-function todoNeedsPlanera(item) {
+function todoNeedsPlan(item) {
     const text = item.text.toLowerCase();
     let signalCount = 0;
-    for (const signal of TODO_PLANERA_SIGNALS)
+    for (const signal of TODO_PLAN_SIGNALS)
         if (text.includes(signal))
             signalCount += 1;
     return signalCount >= 2 || (signalCount >= 1 && text.length > 180);
 }
 // ── per-artifact summaries ──────────────────────────────────────────
 export function planSummary(schemas) {
-    const data = loadNamedArtifact(schemas, "plan");
-    if (!data || typeof data !== "object" || Array.isArray(data)) {
-        return {
+    const info = schemas.plan;
+    if (!info) {
+        const summary = {
             exists: false,
             active: false,
             tasks: [],
             status: "absent",
             title: "",
+            active_path: "",
             absence_reason: "No active plan artifact is available from agentera plan.",
         };
+        summary.lifecycle_state = planLifecycleState(summary);
+        return summary;
     }
-    const d = data;
-    const legacyEntries = asList(d.entries);
-    let tasks;
-    let status;
-    let title;
-    if (legacyEntries.length > 0) {
-        tasks = legacyEntries;
-        status = entryStatusPy(tasks[0], "");
-        title = String(firstPresent(tasks[0], ["title", "name"], ""));
-    }
-    else {
-        const header = d.header && typeof d.header === "object" && !Array.isArray(d.header) ? d.header : {};
-        tasks = asList(d.tasks);
-        status = String(firstPresent(header, ["status"], d.status ?? "") || "");
-        title = String(firstPresent(header, ["title"], d.title ?? "") || "");
+    const discovery = discoverPlanArtifacts(artifactPath(info, "plan"));
+    const activeDiagnostics = discovery.diagnostics.filter((diagnostic) => diagnostic.path === discovery.activePath && diagnostic.category !== "legacy");
+    const archivedPlans = discovery.archived.map((artifact) => planCatalogEntry(artifact, discovery.activePath));
+    if (!discovery.active) {
+        const summary = {
+            exists: activeDiagnostics.length === 0 && archivedPlans.length > 0,
+            active: false,
+            tasks: [],
+            status: activeDiagnostics.length > 0 ? "invalid" : archivedPlans.length > 0 ? "archived" : "absent",
+            title: "",
+            active_path: discovery.activePath,
+            absence_reason: activeDiagnostics.length > 0
+                ? "Current plan artifact is invalid; see diagnostics."
+                : archivedPlans.length > 0
+                    ? "No active plan artifact is available; archived plan state is history only."
+                    : "No active plan artifact is available from agentera plan.",
+            complete: 0,
+            total: 0,
+            complete_plan: false,
+            first_pending: null,
+            archived_plans: archivedPlans,
+            archive_count: archivedPlans.length,
+            invalid_archive_paths: discovery.invalidArchivePaths,
+            ...(activeDiagnostics.length > 0 ? { invalid_path: discovery.activePath } : {}),
+            diagnostics: discovery.diagnostics,
+        };
+        summary.lifecycle_state = planLifecycleState(summary);
+        return summary;
     }
+    const d = discovery.active.data;
+    const parts = planDocumentParts(d);
+    const tasks = parts.tasks;
+    const status = parts.legacyEntries ? entryStatusPy(tasks[0], "") : parts.status;
+    const title = parts.legacyEntries
+        ? String(firstPresent(tasks[0] ?? {}, ["title", "name"], ""))
+        : parts.title;
     const complete = tasks.filter((task) => DONE_STATUSES.has(entryStatusPy(task, ""))).length;
     const total = tasks.length;
     const completePlan = DONE_STATUSES.has(status.toLowerCase()) && complete === total;
-    let firstPending = null;
-    if (!completePlan) {
-        for (const task of tasks) {
-            const ts = entryStatusPy(task, "pending");
-            if (DONE_STATUSES.has(ts) || BLOCKED_STATUSES.has(ts))
-                continue;
-            firstPending = task;
-            break;
-        }
-    }
-    return {
+    const firstPending = completePlan
+        ? null
+        : dependencyReadyTasks(tasks).find((task) => entryStatusPy(task, "pending") === "pending") ?? null;
+    const summary = {
         exists: true,
         status,
         title,
+        active_path: discovery.activePath,
         constraints: d.constraints ?? null,
         scope: d.scope ?? null,
         design: d.design ?? null,
         tasks,
         complete,
         total,
-        active: !completePlan,
+        active: true,
         complete_plan: completePlan,
         first_pending: firstPending,
+        archived_plans: archivedPlans,
+        archive_count: archivedPlans.length,
+        invalid_archive_paths: discovery.invalidArchivePaths,
+        diagnostics: discovery.diagnostics,
     };
+    summary.lifecycle_state = planLifecycleState(summary);
+    return summary;
 }
-export function docsSummary(schemas) {
+export function docsSummary(schemas, startupInput = {}) {
     const data = loadNamedArtifact(schemas, "docs");
     if (!data || typeof data !== "object" || Array.isArray(data)) {
         return { exists: false, status: "absent", absence_reason: "No docs mapping artifact is available from agentera docs." };
@@ -323,13 +361,13 @@ export function docsSummary(schemas) {
         mapping_entries: mapping.length,
         coverage,
         source_contract: {
-            capability_startup_complete: STARTUP_COMPLETENESS_MISSING_STATE.length === 0,
+            capability_startup_complete: capabilityStartupComplete(startupInput),
             raw_artifact_reads_required: false,
             state_families: [
                 "plan task details, dependencies, acceptance criteria, and evidence summaries",
                 "docs artifact mapping and source-contract completeness metadata",
-                "latest progress verification metadata needed for Orkestrera evaluation",
-                "Dokumentera closeout context metadata for docs/TODO/changelog/progress synchronization",
+                "latest progress verification metadata needed for Orchestrate evaluation",
+                "Document closeout context metadata for docs/TODO/changelog/progress synchronization",
             ],
         },
         indexed_documents: index.length,
@@ -341,7 +379,7 @@ export function progressSummary(schemas) {
     if (entries.length === 0) {
         return { exists: false, status: "absent", absence_reason: "No progress cycles are available from agentera progress." };
     }
-    const latest = recentCycles(entries, 1)[0];
+    const latest = progressEntriesForOutput(recentCycles(entries, 1))[0];
     return {
         exists: true,
         status: "available",
@@ -370,18 +408,20 @@ export function healthSummary(schemas, env = process.env) {
     const trajectory = String(latest.trajectory ?? "");
     const auditDate = healthAuditDate(latest);
     const dateStr = auditDate !== null ? isoFromUtc(auditDate) : null;
+    const latestNumber = typeof latest.number === "string" || typeof latest.number === "number" ? latest.number : "?";
+    const latestTimestamp = typeof latest.timestamp === "string" ? latest.timestamp : null;
     const summary = {
         exists: true,
-        number: latest.number ?? "?",
+        number: latestNumber,
         date: dateStr,
-        timestamp: dateStr ?? latest.timestamp ?? null,
+        timestamp: dateStr ?? latestTimestamp,
         trajectory,
         grade: worst ? worst[1] : "",
         worst,
         degrading: ["degrading", "declining", "worse"].includes(trajectory.toLowerCase()) ||
             (worst !== null && worst[2] >= gradeRank.D),
     };
-    const staleness = checkInspekteraAuditStaleness(schemas, latest, auditDate, env);
+    const staleness = checkAuditStaleness(schemas, latest, auditDate, env);
     if (staleness !== null)
         Object.assign(summary, staleness);
     return summary;
@@ -399,7 +439,7 @@ function objectiveStatus(data) {
     return String(firstPresent(header, ["status"], data.status ?? objective.status ?? "") || "").toLowerCase();
 }
 export function activeObjectiveSummary() {
-    const root = path.join(process.cwd(), ".agentera", "optimera");
+    const root = path.join(process.cwd(), ".agentera", "optimize");
     let isDir = false;
     try {
         isDir = fs.statSync(root).isDirectory();
@@ -462,7 +502,11 @@ export function statePresence(plan, docs, progress, health, objective) {
         objective: Boolean(objective.exists),
     };
     const absence = {};
-    for (const [name, summary] of [["plan", plan], ["docs", docs], ["progress", progress]]) {
+    for (const [name, summary] of [
+        ["plan", plan],
+        ["docs", docs],
+        ["progress", progress],
+    ]) {
         if (!summary.exists && summary.absence_reason)
             absence[name] = summary.absence_reason;
     }
@@ -481,11 +525,11 @@ export function decisionFollowUp(schemas) {
     for (const rawEntry of extractEntries(data)) {
         const entry = decisionContextEntry(rawEntry);
         const satisfaction = entry.satisfaction;
-        if (!satisfaction || typeof satisfaction !== "object" || !satisfaction.review_needed)
+        if (!satisfaction || typeof satisfaction !== "object" || Array.isArray(satisfaction) || !satisfaction.review_needed)
             continue;
-        const number = entry.number ?? "?";
+        const number = typeof entry.number === "string" || typeof entry.number === "number" ? entry.number : "?";
         const title = firstPresent(entry, ["question", "choice"], "decision follow-up");
-        return { object: `DECISION ${number} follow-up`, title };
+        return { object: `DECISION ${number} follow-up`, title: String(title) };
     }
     return null;
 }
@@ -495,7 +539,7 @@ function decisionAttentionState(satisfaction) {
         return "missing";
     if (state === "user_confirmed_satisfied" && satisfaction.review_needed)
         return "unconfirmed_user_confirmed_satisfied";
-    if (["open", "provisionally_satisfied", "review_needed"].includes(state))
+    if (["open", "provisionally_satisfied", "review_needed"].includes(String(state)))
         return String(state);
     if (state === "user_confirmed_satisfied")
         return "user_confirmed_satisfied";
@@ -508,12 +552,12 @@ export function decisionReviewAttention(schemas) {
     for (const rawEntry of extractEntries(data)) {
         const entry = decisionContextEntry(rawEntry);
         const satisfaction = entry.satisfaction;
-        if (!satisfaction || typeof satisfaction !== "object" || !satisfaction.review_needed)
+        if (!satisfaction || typeof satisfaction !== "object" || Array.isArray(satisfaction) || !satisfaction.review_needed)
             continue;
         const state = decisionAttentionState(satisfaction);
         stateCounts[state] = (stateCounts[state] ?? 0) + 1;
         reviewEntries.push({
-            number: entry.number ?? "?",
+            number: typeof entry.number === "string" || typeof entry.number === "number" ? entry.number : "?",
             title: truncate(firstPresent(entry, ["question", "choice", "summary"], "decision review"), 80),
             state,
             source: satisfaction.source ?? null,
@@ -541,55 +585,91 @@ export function decisionReviewAttention(schemas) {
 }
 export function formatNextAction(action) {
     if (!action)
-        return "object=VISION refresh | capability=visionera | reason=no executable follow-up";
-    return `object=${truncate(action.object)} | capability=${action.capability} | reason=${action.reason}`;
+        return "object=VISION refresh | capability=vision | reason=no executable follow-up | phase=envision";
+    const phase = "phase" in action && action.phase ? ` | phase=${action.phase}` : "";
+    return `object=${truncate(action.object)} | capability=${action.capability} | reason=${action.reason}${phase}`;
 }
-export function selectHejNextAction(plan, health, objective, todoItems, decision, savedContext) {
+/**
+ * Evolved state-readiness hint (Decision 76). Evaluates every cascade branch
+ * (no early-return); each candidate carries a protocol.yaml phase tag (PH1
+ * envision → PH5 audit). Position 1 (`recommended`) is the branch that would
+ * have won under the legacy early-return cascade.
+ */
+export function selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext) {
+    const candidates = [];
     const pending = plan.first_pending;
     if (pending && typeof pending === "object" && !Array.isArray(pending)) {
         const number = pending.number ?? "?";
         const title = firstPresent(pending, ["name", "title"], "pending task");
-        return { object: `PLAN Task ${number}: ${title}`, capability: "orkestrera", reason: "first pending plan task" };
+        candidates.push({
+            object: `PLAN Task ${number}: ${title}`,
+            capability: "orchestrate",
+            reason: "first pending plan task",
+            phase: "build",
+        });
     }
     if (health.degrading) {
         const worst = health.worst;
         const target = worst ? `${worst[0]}:${worst[1]}` : "degrading health";
-        return { object: `HEALTH: ${target}`, capability: "inspektera", reason: "critical or degrading health" };
+        candidates.push({
+            object: `HEALTH: ${target}`,
+            capability: "audit",
+            reason: "critical or degrading health",
+            phase: "audit",
+        });
     }
     if (objective.active) {
-        return {
+        candidates.push({
             object: `OBJECTIVE: ${objective.metric || objective.title}`,
-            capability: "optimera",
+            capability: "optimize",
             reason: "active non-closed objective",
-        };
+            phase: "build",
+        });
     }
     if (todoItems.length > 0) {
         const item = [...todoItems].sort((a, b) => (TODO_SEVERITY_ORDER[a.severity] ?? 2) - (TODO_SEVERITY_ORDER[b.severity] ?? 2))[0];
-        if (todoNeedsPlanera(item)) {
-            return { object: `TODO: ${item.text}`, capability: "planera", reason: "complex TODO needs planning" };
+        if (todoNeedsPlan(item)) {
+            candidates.push({ object: `TODO: ${item.text}`, capability: "plan", reason: "complex TODO needs planning", phase: "plan" });
+        }
+        else {
+            candidates.push({ object: `TODO: ${item.text}`, capability: "build", reason: "highest-priority open TODO", phase: "build" });
         }
-        return { object: `TODO: ${item.text}`, capability: "realisera", reason: "highest-priority open TODO" };
     }
     if (health.stale && !health.degrading) {
-        return {
+        candidates.push({
             object: `HEALTH: Audit ${health.number ?? "?"} stale`,
-            capability: "inspektera",
+            capability: "audit",
             reason: "stale health audit",
-        };
+            phase: "audit",
+        });
     }
     if (decision) {
-        return { object: String(decision.object), capability: "resonera", reason: "unresolved decision follow-up" };
+        candidates.push({
+            object: String(decision.object),
+            capability: "discuss",
+            reason: "unresolved decision follow-up",
+            phase: "deliberate",
+        });
     }
     const visionExists = fs.existsSync(path.join(process.cwd(), ".agentera", "vision.yaml"));
-    if (plan.exists && !plan.complete_plan) {
-        return { object: "VISION refresh", capability: "planera", reason: "no executable follow-up" };
+    if ((plan.exists && !plan.complete_plan) || visionExists) {
+        candidates.push({ object: "VISION refresh", capability: "plan", reason: "no executable follow-up", phase: "envision" });
     }
-    if (visionExists) {
-        return { object: "VISION refresh", capability: "planera", reason: "no executable follow-up" };
+    if (savedContext && !visionExists) {
+        candidates.push({ object: "Direction clarification", capability: "discuss", reason: "saved context without vision", phase: "envision" });
     }
-    if (savedContext) {
-        return { object: "Direction clarification", capability: "resonera", reason: "saved context without vision" };
+    candidates.push({ object: "VISION refresh", capability: "vision", reason: "fresh project direction", phase: "envision" });
+    // Guarantee at least one alternative so the hint never collapses to a single entry.
+    if (candidates.length < 2) {
+        candidates.push({ object: "Direction clarification", capability: "discuss", reason: "clarify project direction", phase: "envision" });
     }
-    return { object: "VISION refresh", capability: "visionera", reason: "fresh project direction" };
+    const [recommended, ...alternatives] = candidates;
+    return { recommended, alternatives };
+}
+/** Legacy single-entry projection of {@link selectStatusReadiness}: the
+ *  top-priority candidate as `{object, capability, reason}` (no `phase`). */
+export function selectStatusNextAction(plan, health, objective, todoItems, decision, savedContext) {
+    const { recommended } = selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext);
+    return { object: recommended.object, capability: recommended.capability, reason: recommended.reason };
 }
 //# sourceMappingURL=orientation.js.map