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

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

@@ -12,7 +12,22 @@ import { v1MigrationSummary } from "./v1Migration.js";
 import { diagnoseCanonicalSkill } from "../../../setup/sharedSkill.js";
 import { collectEntityOrientation } from "./collectEntityOrientation.js";
 import { acquireProfile } from "../../profileAcquisition.js";
+import { fullEntityUpgradeCommand } from "../../../upgrade/upgradeCommands.js";
+import { classifyEntityCutoverProject } from "../../../state/entityMigrationPreview.js";
+import { preCutoverCommand } from "../../preCutoverCommand.js";
 const EMPTY_SCHEMAS = Object.freeze({});
+function stateCutover(project, sourceRoot) {
+    try {
+        const projectState = classifyEntityCutoverProject(project, sourceRoot);
+        if (projectState === "v3") {
+            return { status: "complete", project_state: "v3", recovery_command: null };
+        }
+        return { status: "required", project_state: projectState, recovery_command: fullEntityUpgradeCommand(project) };
+    }
+    catch {
+        return { status: "invalid_lifecycle", project_state: "invalid_lifecycle", recovery_command: preCutoverCommand("check validate state --format json") };
+    }
+}
 export function collectOrientationState(opts) {
     const env = opts.env ?? process.env;
     const home = opts.home ? opts.home : os.homedir();
@@ -52,6 +67,7 @@ export function collectOrientationState(opts) {
     const v1Artifacts = detectV1ArtifactPairs(project);
     const v1Migration = v1MigrationSummary(v1Artifacts, { sourceRoot, home, env });
     const entity = collectEntityOrientation(project, sourceRoot);
+    const cutover = stateCutover(project, sourceRoot);
     const plan = entity.plan;
     const docs = entity.docs;
     const progress = entity.progress;
@@ -81,7 +97,22 @@ export function collectOrientationState(opts) {
         precomputedV1Artifacts: v1Artifacts,
     });
     const readiness = selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext, entity.todoReadiness);
