Purpose and scope#
Teach operators, release owners and assistant-product engineers the exact
degraded-mode contract for every dependency in Eve's operational map. This
package covers source unit cdd6397dbcf8d63ead496a75, exact lines 30–43 of
V1/docs/eve/operations-observability-and-maintenance.md, in
eve-operations-detail. It adds eve-detail-dependency-access-reasoning,
eve-detail-dependency-evidence-effects and
eve-detail-dependency-surfaces-signals. The health-signal inventory, release
procedure and related-document navigation remain separate source units.
Baseline and dependencies#
- Integrated implementation baseline:
336013f511c0b4dcebfe47b50f2002b4f0f62798. - Inventory/source revision:
1ceae52c7896a59ac74a4429d410f3218f0b91c6. - Source file SHA-256:
37e2944ae765de1819a9d4801b58aa3f8a75f6795147b89e2c4694bfc704f6d4. - Unit SHA-256:
acb8c04fa9882caad1c9bcfc2babd30c5141494ccda47ca4d6aa22d1dc6f4cc8. - Prerequisite guide:
eve-operations; the three operating-state pages explain how dependency failures select and leave degraded postures.
The pinned file and current working copy are byte-identical. This package teaches the documented dependency contract. It does not infer live dependency health, current provider settings, executed failover or measured alerting.
Source review#
The unit is a nine-row table. Each row names a dependency, its operating concern and its required degraded behavior. The contract spans identity and tenant scope; model routing; Iris memory; Sophia/docs retrieval; tool services; conversation persistence; workbench/MCP state; voice/browser media; and telemetry/evaluation. The required behaviors differ: denial or public reduction, bounded fallback, memory-posture disclosure, unsupported-output labeling, typed tool failure, duplicate-safe continuity, mutation refusal or safe queueing, text-first operation and alerting on blind operation.
The table's cells are normative pairs. For example, text-first service applies to voice/browser degradation, while telemetry blindness permits a safe response by default but requires an alert. Moving those behaviors between rows would change the contract even if all phrases remained visible.
Deliverables#
- Three canonical field-guide slides in
content/55-eve-operations-detail.json. - Ordered membership after the state contract and before the existing end-to-end dependency-health synthesis.
- One reviewed assignment containing all three assembled slide fingerprints.
- Updated learning map, coverage ledger, TODO status and generated catalog, HTML, guide maps, narration, PDF and coverage artifacts.
- Exact source, table, sequence and count regressions plus a dated verification receipt with desktop, compact, mobile, PDF and actual-audio evidence.
Design and story#
The nine-row table is split into three consecutive evidence-comparison pages
so every source cell remains readable. The first groups access, reasoning and
memory. The second groups evidence, effects and conversation continuity. The
third groups governed work, voice and operating visibility. Each page repeats
the source column headings and keeps the source row order. No row is emphasized;
the grouping supports reading without ranking the dependencies.
The guide first establishes state classification and reconciliation, then teaches the exact dependency-specific degraded behaviors. The existing dependency-health page follows as synthesis: it asks readers to prove the end-to-end promise rather than counting one repaired dependency as recovery.
Acceptance#
- The visible compositions contain all nine exact dependency, concern and required-behavior triplets in source order and attach no behavior to another dependency.
- All three slides cite
Operational dependency map, usedesignEdition: field-guide, omit redundant mastheads and retain three substantive notes and questions. - The assignment validates at the exact inventory revision and moves only this source from six reviewed/four open to seven reviewed/three open.
- Static and playing desktop/compact/mobile layouts, Explain/source access, accessibility, tagged PDF pages and actual narration playback pass.
Verification and recovery#
Run focused assignment/composition tests while authoring, then the affected guide and center browser suites, PDF checks, full presentation Python and Node suites, builder freshness, coverage, inventory freshness and narration integrity. Run costly gates serially after the repository resource checks.
Generated files are rebuilt only through the canonical builder, narration
renderer and browser PDF exporter. Stop the owned process group if the host
crosses the memory thresholds in AGENTS.md; preserve logs and resume with the
focused command. If source or assembled slide hashes change, leave the
assignment stale until the explanation and evidence are reviewed again.
Closeout#
Status: the source review, three-slide sequence, exact hash-bound assignment, generated artifacts, narration and automated desktop/compact/mobile/PDF review are complete. The dated verification receipt records all final evidence and the remaining limits. The next source unit is the complete health and service-level signal inventory.