Update documentation for the new analyze stage and artifact registry

docs/examples/pipeline.full.annotated.yml

@@ -2,8 +2,8 @@
 # Values are safe placeholders and must be adapted per environment.
 
 workspace:
-  # Required: local workspace root.
-  root: ./tmp/narratio-workspace
+  # Optional: defaults to /var/lib/narratio.
+  root: /var/lib/narratio/workspace
   # Optional: remove run-scoped workdir after successful archive commit.
   cleanup_after_archive: false
 
@@ -14,7 +14,7 @@ workspace:
 storage:
   # Optional storage backend selector; use "s3" for archive + S3 audio workflows.
   backend: s3
-  # Legacy fields retained in schema for compatibility.
+  # Compatibility fields retained in schema.
   bucket: ""
   prefix: ""
   s3:
@@ -40,7 +40,7 @@ archive:
   # Optional booleans; defaults are true.
   enabled: true
   upload_run: true
-  # Optional promotions; defaults shown explicitly.
+  # Optional promotion rules; required files fail archive if missing.
   promote_artifacts:
     - from: transcripts/trimmed.json
       to: transcripts/trimmed.json
@@ -48,6 +48,9 @@ archive:
     - from: artifacts/session_recap.md
       to: artifacts/session_recap.md
       required: true
+    - from: artifacts/player_handout.md
+      to: artifacts/player_handout.md
+      required: false
 
 whisperx:
   # Required.
@@ -118,6 +121,7 @@ scriptorium:
   timeout: 10m
   render_debug: false
   artifacts:
+    # Configured artifact keys map to source IDs narratio.artifact.<key>.
     session_recap:
       enabled: true
       prompt_id: dnd.session_recap
@@ -140,6 +144,29 @@ scriptorium:
         previous_session_id: true
         output_kind: session_recap
 
+    # Example dependent artifact:
+    # - depends_on entries use artifact keys.
+    # - narratio.artifact.<key> sources require matching depends_on membership.
+    player_handout:
+      enabled: true
+      depends_on:
+        - session_recap
+      prompt_id: dnd.player_handout
+      profile_id: local-fast
+      output_path: artifacts/player_handout.md
+      timeout: 10m
+      inputs:
+        recap:
+          source: narratio.artifact.session_recap
+          required: true
+        transcript:
+          source: narratio.transcript.trimmed
+          required: true
+      vars:
+        session_id: true
+        campaign_name: true
+        output_kind: player_handout
+
 analyzer:
   # Optional adapter settings.
   binary_path: ""

docs/examples/pipeline.production.yml

@@ -25,6 +25,9 @@ archive:
     - from: artifacts/session_recap.md
       to: artifacts/session_recap.md
       required: true
+    - from: artifacts/player_handout.md
+      to: artifacts/player_handout.md
+      required: false
 
 whisperx:
   transcribe_url: "https://transcription.example.com/transcribe"
@@ -87,6 +90,24 @@ scriptorium:
         campaign_name: true
         previous_session_id: true
         output_kind: session_recap
+    player_handout:
+      enabled: true
+      depends_on:
+        - session_recap
+      prompt_id: dnd.player_handout
+      profile_id: local-fast
+      output_path: artifacts/player_handout.md
+      timeout: 10m
+      inputs:
+        recap:
+          source: narratio.artifact.session_recap
+          required: true
+        transcript:
+          source: narratio.transcript.trimmed
+          required: true
+      vars:
+        session_id: true
+        output_kind: player_handout
 
 analyzer:
   timeout: 2m