agentera 3.0.0-dev.7 → 3.0.0-dev.74

package/dist/cli/capabilityContext/closeout.js

@@ -7,12 +7,15 @@ import { docsConventions, sourceProvenance, uniqueList } from "./shared.js";
 import { closeoutChangelogBoundary } from "./planState.js";
 import { progressVerificationSummary } from "./progress.js";
 import { decisionReviewPressure } from "./evidence.js";
+import { STATE_FAMILY_FALLBACK_COMMANDS } from "./types.js";
+import { deferredStartupFamilies } from "./startupAggregation.js";
+import { preCutoverCommand } from "../preCutoverCommand.js";
 export function closeoutArtifactMappings(docs) {
     const mapping = asList(docs.mapping);
     const ok = Boolean(docs.exists) && mapping.length > 0;
     return {
         status: ok ? "available" : "unavailable",
-        source_provenance: sourceProvenance("docs", "agentera docs --format json", "summary.mapping"),
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.mapping"),
         entries: mapping,
         mapping_entries: mapping.length,
         caveats: ok ? [] : ["Docs artifact mappings are unavailable or empty in CLI docs state."],
@@ -26,21 +29,25 @@ export function closeoutVersionPolicy(docs) {
     const available = Object.keys(semverPolicy).length > 0;
     return {
         status: available ? "available" : "unavailable",
-        source_provenance: sourceProvenance("docs", "agentera docs --format json", "summary.conventions"),
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.conventions"),
         version_files: versionFiles,
         version_files_registry: registry,
         semver_policy: semverPolicy,
         caveats: available ? [] : ["Docs version policy is unavailable in CLI docs state."],
     };
 }
-export function closeoutTodoBlockers(schemas, todoItems) {
+export function closeoutTodoBlockers(schemas, todoItems, selectedTargetVersion = null) {
     const info = schemas.todo ?? { path: "TODO.md", record: undefined, schema: {}, fields: {} };
     const exists = fs.existsSync(artifactPath(info, "todo"));
+    const blockers = selectedTargetVersion === null
+        ? []
+        : todoItems.filter((item) => item.status === "open" && item.release_blocker === true && item.target_version === selectedTargetVersion);
     return {
         status: exists ? "available" : "unavailable",
-        source_provenance: sourceProvenance("todo", "agentera todo --format json"),
-        open_count: todoItems.length,
-        items: todoItems,
+        source_provenance: sourceProvenance("todo", STATE_FAMILY_FALLBACK_COMMANDS.todo),
+        selected_target_version: selectedTargetVersion,
+        open_count: blockers.length,
+        items: blockers,
         caveats: exists ? [] : ["TODO state is unavailable in CLI state."],
     };
 }
@@ -50,7 +57,7 @@ export function closeoutBenchmarkEvidence(docs) {
     if (testsSummary && testsSummary.toLowerCase().includes("benchmark")) {
         return {
             status: "available",
-            source_provenance: sourceProvenance("docs", "agentera docs --format json", "summary.coverage.tests"),
+            source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.coverage.tests"),
             summary_present: true,
             non_empty_evidence_present: true,
             history_scope: "cli_visible_summary",
@@ -61,7 +68,7 @@ export function closeoutBenchmarkEvidence(docs) {
     }
     return {
         status: "unavailable",
-        source_provenance: sourceProvenance("docs", "agentera docs --format json", "summary.coverage.tests"),
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.coverage.tests"),
         summary_present: false,
         non_empty_evidence_present: false,
         history_scope: "not_exposed_by_supported_cli_state",
@@ -129,30 +136,30 @@ export function closeoutReleaseBoundary(changelogBoundary, bundle) {
             remote_push: "not_recorded_in_cli_state",
             remote_checks_performed: false,
             registry_checks_performed: false,
-            source_provenance: sourceProvenance("closeout_context", "agentera prime --context document --format json", "release_boundary.publication_evidence"),
+            source_provenance: sourceProvenance("closeout_context", preCutoverCommand("prime --context document --format json"), "release_boundary.publication_evidence"),
             caveats: ["Closeout context does not contact remotes or package registries."],
         },
         app_refresh_evidence: {
             installed_app_status: bundle.status ?? null,
             refresh: "not_recorded_in_cli_state",
             approval_recorded: false,
-            source_provenance: sourceProvenance("status", "agentera prime --format json", "app.status"),
+            source_provenance: sourceProvenance("status", preCutoverCommand("prime --format json"), "app.status"),
         },
         caveats,
     };
 }
-export function documentCloseoutContext(capability, schemas, plan, progress, todoItems, docs, profile, bundle) {
+export function documentCloseoutContext(capability, schemas, plan, progress, todoItems, docs, profile, bundle, decisionHistory, projectRoot) {
     if (capability !== "document")
         return null;
     const capabilityContract = capabilityContext(capability) ?? {};
     const artifactMappings = closeoutArtifactMappings(docs);
     const versionPolicy = closeoutVersionPolicy(docs);
-    const todoBlockers = closeoutTodoBlockers(schemas, todoItems);
-    const changelogBoundary = closeoutChangelogBoundary(schemas, plan);
+    const changelogBoundary = closeoutChangelogBoundary(projectRoot, plan);
+    const todoBlockers = closeoutTodoBlockers(schemas, todoItems, typeof changelogBoundary.selected_target_version === "string" ? changelogBoundary.selected_target_version : null);
     const progressEvidence = progressVerificationSummary(progress);
     const benchmarkEvidence = closeoutBenchmarkEvidence(docs);
     const releaseBoundary = closeoutReleaseBoundary(changelogBoundary, bundle);
-    const reviewPressure = decisionReviewPressure(schemas);
+    const reviewPressure = decisionReviewPressure(decisionHistory);
     const requiredState = {
         artifact_mappings: artifactMappings.status === "available",
         version_policy: versionPolicy.status === "available",
@@ -160,30 +167,29 @@ export function documentCloseoutContext(capability, schemas, plan, progress, tod
         changelog_boundary: Boolean(changelogBoundary.boundary_present),
         progress_evidence: progressEvidence.status === "available",
         benchmark_evidence_or_caveat: benchmarkEvidence.status === "available" || (benchmarkEvidence.caveats ?? []).length > 0,
-        decision_review_pressure: reviewPressure.status !== "review_required",
+        decision_review_pressure: reviewPressure.status === "available",
     };
     const missingRequired = Object.entries(requiredState).filter(([, present]) => !present).map(([k]) => k);
     let stateCaveats = [];
-    for (const family of (capabilityContract.missing_state_families ?? [])) {
-        stateCaveats.push(`${family} state is not included in prime --context startup context.`);
+    for (const family of deferredStartupFamilies(capabilityContract)) {
+        stateCaveats.push(`${family} detail is deferred from prime --context startup.`);
     }
     for (const component of [artifactMappings, versionPolicy, todoBlockers, changelogBoundary, releaseBoundary, progressEvidence, benchmarkEvidence, reviewPressure]) {
         stateCaveats.push(...(component.caveats ?? []));
     }
     if (bundle.status !== "up_to_date")
         stateCaveats.push("Agentera app files are not up to date; this is a caveat, not approval to repair or update app files.");
-    if (profile.status !== "loaded")
+    if (profile.status !== "valid")
         stateCaveats.push("profile-derived state is unavailable in prime --context response.");
     else if (profile.stale === true)
         stateCaveats.push("profile-derived state is stale; this is a caveat, not approval to refresh profile state.");
     stateCaveats = uniqueList(stateCaveats);
     const fallbackCommands = uniqueList([
-        "agentera state todo --format json",
-        "agentera state docs --format json",
-        "agentera state progress --format json",
-        "agentera state query changelog --format json",
-        "agentera state query --list-artifacts --format json",
-        ...(capabilityContract.cli_fallback ?? []),
+        STATE_FAMILY_FALLBACK_COMMANDS.todo,
+        STATE_FAMILY_FALLBACK_COMMANDS.docs,
+        STATE_FAMILY_FALLBACK_COMMANDS.progress,
+        preCutoverCommand("state query changelog --format json"),
+        preCutoverCommand("state query --list-artifacts --format json"),
     ]);
     return {
         capability: "document",
@@ -203,8 +209,6 @@ export function documentCloseoutContext(capability, schemas, plan, progress, tod
             raw_artifact_reads_required: false,
             raw_artifact_read_policy: "Use this closeout_context and included status state first. Run listed routine/query CLI fallback commands " +
                 "for missing or incomplete closeout state; raw artifact reads are last-resort diagnostics, not normal closeout behavior.",
-            included_state_families: capabilityContract.included_state_families ?? [],
-            missing_state_families: capabilityContract.missing_state_families ?? [],
             closeout_state_families: ["docs", "todo", "changelog", "progress", "benchmark_evidence", "decisions"],
             required_closeout_state: requiredState,
             missing_required_closeout_state: missingRequired,
@@ -227,4 +231,3 @@ export function documentCloseoutContext(capability, schemas, plan, progress, tod
         },
     };
 }
-//# sourceMappingURL=closeout.js.map

package/dist/cli/capabilityContext/contract.js

@@ -3,9 +3,11 @@ import path from "node:path";
 import { loadYamlMapping } from "../../core/yaml.js";
 import { activeAppModel, discoverSchemasDir } from "../appContext.js";
 import { capabilityStartupCommand } from "../../capabilities/index.js";
-import { PLAN_COMPLETED_PLAN_ARCHIVE_CONFIRMATION, PLAN_INSTRUCTIONS_AUTHORITY_EXCEPTIONS, PLAN_PLANNING_LEVELS, PLAN_RAW_PLAN_ACCESS_ALLOWED_FOR, PLAN_STARTUP_CONTRACT_VERSION, PLAN_STEP_VERBS, STARTUP_ENVELOPE_STATE_FAMILIES, STATE_FAMILY_FALLBACK_COMMANDS, } from "./types.js";
+import { PLAN_COMPLETED_PLAN_ARCHIVE_CONFIRMATION, PLAN_INSTRUCTIONS_AUTHORITY_EXCEPTIONS, PLAN_PLANNING_LEVELS, PLAN_RAW_PLAN_ACCESS_ALLOWED_FOR, PLAN_STARTUP_CONTRACT_VERSION, PLAN_STEP_VERBS, PLAN_TASK_COHERENCE_RULE, STATE_FAMILY_FALLBACK_COMMANDS, } from "./types.js";
 import { CAPABILITY_INSTRUCTIONS, capabilityInstructionModulePath } from "../../capabilities/index.js";
 import { isFile, pyRepr, appendUnique } from "./shared.js";
+import { startupAvailabilityProjection } from "./startupAggregation.js";
+import { preCutoverCommand } from "../preCutoverCommand.js";
 export function capabilityInstructionContractPath() {
     const model = activeAppModel();
     const active = path.join(String(model.authoritativeRoot ?? model.activeBundleRoot), "references", "cli", "capability-instruction-contract.yaml");
@@ -27,13 +29,13 @@ export function capabilityInstructionContract() {
 }
 export function capabilityInstructionTarget(capability) {
     const module = capabilityInstructionModulePath(capability);
-    const prose = CAPABILITY_INSTRUCTIONS[capability] ?? null;
+    const instructions = CAPABILITY_INSTRUCTIONS[capability] ?? null;
     return {
         module,
-        exists: prose !== null && prose.length > 0,
+        exists: instructions !== null && instructions.length > 0,
         runtime_path: module,
-        prose_present: prose !== null,
-        prose_length: prose === null ? 0 : prose.length,
+        instructions_present: instructions !== null,
+        instructions_length: instructions === null ? 0 : instructions.length,
     };
 }
 export function firstInvocationReadMetadata(capability) {
@@ -66,12 +68,12 @@ export function planStartupContract() {
     return {
         schemaVersion: PLAN_STARTUP_CONTRACT_VERSION,
         status: "implemented_compact_normal_startup_contract",
-        canonical_surface: "agentera prime --context plan --format json",
+        canonical_surface: capabilityStartupCommand("plan"),
         bounded: true,
         instructions_runtime_read_required: false,
         instructions_authority: {
             normal_startup: "Use this compact context for normal Plan execution startup; " +
-                "shell out to `agentera prime --context plan --format json` for the full Plan prose.",
+                `shell out to \`${capabilityStartupCommand("plan")}\` for the full Plan instructions.`,
             read_plan_instructions_when: PLAN_INSTRUCTIONS_AUTHORITY_EXCEPTIONS,
         },
         planning: {
@@ -80,21 +82,21 @@ export function planStartupContract() {
             required_steps: PLAN_STEP_VERBS,
             full_plan_review_required: true,
             pre_write_self_audit_required: true,
-            max_full_plan_tasks: 8,
+            task_coherence_rule: PLAN_TASK_COHERENCE_RULE,
         },
         cli_first_orientation: {
             use_startup_state_first: true,
-            current_plan_command: "agentera plan --format json",
+            current_plan_command: STATE_FAMILY_FALLBACK_COMMANDS.plan,
             complete_plan_contract_key: "source_contract.complete_for_plan_artifact",
             fallback_policy: "Use CLI-provided fallback commands for missing or incomplete state families " +
                 "before any last-resort raw artifact read.",
         },
         artifact_access_boundaries: {
-            skip_raw_plan_artifact_when: "`agentera plan --format json` reports source_contract.complete_for_plan_artifact=true " +
+            skip_raw_plan_artifact_when: `\`${STATE_FAMILY_FALLBACK_COMMANDS.plan}\` reports source_contract.complete_for_plan_artifact=true ` +
                 "during normal read-only startup or evaluation.",
             raw_plan_artifact_allowed_for: PLAN_RAW_PLAN_ACCESS_ALLOWED_FOR,
             completed_plan_archive_confirmation: PLAN_COMPLETED_PLAN_ARCHIVE_CONFIRMATION,
-            artifact_mapping_source: "agentera docs/query artifact mapping before writes or closeout",
+            artifact_mapping_source: STATE_FAMILY_FALLBACK_COMMANDS.docs,
         },
         handoff_expectations: [
             "skip level suggests ⧉ build and waits for confirmation unless the user already asked to implement now",
@@ -104,13 +106,13 @@ export function planStartupContract() {
         unsupported_command_boundary: {
             capability_cli_commands_added: true,
             forbidden_examples: [],
-            route_boundary: "Use `/agentera plan` for routing, `agentera plan` for plan state, " +
+            route_boundary: "Use `/agentera plan` for routing, `agentera state plan list` for plan state, " +
                 "and `agentera plan` for capability routing guidance only.",
         },
         seam_decision: {
             selected: "prime --context",
             not_changed: [
-                { surface: "agentera schema --format json", reason: "runtime/schema command discovery, not capability workflow startup context" },
+                { surface: preCutoverCommand("schema --format json"), reason: "runtime/schema command discovery, not capability workflow startup context" },
                 { surface: "dispatcher guidance", reason: "route and CLI-state separation guidance, not a bounded Plan workflow payload" },
             ],
         },
@@ -140,10 +142,10 @@ export function capabilityArtifactInventory(capability) {
             continue;
         }
         const e = entry;
-        const artifactId = String(e.artifact_id ?? "").trim();
+        const artifactId = String(e.artifact ?? "").trim();
         const localRole = String(e.local_role ?? "").trim();
         if (!artifactId) {
-            errors.push(`entry ${key} is missing artifact_id`);
+            errors.push(`entry ${key} is missing artifact`);
             continue;
         }
         if (localRole === "consumes")
@@ -165,24 +167,13 @@ export function capabilityContext(capability) {
         return null;
     const [inventory, error] = capabilityArtifactInventory(capability);
     const needs = inventory.read_needs;
-    const writeTargets = inventory.write_targets;
-    const missing = needs.filter((name) => !STARTUP_ENVELOPE_STATE_FAMILIES.has(name));
-    const cliFallback = missing.filter((name) => name in STATE_FAMILY_FALLBACK_COMMANDS).map((name) => STATE_FAMILY_FALLBACK_COMMANDS[name]);
     const context = {
         capability,
         first_invocation_read: firstInvocationReadMetadata(capability),
-        declared_state_needs: needs,
-        declared_write_targets: writeTargets,
-        artifact_inventory: inventory,
-        included_state_families: needs.filter((name) => STARTUP_ENVELOPE_STATE_FAMILIES.has(name)),
-        missing_state_families: missing,
-        cli_fallback: cliFallback,
-        raw_artifact_read_policy: "Use the included state families from this prime --context response first. " +
-            "If needed families are missing or CLI state is incomplete, run the CLI fallback commands before raw file access.",
+        availability: startupAvailabilityProjection(needs),
         schema_error: error,
     };
     if (capability === "plan")
         context.startup_contract = planStartupContract();
     return context;
 }
-//# sourceMappingURL=contract.js.map

package/dist/cli/capabilityContext/evidence.js

@@ -1,13 +1,13 @@
 import fs from "node:fs";
 import { artifactPath } from "../appContext.js";
 import { asList } from "../stateQuery.js";
-import { decisionContextEntry, decisionSourceContract, extractDecisionEntries } from "../commands/state/index.js";
 import { capabilityContext } from "./contract.js";
 import { docsConventions, sourceProvenance, uniqueList, hasRecordedValue } from "./shared.js";
-import { loadNamedArtifact } from "../orientation.js";
-import { sourceMetadata } from "../stateQuery.js";
-import { selectEvidenceTarget } from "./planState.js";
+import { selectEvidenceTarget, taskByRef } from "./planState.js";
 import { progressVerificationSummary, retryState } from "./progress.js";
+import { STATE_FAMILY_FALLBACK_COMMANDS, STATE_FAMILY_LIST_COMMANDS } from "./types.js";
+import { deferredStartupFamilies } from "./startupAggregation.js";
+import { preCutoverCommand } from "../preCutoverCommand.js";
 export function dateFromIsoUtc(s) {
     const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(s.trim());
     if (!m)
@@ -39,7 +39,7 @@ export function evidenceDocsState(docs) {
     const [currentState, currentStateCaveat] = currentStateStatus(docs.last_audit, "Docs");
     return {
         status: available ? "available" : "unavailable",
-        source_provenance: sourceProvenance("docs", "agentera docs --format json"),
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs),
         mapping_entries: docs.mapping_entries ?? 0,
         indexed_documents: docs.indexed_documents ?? 0,
         last_audit: docs.last_audit ?? null,
@@ -54,14 +54,14 @@ export function evidenceDocsState(docs) {
 }
 export function evidenceHealthState(health) {
     const available = Boolean(health.exists);
-    const merged = { audit_number: health.number, ...health };
-    const nonEmptyFields = ["audit_number", "trajectory", "grade"].filter((f) => hasRecordedValue(merged[f]));
+    const nonEmptyFields = ["id", "artifact", "trajectory", "grade"].filter((f) => hasRecordedValue(health[f]));
     const auditDate = health.date ?? health.timestamp ?? null;
     const [currentState, currentStateCaveat] = currentStateStatus(auditDate, "Health");
     return {
         status: available ? "available" : "unavailable",
-        source_provenance: sourceProvenance("health", "agentera health --format json"),
-        audit_number: health.number ?? null,
+        source_provenance: sourceProvenance("health", STATE_FAMILY_LIST_COMMANDS.health),
+        id: health.id ?? null,
+        artifact: health.artifact ?? "health",
         date: auditDate,
         timestamp: auditDate,
         trajectory: health.trajectory ?? null,
@@ -81,7 +81,7 @@ export function evidenceTodoState(schemas, todoItems) {
     const exists = fs.existsSync(artifactPath(info, "todo"));
     return {
         status: exists ? "available" : "unavailable",
-        source_provenance: sourceProvenance("todo", "agentera todo --format json"),
+        source_provenance: sourceProvenance("todo", STATE_FAMILY_FALLBACK_COMMANDS.todo),
         open_count: todoItems.length,
         items: todoItems,
         non_empty_evidence_present: todoItems.length > 0,
@@ -90,7 +90,7 @@ export function evidenceTodoState(schemas, todoItems) {
     };
 }
 export function evidenceProtectedStateChecks() {
-    const source = sourceProvenance("evidence_context", "agentera prime --context audit --format json", "protected_state_checks");
+    const source = sourceProvenance("evidence_context", preCutoverCommand("prime --context audit --format json"), "protected_state_checks");
     return {
         status: "not_checked_by_design",
         allowed_status_values: ["verified_local", "not_checked_by_design", "requires_manual_check", "unavailable"],
@@ -120,8 +120,8 @@ export function evidenceVersionChecks(docs) {
     const conventions = docsConventions(docs);
     const versionFiles = asList(conventions.version_files);
     const semverPolicy = conventions.semver_policy && typeof conventions.semver_policy === "object" && !Array.isArray(conventions.semver_policy) ? conventions.semver_policy : {};
-    const source = sourceProvenance("docs", "agentera docs --format json", "summary.conventions");
-    const ec = (field) => sourceProvenance("evidence_context", "agentera prime --context audit --format json", field);
+    const source = sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.conventions");
+    const ec = (field) => sourceProvenance("evidence_context", preCutoverCommand("prime --context audit --format json"), field);
     const checks = [
         {
             name: "docs_version_policy",
@@ -177,15 +177,11 @@ export function evidenceVersionChecks(docs) {
 }
 export function evidencePlanCriteria(plan, target) {
     const taskRefObj = target.task && typeof target.task === "object" && !Array.isArray(target.task) ? target.task : null;
-    let selected = null;
-    if (taskRefObj) {
-        const tasks = asList(plan.tasks).filter((t) => t && typeof t === "object" && !Array.isArray(t));
-        selected = tasks.find((t) => t.number === taskRefObj.number) ?? null;
-    }
+    const selected = taskByRef(plan, taskRefObj);
     const criteria = selected && typeof selected === "object" ? asList(selected.acceptance) : [];
     return {
         status: criteria.length > 0 ? "available" : "incomplete",
-        source_provenance: sourceProvenance("plan", "agentera plan --format json", "entries.acceptance"),
+        source_provenance: sourceProvenance("plan", STATE_FAMILY_FALLBACK_COMMANDS.plan, "entries.acceptance"),
         target: taskRefObj,
         criteria,
         criteria_count: criteria.length,
@@ -197,32 +193,49 @@ export function evidencePlanCriteria(plan, target) {
 export function residualRiskEntry(category, status, message, sp) {
     return { category, status, message, source_provenance: sp };
 }
-export function decisionContextRisk(schemas) {
-    const info = schemas.decisions ?? { path: ".agentera/decisions.yaml", record: undefined, schema: {}, fields: {} };
-    const p = artifactPath(info, "decisions");
-    const source = sourceMetadata("decisions", p);
-    const data = loadNamedArtifact(schemas, "decisions");
-    const entries = extractDecisionEntries(data).map((e) => decisionContextEntry(e));
-    if (!source.exists) {
+function decisionHistoryEntries(history) {
+    return asList(history.entries).flatMap((value) => {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            return [];
+        const entry = value;
+        const record = entry.record;
+        if (!record || typeof record !== "object" || Array.isArray(record))
+            return [];
+        return [{ ...record, id: entry.id ?? null, artifact: entry.artifact ?? "decisions", retrieval: entry.retrieval ?? null }];
+    });
+}
+function decisionHistoryCounts(history) {
+    return history.counts && typeof history.counts === "object" && !Array.isArray(history.counts)
+        ? history.counts
+        : {};
+}
+export function decisionContextRisk(history) {
+    const entries = decisionHistoryEntries(history);
+    const counts = decisionHistoryCounts(history);
+    if (history.command !== "state decisions list") {
         return {
             status: "unavailable",
-            source_provenance: sourceProvenance("decisions", "agentera decisions --format json"),
+            source_provenance: sourceProvenance("decisions", STATE_FAMILY_LIST_COMMANDS.decisions),
             summary: null,
             caveats: ["Decision state is unavailable in CLI evidence context."],
         };
     }
-    const contract = decisionSourceContract(source, entries, {});
-    const completeness = contract.completeness && typeof contract.completeness === "object" && !Array.isArray(contract.completeness)
-        ? contract.completeness
-        : {};
-    const compacted = completeness.compacted_entries;
-    const missing = completeness.entries_with_missing_fields;
-    const caveatsSource = compacted || missing ? (contract.caveats ?? []) : [];
-    const caveats = Array.isArray(caveatsSource) ? caveatsSource : [];
+    const omitted = Number(counts.remaining ?? history.omitted_count ?? 0);
+    const missing = entries.filter((entry) => !entry.id || !entry.date || !entry.question || !entry.choice).length;
+    const caveats = uniqueList([
+        ...(omitted > 0 ? [`Decision startup history omits ${omitted} decision detail entr${omitted === 1 ? "y" : "ies"}; run ${STATE_FAMILY_LIST_COMMANDS.decisions} for the ordinary bounded list.`] : []),
+        ...(missing > 0 ? [`${missing} bounded decision entr${missing === 1 ? "y is" : "ies are"} missing review context fields.`] : []),
+    ]);
     return {
         status: caveats.length > 0 ? "caveated" : "available",
-        source_provenance: sourceProvenance("decisions", "agentera decisions --format json"),
-        summary: completeness,
+        source_provenance: sourceProvenance("decisions", STATE_FAMILY_LIST_COMMANDS.decisions),
+        summary: {
+            total_entries: Number(counts.total ?? entries.length),
+            returned_entries: Number(counts.returned ?? entries.length),
+            omitted_entries: omitted,
+            entries_with_missing_fields: missing,
+            authority: "canonical_entity_files",
+        },
         caveats,
     };
 }
@@ -248,6 +261,9 @@ export function decisionReviewDue(entry) {
     return [null, null];
 }
 export function decisionLabel(entry) {
+    const id = entry.id;
+    if (typeof id === "string" && id)
+        return `Decision ${id}`;
     const number = entry.number;
     if (number !== null && number !== undefined && number !== "")
         return `Decision ${number}`;
@@ -260,29 +276,21 @@ export function isoFromUtcMs(utc) {
     const d = new Date(utc);
     return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, "0")}-${String(d.getUTCDate()).padStart(2, "0")}`;
 }
-export function decisionReviewPressure(schemas) {
-    const info = schemas.decisions ?? { path: ".agentera/decisions.yaml", record: undefined, schema: {}, fields: {} };
-    const p = artifactPath(info, "decisions");
-    const source = sourceMetadata("decisions", p);
-    const sp = sourceProvenance("decisions", "agentera decisions --format json");
-    if (!source.exists) {
+export function decisionReviewPressure(history) {
+    const sp = sourceProvenance("decisions", STATE_FAMILY_LIST_COMMANDS.decisions);
+    if (history.command !== "state decisions list") {
         return { status: "unavailable", source_provenance: sp, summary: null, stale_protected_decisions: [], caveats: [] };
     }
-    const data = loadNamedArtifact(schemas, "decisions");
-    const dd = data && typeof data === "object" && !Array.isArray(data) ? data : {};
-    const active = Array.isArray(dd.decisions) ? dd.decisions : [];
-    const archive = Array.isArray(dd.archive) ? dd.archive : [];
-    const activeEntries = active
-        .filter((e) => Boolean(e && typeof e === "object" && !Array.isArray(e)))
-        .map((e) => decisionContextEntry(e));
-    const archiveEntries = archive
-        .filter((e) => Boolean(e && typeof e === "object" && !Array.isArray(e)))
-        .map((e) => decisionContextEntry(e));
+    const activeEntries = decisionHistoryEntries(history);
+    const counts = decisionHistoryCounts(history);
+    const omitted = Number(counts.remaining ?? history.omitted_count ?? 0);
     const protectedActive = activeEntries.filter((e) => e.satisfaction && typeof e.satisfaction === "object" && !Array.isArray(e.satisfaction) && e.satisfaction.review_needed);
-    const protectedArchive = archiveEntries.filter((e) => e.satisfaction && typeof e.satisfaction === "object" && !Array.isArray(e.satisfaction) && e.satisfaction.review_needed);
+    const protectedArchive = [];
     const today = todayUtcMs();
     const stale = [];
-    let caveats = [];
+    let caveats = omitted > 0
+        ? [`Decision review pressure is bounded with ${omitted} decision(s) omitted; continue with ${STATE_FAMILY_LIST_COMMANDS.decisions}.`]
+        : [];
     for (const [collection, entries] of [["decisions", protectedActive], ["archive", protectedArchive]]) {
         for (const entry of entries) {
             const [field, reviewDate] = decisionReviewDue(entry);
@@ -303,19 +311,22 @@ export function decisionReviewPressure(schemas) {
     }
     caveats = uniqueList(caveats);
     return {
-        status: caveats.length > 0 ? "review_required" : "available",
+        status: stale.length > 0 || protectedOverflowCount > 0 ? "review_required" : omitted > 0 ? "degraded" : "available",
         source_provenance: sp,
         summary: {
             protected_active_decisions: protectedActive.length,
             protected_archive_decisions: protectedArchive.length,
             protected_overflow_count: protectedOverflowCount,
             stale_protected_decisions: stale.length,
+            returned_decisions: Number(counts.returned ?? activeEntries.length),
+            total_decisions: Number(counts.total ?? activeEntries.length),
+            omitted_decisions: omitted,
         },
         stale_protected_decisions: stale,
         caveats,
     };
 }
-export function auditEvidenceContext(capability, schemas, plan, progress, health, todoItems, docs, profile, bundle) {
+export function auditEvidenceContext(capability, schemas, plan, progress, health, todoItems, docs, profile, bundle, decisionHistory) {
     if (capability !== "audit")
         return null;
     const capabilityContract = capabilityContext(capability) ?? {};
@@ -327,35 +338,35 @@ export function auditEvidenceContext(capability, schemas, plan, progress, health
     const todoState = evidenceTodoState(schemas, todoItems);
     const protectedStateChecks = evidenceProtectedStateChecks();
     const versionChecks = evidenceVersionChecks(docs);
-    const decisionRisk = decisionContextRisk(schemas);
-    const reviewPressure = decisionReviewPressure(schemas);
+    const decisionRisk = decisionContextRisk(decisionHistory);
+    const reviewPressure = decisionReviewPressure(decisionHistory);
     let stateCaveats = [];
     const attributedRisks = [];
-    for (const family of (capabilityContract.missing_state_families ?? [])) {
-        const message = `${family} state is not included in prime --context startup context.`;
+    for (const family of deferredStartupFamilies(capabilityContract)) {
+        const message = `${family} detail is deferred from prime --context startup.`;
         stateCaveats.push(message);
-        attributedRisks.push(residualRiskEntry("missing_state_family", "caveated", message, sourceProvenance("prime", "agentera prime --context audit --format json", "source_contract.capability_context.missing_state_families")));
+        attributedRisks.push(residualRiskEntry("deferred_state_detail", "caveated", message, sourceProvenance("prime", preCutoverCommand("prime --context audit --format json"), "capability_context.startup.availability")));
     }
     if (bundle.status !== "up_to_date") {
         const message = "Agentera app files are not up to date; this is a caveat, not approval to repair or update app files.";
         stateCaveats.push(message);
-        attributedRisks.push(residualRiskEntry("installed_app_state", "caveated", message, sourceProvenance("status", "agentera prime --format json", "app.status")));
+        attributedRisks.push(residualRiskEntry("installed_app_state", "caveated", message, sourceProvenance("status", preCutoverCommand("prime --format json"), "app.status")));
     }
-    if (profile.status !== "loaded") {
+    if (profile.status !== "valid") {
         const message = "profile-derived state is unavailable in prime --context response.";
         stateCaveats.push(message);
-        attributedRisks.push(residualRiskEntry("profile_state", "unavailable", message, sourceProvenance("status", "agentera prime --format json", "profile.status")));
+        attributedRisks.push(residualRiskEntry("profile_state", "unavailable", message, sourceProvenance("status", preCutoverCommand("prime --format json"), "profile.status")));
     }
     else if (profile.stale === true) {
         const message = "profile-derived state is stale; this is a caveat, not approval to refresh profile state.";
         stateCaveats.push(message);
-        attributedRisks.push(residualRiskEntry("profile_state", "caveated", message, sourceProvenance("status", "agentera prime --format json", "profile.stale")));
+        attributedRisks.push(residualRiskEntry("profile_state", "caveated", message, sourceProvenance("status", preCutoverCommand("prime --format json"), "profile.stale")));
     }
     for (const component of [evaluationTarget, planCriteria, progressVerification, docsState, healthState, todoState, protectedStateChecks, versionChecks]) {
         for (const caveat of (component.caveats ?? [])) {
             stateCaveats.push(caveat);
             // cast: component source_provenance comes from evidence builders backed by parsed artifact/decision state
-            const componentSp = component.source_provenance ?? sourceProvenance("evidence_context", "agentera prime --context audit --format json");
+            const componentSp = component.source_provenance ?? sourceProvenance("evidence_context", preCutoverCommand("prime --context audit --format json"));
             attributedRisks.push(residualRiskEntry("evidence_family", "caveated", caveat, componentSp));
         }
     }
@@ -393,13 +404,12 @@ export function auditEvidenceContext(capability, schemas, plan, progress, health
     };
     const missingRequired = Object.entries(requiredState).filter(([, present]) => !present).map(([name]) => name);
     const fallbackCommands = uniqueList([
-        "agentera state plan --format json",
-        "agentera state progress --format json",
-        "agentera state docs --format json",
-        "agentera state health --format json",
-        "agentera state todo --format json",
-        "agentera state query --list-artifacts --format json",
-        ...(capabilityContract.cli_fallback ?? []),
+        STATE_FAMILY_FALLBACK_COMMANDS.plan,
+        STATE_FAMILY_FALLBACK_COMMANDS.progress,
+        STATE_FAMILY_FALLBACK_COMMANDS.docs,
+        STATE_FAMILY_FALLBACK_COMMANDS.health,
+        STATE_FAMILY_FALLBACK_COMMANDS.todo,
+        preCutoverCommand("state query --list-artifacts --format json"),
     ]);
     return {
         capability: "audit",
@@ -427,8 +437,6 @@ export function auditEvidenceContext(capability, schemas, plan, progress, health
             raw_artifact_reads_required: false,
             raw_artifact_read_policy: "Use this evidence_context and included status state first. Run listed routine/query CLI fallback commands " +
                 "for missing or incomplete evidence state; raw artifact reads are last-resort diagnostics, not normal evaluation startup behavior.",
-            included_state_families: capabilityContract.included_state_families ?? [],
-            missing_state_families: capabilityContract.missing_state_families ?? [],
             required_evidence_state: requiredState,
             missing_required_evidence_state: missingRequired,
             fallback_commands: fallbackCommands,
@@ -453,4 +461,3 @@ export function auditEvidenceContext(capability, schemas, plan, progress, health
         },
     };
 }
-//# sourceMappingURL=evidence.js.map

package/dist/cli/capabilityContext/index.js

@@ -1,4 +1,3 @@
 export { CAPABILITY_NAMES } from "./types.js";
 export { validatePrimeCapability } from "./shared.js";
 export { buildPrimeCapabilityContextPayload } from "./startup.js";
-//# sourceMappingURL=index.js.map