agentera 3.0.0-dev.38 → 3.0.0-dev.39

package/bundle/CHANGELOG.md

@@ -4,6 +4,9 @@
 
 ### Changed
 
+- `agentera prime` now selects Build and Audit work from the complete plan task
+  graph, prioritizes in-progress work before dependency-ready pending tasks, and
+  keeps status recommendations aligned when the public task list is bounded.
 - Status now selects TODO recommendations from complete typed readiness state
   before applying startup bounds, preserves the selected TODO ID and exact
   retrieval command across JSON, terminal, and host projections, and abstains
@@ -61,9 +64,9 @@
 - Added a validated TODO readiness authority with phase-derived capability
   destinations, explicit triage/block/gate/dependency outcomes, and
   reviewer-assigned deterministic queue ordering.
-- Added post-cutover entity-backed default state views, bare-ID durability diagnostics, and read-only historical migration-manifest target validation while preserving legacy numbered behavior before cutover.
-- Added a Git-backed entity cutover owned by the full development-channel `upgrade --yes` command, with deterministic direct publication, exact-target retries, marker-last authority activation, and first-unresolved-path handoff.
-- Added post-cutover decision entities for immutable bases and content revisions, replaceable satisfaction ownership, bare-ID exact and bounded reads, deterministic effective provenance, stale-base and transition validation, and explicit same-decision conflict detection; marker-absent projects retain the legacy numbered authority without dual writes.
+- Added entity-backed state views, bare-ID durability diagnostics, and read-only historical migration validation; marker-absent projects now require migration instead of exposing legacy numbered reads.
+- Added a Git-backed entity cutover owned by the full development-channel `upgrade --yes` command, with deterministic direct publication, exact-target retries, source-bound marker-last authority activation, and first-unresolved-path handoff.
+- Added decision entities for immutable bases and content revisions, replaceable satisfaction ownership, bare-ID exact and bounded reads, deterministic effective provenance, stale-base and transition validation, and serialized same-decision ownership. Migration preserves ordered legacy amendments, including whole-alternative replacements and dateless evidence, rejects invalid or stale claims, and requires source-bound provenance for inherited legacy confidence; marker-absent aggregate files remain migration input only.
 - Added the post-cutover progress entity writer and `state progress get|list` reads with bare IDs, one canonical file per cycle, atomic replay-safe publication, full provenance, bounded snapshot pagination, and no legacy projection or archive writes; legacy projects remain unchanged until the durable cutover marker exists.
 - Added authority-driven, one-file-per-entity storage primitives with secure project-wide IDs, symlink-safe discovery, conflict-safe publication, relationship validation, and `agentera check validate state` diagnostics.
 - Added an authoritative evidence-tier contract (`references/analysis/evidence-tier-authority.yaml`) and contract-model loader (`packages/cli/src/registries/evidenceTierContract.ts`) fixing the bounded full-evidence and signal tiers, supported Codex, Cursor, OpenCode, Copilot, and historical Claude source coverage, the consumer field-supply map including the latent startup-analysis reader, bounded personal-glossary synthesis semantics, and deterministic recovery outcomes for oversized, legacy, missing, corrupt, and incomplete state.
@@ -78,7 +81,7 @@
 - Added `agentera state plan list` and `agentera state plan get --plan PLAN_ID` for deterministic, cursor-paginated active and archived plan retrieval, full-plan exact reads, lifecycle provenance, and explicit legacy, invalid, missing, and ambiguous archive outcomes.
 - Added persisted plan identity across active-to-archive transitions, deterministic read-only identity for legacy plans, explicit lifecycle provenance, mirrored-path reporting, and structured ambiguity failures for identity collisions.
 - Added `agentera state plan tasks list` and `agentera state plan tasks get --task N` for bounded active-plan task retrieval with declared task-number order, opaque snapshot cursors, structured not-found and compatibility errors, and exact omission recovery in text and JSON plan output.
