Reconcile lifecycle documentation

2026-08-10 23:18:29 +00:00
parent feba7b9d74
commit 801adb385d
9 changed files with 137 additions and 19 deletions
--- a/docs/internal/stage-render.md
+++ b/docs/internal/stage-render.md
@@ -20,7 +20,9 @@ Render Markdown transcript artifacts from normalized JSON transcripts via Seriat
 - resolves inputs manifest-first, then canonical fallback.
 - writes run-local outputs first, then materializes canonical session outputs.
 - records input provenance, output paths, adapter metadata, logs, and generated config refs.
- skips with stage metadata when `pipeline.render.enabled=false`.
+- when `pipeline.render.enabled=false`, completes successfully with no outputs
+  and records explanatory metadata. This is not an explicit self-skip: both
+  manifests record success, and enabling render later requires a forced run.

 ## Failure Semantics