Align configuration ownership policy with ADR 0003
All checks were successful
ci/woodpecker/push/verify Pipeline was successful

This commit is contained in:
2026-11-20 00:46:06 +00:00
parent 7ee362f1c3
commit 7cc877ea7f
3 changed files with 41 additions and 64 deletions

View File

@@ -2,7 +2,7 @@
**Base Policy Version:** 1.3
**Last Updated**: 2026-11-17
**Last Updated**: 2026-11-19
**Upstream Source**: https://gitea.maximumdirect.net/eric/policy/src/commit/593c9b52273c5c879785ae9e995d21026df467b4/docs/policy/architecture.md
@@ -52,7 +52,7 @@ their domains:
- Notarius extracts validated structured artifact bundles; and
- Scriptorium executes prompts and produces configured artifacts.
Narratio owns orchestration, configuration resolution, session and run state,
Narratio owns orchestration, configuration interpretation, session and run state,
artifact and path modeling, manifest persistence, stage sequencing, resume,
restore, cleanup gates, and publish semantics. External contracts are defined
in the [integration documentation](../integrations/).
@@ -73,7 +73,7 @@ itself an architectural goal.
## Ownership And Dependency Direction
The application boundary owns command dispatch, configuration selection,
The application boundary owns command composition, configuration selection,
production composition, session locking, and top-level lifecycle. It may depend
on concrete implementations to assemble a run.
@@ -172,10 +172,19 @@ or other non-regular conflict into a successful restore.
## Configuration
Configuration is strict, explicit, centralized, and operator-oriented. ConfigKit
owns input loading, assembly, sibling inheritance, presence tracking, typed
secrets, and provenance. Narratio owns configuration-domain meaning and
fail-fast validation of the effective configuration.
Configuration ownership follows
[ADR 0003](../adr/0003-assign-configuration-ownership.md):
- ConfigKit owns configuration policy and resolution through the final handoff.
Narratio supplies its schema, defaults, and configuration rules through
supported extension points. The completed ConfigKit result is authoritative.
- Narratio consumes that result without mutation and derives separate domain
objects. It must not construct a replacement effective configuration.
- CommandKit owns CLI mechanics and presentation; `ckconfig` exposes ConfigKit
inspection. Narratio supplies selection and acquisition wiring through native
adapters without changing upstream semantics or substituting inspection views.
Missing configuration or inspection capabilities are addressed upstream.
- YAML decoding rejects unknown fields.
- Defaults are centralized and testable.
@@ -183,14 +192,10 @@ fail-fast validation of the effective configuration.
values remain present and are evaluated by Narratio's domain rules.
- Validation rejects invalid configuration before stage execution where
practical.
- Local document imports and one selected pipeline overlay resolve through
the configuration owner; commands do not implement their own merge rules.
- Native ConfigKit metadata and supported resolution callbacks provide presence,
inheritance, and provenance information without a parallel loading or
ownership system.
- Canonical party rosters are campaign-owned. Their derived players projection
and concrete character-family artifacts are resolved before runtime stages
or adapters receive configuration.
- ConfigKit resolves local imports and the selected pipeline overlay.
- Canonical party rosters are campaign-owned inputs. Narratio derives players
projections and concrete character-family artifacts as separate domain
objects before execution, without modifying configuration.
- Resume uses stage- or artifact-owned semantic evidence for observable
result-affecting configuration; overlay identity and an effective digest are
provenance, never blanket cache keys.