mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-09-23 11:46:28 +00:00
rcourtman
9905383f70
Follow-up to the report narrative refactor: ai-runtime.md gains a Current State paragraph documenting that internal/ai.Service now implements pkg/reporting.Narrator and pkg/reporting.FindingsProvider, and that the narrator/findings surfaces inherit the same provider, sanitizer, model selection, budget enforcement, and fail-closed governance as the rest of the canonical AI runtime. api-contracts.md gains a paragraph documenting the new optional Narrator and FindingsProvider fields on MetricReportRequest, the new Narrative, PriorPeriod, and Findings fields on ReportData, the three new PDF sections (executive prose, Period-over-period changes, AI provenance footer), and the explicit invariant that the deterministic data surface (charts, stats, alerts, storage, disks) stays rendered from the same aggregates so every AI claim is verifiable against adjacent data. Multi-resource fleet reports intentionally remain heuristic-only at this transport layer. The dependent subsystems flagged by the staged-shape guard (agent-lifecycle, performance-and-scalability, storage-recovery) genuinely have no contract delta from the prior commit: their Extension Points reference internal/api/ broadly, but agent lifecycle, performance scaling, and storage recovery semantics are unchanged.