Reconcile Notarius extraction documentation

docs/troubleshooting.md

@@ -154,6 +154,29 @@ Safe fix:
 
 Relevant reference: [Operations: Extraction Workflow](./operations.md#extraction-workflow).
 
+## Atomic Notarius promotion unsupported
+
+Symptom:
+
+- extraction fails with `atomic no-replace directory promotion is unsupported`
+  before a durable bundle or temporary promotion tree is created.
+
+Likely cause:
+
+- Narratio is running on an operating system other than Linux, macOS, or
+  Windows, where the required atomic no-replace directory primitive has not
+  been implemented and verified.
+
+Safe fix:
+
+- run extraction on Linux, macOS, or Windows. Do not replace the atomic commit
+  with a manual copy or move; the session manifest must never observe a partial
+  or overwritten bundle.
+
+This is an extraction-specific platform boundary, not a support statement for
+unrelated Narratio workflows. See
+[Operations: Extraction Workflow](./operations.md#extraction-workflow).
+
 ## Notarius receipt or index incompatible
 
 Symptom:
@@ -170,8 +193,10 @@ Likely causes:
 Safe fix:
 
 - compare installed Notarius output with the canonical Notarius contracts,
-  align `pipeline.notarius` constraints, and rerun. Do not bypass confinement or
-  schema checks.
+  including receipt `index_file: index.json` and index management names
+  `manifest.json`, `rejected.json`, and `warnings.json`; align
+  `pipeline.notarius` constraints and rerun. Do not bypass confinement or schema
+  checks.
 
 Relevant reference: [Notarius integration](./integrations/notarius.md).