-- Added `agentera state decisions amend --number N [--question ... --context ... --alternative-chosen ... --alternative-rejected ... --choice ... --reasoning ... --confidence firm|provisional|exploratory --feeds-into ...] [--dry-run] --format json`: validates and publishes a record-local revision under `.agentera/revisions/decisions.yaml` that composes over the immutable numbered archive at read time. Apply never rewrites the decisions projection, preserves unrelated decisions' bytes (including comments, block scalars, quoting, and inherited legacy confidence labels), refuses a broken revision document or unsafe record-local boundary without side effects, retries converge on a stable revision identity, and an identical re-submission is an idempotent replay. Append, satisfaction update, and amend tolerate untouched inherited confidence labels as explicit legacy caveats while requiring current vocabulary for new or amended content.
+- Added `agentera state decisions amend --id ID --base-sha256 HASH [--question ... --context ... --alternative-chosen ... --alternative-rejected ... --choice ... --reasoning ... --confidence firm|provisional|exploratory --feeds-into ...] [--dry-run] --format json`: validates and publishes one immutable decision revision entity. Effective reads compose the base, ordered revisions, and current satisfaction entity; stale-base and same-base conflicts fail before publication, and identical retries converge.
 
 - Added an executable bounded-retrieval authority and reserved CLI grammar for plan tasks, plans, and objective-scoped experiments, including stable and legacy identity rules, experiment `0`, opaque cursors, explicit omissions, and structured compatibility errors; retrieval execution remains staged for subsequent tasks.
 - Added one shared skill at `~/.agents/skills/agentera` plus the CLI and entity-backed project state as the active integration contract; host-native plugin, hook, agent, and package surfaces are not shipped.
@@ -121,6 +124,28 @@
 
 ### Fixed
 
+- Fixed `agentera state query changelog`, Build Prime, and Document closeout to
+  use one bounded Keep-a-Changelog reader with matching headings, boundary,
+  provenance, and fail-safe recovery for missing, malformed, unsafe, ambiguous,
+  or oversized input.
+- Fixed explicit-home upgrade planning to ignore inherited
+  `OPENCODE_CONFIG_DIR` values outside the selected home, preventing unrelated
+  OpenCode resources from blocking fixture, package, or isolated project
+  upgrades while retaining in-home overrides.
+- Fixed `agentera prime --context build` to accept bounded, transient no-plan
+  scope and acceptance through `--input <file|->`, complete execution context
+  without creating plan state or returning non-advancing plan recovery, and
+  reject active-plan conflicts.
+- Fixed `agentera prime --context build` to derive bounded verification commands
+  from `AGENTS.md` and package scripts, preserve exact provenance, canonicalize
+  aliases, and reject placeholders, conflicts, unsafe paths, missing targets,
+  and over-limit input.
+- Fixed `agentera prime --context build` instructions to log TODO, progress,
+  changelog, and plan closeout before one commit, and to describe canonical
+  progress entity publication instead of numbered aggregate compaction.
+- Fixed plan supersession and open-plan completion to require every replacement
+  task to be complete with latest persisted PASS evidence. Existing records
+  remain readable, and affected open plans retain the narrow first-PASS repair.
 - Fixed same-minute progress recency to use persisted writer-owned publication
   order instead of opaque IDs. List and `prime` now select the final committed
   publication after restart or copy. Version 2 snapshot cursors preserve

package/bundle/references/artifacts/state-storage-authority.yaml

@@ -19,8 +19,9 @@ authority:
     plus one-way forward import, are implemented but activate entity authority only
     from the durable cutover marker. The preserved
     singleton families remain legacy files. The
-    current numbered archive and retrieval groups remain migration input while
-    that marker is absent; no independent legacy repair mutation remains.
+    numbered archives, aggregate overlays, and aggregate revision documents
+    remain migration input while that marker is absent; no independent legacy
+    read or repair mutation remains.
 
 entity_target:
   status: progress_decisions_health_plan_objective_experiment_todo_and_docs_implemented_other_families_declared
@@ -313,9 +314,25 @@ entity_target:
       publication: immutable
       ownership: { fields: [decision, base_sha256], cardinality: zero_or_one }
       record:
-        required_fields: [decision, date, provenance, base_sha256, changes]
+        required_fields: [decision, provenance, base_sha256, changes]
+        legacy_optional_fields: [date]
         required_paths: []
         forbidden_fields: [id, artifact, number, stable_id, artifact_id, entry_number, satisfaction]
