agentera 3.0.0-dev.32 → 3.0.0-dev.39

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
@@ -176,14 +177,42 @@ entity_target:
         forbidden_fields: [id, artifact, number, stable_id, artifact_id, entry_number]
         temporal_fields: [timestamp]
         timestamp_format: 'YYYY-MM-DD HH:MM'
+        publication_order:
+          field: publication_order
+          type: positive_safe_integer
+          presence: optional_for_legacy_required_for_new_publications
+          visibility: public_record_metadata
+          ownership: progress_writer_only
+          assignment: max_valid_existing_progress_publication_order_plus_one
+          synchronization: .agentera/.writer.lock
+          dry_run: omitted_without_consuming_or_mutating_order
+          caller_input: forbidden
+          malformed_or_spoofed_input: reject_before_mutation_with_bounded_diagnostics
+          durability: persisted_in_each_new_progress_cycle_entity
+          privacy: bounded_ordinal_without_time_identity_or_content
       retrieval:
         exact: agentera state progress get --id ID --format json
         list: agentera state progress list [--limit N] [--cursor TOKEN] --format json
-        ordering: timestamp_desc_then_id_asc
+        ordering: timestamp_desc_then_publication_order_desc_then_id_asc
+        semantic_recency: >-
+          The first full progress cycle is latest. Timestamp remains the public
+          minute-compatible primary key. Within one timestamp, a valid writer-owned
+          publication_order sorts descending; a marked publication sorts after all
+          unmarked legacy records observed by that publication and therefore before
+          them in newest-first retrieval. Missing markers are legacy unordered ties.
+          Equal valid markers can result from independently published histories and
+          do not establish relative publication order. Missing or equal markers use
+          opaque ID ascending only as a deterministic final fallback and never claim
+          reconstructed publication chronology.
         default_limit: 20
         maximum_limit: 100
         max_utf8_bytes: 32768
-        cursor: opaque_snapshot_cursor
+        cursor: opaque_snapshot_cursor_v2
+        cursor_compatibility: >-
+          Version 2 continuation keys include timestamp, publication_order presence
+          and value, and opaque ID. Version 1 progress cursors are rejected with
+          recovery to omit --cursor and establish a new snapshot; authority changes
+          also invalidate prior cursor signatures by design.
         mutation_after_snapshot: cursor_snapshot_unavailable
         omission: whole_entries_only_with_count_reason_continuation_and_exact_get
         scalar_truncation: forbidden
@@ -285,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
@@ -647,7 +692,7 @@ entity_target:
           detail_availability: summary
           compatibility: degraded
           caveats: required
-          ordering: full_timestamp_desc_then_id_asc_then_summary_id_asc
+          ordering: full_timestamp_desc_then_publication_order_desc_then_id_asc_then_summary_id_asc
           summary_ordering: canonical_id_asc_without_chronology_claim
           mutation: read_only
       - boundary: decision_summary
@@ -733,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:
@@ -771,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
@@ -1272,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
@@ -1638,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
@@ -1674,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
@@ -1725,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
@@ -1749,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
@@ -1764,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
@@ -1814,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
@@ -1842,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: >-
@@ -1858,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:
@@ -1877,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
@@ -1899,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
@@ -1920,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
@@ -1942,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

package/bundle/references/cli/audience-namespace-cli-migration.yaml

@@ -160,12 +160,23 @@ audience_namespaces:
           [--project-root PATH] [--format text|json]
         delegates_from: stats refresh
         behavior: Matches today's `agentera stats refresh` including consent gates.
+      profile_glossary:
+        canonical_shape: >-
+          agentera report profile-glossary --input <file|-> [--dry-run]
+          --format json
+        delegates_from: null
+        behavior: >-
+          Applies one versioned personal glossary update request to the exact
+          PROFILE.md path supplied by Profile Full. Runs headlessly without a
+          project checkout; never discovers or reads project state or a project
+          glossary. Dry-run validates and computes the candidate without a write.
     legacy_top_level_alias: stats
     rejected_top_level: corpus
     notes: >-
       `agentera usage` and `agentera usage` remain backward-compatible
       maintainer seams per AGENTS.md until separately classified; public user-facing
-      analytics consolidate under `report`.
+      analytics and Profile's bounded personal-output implementation consolidate
+      under `report`.
   check:
     audience: [maintainer]
     status: target_canonical_namespace

package/bundle/references/cli/prime-consumer-compatibility.yaml

@@ -235,7 +235,13 @@ field_classification:
       recommendation is active.
   - field: attention
     status: required
-    rationale: Bounded; opencode and status dashboard consume it.
+    rationale: >-
+      Bounded; opencode and status dashboard consume it. Valid current glossary
+      caveats add at most one generic review item through the glossary authority's
+      declared prime projection. When current, its one reserved final slot leaves
+      the first five unrelated items in their existing order under the six-item
+      public cap; lifecycle identity and private semantics remain internal, and
+      next_action is unchanged.
   - field: history
     status: diagnostic
     rationale: >-