Rewrite docs for the publish stage contract and current behavior

docs/internal/workspace.md

@@ -1,7 +1,7 @@
 # Workspace internals
 
 ## Purpose
-Define the local durable and run-local workspace model used by stages, manifests, resume, and archive.
+Define the local durable and run-local workspace model used by stages, manifests, resume, and publish.
 
 ## Inputs and Outputs
 Inputs:
@@ -24,14 +24,14 @@ Owns:
 
 Does not own:
 - Stage business logic
-- Remote archive semantics (documented in `stage-archive.md`)
+- Remote publish semantics (documented in `stage-publish.md`)
 - CLI argument parsing
 
 ## Config Fields Used
 - `pipeline.workspace.root`
-- `pipeline.workspace.cleanup_after_archive`
+- `pipeline.workspace.cleanup_after_publish`
 - `pipeline.spool.root`
-- `pipeline.spool.delete_audio_after_archive`
+- `pipeline.spool.delete_audio_after_publish`
 - `pipeline.cache.root`
 - `pipeline.cache.s3_audio`
 - `session.campaign`
@@ -43,10 +43,10 @@ None directly in this subsystem. Stages may use object storage adapters and then
 ## State and Manifest Behavior
 - Session state is persisted in the session manifest (`manifest.Manifest`).
 - Invocation history is persisted per run in run manifests under `runs/{run_id}/manifest.json`.
-- During each run, stage outputs are often written run-local first (`runs/{run_id}/{stage}/outputs/...`) and promoted to canonical session paths after stage success.
+- During each run, stage outputs are often written run-local first (`runs/{run_id}/{stage}/outputs/...`) and then materialized to canonical session paths after stage success.
 - `manifest.Artifacts` entries record `ProducerRunID` for durable outputs.
 - For S3 audio sessions, `prepare` records work/cache paths, S3 provenance, and spool path when the invocation downloaded the object.
-- `previous/**` is reconstructed from configured previous-session requirements; restore uses the previous session's committed current archive rather than treating current-session archived `previous/**` as authoritative.
+- `previous/**` is reconstructed from configured previous-session requirements; restore uses the previous session's committed current publish state rather than treating current-session stored `previous/**` as authoritative.
 - Durable cache state under `pipeline.cache.root` is not workspace state and is preserved by default by `narratio clean`.
 - `narratio clean <id>` removes the session work root and session spool root.
 - `narratio clean --all` removes all local session work under `workspace.root/work` and spool children under `spool.root`.
@@ -60,7 +60,7 @@ None directly in this subsystem. Stages may use object storage adapters and then
 ## Failure Behavior
 - Failures preserve manifests and run-local files for inspection.
 - Lock conflicts fail fast via `ErrLockConflict`.
-- Cleanup can fail post-archive; failure is recorded in archive stage metadata and returned by the run.
+- Cleanup can fail post-publish; failure is recorded in publish stage metadata and returned by the run.
 
 ## Tests to Inspect Before Changing
 - `internal/artifacts/local_test.go`
@@ -72,7 +72,7 @@ None directly in this subsystem. Stages may use object storage adapters and then
 ## Architectural Invariants
 - Session root is campaign-aware: `{workspace.root}/work/{campaign}/{session_id}`.
 - Run roots are always nested: `runs/{run_id}` under the session root.
-- Run-local output promotion must end in canonical session paths.
+- Run-local output materialization must end in canonical session paths.
 - `previous/**` is session-durable state and must not be treated as run-local output scratch state.
-- Automatic post-archive cleanup only targets run-scoped directories and must never delete configured root directories.
+- Automatic post-publish cleanup only targets run-scoped directories and must never delete configured root directories.
 - Manual `clean` may delete session-scoped directories or the `workspace.root/work` directory, but it must preserve configured root directories and reject unsafe targets.