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

@@ -6,61 +6,33 @@ Accepted
## Date ## Date
2026-10-05 2026-11-19
## Context ## Context
Narratio uses ConfigKit to assemble typed configuration. Earlier integration Configuration loading, inspection, and domain execution need explicit ownership
code added source-authoring acceptance checks and cached field ownership. so that effective configuration has one authority.
ConfigKit's native composition, inheritance, presence, and provenance APIs now
provide the information needed for loading and operator inspection.
The ConfigKit adoption establishes a responsibility boundary around the
effective configuration. This record captures the rationale for that boundary.
The [architecture policy](../policy/architecture.md#configuration) owns the
normative requirements, and the [configuration reference](../config.md) owns
the operator-facing contract.
## Decision ## Decision
Narratio receives a final configuration from ConfigKit. ConfigKit owns the - **ConfigKit owns configuration policy and resolution through the final
process of resolving the configuration prior to that handoff. Narratio owns handoff.** Narratio supplies its schema, defaults, and configuration rules
domain validation and application use of the configuration after that handoff. through ConfigKit's supported extension points. The completed ConfigKit
result is authoritative.
ConfigKit owns input loading, source composition, sibling inheritance, presence - **Narratio owns domain interpretation and execution.** It consumes the
tracking, typed secret resolution, and native provenance. completed configuration without mutation and produces separate domain
objects. It must not construct a replacement effective configuration.
Narratio owns configuration-domain meaning, application-specific defaults and - **CommandKit owns CLI mechanics and presentation; `ckconfig` exposes
derivation, path resolution, and fail-fast validation of effective domain values. ConfigKit's inspection features.** Narratio supplies selection and acquisition
Narratio expresses these operations through ConfigKit's supported callbacks and wiring and exposes those features through native adapters, without altering
the application resolution steps appropriate to its schema. their semantics or substituting its own inspection views.
Narratio uses ConfigKit's public presence and metadata APIs as intended.
Operator inspection exposes native sources, effective origins, and historical
definition evidence. Narratio adds the derivation context for generated
artifacts and campaign-owned party data.
Structural acceptance follows ConfigKit's loading rules. Domain acceptance
follows Narratio's validation of the effective configuration. Contributor count
and source history serve operator inspection.
## Alternatives Considered ## Alternatives Considered
- Retain Narratio-owned source-authoring checks and cached provenance. This Post-handoff configuration resolution and custom inspection projections are
preserves the earlier implementation but creates overlapping responsibilities rejected because they create competing configuration authorities.
and additional maintenance when ConfigKit's composition features evolve.
- Consume typed configuration alone. This produces a smaller integration but
discards useful presence information and native provenance needed for
defaults and operator inspection.
## Consequences ## Consequences
ConfigKit upgrades carry responsibility for structural configuration semantics. Domain catalogs and plans remain separate from native configuration inspection.
Narratio integration tests cover effective domain outcomes, presence-sensitive Missing configuration or inspection capabilities are addressed upstream.
defaults, safe credential projections, and useful operator inspection.
Composite definitions can have several contributors. Inspection presents that
evidence alongside Narratio's generated-artifact context.
Configuration assembly and provenance have one library owner. Narratio's
integration remains focused on application meaning and runtime preparation.

View File

@@ -2,7 +2,7 @@
**Base Policy Version:** 1.3 **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 **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 - Notarius extracts validated structured artifact bundles; and
- Scriptorium executes prompts and produces configured artifacts. - 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, artifact and path modeling, manifest persistence, stage sequencing, resume,
restore, cleanup gates, and publish semantics. External contracts are defined restore, cleanup gates, and publish semantics. External contracts are defined
in the [integration documentation](../integrations/). in the [integration documentation](../integrations/).
@@ -73,7 +73,7 @@ itself an architectural goal.
## Ownership And Dependency Direction ## 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 production composition, session locking, and top-level lifecycle. It may depend
on concrete implementations to assemble a run. on concrete implementations to assemble a run.
@@ -172,10 +172,19 @@ or other non-regular conflict into a successful restore.
## Configuration ## Configuration
Configuration is strict, explicit, centralized, and operator-oriented. ConfigKit Configuration ownership follows
owns input loading, assembly, sibling inheritance, presence tracking, typed [ADR 0003](../adr/0003-assign-configuration-ownership.md):
secrets, and provenance. Narratio owns configuration-domain meaning and
fail-fast validation of the effective configuration. - 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. - YAML decoding rejects unknown fields.
- Defaults are centralized and testable. - 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. values remain present and are evaluated by Narratio's domain rules.
- Validation rejects invalid configuration before stage execution where - Validation rejects invalid configuration before stage execution where
practical. practical.
- Local document imports and one selected pipeline overlay resolve through - ConfigKit resolves local imports and the selected pipeline overlay.
the configuration owner; commands do not implement their own merge rules. - Canonical party rosters are campaign-owned inputs. Narratio derives players
- Native ConfigKit metadata and supported resolution callbacks provide presence, projections and concrete character-family artifacts as separate domain
inheritance, and provenance information without a parallel loading or objects before execution, without modifying configuration.
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.
- Resume uses stage- or artifact-owned semantic evidence for observable - Resume uses stage- or artifact-owned semantic evidence for observable
result-affecting configuration; overlay identity and an effective digest are result-affecting configuration; overlay identity and an effective digest are
provenance, never blanket cache keys. provenance, never blanket cache keys.

View File

@@ -558,9 +558,9 @@ checks and detailed implementation sequencing remain preparation work for the
roadmap and subsequent plan. Release version selection remains deferred to roadmap and subsequent plan. Release version selection remains deferred to
release preparation. release preparation.
The next discussion is whether and how to crystallize the agreed configuration The configuration ownership boundary is recorded in
ownership boundary in an ADR. The boundary is settled; an ADR has not yet been [ADR 0003](../adr/0003-assign-configuration-ownership.md). Roadmap consolidation
prepared. is the next planning step.
## Discussion and decision record ## Discussion and decision record