+      canonical_metadata:
+        migration_provenance:
+          applicability: inherited_unsupported_revision_confidence_only
+          required_fields: [kind, source, source_path, source_identity, source_fingerprint, source_record_sha256, confidence]
+          additional_fields: forbidden
+          kind: inherited_decision_revision_confidence
+          sources: [revision_document]
+          semantics: >-
+            Cutover persists this envelope-level metadata only when a legacy
+            aggregate revision carries high, medium, or low confidence and the
+            composed decision is otherwise valid. source_identity selects the
+            exact ordered row in .agentera/revisions/decisions.yaml,
+            source_fingerprint binds the deterministic canonical decision ID, and
+            source_record_sha256 binds that complete row. Ordinary decision
+            amendments accept only the current confidence vocabulary.
     - boundary: health_audit
       artifact: health
       independently_mutable: true
@@ -761,7 +778,11 @@ entity_target:
       repetitions: 5
       pass_rule: every repetition stays within every applicable limit
       elapsed: wall-clock milliseconds from process start through complete serialized output
-      heap: process heapUsed peak minus heapUsed before fixture discovery
+      heap: process heapUsed peak minus the normalized heapUsed baseline before fixture discovery
+      heap_baseline:
+        boundary: after CLI import reaches the fixture boundary and before the measured operation
+        normalization: await successful Node inspector HeapProfiler.collectGarbage, then read Runtime.getHeapUsage
+        measured_operation_collection: forbidden
       bytes: UTF-8 byte length of stdout including the trailing newline
     targets:
       exact_get:
@@ -799,6 +820,8 @@ entity_migration:
     entity_mode:
       schemaVersion: agentera.stateMode.v1
       mode: entities
+      source_fingerprint: lowercase_sha256_of_bound_migration_inputs
+      preview_digest: lowercase_sha256_of_bound_migration_preview
     absent_mode: legacy
     invalid_behavior: fail_without_fallback
     detection: read_only
@@ -1300,33 +1323,33 @@ retrieval:
     - collection_id: progress.records
       artifact_id: progress
       growth: append_only_unbounded
-      identity: 'progress:<positive-entry-number>'
-      storage_ownership: immutable_numbered_archive_with_bounded_current_projection
-      ordering: entry_number_desc
+      identity: bare_ten_letter_entity_id
+      storage_ownership: canonical_progress_entities
+      ordering: timestamp_desc_then_publication_order_desc_then_id_asc
       bounds: count_1_to_100_and_serialized_utf8_budget
       cursor: opaque_snapshot_cursor
       omission: explicit_with_advancing_cursor_or_exact_get
-      get: agentera state progress get --number N --format json
+      get: agentera state progress get --id ID --format json
     - collection_id: decisions.records
       artifact_id: decisions
-      growth: append_only_unbounded_with_declared_mutable_overlay
-      identity: 'decisions:<positive-entry-number>'
-      storage_ownership: immutable_numbered_archive_plus_decision_overlay_with_bounded_current_projection
-      ordering: entry_number_desc
+      growth: immutable_base_and_revision_entities_with_replaceable_satisfaction_entity
+      identity: bare_ten_letter_entity_id
+      storage_ownership: canonical_decision_entities
+      ordering: date_desc_then_id_asc
       bounds: count_1_to_100_and_serialized_utf8_budget
       cursor: opaque_snapshot_cursor
       omission: explicit_with_advancing_cursor_or_exact_get
-      get: agentera state decisions get --number N --format json
+      get: agentera state decisions get --id ID --format json
     - collection_id: health.records
       artifact_id: health
       growth: append_only_unbounded
-      identity: 'health:<positive-entry-number>'
-      storage_ownership: immutable_numbered_archive_with_bounded_current_projection
-      ordering: entry_number_desc
+      identity: bare_ten_letter_entity_id
+      storage_ownership: canonical_health_entities
+      ordering: appended_at_desc_then_id_asc_then_legacy_date_desc_then_id_asc
       bounds: count_1_to_100_and_serialized_utf8_budget
       cursor: opaque_snapshot_cursor
       omission: explicit_with_advancing_cursor_or_exact_get
