aoci_overview
Deliver the complete formal Whole-Index, optionally scoped to all, project, meta, code, or database, and manage chunked continuation until the full cognition context is verified.
Instructions
Deliver the complete formal Whole-Index, optionally scoped to all, project, meta, code, or database in a Volumes v1 repository. An ordinary call returns the exact formal body inline when it fits overview_delivery.chunk_tokens, otherwise it immediately returns Chunk 1 using overview-chunk-receipt/v1. When continuation_required=true, submit the exact next_cursor automatically until completed=true; do not ask the user, start the business task, state a partial conclusion, or replace missing Chunks with scope, aoci_search, or aoci_get_entries. Stop the cognition chain on Host truncation, a missing, duplicate, or reordered Chunk, cursor failure, or Index/configuration change. The formal Entry ordinal is the 1-based position in one canonical sequence: Header, comments, blank lines, Section/Overview/Chunk Marker, Receipt, and Metadata are excluded, and Chunk Receipts and Challenge answers consume that same sequence. After the complete chain, submit host_delivery_confirmation and the existing model-cognition-attestation/v1 once; the Attestation must echo the final Challenge's exact current index_sha256, entry_sequence_sha256, and entry_count, and a prior identity is invalid. One same-response schema-only correction is allowed, but semantic mismatch means fail/uncertain with no Memory, source, Spec, aoci.txt, Search, Get Entries, Scope, or historical-session repair. A failed or partial Attestation disables an unqualified complete-system claim; it does not prohibit honest answers or source-bound investigation and engineering. An ordinal, object identity, Tag, or core F mismatch is strict proof failure, not by itself proof that the model did not understand the system. A Host may set cognition_state_version=cognition-state/v2 to receive an additive read-only projection that separates delivery_verified, model_cognition_usable, strict_attestation_verified, governance_aligned, and current_system_cognition_reliable; omitting it preserves the exact legacy response shape. A complete, host-confirmed, governance-aligned context-compaction refresh consumes its generation even when Attestation is partial or failed, so the Host continues the existing source-bound task without another automatic Overview. Initial failure additionally blocks unbound Root/Meta, Migration, layout-wide, and other system decisions. system_mastery_percent self-assesses the system framework—architecture, responsibilities, strong relationships, stable external contracts, and high-entropy safety and maintenance constraints—not complete source or runtime knowledge. Normally expose only one concise user sentence separating actual Index coverage from framework mastery. check_only=true returns only compact checkpoint facts and never starts a Chunk chain. Dirty or Stale cognition is delivered but unreliable; aoci_maintain remains the governance path, while pending Recovery or an incoherent snapshot fails closed. The body is start marker, exact aoci.txt bytes, and end marker with no generated directory inventory. Legacy no-argument and Volumes scope behavior remain compatible. This does not modify formal cognition or Baseline, but may append a local audit record.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| probe | No | check_only only: request a two-question cognition probe sampled from the current formal Entry sequence; answer from memory to prove retained cognition instead of re-requesting the Whole-Index | |
| scope | No | Optional cognition scope: all, project, meta, code, or database; Volumes v1 defaults to all and Legacy no-argument behavior is unchanged | |
| cursor | No | Exact deterministic Overview continuation cursor returned by the preceding chunk | |
| check_only | No | Return only the compact checkpoint assessment; when false or absent, deliver the complete requested scope if a coherent snapshot is available | |
| probe_answers | No | ||
| scope_covered | No | Whether the current task remains within the cognition scope already established | |
| refresh_reasons | No | Optional host-declared refresh reasons: context_compaction and/or phase_transition; semantic_threshold is machine-derived | |
| refresh_event_id | No | Host event idempotency key required when refresh_reasons are declared | |
| cognition_receipt | No | Optional receipt from a previous complete delivery or checkpoint | |
| stable_checkpoint | No | Whether current edits, formatting, lint, and required tests have reached the nearest stable checkpoint | |
| model_cognition_state | No | Host assessment of current complete cognition: valid, uncertain, or invalid | |
| cognition_state_version | No | Optional additive cognition-state projection version; use cognition-state/v2 to request independent delivery, model-usability, strict-Attestation, governance, and current-system reliability fields; omit it for the exact legacy response shape | |
| host_delivery_confirmation | No | ||
| model_cognition_attestation | No |