Align configuration ownership policy with ADR 0003
All checks were successful
ci/woodpecker/push/verify Pipeline was successful
All checks were successful
ci/woodpecker/push/verify Pipeline was successful
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user