-    const nextAction = selectProjectIntegrationNextAction(readiness, projectIntegration);
+    const reconciliationReadiness = entity.todoReconciliation?.status === "action_required"
+        ? withRecommended(readiness, {
+            object: entity.todoReconciliation.state === "inactive" ? "Activate TODO reconciliation" : "Repair TODO reconciliation",
+            capability: "build",
+            reason: entity.todoReconciliation.recovery_command,
+            phase: entity.todoReconciliation.state === "invalid_lifecycle" ? "audit" : "build",
+        })
+        : readiness;
+    const nextAction = cutover.status !== "complete"
+        ? withRecommended(readiness, {
+            object: "Complete Agentera entity-state cutover",
+            capability: "status",
+            reason: `Status startup is blocked until entity-state cutover completes. Exact recovery: ${cutover.recovery_command}`,
+            phase: "build",
+        })
+        : selectProjectIntegrationNextAction(reconciliationReadiness, projectIntegration);
     const attention = buildOrientationAttention({
         project_root: project,
         schemas_dir: schemasDir,
@@ -93,6 +124,7 @@ export function collectOrientationState(opts) {
         profile,
         v1_migration: v1Migration,
         project_integration: projectIntegration,
+        state_cutover: cutover,
         shared_skill: sharedSkill,
         plan,
         docs,
@@ -103,6 +135,7 @@ export function collectOrientationState(opts) {
         corpus_coverage: corpusCoverage,
         todo_items: todoItems,
         todo_detail: entity.todoDetail,
+        todo_reconciliation: entity.todoReconciliation,
         counts,
         decision_attention: decisionAttention,
         glossary_caveat_attention: entity.glossaryCaveatAttention,
@@ -122,6 +155,7 @@ export function collectOrientationState(opts) {
         profile,
         v1_migration: v1Migration,
         project_integration: projectIntegration,
+        state_cutover: cutover,
         shared_skill: sharedSkill,
         plan,
         docs,
@@ -132,6 +166,7 @@ export function collectOrientationState(opts) {
         corpus_coverage: corpusCoverage,
         todo_items: todoItems,
         todo_detail: entity.todoDetail,
+        todo_reconciliation: entity.todoReconciliation,
         counts,
         decision_attention: decisionAttention,
         glossary_caveat_attention: entity.glossaryCaveatAttention,
@@ -175,4 +210,3 @@ function withRecommended(hint, newRecommended) {
         alternatives: [hint.recommended, ...hint.alternatives],
     };
 }
-//# sourceMappingURL=collectOrientationState.js.map

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

@@ -1,15 +1,17 @@
 import { publicDoctorStatus } from "../../../upgrade/doctor.js";
 import { projectInstallTrack } from "../../../upgrade/compatibility.js";
 import { formatNextAction, startupPlanSummary } from "../../orientation.js";
-import { requestedFields, REQUIRED_SPARSE_CONTEXT_FIELDS, PRIME_STRUCTURED_FIELDS, availablePrimeFields } from "../../stateQuery.js";
+import { requestedFields, REQUIRED_SPARSE_CONTEXT_FIELDS, PRIME_STRUCTURED_FIELDS, RETIRED_PRIME_FIELD_CORRECTIONS, availablePrimeFields, } from "../../stateQuery.js";
 import { emitStructured } from "../../structured.js";
-import { startupCompletenessContract } from "../../startupCompletenessContract.js";
-import { stateWriterContract } from "../../../state/write/operations.js";
-import { briefOrientationPayload, briefUtf8Bytes, PRIME_BRIEF_MAX_UTF8_BYTES } from "./briefOrientation.js";
-export { startupCompletenessContract } from "../../startupCompletenessContract.js";
+import { emitInvalidInput } from "../../errors.js";
+import { preCutoverCommand } from "../../preCutoverCommand.js";
+import { truncateCodePoints } from "../../../core/text.js";
+import { briefOrientationPayload, briefUtf8Bytes } from "./briefOrientation.js";
+import { capabilityContext } from "../../capabilityContext/contract.js";
+import { startupAggregation } from "../../capabilityContext/startupAggregation.js";
 export { briefOrientationPayload, PRIME_BRIEF_MAX_UTF8_BYTES } from "./briefOrientation.js";
 /** Authority for the complete status startup capsule, including instructions. */
-export const PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES = 25000;
+export const PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES = 22500;
 /** Project a single {@link NextAction} to its JSON record shape. */
 function nextActionEntry(action) {
     return {
@@ -48,7 +50,6 @@ export function projectPublicOrientationAttention(state) {
     const unrelatedLimit = Math.max(0, policy.public_limit - policy.reserved_slots);
     return [...unrelated.slice(0, unrelatedLimit), glossary].slice(0, policy.public_limit);
 }
-const ISSUES_FIELD_DEPRECATION_MESSAGE = "Deprecation: prime JSON field 'issues' is deprecated; use 'todo'. The 'issues' field will be removed at the 3.0.0 stable cut.\n";
 /** Top-level conditional fields whose default/inactive payload is omitted from
  *  the default bare briefing so startup does not carry default-only adjective
  *  noise. They remain declared in PRIME_STRUCTURED_FIELDS (selectable via
@@ -56,9 +57,7 @@ const ISSUES_FIELD_DEPRECATION_MESSAGE = "Deprecation: prime JSON field 'issues'
  *  through `state_presence` (missing-vs-empty semantics) plus a named
  *  authoritative command. The full payload kept by `buildOrientationJsonPayload`
  *  still populates them, so explicit `--fields <name>` selection, the text
- *  briefing, and downstream state consumers are unaffected. See
- *  references/cli/prime-consumer-compatibility.yaml
- *  default_emission_omission_contract for the published contract. */
+ *  briefing, and downstream state consumers are unaffected. */
 const OMITTABLE_DEFAULT_CONDITIONAL_TOP_FIELDS = [
     "v1_migration",
     "docs",
@@ -104,18 +103,6 @@ function omitInactiveConditionalDefaults(payload) {
     }
     return out;
 }
-function shouldEmitIssuesDeprecation(requested, payload) {
-    if (!("issues" in payload))
-        return false;
-    if (requested.length === 0)
-        return true;
-    return requested.includes("issues");
-}
-function emitIssuesFieldDeprecationWarning(requested, payload, err) {
-    if (shouldEmitIssuesDeprecation(requested, payload)) {
-        err(ISSUES_FIELD_DEPRECATION_MESSAGE);
-    }
-}
 function orientationAppHome(bundle) {
     return {
         install_track: projectInstallTrack(bundle.installKind),
@@ -129,7 +116,7 @@ function orientationAppHome(bundle) {
 function capabilityContextPointer(requiredBeforeRendering = true) {
     return {
         capability: "status",
-        fetch_command: "agentera prime --context status --format json",
+        fetch_command: preCutoverCommand("prime --context status --format json"),
         required_before_rendering: requiredBeforeRendering,
         note: requiredBeforeRendering
             ? "Dashboard rendering instructions (template, field rules, exit marker) are owned by the status capability. Run the fetch_command before rendering."
@@ -141,6 +128,8 @@ export function buildOrientationJsonPayload(state, command, options = {}) {
     const schemasDir = state.schemas_dir;
     const bundlePublic = publicDoctorStatus(bundle);
     const appHome = orientationAppHome(bundle);
+    const todoReconciliation = state.todo_reconciliation ?? null;
+    const startup = startupAggregation(capabilityContext("status") ?? {}, state.health, state.state_cutover, todoReconciliation);
     const bespoke = {
         orchestration_context: null,
         closeout_context: null,
@@ -156,26 +145,26 @@ export function buildOrientationJsonPayload(state, command, options = {}) {
         : "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime";
     return {
         command,
-        status: "ok",
+        outcome: startup.outcome,
         app_home: appHome,
         app: bundlePublic,
         mode: state.mode,
-        profile: state.profile_dict,
         v1_migration: state.v1_migration,
         shared_skill: state.shared_skill,
         project_integration: state.project_integration,
+        ...(state.todo_reconciliation?.status === "action_required" ? { todo_reconciliation: state.todo_reconciliation } : {}),
         health: state.health,
         todo: { ...state.counts, detail: state.todo_detail },
-        issues: state.counts,
         plan: startupPlanSummary(state.plan),
         docs: state.docs,
         progress: state.progress,
         objective: state.objective,
         state_presence: state.state_presence,
-        attention: projectPublicOrientationAttention(state),
+        attention: projectPublicOrientationAttention(state).map((item) => truncateCodePoints(item, 200, "…")),
         decision_attention: state.decision_attention,
         history: state.history,
         next_action: nextActionPayload(state),
+        startup,
         orchestration_context: bespoke.orchestration_context,
         closeout_context: bespoke.closeout_context,
         evidence_context: bespoke.evidence_context,
@@ -187,55 +176,67 @@ export function buildOrientationJsonPayload(state, command, options = {}) {
             artifacts_present: state.mode === "returning",
         },
         source_contract: {
-            fields: STATUS_STRUCTURED_FIELDS,
+            fields: state.todo_reconciliation?.status === "action_required" ? [...STATUS_STRUCTURED_FIELDS, "todo_reconciliation"] : STATUS_STRUCTURED_FIELDS,
             render,
             access,
-            empty_state: "fresh: summaries absent; zero issues",
-            capability_startup: startupCompletenessContract({ profileStatus: state.profile_status }),
+            empty_state: "fresh: summaries absent; zero TODO items",
             capability_context: capabilityContextPointer(options.capabilityContextRequiredBeforeRendering ?? true),
-            artifact_writes: stateWriterContract(undefined, "compact"),
         },
     };
 }
-/**
- * The status capability consumes the same bounded decision-brief projection as
- * bare prime. Keeping the projection here prevents a second status summary
- * implementation from drifting from the public prime contract.
- */
-export function buildStatusContextState(state, command = "prime", options = {}) {
-    const projected = briefOrientationPayload(omitInactiveConditionalDefaults(buildOrientationJsonPayload(state, command, { capabilityContextRequiredBeforeRendering: false })), {
-        budgetBytes: options.budgetBytes ?? PRIME_BRIEF_MAX_UTF8_BYTES,
-        degradedMode: options.degradedMode ?? "status_routing",
-    });
-    // The canonical brief contains compatibility and source metadata useful to
-    // bare-prime consumers. Keep only the startup-completeness source contract
-    // consumed by status; the outer capability capsule already declares how it
-    // was fetched, while the brief block retains omitted-detail recovery.
-    const sourceContract = projected.source_contract;
-    if (sourceContract && typeof sourceContract === "object" && !Array.isArray(sourceContract)) {
-        projected.source_contract = {
-            capability_startup: sourceContract.capability_startup,
-            empty_state: sourceContract.empty_state,
-        };
-    }
-    // History/source and null bespoke pointers are not dashboard or routing
-    // inputs. Omit those redundant leaves after applying the shared projection.
-    for (const field of [
-        "app_home",
-        "history",
-        "issues",
-        "source",
-        "orchestration_context",
-        "closeout_context",
-        "evidence_context",
-        "benchmark_context",
-        "execution_context",
-    ]) {
-        delete projected[field];
-    }
-    return projected;
+/** The status dashboard consumes a compact view of the one startup aggregation. */
+export function buildStatusContextState(state, _command = "prime", _options = {}) {
+    const todoReconciliation = state.todo_reconciliation ?? null;
+    const startup = startupAggregation(capabilityContext("status") ?? {}, state.health, state.state_cutover, todoReconciliation);
+    const plan = state.plan;
+    const firstPending = plan.first_pending && typeof plan.first_pending === "object" && !Array.isArray(plan.first_pending)
+        ? plan.first_pending
+        : null;
+    return {
+        outcome: startup.outcome,
+        mode: state.mode,
+        project_integration: {
+            recommendation: state.project_integration.recommendation,
+            ...(state.project_integration.message ? { message: state.project_integration.message } : {}),
+            ...(state.project_integration.dry_run_command ? { dry_run_command: state.project_integration.dry_run_command } : {}),
+            ...(state.project_integration.apply_command ? { apply_command: state.project_integration.apply_command } : {}),
+        },
+        health: {
+            exists: state.health.exists,
+            status: state.health.status ?? null,
+            id: state.health.id ?? null,
+            grade: state.health.grade ?? null,
+            worst: state.health.worst ?? null,
+            trajectory: state.health.trajectory ?? null,
+            degrading: Boolean(state.health.degrading),
+        },
+        todo: { ...state.counts, detail: state.todo_detail },
+        plan: {
+            exists: plan.exists,
+            active: plan.active ?? false,
+            status: plan.status,
+            title: plan.title ?? null,
+            complete: plan.complete ?? 0,
+            total: plan.total ?? 0,
+            complete_plan: plan.complete_plan ?? false,
+            first_pending: firstPending ? {
+                id: firstPending.id ?? null,
+                artifact: firstPending.artifact ?? "plan",
+                name: firstPending.name ?? firstPending.title ?? null,
+                status: firstPending.status ?? null,
+            } : null,
+        },
+        progress: { exists: state.progress.exists, status: state.progress.status ?? null, latest: state.progress.latest ?? null },
+        objective: { exists: state.objective.exists, active: state.objective.active ?? false, title: state.objective.title ?? null },
+        state_presence: state.state_presence,
+        attention: projectPublicOrientationAttention(state).map((item) => truncateCodePoints(item, 200, "…")),
+        next_action: nextActionPayload(state),
+    };
 }
 export function emitPrime(command, payload, format, fieldsArg, out, err, options = {}) {
+    const retiredRejection = rejectRetiredPrimeFields(command, format, fieldsArg, out, err);
+    if (retiredRejection !== null)
+        return retiredRejection;
     const requested = requestedFields(fieldsArg);
     // The default bare briefing first omits inactive conditional top-level fields
     // (v1_migration/docs/objective when default) so startup does not carry
@@ -248,7 +249,6 @@ export function emitPrime(command, payload, format, fieldsArg, out, err, options
     const effectivePayload = requested.length === 0 && options.bareBrief
         ? briefOrientationPayload(conditional, { budgetBytes: options.briefBudgetBytes })
         : conditional;
-    emitIssuesFieldDeprecationWarning(requested, effectivePayload, err);
     if (requested.length === 0) {
         if (format === "json" && options.maxUtf8Bytes !== undefined) {
             const bytes = briefUtf8Bytes(effectivePayload);
@@ -281,10 +281,30 @@ export function emitPrime(command, payload, format, fieldsArg, out, err, options
     emitStructured(selected, format, out);
     return 0;
 }
+/** Reject a retired selector before state collection or output projection. Text
+ *  mode uses JSON because a retired-field request is an automation-shaped
+ *  selector and must return one machine-readable correction, not a briefing. */
+export function rejectRetiredPrimeFields(command, format, fieldsArg, out, err) {
+    const requested = requestedFields(fieldsArg);
+    const retired = requested.find((field) => field in RETIRED_PRIME_FIELD_CORRECTIONS);
+    if (retired === undefined)
+        return null;
+    const replacement = RETIRED_PRIME_FIELD_CORRECTIONS[retired];
+    return emitInvalidInput({ out, err }, {
+        format: format === "yaml" ? "yaml" : "json",
+        body: {
+            class: "invalid_choice",
+            message: `prime field '${retired}' is retired; use '${replacement}'`,
+            valid_values: [replacement],
+            syntax: preCutoverCommand(`${command} --fields ${replacement} --format json`),
+            example: preCutoverCommand(`${command} --fields ${replacement} --format json`),
+            recovery: `Replace '${retired}' with '${replacement}' and retry; no state was changed.`,
+        },
+    });
+}
 export function printOrientationTextBriefing(state, command, out) {
     const bundle = state.app;
     const mode = state.mode;
-    const profileStatus = state.profile_status;
     const health = state.health;
     const counts = state.counts;
     const plan = state.plan;
@@ -293,7 +313,7 @@ export function printOrientationTextBriefing(state, command, out) {
     const attention = state.attention;
     const nextAction = state.next_action;
     const dashboardLabel = command === "prime" ? "prime orientation dashboard" : "prime orientation dashboard";
-    out(`agentera ${command}\n`);
+    out(`${preCutoverCommand(command)}\n`);
     out(`app_home: install_track=${projectInstallTrack(bundle.installKind)} | status=${bundle.status} | home=${bundle.appHome} | ` +
         `source=${bundle.appHomeSource} | managed_app=${bundle.managedAppRoot} | user_data=${bundle.userDataRoot} | expected=${bundle.expectedVersion} | ` +
         `expected_source=${bundle.expectedVersionSource ?? "-"} | current=${bundle.markerVersion || "-"}\n`);
@@ -305,7 +325,9 @@ export function printOrientationTextBriefing(state, command, out) {
         out(`project_integration_message: ${projectIntegration.message}\n`);
     }
     out(`shared_skill: status=${String(state.shared_skill.status)} | path=${String(state.shared_skill.path)}\n`);
-    out(`profile: ${profileStatus} | class=${state.profile_dict.validity.class}\n`);
+    const todoReconciliation = state.todo_reconciliation ?? null;
+    const startup = startupAggregation(capabilityContext("status") ?? {}, state.health, state.state_cutover, todoReconciliation);
+    out(`outcome: ${String(startup.outcome)}\n`);
     if (health.exists && health.id) {
         const worst = health.worst;
         const worstText = worst ? `${worst[0]}:${worst[1]}` : "none";
@@ -315,7 +337,7 @@ export function printOrientationTextBriefing(state, command, out) {
     if (health.degraded_history) {
         const degraded = health.degraded_history;
         out(`health: degraded_history | summaries=${String(degraded.summary_count ?? 0)} | returned=${String(degraded.returned_count ?? 0)} | omitted=${String(degraded.omitted_count ?? 0)} | ` +
-            `detail=summary-only | recovery=agentera state health list --limit 20 --format json\n`);
+            `detail=summary-only | recovery=${preCutoverCommand("state health list --limit 20 --format json")}\n`);
     }
     const latestProgress = state.progress.latest;
     if (latestProgress) {
@@ -325,12 +347,12 @@ export function printOrientationTextBriefing(state, command, out) {
     if (state.progress.degraded_history) {
         const degraded = state.progress.degraded_history;
         out(`progress: degraded_history | summaries=${String(degraded.summary_count ?? 0)} | returned=${String(degraded.returned_count ?? 0)} | omitted=${String(degraded.omitted_count ?? 0)} | ` +
-            `detail=summary-only | recovery=agentera state progress list --limit 20 --format json\n`);
+            `detail=summary-only | recovery=${preCutoverCommand("state progress list --limit 20 --format json")}\n`);
     }
     const decisionHistory = state.history.decisions?.degraded_history;
     if (decisionHistory) {
         out(`decisions: degraded_history | summaries=${String(decisionHistory.summary_count ?? 0)} | returned=${String(decisionHistory.returned_count ?? 0)} | omitted=${String(decisionHistory.omitted_count ?? 0)} | ` +
-            `detail=summary-only | recovery=agentera state decisions list --limit 20 --format json\n`);
+            `detail=summary-only | recovery=${preCutoverCommand("state decisions list --limit 20 --format json")}\n`);
     }
     out(`todo: critical=${counts.critical} | degraded=${counts.degraded} | normal=${counts.normal} | annoying=${counts.annoying}\n`);
     if (!presence.any_active) {
@@ -364,14 +386,12 @@ export function printOrientationTextBriefing(state, command, out) {
     out(`- fields=${PRIME_STRUCTURED_FIELDS.join(", ")}\n`);
     out(`- render=caller-owned README-style ${dashboardLabel}\n`);
     out("- access=single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls\n");
-    const startup = startupCompletenessContract({ profileStatus: state.profile_status });
-    out(`- capability_startup_complete=${String(startup.complete_for_capability_startup).toLowerCase()}\n`);
-    out(`- capability_context: fetch rendering instructions via \`agentera prime --context status --format json\`\n`);
-    out("- artifact_writes: discover via `agentera schema --format json` or `agentera state <artifact> explain --format json`\n");
+    out(`- startup_outcome=${String(startup.outcome)}\n`);
+    out(`- capability_context: fetch rendering instructions via \`${preCutoverCommand("prime --context status --format json")}\`\n`);
+    out(`- detail_discovery=${String(startup.detail_discovery.schema)}\n`);
     out(`- raw_artifact_reads_required=${String(startup.raw_artifact_reads_required).toLowerCase()}; policy=${startup.raw_artifact_read_policy}\n`);
-    const missingState = startup.missing_state.join("; ") || "none";
-    out(`- missing_state=${missingState}\n`);
-    out(`- confidence_caveats=${startup.confidence_caveats.join("; ")}\n`);
-    out(`- cli_fallback=${startup.cli_fallback.join("; ")}\n`);
+    const deferred = startup.availability
+        .filter((entry) => entry.availability === "deferred")
+        .map((entry) => String(entry.family));
+    out(`- deferred_detail=${deferred.join(", ") || "none"}\n`);
 }
-//# sourceMappingURL=orientationOutput.js.map

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

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

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

@@ -36,4 +36,3 @@ export function v1MigrationSummary(v1Artifacts, opts) {
     }
     return summary;
 }
-//# sourceMappingURL=v1Migration.js.map

package/dist/cli/commands/prime.js

@@ -1,11 +1,10 @@
 import { PRIME_BLOB } from "../prime-blob.js";
 import { buildPrimeCapabilityContextPayload, validatePrimeCapability } from "../capabilityContext.js";
 import { collectOrientationState } from "./prime/collectOrientationState.js";
-import { buildOrientationJsonPayload, buildStatusContextState, emitPrime, PRIME_BRIEF_MAX_UTF8_BYTES, PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES, printOrientationTextBriefing, } from "./prime/orientationOutput.js";
-import { briefUtf8Bytes } from "./prime/briefOrientation.js";
-import { startupSurfaceBudget } from "../../state/retrievalAuthority.js";
+import { buildOrientationJsonPayload, buildStatusContextState, emitPrime, rejectRetiredPrimeFields, PRIME_BRIEF_MAX_UTF8_BYTES, PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES, printOrientationTextBriefing, } from "./prime/orientationOutput.js";
 import { emitInvalidInput } from "../errors.js";
 import { BuildExecutionRequestError, loadBuildExecutionRequest, } from "./prime/buildExecutionRequest.js";
+import { preCutoverCommand } from "../preCutoverCommand.js";
 export { collectOrientationState } from "./prime/collectOrientationState.js";
 export function buildStatusCapabilityContextPayload(state, command = "prime") {
     const payload = buildPrimeCapabilityContextPayload(state, "status", command);
@@ -14,41 +13,21 @@ export function buildStatusCapabilityContextPayload(state, command = "prime") {
 export function finalizeStatusCapabilityContextPayload(payload, state, command = "prime") {
     const capabilityContext = payload.capability_context;
     const context = capabilityContext.context;
-    // status_context carries the dashboard state, so only remove generic rich
-    // copies already projected there. Contract-owned startup metadata remains.
+    // status_context carries the dashboard state. Startup availability remains
+    // singular on capability_context.startup.
     delete capabilityContext.app;
-    delete capabilityContext.profile;
-    const startupState = capabilityContext.state;
-    delete startupState.write_contract;
-    delete startupState.retrieval_contract;
-    delete context.history;
     // status_context already carries the canonical bounded plan projection.
     delete context.plan;
-    let statusBudget = PRIME_BRIEF_MAX_UTF8_BYTES;
-    let previousStatusBytes = Number.POSITIVE_INFINITY;
-    while (true) {
-        context.status_context = buildStatusContextState(state, command, {
-            budgetBytes: statusBudget,
-            degradedMode: "status_routing",
-        });
-        if (briefUtf8Bytes(payload) <= PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES)
-            break;
-        const statusBytes = briefUtf8Bytes(context.status_context);
-        if (statusBytes >= previousStatusBytes) {
-            throw new Error("status context budget projection did not decrease toward the complete capsule budget");
-        }
-        previousStatusBytes = statusBytes;
-        // One byte below the actual serialized projection forces the next bounded
-        // form. Unlike subtracting the outer overage, this transition is monotonic
-        // even when the current projection still sits below its prior allowance.
-        statusBudget = statusBytes - 1;
-    }
+    context.status_context = buildStatusContextState(state, command, {
+        budgetBytes: PRIME_BRIEF_MAX_UTF8_BYTES,
+        degradedMode: "status_routing",
+    });
     return payload;
 }
 /**
  * prime orientation command. Port of scripts/agentera cmd_prime / cmd_status.
- * The text briefing (default), --guidance, --dashboard, --context, and
- * --format json paths are all wired.
+ * The text briefing (default), --guidance, deprecated --dashboard, --context,
+ * and --format json paths are all wired.
  */
 export function cmdPrime(args, io = {}) {
     const out = io.out ?? ((t) => process.stdout.write(t));
@@ -58,13 +37,14 @@ export function cmdPrime(args, io = {}) {
     const dashboard = Boolean(args.dashboard || args.orientation);
     const guidance = Boolean(args.guidance);
     const input = args.input ?? null;
+    const format = args.format ?? "text";
     const inputErrorFormat = args.format === "json" || args.format === "yaml" ? args.format : "text";
     const rejectInput = (body) => emitInvalidInput(io, { format: inputErrorFormat, body });
     if (input !== null && (capability !== "build" || dashboard || guidance)) {
         return rejectInput({
             class: "unsupported_target",
             message: "--input is valid only with prime --context build",
-            syntax: "agentera prime --context build --input <file|-> --format json",
+            syntax: preCutoverCommand("prime --context build --input <file|-> --format json"),
         });
     }
     if (capability !== null && dashboard) {
@@ -79,11 +59,13 @@ export function cmdPrime(args, io = {}) {
         err("Error: prime --dashboard/--orientation and prime --guidance are mutually exclusive\n");
         return 2;
     }
+    const retiredFieldRejection = rejectRetiredPrimeFields(command, format, args.fields, out, err);
+    if (retiredFieldRejection !== null)
+        return retiredFieldRejection;
     if (guidance) {
         out(PRIME_BLOB);
         return 0;
     }
-    const format = args.format ?? "text";
     const collectOpts = {
         projectRoot: args.projectRoot,
         home: args.home,
@@ -133,10 +115,11 @@ export function cmdPrime(args, io = {}) {
             err("Error: prime --dashboard requires --format json\n");
             return 2;
         }
+        err("Deprecation: prime --dashboard is retained as an alias for `prime --context status --format json`; use the status startup capsule directly.\n");
         const state = collectOrientationState(collectOpts);
-        const payload = buildOrientationJsonPayload(state, command);
+        const payload = buildStatusCapabilityContextPayload(state, command);
         return emitPrime(command, payload, format, args.fields, out, err, {
-            maxUtf8Bytes: startupSurfaceBudget("prime_dashboard"),
+            maxUtf8Bytes: PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES,
         });
     }
     const state = collectOrientationState(collectOpts);
@@ -149,4 +132,3 @@ export function cmdPrime(args, io = {}) {
     printOrientationTextBriefing(state, command, out);
     return 0;
 }
-//# sourceMappingURL=prime.js.map

package/dist/cli/commands/profileGrounding.js

@@ -53,4 +53,3 @@ export function runProfileGroundingCommand(argv, io) {
     }, "json", output);
     return 0;
 }
-//# sourceMappingURL=profileGrounding.js.map

package/dist/cli/commands/query.js

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { preCutoverCommand } from "../preCutoverCommand.js";
 import { loadDocsPathOverrides, resolveArtifactPath, } from "../../registries/artifactRegistry.js";
 import { activeObjectiveName, artifactPath, discoverSchemasDir, loadSchemas, resolveArtifactPathLocal, } from "../appContext.js";
 import { validateAgentString } from "../argvalidate.js";
@@ -20,7 +21,7 @@ const ALLOWED_RAW_ARTIFACT_USES = [
     "unavailable or incomplete CLI state after CLI fallbacks",
     "benchmark analysis",
 ];
-const BENCHMARK_CONTEXT_COMMAND = "agentera prime --context optimize --format json";
+const BENCHMARK_CONTEXT_COMMAND = preCutoverCommand("prime --context optimize --format json");
 const STATE_COMMAND_NAMES = new Set([
     "decisions",
     "docs",
@@ -368,4 +369,3 @@ export function cmdQuery(args, io) {
 function pyRepr(value) {
     return value.includes("'") && !value.includes('"') ? `"${value}"` : `'${value}'`;
 }
-//# sourceMappingURL=query.js.map

package/dist/cli/commands/report.js

@@ -283,4 +283,3 @@ export function cmdReport(args, io = {}) {
         err: (t) => err(t + "\n"),
     });
 }
-//# sourceMappingURL=report.js.map

package/dist/cli/commands/route.js

@@ -5,6 +5,7 @@ import { RouteReceiptValidationError, validateRouteReceiptSubmission } from "../
 import { evaluateHybridRoute } from "../../eval/hybridRouteEvaluation.js";
 import { emitStructured } from "../structured.js";
 import { emitInvalidInput } from "../errors.js";
+import { preCutoverCommand } from "../preCutoverCommand.js";
 /** A conformance report that fails is a failed CLI gate, not a successful invocation. */
 export const ROUTE_EVALUATION_FAILED_EXIT_CODE = 1;
 export function routeEvaluationExitCode(report) {
@@ -55,7 +56,7 @@ function parse(argv) {
         return { class: "unrecognized_argument", message: "unrecognized route argument; request text must be supplied through --input" };
     }
     if (!input)
-        return { class: "missing_argument", message: "--input is required so request text is not placed in argv", syntax: "--input PATH", example: "agentera route request --input - --format json" };
+        return { class: "missing_argument", message: "--input is required so request text is not placed in argv", syntax: "--input PATH", example: preCutoverCommand("route request --input - --format json") };
     return { input, format };
 }
 export function runRouteRequest(argv, io) {
@@ -120,7 +121,7 @@ export function runRouteEvaluation(argv, io) {
         return invalidRouteInput(io, {
             class: "unrecognized_argument",
             message: "route evaluation accepts only --format json and never accepts request text or corpus overrides",
-            syntax: "agentera route evaluate --format json",
+            syntax: preCutoverCommand("route evaluate --format json"),
         });
     }
     try {
@@ -139,4 +140,3 @@ export function runRouteEvaluation(argv, io) {
 function readStdin() {
     return process.stdin.isTTY ? Buffer.alloc(0) : fs.readFileSync(0);
 }
-//# sourceMappingURL=route.js.map