Files
notarius/docs/integrations/pkg-configkit.md

72 lines
4.3 KiB
Markdown

# ConfigKit Integration
Notarius uses `go.maximumdirect.net/configkit` at `v1.4.0` from
[the selected release](https://forge.maximumdirect.net/base-layer/configkit/src/tag/v1.4.0).
[go.mod](../../go.mod) owns the declared version; [attribution](../oss/attribution.md#configkit)
owns notices/source revision. The [tagged consumer guide](https://forge.maximumdirect.net/base-layer/configkit/src/tag/v1.4.0/docs/consumers/README.md)
and [configuration contract](https://forge.maximumdirect.net/base-layer/configkit/src/tag/v1.4.0/docs/config.md)
own native loading, presence, inheritance, inspection, and error semantics.
## One Application-Owned Result
Notarius supplies a typed application document containing native
`promptkit.Settings`, and composes its definition with `promptkit.Configure`.
Application version/default/path/normalization/validation rules and native
resource identity/sensitivity rules participate in the same load.
Production composition selects the main source and calls `configkit.LoadLayered`.
It supplies bundled provider, embedded application, and main-relative operator
underlays before the selected main/import/overlay/explicit override layers.
Native filesystem/destination/source contexts remain attached; the application
does not flatten resources or reimplement source composition.
[Configuration](../config.md#configuration-discovery-and-precedence) owns
Notarius's selected sources/precedence; the upstream
[layered-input guide](https://forge.maximumdirect.net/base-layer/configkit/src/tag/v1.4.0/docs/consumers/README.md#native-filesystem-and-layered-input)
owns the library mechanism.
The successful `*configkit.Result[config.Document]` supplies runtime conversion,
inspection, and `promptkit.NewFromConfig`. That handoff performs no second load,
callback run, or YAML round-trip. Runtime pipeline configuration is independently
owned; the original result retains native resource evidence and contexts.
See [PromptKit integration](pkg-promptkit.md) and the upstream
[component handoff](https://forge.maximumdirect.net/base-layer/configkit/src/tag/v1.4.0/docs/consumers/README.md#component-handoff).
## Inspection And Invocation Selection
CommandKit's [ckconfig integration](pkg-commandkit.md#configuration-scopes)
adapts the original result for whole-application and focused PromptKit views.
Focused presentation does not load another document: whole-load validation and
source/findings context remain, while explicit metadata/explanation paths retain
native application-root coordinates.
The invocation-owned loader retains complete selections, including supplied
overlay/override values, and lazily builds one engine for each retained result.
Distinct comparison sides cannot accidentally reuse the same selection.
This is not process-global persistent configuration caching.
Inspection delegates to native result views, diagnostics, explanations, and diff.
ConfigKit sensitivity and PromptKit's composed sensitivity apply together.
Do not infer that arbitrary application text is safe, or replace marked-secret
omissions with heuristic content scrubbing. Exact syntax/selection behavior
belongs in [Configuration](../config.md) and [CLI Reference](../cli.md#configuration-commands).
## Application Ownership And Verification
Notarius owns application document meaning, source-aware operational paths,
runtime conversion, catalog-dependent pipeline resolution, and physical runtime
initialization. ConfigKit does not parse transcripts, construct pipeline modules,
materialize execution references, or allocate run storage.
[Configuration Internals](../internal/configuration.md) locates those implementations.
[Native settings tests](../../internal/core/config/native_settings_test.go),
[loader tests](../../internal/cli/native_load_test.go), and
[scope/diff tests](../../internal/cli/application_test.go) verify the real selected
libraries, retained origins/settings, frozen inspection, secret handling, and
selection isolation. [Assembled recovery](../../internal/cli/recovery_contract_test.go)
uses that same handoff through actual domain execution.
There is no parallel old-path ConfigKit integration or translation layer.
When upgrading, review the composed definition, original-result and source-context
handoff, focused views, and selected native command integration against the new
public contracts; do not infer compatibility from a successful module download.