Record native operator interface ownership and align documentation

This commit is contained in:
2026-11-20 00:49:27 +00:00
parent 6ed4ac624a
commit bcb1a76e34
4 changed files with 97 additions and 34 deletions

View File

@@ -9,6 +9,10 @@ sequence, incorporating the decisions in the
record. The [Narratio proposal](narratio-feature-request.md) supplies consumer
acceptance scenarios for requirements discovery.
[ADR 0006](../adr/0006-adopt-commandkit-native-operator-interfaces.md) records
the native-interface adoption and ownership boundaries, complementing ADRs 0004
and 0005.
Make Scriptorium a CommandKit-native executable interface over PromptKit,
including ckconfig and ckprompt. Most subprocess consumers should be able to
select a stored prompt and consume its resulting artifact directly. Operators
@@ -62,10 +66,12 @@ Use supported public APIs and released dependencies under the existing
CommandKit owns command declarations, dispatch, common parsing, help, reporting,
and outcome mechanics. ckconfig and ckprompt supply their standard families.
ConfigKit owns configuration processing; PromptKit owns definition parsing,
preparation, execution, validation, and domain results. Scriptorium owns
application configuration and source selection, application commands, process
lifecycle, and artifact delivery.
ConfigKit owns configuration policy through the fully resolved handoff,
including resolution of PromptKit's configuration using PromptKit's schema and
rules. PromptKit owns definition, preparation, execution, validation, and
inspection semantics. Scriptorium owns the application domain: it interprets
resolved values and uses upstream APIs and results to satisfy user requests.
Application commands, process lifecycle, and artifact delivery remain local.
This preserves Scriptorium's request-independent execution model and support
for valid definitions under [ADR 0004](../adr/0004-definition-boundary.md).
@@ -114,7 +120,9 @@ reports describe unsupported or unsuccessful checks.
### Configuration Authority And Native Inspection
The migration preserves these two boundaries:
The migration implements the ownership decision in
[ADR 0006](../adr/0006-adopt-commandkit-native-operator-interfaces.md) through
these two boundaries:
1. **ConfigKit's completed result is authoritative configuration.** Scriptorium
supplies its schema, domain defaults, validation, and genuine application