-      get: agentera state health get --number N --format json
+      get: agentera state health get --id ID --format json
     - collection_id: plan.plans
       artifact_id: plan
       growth: one_active_plus_append_only_immutable_file_archives
@@ -1666,6 +1689,7 @@ identity:
       not emitted on the current bounded page.
 
 envelope:
+  legacy_source_state: migration_input_only
   schema_version: agentera.stateArchiveEntry.v1
   required_fields:
     - schemaVersion
@@ -1702,15 +1726,18 @@ envelope:
 
 overlays:
   location: .agentera/overlays/decisions.yaml
+  legacy_source_state: migration_input_only
+  current_entity_boundary: decision_satisfaction
   project_root_fixed: true
   docs_yaml_override: forbidden
   schema_version: agentera.decisionOverlay.v1
   supported_artifact: decisions
   identity_key: decisions:<decision-number>
   storage_shape: >-
-    A mapping keyed by stable decision ID. Each value contains only the
-    authority-declared mutable paths and never replaces the immutable archive
-    record.
+    The legacy migration source is a mapping keyed by numbered decision ID.
+    Entity migration converts each value into one decision_satisfaction entity
+    related to the canonical decision ID. Current reads and writes use that
+    entity and never read or publish the aggregate overlay document.
   mutable_paths:
     - satisfaction.state
     - satisfaction.evidence
@@ -1753,18 +1780,29 @@ overlays:
 
 revisions:
   location: .agentera/revisions/decisions.yaml
+  legacy_source_state: migration_input_only
   project_root_fixed: true
   docs_yaml_override: forbidden
   schema_version: agentera.decisionRevision.v1
   supported_artifact: decisions
   identity_key: decisions:<decision-number>
   storage_shape: >-
-    A mapping keyed by stable decision ID. Each value is an ordered list of
-    immutable revision records carrying only authority-declared amendable
-    content paths plus revision provenance. A revision never replaces the
-    immutable numbered archive record and never replaces the satisfaction
-    overlay; it is additional immutable evidence composed at read time.
+    The legacy migration source is a mapping keyed by numbered decision ID.
+    Entity migration converts each ordered row into one decision_revision
+    entity related to the canonical decision ID. Current reads and writes use
+    those entities and never read or publish the aggregate revision document.
   amendable_paths:
+    - question
+    - context
+    - alternatives.chosen
+    - alternatives.rejected
+    - choice
+    - reasoning
+    - confidence
+    - feeds_into
+  migration_amendable_paths:
+    - alternatives
+  legacy_amendable_paths:
     - question
     - context
     - alternatives
@@ -1777,14 +1815,15 @@ revisions:
   temporal_paths:
     - date
   separation_from_overlay: >-
-    Amendments never touch satisfaction overlay paths. Satisfaction updates
-    remain under overlays; content amendments remain under revisions. Each
-    authority composes its own evidence and neither rewrites the other.
+    Legacy content amendments never touch legacy aggregate satisfaction paths;
+    migration converts both sources independently. Current satisfaction and
+    content mutations publish decision_satisfaction and decision_revision
+    entities, and neither entity boundary rewrites the other.
   immutability: >-
-    Original numbered archive records remain immutable historical evidence.
-    Revisions are additional immutable evidence appended in declared order;
-    no revision overwrites, reorders, or deletes a prior revision. A revision
-    is byte-stable after publication and an identical revision is an
+    Imported numbered archive records remain immutable historical evidence.
+    Current decision_revision entities are additional immutable evidence;
+    no revision overwrites, reorders, or deletes a prior revision. An entity
+    revision is byte-stable after publication and an identical revision is an
     idempotent replay.
   provenance: >-
     Revision evidence carries revision provenance only. It is never labeled
@@ -1792,33 +1831,32 @@ revisions:
     legacy projection record may carry degraded_projection provenance and
     never historical_archive provenance.
   publication_order:
-    - validate_target_identity
+    - validate_entity_target_identity
     - validate_amendment_vocabulary
-    - stage_revision
-    - publish_revision
-    - update_effective_projection
-  apply_state: implemented
+    - validate_base_sha256
+    - publish_decision_revision_entity
+    - compose_effective_entity_read
+  apply_state: entity_implemented_legacy_source_retired
   apply_state_note: >-
