Defer execution overrides to a reusable CommandKit binding
This commit is contained in:
@@ -1,6 +1,6 @@
|
|||||||
# CommandKit migration notepad
|
# CommandKit migration notepad
|
||||||
|
|
||||||
Status: artifacts command family agreed; execution override binding under discussion.
|
Status: discussion decisions recorded; ready for roadmap consolidation.
|
||||||
Started 2026-11-19.
|
Started 2026-11-19.
|
||||||
|
|
||||||
Narratio will become a CommandKit-native application. This notepad collects the
|
Narratio will become a CommandKit-native application. This notepad collects the
|
||||||
@@ -261,24 +261,27 @@ ConfigKit owns the relationship between effective, historical, explainable,
|
|||||||
and overridable paths; Narratio does not add a writable-path registry,
|
and overridable paths; Narratio does not add a writable-path registry,
|
||||||
reinterpret explicitness, or manufacture provenance for domain products.
|
reinterpret explicitness, or manufacture provenance for domain products.
|
||||||
|
|
||||||
### Native application configuration overrides
|
### Native inspection overrides; execution overrides deferred
|
||||||
|
|
||||||
Support invocation-local field overrides only for the `app` scope, with
|
Enable native `ckconfig` field overrides only for the `app` inspection scope.
|
||||||
equivalent application configuration selections available to app inspection,
|
Campaign, session, and party scopes retain their inspection capabilities;
|
||||||
planning, and execution. Campaign, session, and party scopes retain their
|
alternate inputs use `--campaign-file`, `--session-file`, and `--party-file`.
|
||||||
inspection capabilities; alternate inputs use `--campaign-file`,
|
|
||||||
`--session-file`, and `--party-file`.
|
|
||||||
|
|
||||||
CommandKit supplies the `POINTER=JSON` flag grammar; ConfigKit applies its native
|
Defer field overrides on Narratio's execution and planning commands until
|
||||||
override mechanism to application configuration. Do not introduce additional
|
CommandKit provides a reusable binding. Do not build a local assignment parser,
|
||||||
protected-field lists, custom merge semantics, or a separate override acceptance
|
flag binding, or equivalent machinery. Operators use configuration files and
|
||||||
policy within that scope.
|
overlays to select execution settings. This optional convenience is not a
|
||||||
|
dependency of the migration.
|
||||||
|
|
||||||
|
Within standard inspection, `ckconfig` supplies the `POINTER=JSON` binding and
|
||||||
|
ConfigKit applies its native override mechanism. Do not introduce additional
|
||||||
|
protected-field lists, custom merge semantics, or an override acceptance policy.
|
||||||
|
|
||||||
Use these flag spellings:
|
Use these flag spellings:
|
||||||
|
|
||||||
| Flag | Target |
|
| Flag | Target |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| `--set POINTER=JSON` | App/pipeline configuration on app inspection, planning, and execution |
|
| `--set POINTER=JSON` | App/pipeline configuration on native app inspection only |
|
||||||
| `--against-set POINTER=JSON` | Right-side app/pipeline configuration on app comparisons |
|
| `--against-set POINTER=JSON` | Right-side app/pipeline configuration on app comparisons |
|
||||||
|
|
||||||
Declare native override support only for `app`. Other inspection scopes do not
|
Declare native override support only for `app`. Other inspection scopes do not
|
||||||
@@ -308,11 +311,10 @@ displayed path accepts an override. Narratio passes explicit assignments to
|
|||||||
ConfigKit without translating runtime catalog paths into input paths or
|
ConfigKit without translating runtime catalog paths into input paths or
|
||||||
patching domain products after handoff.
|
patching domain products after handoff.
|
||||||
|
|
||||||
Overrides leave source configuration files unchanged. Normal run metadata and
|
Inspection overrides leave source files unchanged and do not carry into later
|
||||||
prepared configuration may record the effective settings through established
|
planning or execution. Run metadata and prepared configuration record settings
|
||||||
secret-safe representations. Reuse decisions continue to depend on semantic
|
selected through files and overlays using established secret-safe
|
||||||
evidence: result-affecting changes can require regeneration, while the presence
|
representations. Reuse remains based on semantic evidence.
|
||||||
of an override alone does not force execution.
|
|
||||||
|
|
||||||
### Identity assertions and credential overrides
|
### Identity assertions and credential overrides
|
||||||
|
|
||||||
@@ -321,15 +323,15 @@ asserted identity after loading and resolution so an operation targeting one
|
|||||||
session cannot silently use another session's workspace, lock, manifest, or
|
session cannot silently use another session's workspace, lock, manifest, or
|
||||||
remote destination. This is an ordinary domain consistency check, independent
|
remote destination. This is an ordinary domain consistency check, independent
|
||||||
of the selected source. Alternate campaign and session values come from file
|
of the selected source. Alternate campaign and session values come from file
|
||||||
selection rather than field overrides. App overrides retain native acceptance
|
selection rather than field overrides. Native app inspection overrides retain
|
||||||
without a protected-field list.
|
upstream acceptance without a protected-field list.
|
||||||
|
|
||||||
When no identity is asserted, such as inspection of an explicit session file
|
When no identity is asserted, such as inspection of an explicit session file
|
||||||
without `--session`, the effective document supplies its identity.
|
without `--session`, the effective document supplies its identity.
|
||||||
Session-oriented commands retain their required positional assertion.
|
Session-oriented commands retain their required positional assertion.
|
||||||
|
|
||||||
Credential-related app fields accept native overrides and use ConfigKit's
|
Credential-related app fields accept native inspection overrides and use
|
||||||
ordinary typed-secret handling and normal configuration validation. Safe
|
ConfigKit's ordinary typed-secret handling and normal configuration validation. Safe
|
||||||
inspection, diagnostics, and persistence remain separate output
|
inspection, diagnostics, and persistence remain separate output
|
||||||
responsibilities; they do not justify additional restrictions on which app
|
responsibilities; they do not justify additional restrictions on which app
|
||||||
fields may be overridden.
|
fields may be overridden.
|
||||||
@@ -460,7 +462,7 @@ commit working. Report intermediate status accurately, use focused checks when
|
|||||||
useful, and require a coherent, compilable, fully validated final application.
|
useful, and require a coherent, compilable, fully validated final application.
|
||||||
|
|
||||||
Useful work boundaries are core invocation/domain commands; configuration
|
Useful work boundaries are core invocation/domain commands; configuration
|
||||||
handoff, native scopes and inspection, file selection, and app overrides;
|
handoff, native scopes and inspection overrides, and file selection;
|
||||||
reports, diagnostics, cancellation, and completion; and integration
|
reports, diagnostics, cancellation, and completion; and integration
|
||||||
verification, removal of superseded CLI machinery, and documentation. These
|
verification, removal of superseded CLI machinery, and documentation. These
|
||||||
are organizational boundaries, not mandatory buildable milestones or a
|
are organizational boundaries, not mandatory buildable milestones or a
|
||||||
@@ -484,9 +486,9 @@ remain useful records, but do not replace the result used by native inspection.
|
|||||||
|
|
||||||
Retain Narratio's stage sequencing, resume authority, publication semantics,
|
Retain Narratio's stage sequencing, resume authority, publication semantics,
|
||||||
restore safety, and cleanup rules. Changes required for the agreed ownership
|
restore safety, and cleanup rules. Changes required for the agreed ownership
|
||||||
boundary, inspection, overrides, reporting, and cancellation behavior are in
|
boundary, inspection, reporting, and cancellation behavior are in scope.
|
||||||
scope. Workspace reorganization, downstream-tool adoption, and Scriptorium
|
Workspace reorganization, downstream-tool adoption, and Scriptorium requirements
|
||||||
requirements inspection remain separate work.
|
inspection remain separate work.
|
||||||
|
|
||||||
Validate the integration through representative behavioral acceptance cases:
|
Validate the integration through representative behavioral acceptance cases:
|
||||||
|
|
||||||
@@ -495,13 +497,15 @@ Validate the integration through representative behavioral acceptance cases:
|
|||||||
native adapters, with upstream value, provenance, and path semantics.
|
native adapters, with upstream value, provenance, and path semantics.
|
||||||
- Domain catalog and plan generation consume handed-off configuration without
|
- Domain catalog and plan generation consume handed-off configuration without
|
||||||
modifying it or replacing the native inspection result.
|
modifying it or replacing the native inspection result.
|
||||||
- App inspection, planning, and execution resolve equivalent application
|
- App inspection, planning, and execution use the same configuration loading
|
||||||
configuration selections and overrides.
|
semantics for equivalent file and overlay selections. Inspection overrides
|
||||||
|
apply only to the inspection invocation.
|
||||||
- Explicit party-file selection consistently feeds roster inspection, derived
|
- Explicit party-file selection consistently feeds roster inspection, derived
|
||||||
players, artifact expansion, planning, and execution; comparison sides remain
|
players, artifact expansion, planning, and execution; comparison sides remain
|
||||||
independent.
|
independent.
|
||||||
- Override capability is limited to app; other scopes and aggregate inspection
|
- Field overrides are limited to native app inspection. Other scopes and
|
||||||
retain native behavior when overrides are unsupported.
|
aggregate inspection retain native behavior when overrides are unsupported;
|
||||||
|
execution and planning commands expose no generic `--set` binding.
|
||||||
- Reports remain separate from diagnostics and preserve meaningful partial
|
- Reports remain separate from diagnostics and preserve meaningful partial
|
||||||
results.
|
results.
|
||||||
- Help and completion avoid configuration and service acquisition.
|
- Help and completion avoid configuration and service acquisition.
|
||||||
@@ -518,7 +522,7 @@ adoption work.
|
|||||||
|
|
||||||
Provide workflow-oriented release migration guidance: an old-to-new command
|
Provide workflow-oriented release migration guidance: an old-to-new command
|
||||||
table plus explanations of removed shortcuts, identity/file selectors including
|
table plus explanations of removed shortcuts, identity/file selectors including
|
||||||
party-file selection, app-only field overrides, native flag repetition and
|
party-file selection, inspection-only app overrides, native flag repetition and
|
||||||
placement, native configuration inspection and its distinction from domain
|
placement, native configuration inspection and its distinction from domain
|
||||||
catalogs and plans, configuration comparisons, structured output, diagnostic
|
catalogs and plans, configuration comparisons, structured output, diagnostic
|
||||||
visibility, exit classifications, and cancellation. Identify affected examples,
|
visibility, exit classifications, and cancellation. Identify affected examples,
|
||||||
@@ -560,11 +564,9 @@ baseline. They remain current-behavior documents until the migration lands.
|
|||||||
|
|
||||||
## Open decisions
|
## Open decisions
|
||||||
|
|
||||||
Decide how execution and planning commands bind app overrides. The reviewed
|
No unresolved discussion decisions remain. Execution and planning field
|
||||||
`ckconfig` release exposes no reusable complete `POINTER=JSON` parser or flag
|
overrides are deferred until CommandKit provides a reusable binding; Narratio
|
||||||
binding. The proposal is a small shared binding that splits the assignment,
|
will not implement its own. Native app inspection overrides remain in scope.
|
||||||
uses ConfigKit's path parser and CommandKit's JSON parser, and passes native
|
|
||||||
override records to ConfigKit. This proposal is not yet accepted.
|
|
||||||
|
|
||||||
Consumer probes against the reviewed releases confirmed native inspection,
|
Consumer probes against the reviewed releases confirmed native inspection,
|
||||||
app-only override capabilities, independent comparisons, and lazy acquisition.
|
app-only override capabilities, independent comparisons, and lazy acquisition.
|
||||||
@@ -574,7 +576,7 @@ for the subsequent plan; release version selection remains deferred.
|
|||||||
|
|
||||||
The configuration ownership boundary is recorded in
|
The configuration ownership boundary is recorded in
|
||||||
[ADR 0003](../adr/0003-assign-configuration-ownership.md). Roadmap consolidation
|
[ADR 0003](../adr/0003-assign-configuration-ownership.md). Roadmap consolidation
|
||||||
follows the override-binding decision.
|
is the next planning step.
|
||||||
|
|
||||||
## Discussion and decision record
|
## Discussion and decision record
|
||||||
|
|
||||||
@@ -633,7 +635,8 @@ adding an explicit party-file selector while retaining the campaign default.
|
|||||||
|
|
||||||
The cross-domain override decision below is superseded by the later
|
The cross-domain override decision below is superseded by the later
|
||||||
override-scope revision. Inspection capabilities and native app override
|
override-scope revision. Inspection capabilities and native app override
|
||||||
semantics remain accepted.
|
semantics remain accepted. The subsequent execution-override deferral supersedes
|
||||||
|
the inspection/planning/execution parity requirement recorded here.
|
||||||
|
|
||||||
Accepted full applicable inspection capabilities and native overrides across
|
Accepted full applicable inspection capabilities and native overrides across
|
||||||
all four configuration domains, with parity across inspection, planning, and
|
all four configuration domains, with parity across inspection, planning, and
|
||||||
@@ -703,6 +706,9 @@ to meaningfully reduce complexity while retaining native app override behavior
|
|||||||
and ordinary file-backed configuration composition. This revision supersedes
|
and ordinary file-backed configuration composition. This revision supersedes
|
||||||
the earlier all-domain override and campaign-only party-selection decisions.
|
the earlier all-domain override and campaign-only party-selection decisions.
|
||||||
|
|
||||||
|
The later execution-override decision limits field overrides to native app
|
||||||
|
inspection until a reusable upstream binding is available.
|
||||||
|
|
||||||
### 2026-11-19 — Configuration ownership and native inspection clarified
|
### 2026-11-19 — Configuration ownership and native inspection clarified
|
||||||
|
|
||||||
Accepted ConfigKit's completed result as authoritative configuration, with
|
Accepted ConfigKit's completed result as authoritative configuration, with
|
||||||
@@ -738,6 +744,17 @@ native configuration group's extension gap and keeping domain reports separate
|
|||||||
from configuration inspection. The execution override binding remains the next
|
from configuration inspection. The execution override binding remains the next
|
||||||
discussion topic.
|
discussion topic.
|
||||||
|
|
||||||
|
### 2026-11-19 — Execution overrides deferred
|
||||||
|
|
||||||
|
Deferred field overrides on execution and planning commands until CommandKit
|
||||||
|
provides a reusable binding. Narratio will not build the proposed local binding
|
||||||
|
or other override machinery. Files and overlays provide execution settings;
|
||||||
|
native `ckconfig` overrides remain available for app inspection only.
|
||||||
|
|
||||||
|
Execution overrides are an optional operator convenience, not a core workflow
|
||||||
|
requirement or a migration dependency. This settles the remaining binding
|
||||||
|
decision and supersedes the earlier override-parity requirement.
|
||||||
|
|
||||||
### Continuing the discussion
|
### Continuing the discussion
|
||||||
|
|
||||||
For each topic, record the question, the agreed outcome, its rationale, and any
|
For each topic, record the question, the agreed outcome, its rationale, and any
|
||||||
|
|||||||
Reference in New Issue
Block a user