Clean up and normalize prompt output modules

docs/internal/briefing.md

@@ -64,13 +64,18 @@ subset of discussion fields.
 `spc_convective_outlooks` uses collected SPC run metadata and derived
 report-period outlooks. It emits `checked: true` for a successfully fetched
 empty run, reports `outlook_count`, and includes prompt-facing outlook fields
-such as risk label, severity rank, valid times, source URL, image URL, and
-whether the outlook contains the configured location. It does not emit GeoJSON
-geometry.
+such as risk label, `period_begins`, `period_ends`, image URL, and whether the
+outlook contains the configured location. It does not emit GeoJSON geometry,
+source URL, expiration time, or severity rank.
+
+Prompt-facing module intervals use friendly local `period_begins` and
+`period_ends` labels. Canonical report metadata, source provenance,
+`issued_at`, `updated_at`, and point-in-time fields remain separate.
 
 `spc_convective_discussion` uses the same derived report-period outlooks and
-discussion records. It is omitted unless at least one retained outlook has
-severity rank `3` or higher and matching discussion text exists.
+discussion records. It is omitted unless at least one retained categorical
+outlook for the same SPC day has severity rank `3` or higher and matching
+discussion text exists.
 
 ## External Adapters Used
 

docs/internal/module.md

@@ -78,14 +78,17 @@ validation.
 - `outlooks`
 
 Each outlook entry may include `day`, `outlook_type`, `label`, `label_text`,
-`severity_rank`, `valid_start`, `valid_end`, `issued_at`, `expires_at`,
-`contains_location`, `source_url`, and `image_url`. It omits GeoJSON geometry.
+`period_begins`, `period_ends`, `issued_at`, `contains_location`, and
+`image_url`. It omits GeoJSON geometry, source URL, expiration time, and
+severity rank.
 
 `spc_convective_discussion` emits a narrative stanza only when a retained
-report-period outlook has severity rank `3` or higher and matching discussion
-text is available. Its output includes `included_because` and `discussions`;
-each discussion may include `day`, `headline`, `summary`, `discussion`, and
-`updated_at`.
+report-period categorical outlook has severity rank `3` or higher and matching
+discussion text is available. Its output includes `included_because` and
+`discussions`; each discussion may include `day`, `period_begins`,
+`period_ends`, `headline`, `summary`, `discussion`, and `updated_at`.
+Discussions are included only for SPC days whose retained categorical outlooks
+meet the severity threshold.
 
 ## Boundaries
 

docs/internal/prompt-input.md

@@ -64,6 +64,9 @@ weather module stanzas under prompt-facing categories. This grouping is a YAML
 presentation concern only: module snapshots remain flat, and loaded
 `promptinput.Package` values expose flat stanza names in `Briefing.Values`.
 Within each category, stanza order follows the module snapshot output order.
+Prompt-facing module intervals use local `period_begins` and `period_ends`
+labels; canonical report metadata and source timestamps remain structured
+timestamps where applicable.
 
 Current categories are: