[M6-10] Qualify operations and diagnostics

[vicotrbb]

Release 1 source: #1. The master specification is referenced, not modified by this ticket.

Execution signal: ready-for-agent means this issue is implementation-ready once every native GitHub blocker below is closed.

Outcome

Execute exact-candidate health derivation, operational telemetry bounds, labels, dashboards, alerts, runbooks, self-export guard, online/offline/degraded/fenced/key-unavailable Doctor, Support Bundle encrypted/plaintext modes, planted-canary exclusion, pseudonymization, bounds, manifest/signature status, and Crash Record cells.

Scope and semantic ownership

• Milestone: M6
• Global sequence: 143 / 149
• Semantic owner: Diagnostics and Operations
• Highest useful behavior seam: Qualify operations and diagnostics
• Affected registered scopes: positron-runtime, positron-diagnostics, positron-kernel maintenance/integrity/time modules
• Expected project size / estimate: XL / 13
• Completion status rule: An exact cell may become Qualified only when the frozen candidate passes the complete real-target gate and immutable evidence is retained. Any failed, missing, stale, unsupported, inconclusive, or exceptional required cell remains release-blocking.

No weaker document, implementation convenience, partial target, emulator, local diagnostic, or green subset may reinterpret the binding contract.

Native blockers

• [M6-01] Freeze the exact Release Candidate #135 — M6-01

The native blocked-by graph is authoritative for execution order. Do not start implementation while a blocker is open, while an affected scope remains unlawfully scaffold-only, or while a required decision/review is missing.

Binding product and architecture references

• Frozen Positron product contract
• Binding domain language
• Release 1 qualification and M6 milestone contract
• Whole-application module and flow design
• Project contract §3.5 Operational Observability
• Project contract §3.9 Integrity Verification and Corruption Response
• Project contract §3.10 Time and Clock Safety
• Project contract §3.18 Process Lifecycle and Graceful Shutdown
• Project contract §3.22 Maintenance Coordination
• Project contract §3.23 Diagnostics, Offline Inspection, and Support Bundles
• Project contract §3.25 Release 1 Scope and Qualification
• Application Design §4.11 Maintenance Coordinator
• Application Design §4.11 Lifecycle Clock
• Application Design §4.11 Integrity
• Application Design §4.15 Operational State
• Application Design §4.16 Diagnostics
• Application Design §6.5 Maintenance and compaction
• Application Design §6.8 Drain and shutdown
• Application Design §10.1 Module contract tests

Accepted ADRs

• ADR-0054 — ship bounded operational telemetry without a metrics store
• ADR-0056 — govern all work with hierarchical reservations and protected recovery capacity
• ADR-0058 — verify continuously quarantine local damage and fence ambiguous integrity
• ADR-0059 — separate source query ingest and lifecycle time
• ADR-0067 — use one process lifecycle for readiness drain and shutdown
• ADR-0070 — separate control operations and data listeners with bounded admission
• ADR-0071 — coordinate all background work through one bounded maintenance scheduler
• ADR-0072 — make diagnostics bounded read only and secret safe
• ADR-0074 — freeze release 1 through an evidence backed qualification matrix

If implementation would change caller knowledge, semantic ownership, a public or durable format, compatibility, a non-waivable invariant, or Release 1 scope, stop and land the required accepted superseding ADR together with its contract, migration, tests, and gates.

Engineering invariants and gates

• Mandatory engineering invariants: ARC-02, ARC-05, SAFE-04, CON-01, CON-02, CON-03, CON-05, ERR-03, ERR-04, SEC-01, SEC-04, TEST-01, TEST-02, TEST-04, TEST-05, TEST-07, PERF-01, PERF-04
• Authoritative gates: EG-00, EG-ARCH, EG-BUILD, EG-DEPS, EG-DOCS, EG-ERROR, EG-EVIDENCE, EG-POLICY, EG-RUST, EG-SAFETY, EG-SECRETS, EG-SUPPLY, EG-TEST, EG-CONCURRENCY, EG-CORRECT, EG-DYNAMIC, EG-FAULT, EG-INTEGRITY, EG-MATRIX, EG-RESOURCE, EG-SECURITY, EG-SOAK
• Canonical runner: cargo xtask quality
• Policy sources: Engineering standards, Quality gates, Contribution and activation policy, Application scope registry, Artifact scope registry, Allowed dependency graph

Do not weaken, skip, rename, path-filter, delete, reclassify, or silently bypass a gate, target, threshold, owner, test, corpus, fixture, hook, workflow, or evidence field.