-    The revision authority and amend command publish record-local amendments
-    with recovery. A valid dry-run reports the exact revision, effective record,
-    and projection effect without writing any file. Apply writes a
-    record-local override to the revision document only (preserving unrelated
-    entries' bytes), retries converge on a stable revision identity, and an
-    identical re-submission is an idempotent replay. The decisions projection
-    is never rewritten by an amendment; effective detail composes
-    base→revisions→overlay. Amend execution still refuses before side effects
-    for an unsafe target-only change, a duplicate-revision conflict, a stale
-    base hash, or an unsafe target identity, returning an actionable retry or
-    repair action. Discover the contract with
+    The entity amend command publishes one immutable decision_revision entity
+    related to the selected bare decision ID. A valid dry-run reports the
+    candidate without writing; retries converge through canonical entity
+    replay. Effective entity reads compose base, ordered revision entities, and
+    satisfaction entities. The aggregate revision document is read only by
+    migration preview and cutover and is never a current publication target.
+    Amend execution refuses before side effects for an unsafe target, duplicate
+    same-base claim, or stale base hash. Discover the current contract with
     `agentera state decisions explain --verb amend --format json`.
 
 projections:
   archive:
-    role: complete immutable historical detail
+    source_state: migration_input_only
+    role: complete immutable historical migration detail
     source_of_truth_for: historical_record_fields
     omission: never omit fields from an archive record
   current:
-    role: bounded active projection for current artifact consumers
+    source_state: migration_input_only
+    role: bounded aggregate migration projection
     default_capacity:
       active_entries: 10
       summary_entries: 40
@@ -1842,14 +1880,15 @@ projections:
       progress: .agentera/progress.yaml
       decisions: .agentera/decisions.yaml
       health: .agentera/health.yaml
-    source_of_truth_for: current_projection_and_legacy_compatibility_state
+    source_of_truth_for: legacy_migration_and_compatibility_state_only
     archive_relationship: >-
-      A current entry may be full, summary-only, or absent from the projection;
+      A legacy aggregate entry may be full, summary-only, or absent from the projection;
       archive presence and hash verification determine whether full detail is
-      available. Current mutable decision overlay values are composed at read
-      time and do not rewrite archive bytes.
+      available during migration. Legacy decision overlay values are converted
+      independently and do not rewrite archive bytes.
   summary:
-    role: bounded list and startup representation
+    source_state: migration_input_only
+    role: bounded aggregate migration representation
     required_item_fields: [stable_id, artifact_id, entry_number, addressable, classification, detail_availability, source]
     nullable_item_fields:
       - stable_id
@@ -1870,6 +1909,7 @@ projections:
       truncated, represented as a fabricated summary, or treated as missing
       history without provenance.
   startup:
+    source_state: canonical_entity_authority
     role: bounded orientation and capability-startup projection
     required_fields: [command, status, source, source_contract]
     allowed_payload: >-
@@ -1886,17 +1926,17 @@ api:
   artifact_syntax: agentera state <artifact-id>
   formats: [text, json, yaml]
   direct_get:
-    command: agentera state <artifact-id> get --number N --format json
+    command: agentera state <artifact-id> get --id ID --format json
     examples:
-      progress: agentera state progress get --number 747 --format json
-      decisions: agentera state decisions get --number 53 --format json
-      health: agentera state health get --number 29 --format json
-    required_selector: --number N
+      progress: agentera state progress get --id qjtrmnpvka --format json
+      decisions: agentera state decisions get --id imumkmffwh --format json
+      health: agentera state health get --id abcdefghij --format json
+    required_selector: --id ID
     result: >-
-      One complete record composed from the immutable archive and only the
-      authority-declared current overlay fields, with stable_id, source,
-      detail_availability, compatibility, and provenance metadata.
-    archive_only: direct retrieval reads the exact numbered record without scanning unrelated records
+      One complete canonical entity record with id, artifact, detail availability,
+      compatibility, effective content, and provenance metadata. Decision reads
+      compose immutable base, ordered revisions, and current satisfaction entities.
+    exact_only: direct retrieval resolves one canonical entity ID without scanning unrelated records
   list:
     command: agentera state <artifact-id> list [--limit N] [--cursor TOKEN] --format json
     examples:
@@ -1905,20 +1945,21 @@ api:
     default_limit: 20
     minimum_limit: 1
     maximum_limit: 100
-    ordering: identity.ordering.list
+    ordering:
+      progress: timestamp_desc_then_publication_order_desc_then_id_asc
+      decisions: date_desc_then_id_asc
+      health: appended_at_desc_then_id_asc_then_legacy_date_desc_then_id_asc
     response_fields:
       required: [command, status, entries, counts, source, filters, snapshot, source_contract]
-      entry: [stable_id, artifact_id, entry_number, current_status, detail_availability, source, compatibility, provenance]
-      optional_entry: [summary, record_status, overlay_applied, retrieval]
+      entry: [id, artifact, detail_availability, compatibility, record, provenance, retrieval]
+      optional_entry: [summary, caveats]
     empty_result: status=ok with entries=[] and counts.total=0; absence is not an error
   durability:
-    command: agentera check durability [--project PATH] [--artifact ARTIFACT] [--number N] [--limit N] --format json
-    entity_command: agentera check durability --project PATH --artifact ARTIFACT --id ID --format json
+    command: agentera check durability [--project PATH] [--artifact ARTIFACT] [--id ID] [--limit N] --format json
     formats: [text, json, yaml]
     selectors:
-      artifact: optional supported numbered archive artifact ID
-      number: optional positive entry number; requires artifact
-      id: entity-mode bare entity ID; requires artifact and replaces number after cutover
+      artifact: optional supported entity artifact ID
+      id: optional bare entity ID; requires artifact
       limit: optional bounded result count
     default_limit: 100
     maximum_limit: 100
@@ -1927,7 +1968,7 @@ api:
     git_values: [verified, degraded, unavailable]
     response_fields:
       required: [command, status, project, read_only, remote_contact, head, counts, entries, diagnostics, source_contract]
-      entry: [stable_id, artifact_id, entry_number, status, local, git]
+      entry: [id, artifact, status, local, git]
     guarantees:
       read_only: true
       remote_contact: forbidden
@@ -1948,14 +1989,14 @@ api:
     syntax: opaque TOKEN returned as response.next_cursor
     first_page: omit --cursor to establish a snapshot
     snapshot_identity: >-
-      deterministic hash of ordered candidate IDs, archive hashes, legacy
-      projection hashes when no archive exists, filters, and overlay revision.
+      deterministic hash of ordered canonical entity IDs, projected record
+      hashes, and filters.
     snapshot_scope: artifact and filters are bound to the cursor; limit may change between pages
     append_behavior: >-
       Entries appended after the first page are excluded from that cursor's
       snapshot. They appear only in a new listing without the old cursor.
     continuation: >-
-      Continue strictly after the last emitted numeric entry number. Never
+      Continue strictly after the last emitted entity ordering key. Never
       restart from page one, skip an entry, or duplicate an entry.
     unavailable: return cursor_snapshot_unavailable rather than silently creating a new snapshot
     opacity: callers must not parse, construct, or compare token internals
@@ -1970,7 +2011,7 @@ failures:
     required_fields: [schemaVersion, status, error]
     status: fail
     error_required_fields: [class, message, syntax, example, recovery]
-    error_optional_fields: [artifact_id, entry_number, stable_id, details, valid_values]
+    error_optional_fields: [artifact, id, details, valid_values]
   exit_codes:
     invalid_input: 2
     operational_failure: 1

package/bundle/references/cli/agent-ready-state-contract.yaml

@@ -324,7 +324,20 @@ structured_output:
             constraints, verification expectations, artifact update requirements,
             progress logging requirements, changelog boundary, scope boundary,
             fallback commands, caveats, read-only plan-completion sweep metadata,
-            and a raw-read-last-resort source contract. It must not introduce
+            and a raw-read-last-resort source contract. Verification commands are
+            selected only from bounded verification-labelled rows in the root
+            AGENTS.md `When | Command` recipe table. Explicit root or `pnpm -C`
+            package.json scripts validate those references; exact script aliases are
+            resolved before duplicate-label conflict checks, and equivalent canonical
+            commands are deduplicated with bounded line/field source pointers retained.
+            Command, provenance, rejection, and diagnostic omissions are reported by
+            explicit counts below generic startup projection limits. Malformed
+            recipes, placeholders, shorthand, unsupported syntax, symlinked sources,
+            targets, or existing ancestors, missing scripts, cycles, out-of-root paths,
+            every missing Node entrypoint, and conflicting canonical label sets are
+            rejected with bounded diagnostics rather than inferred or executed. Node
+            arguments use tokens only and reject absolute or parent-traversing values,
+            including values after `=`; discovery never executes a recipe. It must not introduce
             `agentera realisera`, `agentera build`, new top-level commands, or new subcommands.
           decision_attention_semantics: >-
             `agentera prime --format json` may include one bounded `decision_attention`
@@ -369,7 +382,7 @@ startup_completeness:
     - docs artifact mapping and source-contract completeness metadata
     - latest progress verification metadata needed for Orkestrera evaluation
     - Optimera benchmark_context metadata for retained startup benchmark summaries
-    - Realisera execution_context metadata for plan-driven implementation startup
+    - Realisera execution_context metadata for plan-driven or explicit transient no-plan implementation startup
   empty_state_behavior: >-
     agentera prime reports absent plan, docs, and progress state explicitly through
     structured summaries and state_presence absence metadata instead of forcing
@@ -381,6 +394,75 @@ startup_completeness:
     - Do not add Decision 43 slash-route aliases to the CLI command surface.
     - Do not remove or rename routine state commands.
     - Do not add a separate benchmark command; Optimera benchmark comparison stays inside benchmark_context.
+build_transient_execution_request:
+  status: implemented
+  command: agentera prime --context build --input <file|-> --format json
+  schema_version: agentera.buildExecutionRequest.v1
+  transport:
+    sources:
+      - file
+      - stdin
+    request_text_in_argv: forbidden
+    max_utf8_bytes: 32768
+    malformed_utf8: fatal
+    document: YAML or JSON mapping
+    acquisition:
+      file: >-
+        Regular files only; symlinks and non-regular inputs fail closed. Open
+        no-follow where supported, verify the opened descriptor identity against
+        the observed file, precheck known size, and incrementally read at most
+        max_utf8_bytes + 1 before rejecting overflow.
+      stdin: >-
+        Incrementally read fd 0 in bounded chunks through max_utf8_bytes + 1;
+        reject overflow and never close fd 0. Injected test stdin is capped
+        immediately after the supplied value returns.
+  fields:
+    exact_required:
+      - schema_version
+      - scope
+      - acceptance
+    additional_fields: forbidden
+    scope:
+      type: string
+      non_empty: true
+      max_unicode_code_points: 160
+      control_characters: forbidden
+    acceptance:
+      type: list_of_strings
+      min_items: 1
+      max_items: 12
+      duplicate_items: forbidden
+      item_non_empty: true
+      item_max_unicode_code_points: 160
+      item_control_characters: forbidden
+  validation_failure:
+    envelope: agentera.invalidInputEnvelope.v2
+    exit_code: 2
+    sensitive_input_echo: forbidden
+  availability:
+    only_with_context: build
+    active_or_completed_current_plan: conflict
+    archived_history_without_current_executable_plan: allowed
+    malformed_or_degraded_plan_state: fail_safe
+  persistence:
+    request_persisted: false
+    orientation_state_extended: false
+    state_mutation: none
+    plan_creation_or_mutation: forbidden
+  no_plan_execution_context:
+    mode: no_plan
+    valid_request:
+      work_selection_reason: explicit_no_plan_scope
+      acceptance_source: exact transient request
+      source_path_inference: forbidden
+      plan_fallback: forbidden
+      plan_status_update_required: false
+      complete_for_execution_context: true when all non-plan required execution state is available
+    missing_request:
+      complete_for_execution_context: false
+      plan_fallback: forbidden
+      advancing_recovery: agentera prime --context build --input - --format json
+      caveat: Explicit scope and acceptance are required for no-plan execution.
 evidence_context_target_contract:
   status: task_1_design_contract
   planned_context_name: evidence_context