agentera 3.0.0-dev.41 → 3.0.0-dev.46

package/dist/cli/commands/doctor.js

@@ -5,9 +5,11 @@ import { resolveDoctorInstallRoot, resolveSourceRootStrict, } from "../../upgrad
 import { runNpmSmokeChecks } from "../../setup/smokeChecks.js";
 import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE, appLifecycleActionNoun, buildDoctorStatus, EXPECTED_STATE_COMMANDS, doctorParityJsonEnvelope, } from "../../upgrade/doctor.js";
 import { classifyInstall } from "../../upgrade/compatibility.js";
-import { prependCoexistenceDoctorSection, resolveCoexistenceDoctorLines, } from "../../upgrade/coexistenceProbe.js";
 import { prependNextMajorDoctorSection, resolveNextMajorDoctorLines, } from "../../upgrade/nextMajorDoctor.js";
 import { diagnoseCanonicalSkill } from "../../setup/sharedSkill.js";
+import { diagnoseRetiredResources } from "../../upgrade/retiredResourceDiagnostics.js";
+import { commandText } from "../../upgrade/upgradeCommands.js";
+import { inspectTodoReconciliationState } from "../../state/todoReconciliationInspection.js";
 const PLAIN_STATUS = {
     pending: "ready to fix",
     applied: "fixed",
@@ -24,7 +26,36 @@ const PLAIN_STATUS = {
 function plainStatus(value) {
     return PLAIN_STATUS[value] ?? value.replace(/_/g, " ").replace(/-/g, " ");
 }
-export function renderDoctorStatus(status) {
+function previewCommand(resource, context) {
+    return commandText([
+        "npx",
+        "-y",
+        "agentera@next",
+        "doctor",
+        "--home",
+        context.home,
+        "--project",
+        context.project,
+        "--install-root",
+        context.installRoot,
+        "--retired-resource",
+        resource.id,
+        "--format",
+        "json",
+    ]);
+}
+function doctorRetiredResources(diagnosis, context) {
+    return {
+        ...diagnosis,
+        resources: diagnosis.resources.map((resource) => ({
+            id: resource.id,
+            status: resource.status,
+            evidence: resource.evidence,
+            preview_command: previewCommand(resource, context),
+        })),
+    };
+}
+export function renderDoctorStatus(status, retiredResources) {
     const actionNoun = appLifecycleActionNoun(String(status.status));
     const lines = [
         "Agentera doctor",
@@ -42,6 +73,31 @@ export function renderDoctorStatus(status) {
             if (signal.missingCommands && signal.missingCommands.length > 0) {
                 lines.push(`    Missing command: ${signal.missingCommands.join(", ")}`);
             }
+            if (signal.kind === "todo_reconciliation") {
+                if (signal.reconciliationState)
+                    lines.push(`    Reconciliation state: ${signal.reconciliationState}`);
+                if (signal.reconciliationCounts) {
+                    const counts = ["matched", "converted", "retained", "duplicate", "stale", "conflicting"]
+                        .filter((name) => name in signal.reconciliationCounts)
+                        .map((name) => `${name}=${signal.reconciliationCounts[name]}`)
+                        .join(" | ");
+                    lines.push(`    Counts: ${counts} | omitted=${String(signal.reconciliationOmittedCount ?? 0)}`);
+                }
+                if (signal.previewCommand)
+                    lines.push(`    Preview: ${signal.previewCommand}`);
+                if (signal.applyCommand)
+                    lines.push(`    Apply: ${signal.applyCommand}`);
+            }
+        }
+    }
+    const resources = Array.isArray(retiredResources?.resources) ? retiredResources.resources : [];
+    const todoReconciliation = status.signals?.some((signal) => signal.kind === "todo_reconciliation") ?? false;
+    if (resources.length > 0) {
+        lines.push("");
+        lines.push("Retired native resources:");
+        for (const resource of resources) {
+            lines.push(`  - action required: ${String(resource.id)}`);
+            lines.push(`    Preview: ${String(resource.preview_command)}`);
         }
     }
     if (status.status === APP_UP_TO_DATE) {
@@ -60,6 +116,14 @@ export function renderDoctorStatus(status) {
             lines.push("  3. Then retry Agentera once a retry command is available.");
         }
     }
+    else if (todoReconciliation) {
+        lines.push("");
+        lines.push("Next: run the reported TODO reconciliation preview, review its bounded effect, then use its exact apply_command.");
+    }
+    else if (resources.length > 0) {
+        lines.push("");
+        lines.push("Next: review each read-only retirement preview before any explicit cleanup.");
+    }
     else {
         lines.push("");
         lines.push("Next: choose a safer Agentera directory, or use `--force` only after checking the directory is safe to replace.");
@@ -101,6 +165,40 @@ export function cmdDoctor(args, io = {}) {
         expectedVersion: args.expectedVersion ?? null,
         expectedCommands,
     });
+    const todoReconciliation = inspectTodoReconciliationState(project, sourceRoot);
+    if (todoReconciliation?.status === "action_required") {
+        status.signals.push({
+            status: APP_MANUAL_REVIEW_NEEDED,
+            kind: "todo_reconciliation",
+            message: `action-required: TODO reconciliation is ${todoReconciliation.state === "inactive" ? "inactive" : todoReconciliation.state === "unsafe_active" ? "unsafe active" : "in an invalid lifecycle state"}`,
+            reconciliationState: todoReconciliation.state,
+            reconciliationCounts: todoReconciliation.counts,
+            reconciliationOmittedCount: todoReconciliation.omitted_count,
+            previewCommand: todoReconciliation.preview_command,
+            applyCommand: todoReconciliation.apply_command,
+            recoveryCommand: todoReconciliation.recovery_command,
+        });
+        if (status.status === APP_UP_TO_DATE)
+            status.status = APP_MANUAL_REVIEW_NEEDED;
+    }
+    const retiredDiagnosis = diagnoseRetiredResources({
+        home,
+        project,
+        installRoot,
+        resourceId: args.retiredResource ?? null,
+    });
+    const retiredResources = doctorRetiredResources(retiredDiagnosis, { home, project, installRoot });
+    if (retiredDiagnosis.status === "action_required") {
+        status.signals.push({
+            status: APP_MANUAL_REVIEW_NEEDED,
+            kind: "retired_native_resources",
+            message: "retired native resource candidates need ownership review before cleanup",
+            resourceIds: retiredDiagnosis.resources.map((resource) => resource.id),
+            omittedResourceCount: retiredDiagnosis.omittedResourceCount,
+        });
+        if (status.status === APP_UP_TO_DATE)
+            status.status = APP_MANUAL_REVIEW_NEEDED;
+    }
     const sharedSkill = diagnoseCanonicalSkill(home);
     let smokeReport = null;
     if (args.smoke) {
@@ -111,17 +209,13 @@ export function cmdDoctor(args, io = {}) {
     if ((args.format ?? "text") === "json") {
         const payload = doctorParityJsonEnvelope(status);
         payload.shared_skill = sharedSkill;
+        payload.retired_resources = retiredResources;
         if (smokeReport)
             payload.smoke = smokeReport;
         out(pyJsonIndentSorted(payload) + "\n");
     }
     else {
         const install = classifyInstall({ appHome: installRoot, sourceRoot });
-        const coexistenceLines = resolveCoexistenceDoctorLines({
-            home,
-            sourceRoot,
-            env: { ...process.env, HOME: home },
-        });
         const nextMajorLines = resolveNextMajorDoctorLines({
             sourceRoot,
             home,
@@ -129,7 +223,9 @@ export function cmdDoctor(args, io = {}) {
             install,
             env: process.env,
         });
-        const body = prependCoexistenceDoctorSection(prependNextMajorDoctorSection(renderDoctorStatus(status), nextMajorLines), coexistenceLines) + `\nShared skill\n  ${String(sharedSkill.status)}: ${String(sharedSkill.message)}\n  path: ${String(sharedSkill.path)}\n` + (smokeReport ? renderDoctorSmoke(smokeReport) : "");
+        const body = prependNextMajorDoctorSection(renderDoctorStatus(status, retiredResources), nextMajorLines) +
+            `\nShared skill\n  ${String(sharedSkill.status)}: ${String(sharedSkill.message)}\n  path: ${String(sharedSkill.path)}\n` +
+            (smokeReport ? renderDoctorSmoke(smokeReport) : "");
         out(body + "\n");
     }
     if (args.smoke) {
@@ -139,4 +235,3 @@ export function cmdDoctor(args, io = {}) {
     }
     return status.status === APP_UP_TO_DATE && sharedSkill.status === "pass" ? 0 : 1;
 }
-//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/durability.js

@@ -79,4 +79,3 @@ export function cmdDurability(args, io = {}) {
     }
     return 0;
 }
-//# sourceMappingURL=durability.js.map

package/dist/cli/commands/glossaryAdvice.js

@@ -136,4 +136,3 @@ export function runGlossaryAdviceCommand(argv, io) {
         return invalid(io, { class: "invalid_request", message: `glossary advice failed: ${code}` });
     }
 }
-//# sourceMappingURL=glossaryAdvice.js.map

package/dist/cli/commands/lint.js

@@ -159,4 +159,3 @@ export function cmdLint(args, io = {}) {
     const operationalFailure = payload.checks.some((check) => check.status === "fail" && isVerbosityAuthorityError(check.detail));
     return operationalFailure || (args.strict && payload.status === "fail") ? 1 : 0;
 }
-//# sourceMappingURL=lint.js.map

package/dist/cli/commands/personalGlossary.js

@@ -174,4 +174,3 @@ export function runPersonalGlossaryCommand(argv, io) {
         });
     }
 }
-//# sourceMappingURL=personalGlossary.js.map

package/dist/cli/commands/prime/briefOrientation.js

@@ -1,5 +1,6 @@
 import { truncateCodePoints } from "../../../core/text.js";
 import { entityListFamily } from "../../../state/entityRetrievalHelp.js";
+import { preCutoverCommand } from "../../preCutoverCommand.js";
 import { STATE_FAMILY_FALLBACK_COMMANDS } from "../../capabilityContext/types.js";
 /**
  * Bounded default decision brief for the bare `agentera prime --format json`
@@ -17,10 +18,8 @@ import { STATE_FAMILY_FALLBACK_COMMANDS } from "../../capabilityContext/types.js
  * The byte gate is deterministic pretty-JSON UTF-8 measurement
  * (Buffer.byteLength(JSON.stringify(brief, null, 2) + "\n", "utf8")); an
  * over-budget brief is rejected in favor of a bounded degraded envelope.
- * Diagnostics (the `issues` deprecation warning) stay on stderr and are
- * measured separately. See references/cli/prime-consumer-compatibility.yaml
- * brief_omission_contract and references/artifacts/state-storage-authority.yaml
- * budgets.startup.surfaces.prime_briefing.
+ * Diagnostics stay on stderr and are measured separately. The state-storage
+ * authority owns the briefing budget.
  */
 /** Authoritative byte budget for the default bare prime decision brief.
  *  Mirrors references/artifacts/state-storage-authority.yaml
@@ -47,28 +46,26 @@ export function briefByteGate(value, budget = PRIME_BRIEF_MAX_UTF8_BYTES) {
     return { accepted: bytes <= budget, bytes };
 }
 /** Rich-state sub-detail projected out of the default brief, each with a named
- *  authoritative recovery command (AC4). Mirrors brief_omission_contract in
- *  references/cli/prime-consumer-compatibility.yaml. */
+ *  authoritative recovery command. */
 const planTaskFamily = entityListFamily("plan_tasks");
-const planTaskListRecovery = `agentera state ${planTaskFamily.commandTokens.join(" ")} list --format json`;
+const planTaskListRecovery = preCutoverCommand(`state ${planTaskFamily.commandTokens.join(" ")} list --format json`);
 const OMITTED_RICH_STATE = [
-    { field: "startup.path_diagnostics", reason: "startup_path_diagnostics", recovery: "agentera doctor --format json" },
+    { field: "startup.path_diagnostics", reason: "startup_path_diagnostics", recovery: preCutoverCommand("doctor --format json") },
     { field: "plan.tasks", reason: "plan_task_detail", recovery: planTaskListRecovery },
     { field: "plan.archived_plans", reason: "archive_catalog", recovery: STATE_FAMILY_FALLBACK_COMMANDS.plan },
     { field: "plan.diagnostics", reason: "plan_diagnostics", recovery: STATE_FAMILY_FALLBACK_COMMANDS.plan },
     { field: "history.progress.entries", reason: "startup_history_entries", recovery: STATE_FAMILY_FALLBACK_COMMANDS.progress },
     { field: "history.decisions.entries", reason: "startup_history_entries", recovery: STATE_FAMILY_FALLBACK_COMMANDS.decisions },
     { field: "history.health.entries", reason: "startup_history_entries", recovery: STATE_FAMILY_FALLBACK_COMMANDS.health },
-    { field: "project_integration.phases", reason: "phase_blockers", recovery: "agentera doctor --format json" },
-    { field: "source_contract.artifact_writes.artifacts", reason: "writer_contract_detail", recovery: "agentera schema --format json" },
+    { field: "project_integration.phases", reason: "phase_blockers", recovery: preCutoverCommand("doctor --format json") },
     { field: "docs.source_contract", reason: "docs_state_families", recovery: STATE_FAMILY_FALLBACK_COMMANDS.docs },
-    { field: "profile.bounded_signals", reason: "profile_signal_detail", recovery: "agentera profile --format json" },
+    { field: "profile.bounded_signals", reason: "profile_signal_detail", recovery: preCutoverCommand("report profile-grounding --format json") },
 ];
 /** Maximum number of ranked next_action alternatives retained in the brief.
  *  The recommended entry is always kept; overflow alternatives recover via the
  *  state-derived readiness cascade rather than raw artifact access. */
 const BRIEF_NEXT_ACTION_ALTERNATIVES = 3;
-const PATH_DIAGNOSTICS_RECOVERY = "agentera doctor --format json";
+const PATH_DIAGNOSTICS_RECOVERY = preCutoverCommand("doctor --format json");
 /** Code-point cap for routing-essential free-text scalars retained in the brief
  *  (e.g. progress.latest.what/next). Matches the boundStartupValue 200-cp
  *  limit already applied to context payloads so the brief never lets a single
@@ -466,44 +463,6 @@ function briefCapabilityContext(value, maxChars) {
     }
     return out;
 }
-function briefCapabilityStartup(startup, maxChars) {
-    if (!isObject(startup))
-        return {};
-    const out = {};
-    if (typeof startup.complete_for_capability_startup === "boolean") {
-        out.complete_for_capability_startup = startup.complete_for_capability_startup;
-    }
-    if (typeof startup.raw_artifact_reads_required === "boolean") {
-        out.raw_artifact_reads_required = startup.raw_artifact_reads_required;
-    }
-    const policy = boundedString(startup.raw_artifact_read_policy, maxChars);
-    if (policy !== undefined)
-        out.raw_artifact_read_policy = policy;
-    for (const [key, maxItems] of [
-        ["available_state", 64],
-        ["missing_state", 16],
-        ["confidence_caveats", 8],
-        ["cli_fallback", 8],
-    ]) {
-        const bounded = boundedStringList(startup[key], maxItems, maxChars);
-        if (bounded !== undefined)
-            out[key] = bounded;
-    }
-    return out;
-}
-function briefArtifactWrites(writes, maxChars) {
-    // Keep the discovery pointer (required by the compatibility boundary test)
-    // and schema identity; the full writer-operation matrix recovers via schema.
-    if (!isObject(writes))
-        return {};
-    const out = {};
-    for (const key of ["schemaVersion", "discovery_command"]) {
-        const bounded = boundedString(writes[key], maxChars);
-        if (bounded !== undefined)
-            out[key] = bounded;
-    }
-    return out;
-}
 function briefSourceContract(sourceContract, projection = "normal") {
     if (!isObject(sourceContract))
         return {};
@@ -535,27 +494,6 @@ function briefSourceContract(sourceContract, projection = "normal") {
             out.capability_context = { fetch_command: capabilityContext.fetch_command };
         }
     }
-    if (isObject(sourceContract.capability_startup)) {
-        if (projection === "irreducible") {
-            const startup = sourceContract.capability_startup;
-            const minimalStartup = {};
-            if (typeof startup.complete_for_capability_startup === "boolean") {
-                minimalStartup.complete_for_capability_startup = startup.complete_for_capability_startup;
-            }
-            if (typeof startup.raw_artifact_reads_required === "boolean") {
-                minimalStartup.raw_artifact_reads_required = startup.raw_artifact_reads_required;
-            }
-            out.capability_startup = minimalStartup;
-        }
-        else {
-            out.capability_startup = briefCapabilityStartup(sourceContract.capability_startup, maxChars);
-        }
-    }
-    if (isObject(sourceContract.artifact_writes)) {
-        if (projection !== "irreducible") {
-            out.artifact_writes = briefArtifactWrites(sourceContract.artifact_writes, maxChars);
-        }
-    }
     return out;
 }
 /** Project the full orientation payload to a bounded decision brief. The brief
@@ -587,10 +525,10 @@ export function briefOrientationPayload(payload, options = {}) {
 /** Attach the brief meta block and settle `utf8_bytes` to a fixed point so the
  *  reported size equals the actual emitted byte count (otherwise the digits of
  *  `utf8_bytes` itself would change the measurement). */
-function withBriefMeta(body, status, budget, error) {
+function withBriefMeta(body, projection, budget, error) {
     const meta = {
         budget_utf8_bytes: budget,
-        status,
+        projection,
         path_diagnostics_recovery: PATH_DIAGNOSTICS_RECOVERY,
         omitted_rich_state: OMITTED_RICH_STATE.map((entry) => ({ ...entry })),
     };
@@ -651,7 +589,7 @@ function projectBriefBody(payload) {
                 out[key] = briefSource(value);
                 break;
             default:
-                // Command/status/mode, bounded ordinary state, shared-skill diagnosis,
+                // Command/outcome/mode, bounded ordinary state, shared-skill diagnosis,
                 // bespoke context pointers, and active conditional fields pass through
                 // at full fidelity.
                 out[key] = value;
@@ -666,7 +604,7 @@ function boundedEnvelopeScalar(value, fallback) {
 function degradedBody(payload, projection) {
     const out = {
         command: boundedEnvelopeScalar(payload.command, "prime"),
-        status: boundedEnvelopeScalar(payload.status, "ok"),
+        outcome: boundedEnvelopeScalar(payload.outcome, "ok"),
         mode: boundedEnvelopeScalar(payload.mode, "unknown"),
         state_presence: briefStatePresence(payload.state_presence),
         source_contract: briefSourceContract(payload.source_contract, projection),
@@ -681,12 +619,14 @@ function degradedBody(payload, projection) {
         out.shared_skill = briefSharedSkill(payload.shared_skill);
     if ("project_integration" in payload)
         out.project_integration = briefProjectIntegration(payload.project_integration);
+    if ("todo_reconciliation" in payload)
+        out.todo_reconciliation = payload.todo_reconciliation;
+    if ("startup" in payload)
+        out.startup = payload.startup;
     if ("health" in payload)
         out.health = briefHealth(payload.health);
     if ("todo" in payload)
         out.todo = payload.todo;
-    if ("issues" in payload)
-        out.issues = payload.issues;
     if ("progress" in payload)
         out.progress = briefProgress(payload.progress);
     if ("attention" in payload)
@@ -735,7 +675,7 @@ export class BriefBudgetError extends Error {
     budgetBytes;
     minimumBytes;
     constructor(budgetBytes, minimumBytes) {
-        super(`brief budget ${budgetBytes} bytes cannot contain the minimum routing envelope (${minimumBytes} bytes); increase the budget or use --dashboard`);
+        super(`brief budget ${budgetBytes} bytes cannot contain the minimum routing envelope (${minimumBytes} bytes); increase the budget or use prime --context status`);
         this.name = "BriefBudgetError";
         this.budgetBytes = budgetBytes;
         this.minimumBytes = minimumBytes;
@@ -744,14 +684,14 @@ export class BriefBudgetError extends Error {
 function degradedBriefEnvelope(payload, budget, attemptedBytes, mode) {
     const detailedMeta = {
         budget_utf8_bytes: budget,
-        status: "degraded",
+        projection: "degraded",
         attempted_utf8_bytes: attemptedBytes,
         path_diagnostics_recovery: PATH_DIAGNOSTICS_RECOVERY,
         omitted_rich_state: OMITTED_RICH_STATE.map((entry) => ({ ...entry })),
         error: {
             class: "brief_output_budget",
             message: "the projected decision brief exceeded the authority byte budget; a bounded degraded envelope was emitted instead of the over-budget payload",
-            recovery: "Run `agentera prime --dashboard --format json` for the full orientation payload, or `agentera state <artifact> list --format json` for a specific record family.",
+            recovery: `Run \`${preCutoverCommand("prime --context status --format json")}\` for status startup, or \`${preCutoverCommand("state <artifact> list --format json")}\` for a specific record family.`,
         },
     };
     const body = (projection) => mode === "status_routing"
@@ -766,13 +706,13 @@ function degradedBriefEnvelope(payload, budget, attemptedBytes, mode) {
     // when caller data would make the detailed degraded envelope too large.
     const compactMeta = {
         budget_utf8_bytes: budget,
-        status: "degraded",
+        projection: "degraded",
         attempted_utf8_bytes: attemptedBytes,
         path_diagnostics_recovery: PATH_DIAGNOSTICS_RECOVERY,
         error: {
             class: "brief_output_budget",
             message: "the projected decision brief exceeded the authority byte budget; compact recovery metadata was emitted",
-            recovery: "Run `agentera prime --dashboard --format json` for full orientation detail.",
+            recovery: `Run \`${preCutoverCommand("prime --context status --format json")}\` for status startup.`,
         },
     };
     const compact = settledBriefEnvelope(body("compact"), compactMeta);
@@ -790,13 +730,13 @@ function degradedBriefEnvelope(payload, budget, attemptedBytes, mode) {
     // over-budget JSON document would violate the public output contract.
     const minimumMeta = {
         budget_utf8_bytes: budget,
-        status: "degraded",
+        projection: "degraded",
         attempted_utf8_bytes: attemptedBytes,
         path_diagnostics_recovery: PATH_DIAGNOSTICS_RECOVERY,
         error: {
             class: "brief_output_budget",
             message: "the configured budget cannot contain the detailed recovery envelope",
-            recovery: "Increase the budget or run `agentera prime --dashboard --format json`.",
+            recovery: `Increase the budget or run \`${preCutoverCommand("prime --context status --format json")}\`.`,
         },
     };
     const minimum = settledBriefEnvelope(body("irreducible"), minimumMeta);
@@ -805,4 +745,3 @@ function degradedBriefEnvelope(payload, budget, attemptedBytes, mode) {
         return minimum;
     throw new BriefBudgetError(budget, minimumBytes);
 }
-//# sourceMappingURL=briefOrientation.js.map

package/dist/cli/commands/prime/buildExecutionRequest.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import { hasControlChars } from "../../argvalidate.js";
 import { loadYamlMapping } from "../../../core/yaml.js";
+import { preCutoverCommand } from "../../preCutoverCommand.js";
 export const BUILD_EXECUTION_REQUEST_SCHEMA = "agentera.buildExecutionRequest.v1";
 export const BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES = 32 * 1024;
 export const BUILD_EXECUTION_REQUEST_MAX_ITEMS = 12;
@@ -35,7 +36,7 @@ function unreadableInput() {
     return fail({
         class: "invalid_format",
         message: "Build execution request input must be one readable regular file or bounded stdin stream",
-        syntax: "agentera prime --context build --input <file|-> --format json",
+        syntax: preCutoverCommand("prime --context build --input <file|-> --format json"),
     });
 }
 function oversizedInput() {
@@ -162,4 +163,3 @@ export function loadBuildExecutionRequest(source, readStdin) {
         },
     };
 }
-//# sourceMappingURL=buildExecutionRequest.js.map

package/dist/cli/commands/prime/bundleStatus.js

@@ -188,4 +188,3 @@ export function statusBundleContext(opts) {
 export function statusBundleStatus(opts) {
     return statusBundleContext(opts).bundle;
 }
-//# sourceMappingURL=bundleStatus.js.map

package/dist/cli/commands/prime/collectEntityOrientation.js

@@ -5,6 +5,7 @@ import { listHealthEntities } from "../../../state/healthEntities.js";
 import { listPlanEntities, listPlanTaskEntities } from "../../../state/planEntities.js";
 import { listObjectiveEntities, listExperimentEntities } from "../../../state/objectiveExperimentEntities.js";
 import { assertTodoReconciliationReadable, listTodoDocsEntities, projectTodoReadEntities } from "../../../state/todoDocsEntities.js";
+import { inspectTodoReconciliationState } from "../../../state/todoReconciliationInspection.js";
 import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
 import { discoverEntities } from "../../../state/entityStorage.js";
 import { summaryCaveat } from "../../../state/summaryEntityRead.js";
@@ -12,6 +13,7 @@ import { boundStartupValue, STARTUP_ARRAY_LIMIT } from "../../../state/startupPr
 import { rememberPlanTaskIndex } from "../../planTaskIndex.js";
 import { firstActionablePlanTask } from "../../capabilityContext/planState.js";
 import { issueCounts } from "../../orientation.js";
+import { preCutoverCommand } from "../../preCutoverCommand.js";
 import { evaluateTodoReadinessQueue } from "../../todoReadinessSelection.js";
 import { projectCurrentGlossaryCaveats } from "../../../state/progressGlossaryCaveat.js";
 import { glossaryCaveatContract } from "../../../registries/glossaryCaveatContract.js";
@@ -36,6 +38,40 @@ function header(entry) {
 function terminal(status) {
     return ["complete", "completed", "closed", "done", "resolved", "retired", "superseded"].includes(String(status ?? "").toLowerCase());
 }
+function healthSummary(latest, history) {
+    if (!latest) {
+        return history
+            ? { exists: true, status: "degraded", startup_outcome: "degraded", degraded_history: history }
+            : { exists: false, status: "absent", startup_outcome: "ok" };
+    }
+    const healthRecord = record(latest);
+    const grades = healthRecord.grades && typeof healthRecord.grades === "object" && !Array.isArray(healthRecord.grades)
+        ? healthRecord.grades
+        : {};
+    const ranks = { A: 0, B: 1, C: 2, D: 3, F: 4 };
+    let worst = null;
+    for (const [dimension, grade] of Object.entries(grades)) {
+        const text = String(grade);
+        const rank = ranks[text.toUpperCase().slice(0, 1)] ?? -1;
+        if (worst === null || rank > worst[2])
+            worst = [dimension, text, rank];
+    }
+    const trajectory = String(healthRecord.trajectory ?? "");
+    const degrading = ["degrading", "declining", "worse"].includes(trajectory.toLowerCase()) || (worst !== null && worst[2] >= ranks.D);
+    return {
+        exists: true,
+        status: degrading ? "degraded" : "available",
+        startup_outcome: degrading ? "degraded" : "ok",
+        id: latest.id,
+        artifact: latest.artifact,
+        date: String(healthRecord.date ?? ""),
+        trajectory,
+        grade: worst?.[1] ?? "",
+        worst,
+        degrading,
+        ...(history ? { degraded_history: history } : {}),
+    };
+}
 function degradedHistory(artifact, totalSummaryCount) {
     if (totalSummaryCount === 0)
         return undefined;
@@ -44,15 +80,15 @@ function degradedHistory(artifact, totalSummaryCount) {
         returned_count: 0,
         omitted_count: totalSummaryCount,
         retrieval: {
-            list: `agentera state ${artifact} list --limit 20 --format json`,
-            get: `agentera state ${artifact} get --id ID --format json`,
+            list: preCutoverCommand(`state ${artifact} list --limit 20 --format json`),
+            get: preCutoverCommand(`state ${artifact} get --id ID --format json`),
         },
     };
 }
 function projectedHistory(list, artifact, fullCount, summaryCount, degraded) {
     const total = fullCount + summaryCount;
-    const listCommand = `agentera state ${artifact} list --limit 20 --format json`;
-    const getCommand = `agentera state ${artifact} get --id ID --format json`;
+    const listCommand = preCutoverCommand(`state ${artifact} list --limit 20 --format json`);
+    const getCommand = preCutoverCommand(`state ${artifact} get --id ID --format json`);
     return {
         schemaVersion: list.schemaVersion,
         command: list.command,
@@ -74,7 +110,7 @@ function selected(entries, artifact) {
         return entries[0];
     const ids = entries.map((entry) => String(entry.id)).sort().join(", ");
     const noun = artifact === "plan" ? "open plans" : "active objectives";
-    const list = `agentera state ${artifact} list --format json`;
+    const list = preCutoverCommand(`state ${artifact} list --format json`);
     throw new StateRetrievalFailure({
         schemaVersion: "agentera.stateFailure.v1",
         status: "fail",
@@ -82,8 +118,8 @@ function selected(entries, artifact) {
             class: "ambiguous",
             artifact,
             message: `multiple ${noun} require explicit selection: ${ids}`,
-            syntax: `agentera state ${artifact} get --id ID --format json`,
-            example: `agentera state ${artifact} get --id ${String(entries[0]?.id)} --format json`,
+            syntax: preCutoverCommand(`state ${artifact} get --id ID --format json`),
+            example: preCutoverCommand(`state ${artifact} get --id ${String(entries[0]?.id)} --format json`),
             recovery: `Run ${list}, resolve the competing ${noun}, and retry prime.`,
         },
     }, 1);
@@ -92,6 +128,7 @@ function selected(entries, artifact) {
 export function collectEntityOrientation(projectRoot, sourceRoot) {
     assertTodoReconciliationReadable(projectRoot, sourceRoot);
     const discovery = discoverEntities(projectRoot, sourceRoot);
+    const todoReconciliation = inspectTodoReconciliationState(projectRoot, sourceRoot, discovery);
     const caveatContract = glossaryCaveatContract(path.join(sourceRoot, "references", "artifacts", "glossary-entry-contract.yaml"));
     const glossaryCaveatProjection = projectCurrentGlossaryCaveats(discovery.entities, caveatContract);
     const invalidProgress = (entity) => (entity.artifact === "progress" || ["progress_cycle", "progress_summary"].includes(entity.boundary ?? "")) &&
@@ -148,7 +185,7 @@ export function collectEntityOrientation(projectRoot, sourceRoot) {
     const publicTaskEntries = taskEntries.slice(0, STARTUP_ARRAY_LIMIT);
     const taskDetailOmitted = allTaskEntries.length > publicTaskEntries.length;
     const taskRetrieval = selectedPlan
-        ? { list: `agentera state plan tasks list ${String(selectedPlan.id)} --limit 100 --format json`, restart: `agentera state plan tasks list ${String(selectedPlan.id)} --limit 100 --format json`, get: "agentera state plan tasks get --id ID --format json" }
+        ? { list: preCutoverCommand(`state plan tasks list ${String(selectedPlan.id)} --limit 100 --format json`), restart: preCutoverCommand(`state plan tasks list ${String(selectedPlan.id)} --limit 100 --format json`), get: preCutoverCommand("state plan tasks get --id ID --format json") }
         : {};
     const plan = selectedPlan ? {
         exists: true,
@@ -188,23 +225,7 @@ export function collectEntityOrientation(projectRoot, sourceRoot) {
         cycle_count: Number(progressList.counts?.total ?? progressEntries.length),
         degraded_history: progressHistory,
     } : { exists: false, status: "missing", cycle_count: 0 };
-    const latestHealth = fullHealthEntries[0];
-    const healthRecord = record(latestHealth);
-    const grades = healthRecord.grades && typeof healthRecord.grades === "object" && !Array.isArray(healthRecord.grades)
-        ? healthRecord.grades
-        : {};
-    const health = latestHealth ? {
-        exists: true,
-        id: latestHealth.id,
-        artifact: latestHealth.artifact,
-        date: String(healthRecord.date ?? ""),
-        trajectory: String(healthRecord.trajectory ?? ""),
-        grade: Object.values(grades).map(String).sort()[0] ?? "",
-        ...(healthHistory ? { degraded_history: healthHistory } : {}),
-    } : healthEntries.length ? {
-        exists: true,
-        degraded_history: healthHistory,
-    } : { exists: false };
+    const health = healthSummary(fullHealthEntries[0], healthEntries.length ? healthHistory : undefined);
     const activeObjective = selected(objectiveEntries, "objective");
     const closedObjectiveCount = Number(closedObjectiveList.counts?.total ?? 0);
     const objectiveRecord = record(activeObjective);
@@ -284,8 +305,7 @@ export function collectEntityOrientation(projectRoot, sourceRoot) {
     });
     // The opaque continuation cursor is already list-budget bounded and must stay
     // byte-exact so omitted TODO detail remains recoverable.
-    const result = { ...projection, todoDetail, todoReadiness };
+    const result = { ...projection, todoDetail, todoReadiness, todoReconciliation };
     rememberPlanTaskIndex(result.plan, allTaskEntries);
     return result;
 }
-//# sourceMappingURL=collectEntityOrientation.js.map