Centralize atomic artifact writes

docs/internal/scriptorium-adapter.md

@@ -48,8 +48,8 @@ CLI contract used by this project.
 
 ## State Or Manifest Behavior
 
-`SaveRenderResult` can write render results atomically. The app and state store
-own managed preflight paths and metadata links.
+None directly. The adapter returns render and run results; app orchestration and
+state own managed preflight paths and metadata links.
 
 ## Skip And Resume Behavior
 

docs/internal/state.md

@@ -15,7 +15,7 @@ Inputs:
 - resolved report definition and valid period
 - briefing package
 - prompt input data package
-- Scriptorium render result
+- preflight artifact
 - rendered report path preparation request
 - RunID for inspection lookups
 
@@ -35,7 +35,8 @@ Outputs:
 - This package owns managed workspace layout, path validation, filesystem
   writes, and metadata reads.
 - It does not fetch weather data, derive forecasts, build prompt input content,
-  compare briefing contents, invoke Scriptorium, or parse CLI flags.
+  compare briefing contents, invoke Scriptorium, import adapter result types, or
+  parse CLI flags.
 
 ## Config Fields Used
 

docs/policy/development.md

@@ -12,6 +12,7 @@ Developers and LLM coding agents should use it with
 - `internal/cli`: command parsing, flag handling, help text, and JSON output.
 - `internal/config`: configuration structs, defaults, loading, overrides, and
   validation.
+- `internal/fileutil`: shared atomic filesystem write and copy helpers.
 - `internal/adapters/weatherapi`: Weather API HTTP adapter.
 - `internal/adapters/scriptorium`: Scriptorium subprocess adapter.
 - `internal/forecast`: normalized bundle types and deterministic forecast