Record native operator interface ownership and align documentation
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
|
||||
|
||||
@@ -53,23 +53,27 @@ Scriptorium consumes
|
||||
[PromptKit v0.23.3](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/804a4d32b23aa2e7973400bb0a322a7016574c9f/docs/consumers/pkg-promptkit.md)
|
||||
through its supported public root package. Promptkit owns prompt execution,
|
||||
preparation, prompt and profile formats, built-in profiles, model-client
|
||||
behavior, validation, and framework defaults. Scriptorium owns application
|
||||
configuration, executable CLI and HTTP adapters, prepared-run and
|
||||
definition-inspection presentation, captured-configuration inspection
|
||||
exposure, process behavior, and HTTP deployment policy. The [format
|
||||
behavior, validation, inspection semantics, and framework defaults. Scriptorium
|
||||
owns the application domain, executable CLI and HTTP adapters, process behavior,
|
||||
and HTTP deployment policy. It interprets resolved configuration and uses
|
||||
PromptKit's supported APIs and results to satisfy user requests. The [format
|
||||
reference](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/804a4d32b23aa2e7973400bb0a322a7016574c9f/docs/formats.md)
|
||||
and [outbound integration contract](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/804a4d32b23aa2e7973400bb0a322a7016574c9f/docs/integrations/openai-compatible-chat.md)
|
||||
remain Promptkit's contracts.
|
||||
|
||||
Scriptorium uses ConfigKit v1.2.1 for strict application YAML decoding,
|
||||
resolution, and validation flow. Scriptorium retains its application schema,
|
||||
defaults, normalization, validation rules, source selection, and CLI override
|
||||
mapping. PromptKit uses the same ConfigKit generation to decode and assemble
|
||||
framework sources under its separate schema and format contract; Scriptorium
|
||||
selects the inputs but does not parse PromptKit definitions. ConfigKit is a
|
||||
loading mechanism, not the owner of either domain schema or HTTP artifact
|
||||
containment. The [configuration contract](../config.md) owns externally
|
||||
observable application behavior, while Promptkit owns framework formats.
|
||||
ConfigKit v1.2.1 owns configuration policy and the lifecycle through the final,
|
||||
fully resolved configuration handoff. Scriptorium supplies application schema
|
||||
and domain callbacks through ConfigKit's supported extension points and consumes
|
||||
the completed result without redefining effective configuration. PromptKit's
|
||||
configuration is also resolved through ConfigKit, with PromptKit supplying its
|
||||
domain schema and rules. The [configuration contract](../config.md) owns
|
||||
externally observable application behavior; PromptKit owns framework formats.
|
||||
|
||||
As decided in [ADR 0006](../adr/0006-adopt-commandkit-native-operator-interfaces.md),
|
||||
Scriptorium adopts CommandKit's native `ckconfig` and `ckprompt` interfaces to
|
||||
neutrally expose upstream features and semantics. The current CLI still uses
|
||||
custom presentation; the [adoption roadmap](../roadmap/commandkit-adoption.md)
|
||||
tracks its replacement. This decision complements ADRs 0004 and 0005.
|
||||
|
||||
The CLI exposes Promptkit's captured framework configuration inspection. Its
|
||||
`show` and `explain` reports use Promptkit's native redaction for classified
|
||||
|
||||
Reference in New Issue
Block a user