eric/narratio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 27 Wiki Activity

Complete remote publication workstream

Browse Source
This commit is contained in:
Eric Rakestraw
2026-09-05 13:24:54 +00:00
parent 7e78c22fec
commit 470450e509
4 changed files with 15 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
docs/operations.md
View File

@@ -405,6 +405,11 @@ Each mutable lock is an independent strict JSON object at
from the exact canonical source. Listing validates every object in that from the exact canonical source. Listing validates every object in that
reserved prefix and reports locks sorted by source. reserved prefix and reports locks sorted by source.
Upgrades do not read, migrate, or delete the retired `{session_prefix}/locks.yml`
object. It has no effect on publication and may be removed manually after
verifying lock commands and publication behavior with the upgraded Narratio
version. No migration command is required.
Operational rules: Operational rules:
- add uses conditional creation and reports an existing lock; - add uses conditional creation and reports an existing lock;

10
docs/policy/architecture.md
View File

@@ -202,9 +202,13 @@ the immutable commit manifest, and finally the current commit pointer.
`current/commit-pointer.json` is the sole mutable selector and must be written `current/commit-pointer.json` is the sole mutable selector and must be written
exactly once, last. Failed, incomplete, skipped, or uncommitted publish attempts exactly once, last. Failed, incomplete, skipped, or uncommitted publish attempts
must not be presented as current remote state. Publish locks remain authoritative must not be presented as current remote state. Publish locks remain authoritative
and are not bypassed by a forced run. Mutable remote locks use provider-enforced and are not bypassed by a forced run. Each mutable remote lock is an independent
generation preconditions and are revalidated immediately before pointer per-source object; lock mutations use provider-enforced generation preconditions.
selection; loss of that check leaves the prior committed snapshot current. Publish revalidates every initially unlocked participating source after writing
the immutable commit and before pointer selection. A lock observed then leaves
the prior committed snapshot current. A lock created after that final check may
race the pointer write; the commit protocol does not claim a stronger distributed
transaction boundary.
Automatic local cleanup is permitted only after a successful publish commit, Automatic local cleanup is permitted only after a successful publish commit,
only when explicitly configured, and only through the path-safety guardrails. only when explicitly configured, and only through the path-safety guardrails.

4
docs/roadmap/implementation.md
View File

@@ -2,7 +2,7 @@
## Status ## Status
Planned implementation for Workstream 8, **Remote publication, per-artifact Completed implementation for Workstream 8, **Remote publication, per-artifact
locks, and publish decomposition**, in [`refactoring.md`](refactoring.md). locks, and publish decomposition**, in [`refactoring.md`](refactoring.md).
Workstreams 1 through 7 are complete prerequisites. This plan does not enter Workstreams 1 through 7 are complete prerequisites. This plan does not enter
Workstream 9's cleanup-stage work. Workstream 9's cleanup-stage work.
@@ -351,7 +351,7 @@ Independent objects are the sole lock authority.
## Stage 10 — Align Documentation And Close The Workstream ## Stage 10 — Align Documentation And Close The Workstream
**Status:** Pending **Status:** Completed
### Goal ### Goal

2
docs/roadmap/refactoring.md
View File

@@ -363,7 +363,7 @@ without treating private ordering or wording as compatibility behavior.
### Workstream 8 — Remote publication, per-artifact locks, and publish decomposition ### Workstream 8 — Remote publication, per-artifact locks, and publish decomposition
**Status:** Pending **Status:** Complete
**Audit sources:** H04, H15, H18, H44, and C05. **Audit sources:** H04, H15, H18, H44, and C05.