Affected Qualification Cells

• Q-INTEGRITY-001
• Q-TIME-001
• Q-MAINT-001
• Q-PROCESS-001
• Q-DIAG-001
• Q-DIAG-002
• Q-OPS-001

Each cell remains independently reportable. A passing child cannot hide a failed, unsupported, missing, unresolved, or inconclusive sibling.

Required implementation contract

• Deliver the outcome exactly as stated above, through the named semantic owner and highest useful behavior seam.
• Keep health, process phase, clock safety, maintenance, integrity, diagnostics, and telemetry ownership explicit and non-duplicated.
• Bound telemetry labels, diagnostics work, support-bundle content, maintenance tasks, retries, and temporary state.
• Never return corrupt data or mutate state through Doctor; ambiguity fences or degrades explicitly.
• Exclude secrets and tenant telemetry through allowlists, planted canaries, pseudonymization, and Redaction Reports.
• If any affected code or artifact scope is still scaffold, activate it atomically with its owner, exact edges, risk gates, test commands, measured coverage/mutation baselines, and required threat model or format/API decision before adding behavior.
• Preserve the registered acyclic dependency graph and keep provider/protocol/distribution types behind their adapters.
• Return closed typed outcomes with safe details, retry class, completion state, and source context. Never use strings for control flow.
• Declare every externally reachable input, work, memory, allocation, copy, I/O, task, queue, cache, lease, retry, and latency bound plus overload behavior.
• Add no dependency without the complete review required by CONTRIBUTING.md.
• Keep generated output generated and prove clean deterministic regeneration.
• Update user/operator compatibility, migration, failure, recovery, and release-note documentation where behavior is visible.

Required tests

• Clock movement, restart regression, maintenance conflicts, pauses, checkpoints, crashes, orphan handling, eventual progress, and bounded interference.
• Integrity startup/online/offline verify, scrub, quarantine, abandonment, degraded, fenced, and key-unavailable cases.
• Doctor read-only assertions plus support-bundle/crash-record canary, bounds, encryption, signature, and truncation tests.
• Include positive, boundary, negative, and adversarial cases at the lowest interface that proves the contract.
• Assert returned outcomes, durable externally readable state, published artifacts, or public behavior—not private fields, helper calls, queue layout, or incidental ordering.
• Keep tests hermetic, deterministic, parallel-safe, bounded, and retain seeds, clocks, entropy, schedules, fault plans, fixtures, and minimized failures.
• A reproducible defect fix begins with a failing regression test and retains the reproducer.
• Run all scope-selected unit, compile-fail, contract, property, integration, end-to-end, compatibility, platform, real-target, fuzz, model, fault, sanitizer, and soak suites that apply.

Evidence and completion

• Run the authoritative cargo xtask quality profile required by the change and retain its exact revision-bound evidence.
• Record exact source revision, artifact digests, target/environment, configuration, fixtures, dataset/workload, fault schedule, toolchain, command, duration, raw measurements, safe logs/metrics, result, owner, and verifier as applicable.
• Retain passing, failing, inconclusive, exceptional, timeout, cancellation, and missing-tool attempts. A later pass must not erase a failure.
• Verify no panic/unwrap/expect, unchecked indexing, ignored result, detached task, unbounded resource, ambient authority, prohibited unsafe code, secret leak, or hidden best-effort path was introduced.
• Verify the working tree and generated artifacts are clean after the authoritative runner.
• Do not close this issue from an ad hoc command, mock-only proof, emulator-only proof, local dirty evidence, or partial Qualification Cell.

Explicit non-goals

• No Metric Signal Store, automatic repair of ambiguous state, hidden best effort, or diagnostic mutation.
• No high-cardinality or self-recursive operational telemetry.
• No Release 1 Metrics or Profiles implementation.
• No replication, consensus, HA, automatic failover, follower reads, clustering, or live shard split/merge.
• No hidden feature flags, placeholder APIs, empty adapters, speculative modules, or disabled deferred behavior.

Agent handoff checklist

• Re-read the referenced contracts and ADRs before changing code.
• Identify the exact semantic owner, caller-visible seam, durable publication owner, and affected Qualification Cells in the implementation PR.
• Explain the lifecycle and failure boundaries before editing.
• Keep implementation, qualification, publication, deployment, and release as separate states and authorizations.
• Leave an evidence-backed status if blocked; never fabricate Implemented, Qualified, or merge eligibility.