Retire completed PromptKit adoption records
This commit is contained in:
@@ -27,6 +27,8 @@ also remain in Git history. Completed records are not assignments to restart wor
|
||||
|
||||
The completed configuration-outcome implementation and remediation are preserved
|
||||
in the [v0.8.0 retirement snapshot](https://forge.maximumdirect.net/base-layer/commandkit/src/commit/6c7d7c90de4deea8be38b2a447b5c957d748d1b0/docs/roadmap).
|
||||
The completed PromptKit v0.23.1 adoption, companion-YAML report, and
|
||||
verification evidence are preserved in the [adoption snapshot](https://forge.maximumdirect.net/base-layer/commandkit/src/commit/b1e7c1ee09bf4fb7845b3b5222ccb448ac7fb468/docs/roadmap).
|
||||
|
||||
Accepted [ADRs](../adr/) and the [architecture policy](../policy/architecture.md)
|
||||
govern any future implementation. The [CLI reference](../cli.md), public GoDoc,
|
||||
|
||||
@@ -1,270 +0,0 @@
|
||||
# PromptKit v0.23.1 implementation plan
|
||||
|
||||
## Purpose and execution
|
||||
|
||||
Implement the target state in the [adoption roadmap](promptkit-v0.23.1.md).
|
||||
The [companion-YAML report](promptkit-companion-yaml-exit-status.md) provides the
|
||||
original reproduction and expected outcomes. This plan is written for a Luna
|
||||
coding agent working through one end-to-end sprint.
|
||||
|
||||
Follow Stage 1 through Stage 5 in order. Continue between stages using the
|
||||
decisions below. Intermediate stages may be incomplete while the sprint moves
|
||||
toward the final target. Record each completed stage and its verification here,
|
||||
then commit each completed nonempty unit using a short plain English message,
|
||||
following the [agent policy](../policy/agents.md#git-commit-policy).
|
||||
|
||||
Read the [developer guide](../development.md) and its applicable policy links.
|
||||
Use the installed codebase knowledge graph for code discovery. Use Go 1.27.0
|
||||
on `PATH` with `GOTOOLCHAIN=local`. The final deliverable is a locally committed,
|
||||
release-ready ckprompt v0.9.0 candidate. Publication and hosted-page delivery
|
||||
follow the existing [release procedure](../release.md) when authorized.
|
||||
|
||||
## Baseline and selected approach
|
||||
|
||||
The planning baseline is `8513949`. ckprompt v0.8.0 selects PromptKit v0.21.0,
|
||||
ckconfig v0.8.0, core v0.6.0, and ConfigKit v1.2.0, with Go 1.27.0 as its
|
||||
consumer minimum. PromptKit v0.23.1 corresponds to upstream source commit
|
||||
`74066167942fcf6f70c112359995739ec9789fa6`.
|
||||
|
||||
Select PromptKit v0.23.1 and retain the other baseline dependency selections.
|
||||
Use the existing `ckconfig.ClassifyConfigurationError`, ckprompt diagnostic
|
||||
adaptation, and core outcome presentation. The upstream constructor fix enables
|
||||
those mechanisms to classify malformed YAML correctly. Any production-code
|
||||
adjustment should address a failure demonstrated by the integration checks.
|
||||
|
||||
Existing application callbacks continue to own engine construction and native
|
||||
request construction. Upstream owns conversation execution, operation timeouts,
|
||||
and prepared-run notifications. Additional CLI proposals retain their status in
|
||||
[future work](future.md). The [testing policy](../policy/testing.md#upstream-integration-testing-ownership)
|
||||
governs assertions about these integrations.
|
||||
|
||||
## Stage 1 — Select PromptKit v0.23.1 and update attribution
|
||||
|
||||
Status — completed. `GOWORK=off GOTOOLCHAIN=local go get` selected
|
||||
PromptKit v0.23.1; `go list -m all` confirmed the baseline dependency versions,
|
||||
and `go list -m go.maximumdirect.net/promptkit` confirmed the selected version.
|
||||
The module diff adds only the PromptKit version and checksums. The selected
|
||||
upstream LICENSE and COPYRIGHT match v0.21.0, and attribution now points to
|
||||
commit `74066167942fcf6f70c112359995739ec9789fa6`.
|
||||
|
||||
1. Inspect `integrations/ckprompt/go.mod`, `go.sum`, and the module-local
|
||||
`docs/oss/attribution.md`. Prepare the published dependency from the ckprompt
|
||||
directory with the following command.
|
||||
|
||||
```sh
|
||||
GOWORK=off GOTOOLCHAIN=local go get go.maximumdirect.net/promptkit@v0.23.1
|
||||
```
|
||||
|
||||
2. Review the resulting module diff and resolved versions with
|
||||
`GOWORK=off GOTOOLCHAIN=local go list -m all`. Keep the selected ckconfig,
|
||||
core, ConfigKit, and Go minimum from the baseline. Resolve incidental module
|
||||
changes using ordinary Go module tooling and the actual dependency graph.
|
||||
3. Compare PromptKit's license and copyright notices at the selected source.
|
||||
Update only the affected attribution entry and its source/license links to
|
||||
v0.23.1 and commit `74066167942fcf6f70c112359995739ec9789fa6`, applying the
|
||||
[OSS policy](../policy/oss.md). Existing reviewed license texts match.
|
||||
4. Verify the published module selection with
|
||||
`GOWORK=off GOTOOLCHAIN=local go list -m go.maximumdirect.net/promptkit`.
|
||||
Keep any local `go.work` and `go.work.sum` as ignored development files.
|
||||
|
||||
Completion evidence consists of the selected published version, reviewed
|
||||
module/checksum diff, and updated attribution. Focused behavioral tests follow
|
||||
in Stage 2.
|
||||
|
||||
## Stage 2 — Cover real constructor failures through both integrations
|
||||
|
||||
Status — completed. The focused independent-module test
|
||||
`GOWORK=off GOTOOLCHAIN=local go test -count=1 -run '^TestPromptConstructorConfigurationOutcomes$' .`
|
||||
passes with PromptKit v0.23.1. It exercises a real malformed companion through
|
||||
catalog and configuration commands, preserving constructor and typed error
|
||||
identity, diagnostic/source evidence, reports, and diff-side context.
|
||||
|
||||
1. Read the existing test wiring in ckprompt's `command_test.go`,
|
||||
`configuration_outcomes_test.go`, and
|
||||
`configuration_composition_outcomes_test.go`. In particular,
|
||||
`TestPromptNativeConfigurationFailures` and
|
||||
`TestComposedConfigurationInputOutcomes` currently inject ConfigKit errors
|
||||
directly. Reuse `newPromptTestApp` and the existing suite composition.
|
||||
2. Add focused regression tests in
|
||||
`integrations/ckprompt/constructor_outcomes_test.go`, using package
|
||||
`ckprompt`. Build a small test-owned loader with `t.TempDir()` files,
|
||||
including malformed `prompts.yml` containing `profiles: [`. Resolve the
|
||||
companion from a valid application-config fixture, then construct the
|
||||
engine using `promptkit.NewEngine` with a `configkit.File` input for that
|
||||
companion. Use the existing fixture's `WithBundledOpenRouter(false)` option
|
||||
to keep construction self-contained. Capture the actual constructor error
|
||||
for identity assertions.
|
||||
3. Let the test loader's `ckconfig.Selection` distinguish valid and malformed
|
||||
configurations so it can serve both comparison sides. Use the existing
|
||||
`adapterEngine` fixture for a successful side. Register a `FromEngine`
|
||||
suite and a `ckconfig.Command` containing `ConfigScope(load)` through the
|
||||
usual public command declarations.
|
||||
4. Add `TestPromptConstructorConfigurationOutcomes` with the following
|
||||
invocation cases. Pass the fixture's selected main path through `--config`
|
||||
and use `--scope=promptkit` on configuration commands.
|
||||
|
||||
| Invocation | Additional assertion |
|
||||
| --- | --- |
|
||||
| `promptkit list prompts` | Catalog acquisition preserves the constructor error. |
|
||||
| `config show` | Configuration acquisition classifies the same error. |
|
||||
| `config sources --format=json` | Available source evidence is still reported. |
|
||||
| `config validate --details --format=json` | Available findings include the returned YAML diagnostic. |
|
||||
| `config explain --list` | Discovery follows the configuration acquisition outcome. |
|
||||
| `config diff` with malformed left input | Explanation identifies the left side. |
|
||||
| `config diff` with valid left and malformed right inputs | Explanation identifies the right side. |
|
||||
|
||||
5. For each case, assert usage classification and status 2, propagation of
|
||||
the captured error through `errors.Is`, access to the same typed
|
||||
`*configkit.LoadError` through `errors.As`, and recognition of
|
||||
`promptkit.ErrInvalidConfig`. Check the returned `yaml.invalid` diagnostic
|
||||
and companion source context through stable structured fields or small
|
||||
semantic output fragments. Assert the available source/validation report
|
||||
for the two reporting cases. Keep comparisons about adaptation and outcome
|
||||
selection at the CommandKit boundary.
|
||||
6. Run the focused test from the ckprompt module directory.
|
||||
|
||||
```sh
|
||||
GOWORK=off GOTOOLCHAIN=local go test -count=1 -run '^TestPromptConstructorConfigurationOutcomes$' .
|
||||
```
|
||||
|
||||
Completion evidence consists of real constructor errors producing the expected
|
||||
CommandKit outcomes, identity, diagnostics, reports, and comparison-side context.
|
||||
|
||||
## Stage 3 — Preserve failure precedence and native report compatibility
|
||||
|
||||
Status — completed. The focused constructor and preparation tests and
|
||||
`GOWORK=off GOTOOLCHAIN=local go test ./...` passed against published
|
||||
dependencies. Real missing-schema and malformed-YAML constructor failures
|
||||
retain their causes; mixed operational and cancellation causes and pre-canceled
|
||||
invocations select status 1. The prepared report retains `ParentRunID`.
|
||||
Both native request adapters forward whole builder results; upstream preparation
|
||||
and validation use the supplied context, while execution owns notifications and
|
||||
operation timeouts.
|
||||
|
||||
1. Add `TestPromptConstructorFailurePrecedence` alongside Stage 2's tests.
|
||||
Exercise a representative catalog command and `config show --scope=promptkit`
|
||||
for each distinct failure category below.
|
||||
|
||||
- Use `NewEngine` with `WithSchemaFile` pointing to an absent file to obtain
|
||||
an actual operational constructor error. Assert operational classification,
|
||||
status 1, and preservation of both `ErrInvalidConfig` and `os.ErrNotExist`.
|
||||
- Join the real malformed-YAML constructor error with a test-owned
|
||||
operational sentinel using `errors.Join` in the loader. Assert status 1
|
||||
and preservation of both causes.
|
||||
- Join the real malformed-YAML constructor error with `context.Canceled`.
|
||||
Assert status 1 and preservation of the cancellation and constructor
|
||||
causes.
|
||||
- Execute with an already-canceled context and a loader that could otherwise
|
||||
construct an engine. Assert status 1, `context.Canceled`, empty stdout,
|
||||
and acquisition skipped, reusing the existing cancellation test pattern.
|
||||
|
||||
2. Review `WithRequestPreparation` in `preparation.go` and
|
||||
`WithRequestValidation` in `adapters.go` against the selected upstream
|
||||
`RunRequest` type. Their existing whole-request assignment forwards native
|
||||
builder results. Account for the new fields using that path.
|
||||
3. Extend `TestPreparationCommandForwardsOrderedInputsAndNativeReport` in
|
||||
`preparation_test.go` with a nonempty `ParentRunID` on its supplied native
|
||||
`PreparedRun`. Keep its existing logical comparison with upstream JSON
|
||||
serialization to cover additive report data through CommandKit's renderer.
|
||||
4. Use the upstream public contracts when interpreting new options.
|
||||
`Prepare` and `ValidateRequest` use the supplied context and leave
|
||||
`OnPrepared` invocation to execution operations. Operation-timeout behavior
|
||||
belongs to the upstream operations that apply it. Review keyed struct
|
||||
literals and native-type use for compatibility during compilation.
|
||||
5. Run the constructor tests and the affected preparation test, then ckprompt's
|
||||
full default suite with published dependency selections.
|
||||
|
||||
```sh
|
||||
GOWORK=off GOTOOLCHAIN=local go test -count=1 -run '^(TestPromptConstructor.*|TestPreparationCommandForwardsOrderedInputsAndNativeReport)$' .
|
||||
GOWORK=off GOTOOLCHAIN=local go test ./...
|
||||
```
|
||||
|
||||
Completion evidence consists of operational/cancellation precedence, retained
|
||||
causes, native prepared-report forwarding, and the passing independent suite.
|
||||
|
||||
## Stage 4 — Update current guidance and prepare ckprompt v0.9.0
|
||||
|
||||
Status — completed. Consumer and CLI guidance identifies the prepared v0.9.0
|
||||
candidate separately from published v0.8.0, links to PromptKit v0.23.1, and
|
||||
describes construction, request ownership, and the corrected outcome. The
|
||||
version-matched release note records compatibility and includes full-tag notice
|
||||
links. Upstream source paths and relevant fragments were checked against the
|
||||
selected module; ckprompt GoDoc required no version-specific correction.
|
||||
|
||||
1. Update PromptKit references in `docs/consumers/guide.md` and `docs/cli.md`
|
||||
to the selected source revision. Verify destinations and fragments against
|
||||
v0.23.1. Review affected ckprompt GoDoc and correct version-specific claims
|
||||
where needed.
|
||||
2. Keep the currently published v0.8.0 installation instructions and historical
|
||||
release facts accurate. Add a clearly identified prepared ckprompt v0.9.0
|
||||
candidate paragraph beside the consumer guide's version table, selecting core
|
||||
v0.6.0, ckconfig v0.8.0, ConfigKit v1.2.0, and PromptKit v0.23.1. Current
|
||||
checkout guidance can describe its selected v0.23.1 capabilities. Published
|
||||
installation guidance can advance when publication occurs.
|
||||
3. Document the corrected constructor-error behavior by referencing the existing
|
||||
configuration-failure contract. Explain the application-owned engine/request
|
||||
callbacks briefly and link upstream for conversation and execution features.
|
||||
The existing maintained consumer supplies the composition example for this
|
||||
adoption. Keep examples focused on CommandKit-specific integration behavior.
|
||||
4. Create `integrations/ckprompt/docs/releases/v0.9.0.md` with title
|
||||
`CommandKit ckprompt v0.9.0`. Describe the PromptKit upgrade, malformed
|
||||
companion YAML changing from status 1 to status 2, preserved diagnostics
|
||||
and typed causes, operational/cancellation status 1, dependency pairing, and
|
||||
Go 1.27.0 minimum. Explain relevant additive native-type/report compatibility
|
||||
and link to upstream upgrade guidance. Link current contracts for details.
|
||||
5. End the release note with `COPYRIGHT | LICENSE | ATTRIBUTION` links using
|
||||
full tag `integrations/ckprompt/v0.9.0` and module-prefixed paths, following
|
||||
the [release-note procedure](../release.md#modules-versions-notes-and-shared-files).
|
||||
Treat this as preparation for subsequent publication.
|
||||
|
||||
Completion evidence consists of accurate current-versus-published guidance,
|
||||
updated pinned references, and a version-matched release note.
|
||||
|
||||
## Stage 5 — Verify the assembled candidate and complete the records
|
||||
|
||||
Status — completed. With Go 1.27.0 and the aligned three-module workspace,
|
||||
`GOTOOLCHAIN=local go test ./...`, `go test ./integrations/ckconfig/...`, and
|
||||
`go test ./integrations/ckprompt/...` all passed, including the composed
|
||||
consumer. The independent ckprompt suite passed in Stage 3 with unchanged Go
|
||||
and module inputs. Aggregate whitespace and Go formatting checks passed; local
|
||||
documentation links and the selected upstream paths and fragments were reviewed.
|
||||
The companion-YAML report records resolution. The subsequent cleanup commit
|
||||
retires these completed records and links this evidence from future work.
|
||||
|
||||
1. Ensure the ignored local workspace includes root, ckconfig, and ckprompt,
|
||||
following the developer guide. Run the following from the repository root
|
||||
to validate aligned local sources and the maintained composed consumer.
|
||||
|
||||
```sh
|
||||
GOTOOLCHAIN=local go test ./...
|
||||
GOTOOLCHAIN=local go test ./integrations/ckconfig/...
|
||||
GOTOOLCHAIN=local go test ./integrations/ckprompt/...
|
||||
```
|
||||
|
||||
The ckprompt workspace suite includes `examples/composed`; use that package's
|
||||
result as the maintained-consumer evidence.
|
||||
Reuse Stage 3's independent-suite result for the same Go inputs, or rerun
|
||||
that suite if later Go/module changes affect it.
|
||||
2. Review the aggregate diff against the roadmap's target state. Check Go
|
||||
formatting for changed Go files, Markdown links and fragments, release-note
|
||||
paths, attribution revision, and whitespace. Validate intended new files
|
||||
along with tracked files. Resolve failures within their owning integration
|
||||
paths and rerun affected checks.
|
||||
3. Record stage completion and concrete verification commands/results. Mark the
|
||||
companion-YAML report resolved with the selected upstream version and
|
||||
integration regression evidence. Commit the verified implementation and
|
||||
completed records under the local commit policy.
|
||||
4. Complete roadmap retirement as release preparation. Preserve any unfinished
|
||||
items in `future.md`. Record an immutable Git-history link in `future.md`
|
||||
to the commit containing the completed records, then remove the completed
|
||||
adoption roadmap, companion-YAML report, and this implementation plan.
|
||||
Repair affected references and commit the cleanup. This sequence preserves
|
||||
their resolution evidence in history while keeping active roadmaps current.
|
||||
5. Confirm a clean worktree and summarize the dependency selection, tests,
|
||||
documentation, commits, and prepared ckprompt version. Identify publication
|
||||
as the subsequent separately authorized release action using the existing
|
||||
procedure.
|
||||
|
||||
The sprint is complete when the locally committed candidate meets the target
|
||||
state, the scoped verification passes, and completed planning records have been
|
||||
retired with their evidence retained in Git history.
|
||||
@@ -1,91 +0,0 @@
|
||||
# PromptKit companion YAML still exits with status 1 in v0.8.0
|
||||
|
||||
Status — resolved in the prepared ckprompt v0.9.0 candidate with PromptKit
|
||||
v0.23.1. `TestPromptConstructorConfigurationOutcomes` exercises real malformed
|
||||
companion construction through both integrations, including source and validation
|
||||
reports and both comparison sides. `TestPromptConstructorFailurePrecedence`
|
||||
checks operational and cancellation precedence and preserved causes.
|
||||
|
||||
The original Audita report covered invalid configuration passing through both
|
||||
`ckprompt` and `ckconfig` v0.7.0. Retesting with both integrations at v0.8.0
|
||||
confirmed that malformed main configuration now exits with status `2`. A
|
||||
malformed `prompts.yml` companion still exits with status `1` through both
|
||||
integrations, even though stderr includes the ConfigKit `yaml.invalid` diagnostic.
|
||||
[Original Audita reproduction](https://forge.maximumdirect.net/eric/audita/src/commit/a355f05a273d6ac9d577eab8d30caa60cb74eee8/docs/roadmap/implementation.md#stage-1--establish-the-delegated-inspection-dependency)
|
||||
|
||||
## Reproduction
|
||||
|
||||
From the Audita repository root, build from a scratch copy of the reported
|
||||
revision. The two integration pins are the only selected module versions that
|
||||
change. The build uses CommandKit v0.6.0, ConfigKit v1.2.0, and PromptKit v0.23.0.
|
||||
|
||||
```sh
|
||||
scratch=$(mktemp -d)
|
||||
git archive a355f05a273d6ac9d577eab8d30caa60cb74eee8 | tar -x -C "$scratch"
|
||||
(
|
||||
cd "$scratch" || exit
|
||||
export GOWORK=off
|
||||
go get go.maximumdirect.net/ckprompt@v0.8.0 go.maximumdirect.net/ckconfig@v0.8.0 &&
|
||||
go build -buildvcs=false -o "$scratch/audita" ./cmd/audita
|
||||
)
|
||||
mkdir "$scratch/repro"
|
||||
cd "$scratch/repro"
|
||||
printf '%s\n' 'version: 3' > config.yml
|
||||
printf '%s\n' 'profiles: [' > prompts.yml
|
||||
printf '%s\n' '[]' > transcript.json
|
||||
printf '%s\n' 'version: [' > bad.yml
|
||||
```
|
||||
|
||||
Run the following commands using `"$scratch/audita"` from the fixture
|
||||
directory. They fail during configuration loading, before any provider calls.
|
||||
|
||||
| Command arguments | v0.7.0 | v0.8.0 | Expected | Diagnostic |
|
||||
| --- | ---: | ---: | ---: | --- |
|
||||
| `promptkit list prompts --config config.yml` | 1 | 1 | 2 | `yaml.invalid` in `prompts.yml` |
|
||||
| `config show --scope promptkit --config config.yml` | 1 | 1 | 2 | `yaml.invalid` in `prompts.yml` |
|
||||
| `process transcript.json --config config.yml` | 2 | 2 | 2 | `yaml.invalid` in `prompts.yml` |
|
||||
| `config show --scope app --config bad.yml` | 1 | 2 | 2 | `yaml.invalid` in `bad.yml` |
|
||||
|
||||
`config sources`, `config validate`, `config explain --list`, and
|
||||
`config diff --against-config config.yml` match the `config show` result in
|
||||
each scope. The source and validation commands still deliver their available
|
||||
reports on stdout. With `--config bad.yml`, both `promptkit list prompts`
|
||||
and `config show --scope promptkit` also return `2` in v0.8.0 because the
|
||||
main configuration load fails before construction of the PromptKit engine.
|
||||
|
||||
## Why the companion case returns status 1
|
||||
|
||||
PromptKit's `NewEngine` wraps engine construction errors with
|
||||
`fmt.Errorf("%w: %w", ErrInvalidConfig, err)`. In the reproduction the two
|
||||
branches are the `promptkit.ErrInvalidConfig` category sentinel and a wrapped
|
||||
`*configkit.LoadError` containing the `yaml.invalid` diagnostic.
|
||||
[PromptKit v0.23.0 engine source](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/fcbff80ab227397a03935ab3bf8114481c0736a7/engine.go)
|
||||
|
||||
Both integrations can recover the typed load error through `errors.As`, so
|
||||
the source and diagnostic reach stderr. `ckconfig.ClassifyConfigurationError`
|
||||
classifies the typed load branch as usage and the standalone sentinel branch
|
||||
as operational. The full error therefore becomes operational because the
|
||||
classifier requires every branch to identify invalid input. Both
|
||||
`ckprompt.definitionFailure` and `ckconfig.configFailure` use that shared
|
||||
classification.
|
||||
[ckconfig v0.8.0 classifier](../../integrations/ckconfig/errors.go) ·
|
||||
[ckconfig outcome handling](../../integrations/ckconfig/operations.go) ·
|
||||
[ckprompt outcome handling](../../integrations/ckprompt/command.go)
|
||||
|
||||
## Expected behavior
|
||||
|
||||
- Return status `2` when the typed diagnostic identifies malformed companion
|
||||
YAML. Keep the diagnostic, source information, available reports, and typed
|
||||
cause. Preserve recognition of `promptkit.ErrInvalidConfig` through
|
||||
`errors.Is`.
|
||||
- Return status `1` for cancellation and genuine operational failures,
|
||||
including mixed errors with an independent operational cause. Audita's
|
||||
already-canceled context test passed against v0.8.0 for catalog listing,
|
||||
configuration show, and processing. It checks status `1`,
|
||||
`context.Canceled` in the cause chain, and empty stdout.
|
||||
|
||||
One possible upstream fix is for PromptKit to expose `ErrInvalidConfig` via
|
||||
`Is` on a wrapper that unwraps to the underlying cause. This would let the
|
||||
typed load branch determine the outcome for malformed YAML while preserving
|
||||
the rule for independent operational branches.
|
||||
[CommandKit configuration failure contract](../cli.md#configuration-failure-classification)
|
||||
@@ -1,124 +0,0 @@
|
||||
# PromptKit v0.23.1 adoption
|
||||
|
||||
## Status and objective
|
||||
|
||||
Finalized for implementation. Adopt `go.maximumdirect.net/promptkit v0.23.1`
|
||||
in ckprompt and prepare ckprompt v0.9.0. The
|
||||
[implementation plan](implementation.md) owns sequencing, concrete steps, and
|
||||
verification records.
|
||||
|
||||
The targeted result is that malformed PromptKit configuration encountered
|
||||
through an application-owned engine loader receives CommandKit's existing
|
||||
configuration-input classification. Preserve upstream diagnostics and error
|
||||
identity through the integration. Continue delegating configuration semantics
|
||||
and engine construction behavior to PromptKit and ConfigKit.
|
||||
|
||||
## Current baseline
|
||||
|
||||
This roadmap starts from CommandKit commit
|
||||
`bf45a3f` and the released ckprompt v0.8.0 integration.
|
||||
Its [module metadata](../../integrations/ckprompt/go.mod) selects the following
|
||||
dependencies and consumer minimum.
|
||||
|
||||
| Item | Selected baseline | Adoption target |
|
||||
| --- | --- | --- |
|
||||
| PromptKit | v0.21.0 | v0.23.1 |
|
||||
| ckconfig | v0.8.0 | v0.8.0 |
|
||||
| CommandKit core | v0.6.0 | v0.6.0 |
|
||||
| ConfigKit | v1.2.0 | v1.2.0 |
|
||||
| Go consumer minimum | 1.27.0 | 1.27.0 |
|
||||
|
||||
ckconfig already owns the shared configuration-error classification function.
|
||||
ckprompt uses that classification for engine acquisition failures and adapts
|
||||
typed ConfigKit diagnostics into CommandKit reports. Core carries the selected
|
||||
outcome through invocation reporting and presentation. The existing status
|
||||
contract belongs to the [CLI reference](../cli.md#outcome-status).
|
||||
|
||||
The reported failure involves a valid application configuration that imports a
|
||||
malformed PromptKit companion YAML file. Engine construction returns a typed
|
||||
ConfigKit load error wrapped alongside PromptKit's `ErrInvalidConfig` sentinel.
|
||||
With the earlier multi-error wrapper, the shared classifier encounters an
|
||||
independent sentinel branch and selects operational failure, producing status 1
|
||||
for catalog and configuration-inspection commands. The intended input-error
|
||||
outcome is status 2 with the YAML diagnostic and source context preserved.
|
||||
|
||||
The [companion-YAML report](promptkit-companion-yaml-exit-status.md) records the original
|
||||
reproduction. Its observed application versions include PromptKit v0.23.0.
|
||||
The constructor wrapper responsible for that behavior also exists in the
|
||||
currently selected v0.21.0.
|
||||
|
||||
## Upstream changes and integration scope
|
||||
|
||||
PromptKit v0.23.1 resolves the constructor wrapping defect at source commit
|
||||
`74066167942fcf6f70c112359995739ec9789fa6`. The wrapper exposes the original
|
||||
cause through a single unwrap and recognizes `ErrInvalidConfig` through
|
||||
`errors.Is`. Typed ConfigKit errors remain reachable through `errors.As`.
|
||||
Genuine joined causes remain available for classification. The adoption can
|
||||
therefore use ckconfig's existing classifier. [Upstream constructor](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/74066167942fcf6f70c112359995739ec9789fa6/engine.go)
|
||||
and [error implementation](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/74066167942fcf6f70c112359995739ec9789fa6/errors.go).
|
||||
|
||||
The intervening releases add opt-in conversation capture, continuation,
|
||||
coordination, execution-group summaries, operation timeouts, and prepared-run
|
||||
notifications. Applications own engine setup, native request construction, and
|
||||
execution. Existing native request builders provide the integration point for
|
||||
application-selected request capabilities. Prepared reports continue to expose
|
||||
upstream fields through the existing report path. Review those additive shapes
|
||||
for compatibility during the upgrade. [Upstream consumer guidance](https://forge.maximumdirect.net/base-layer/promptkit/src/commit/74066167942fcf6f70c112359995739ec9789fa6/docs/consumers/pkg-promptkit.md).
|
||||
|
||||
Keep the adoption focused on existing CommandKit operator tasks and the
|
||||
constructor-error fix. Additional CLI capabilities remain subject to the
|
||||
operator needs recorded in [future work](future.md). Preparation and validation
|
||||
documentation should describe the upstream operations actually invoked,
|
||||
including their handling of contexts and request options.
|
||||
|
||||
## Targeted end state
|
||||
|
||||
### Dependency and ownership
|
||||
|
||||
ckprompt selects the published PromptKit v0.23.1 module and verified checksums,
|
||||
with the dependency versions and consumer minimum shown above. Its
|
||||
[attribution](../../integrations/ckprompt/docs/oss/attribution.md) identifies the
|
||||
selected upstream revision. The reviewed upstream license and copyright texts
|
||||
match the v0.21.0 texts.
|
||||
|
||||
The existing shared classifier determines outcomes from the upstream error
|
||||
evidence. CommandKit continues to own adaptation, presentation, and invocation
|
||||
outcomes. Applications continue to supply engines and native requests through
|
||||
the existing callbacks.
|
||||
|
||||
### Configuration outcomes
|
||||
|
||||
Real `promptkit.NewEngine` failures passing through a `FromEngine` catalog
|
||||
command and `ConfigScope` show, sources, validate, explain discovery, and diff
|
||||
receive the existing configuration-failure treatment. This includes either
|
||||
comparison side. Malformed YAML selects status 2 with `yaml.invalid`, source
|
||||
context, available source and validation reports, typed ConfigKit identity, and
|
||||
recognition of `promptkit.ErrInvalidConfig` preserved.
|
||||
|
||||
Operational constructor failures, independent operational branches joined with
|
||||
an input failure, and cancellation select status 1 under the existing
|
||||
[classification contract](../cli.md#configuration-failure-classification).
|
||||
Maintained integration tests cover these CommandKit adaptation boundaries.
|
||||
|
||||
The review already exercised real constructor failures against v0.23.1 using
|
||||
temporary module selection. Catalog and all five configuration operations
|
||||
returned status 2 for malformed YAML. Typed identity and mixed-cause
|
||||
classification were preserved. Maintained regression coverage is the remaining
|
||||
work needed to keep that integration behavior checked in the repository.
|
||||
|
||||
### Compatibility and release readiness
|
||||
|
||||
Native request forwarding and prepared-report presentation accommodate the
|
||||
additive upstream fields, including parent identifiers where supplied. Current
|
||||
consumer guidance, CLI references, GoDoc, and upstream source links reflect the
|
||||
selected library and the operations CommandKit invokes.
|
||||
|
||||
The release-ready result includes a ckprompt v0.9.0 note describing the dependency
|
||||
upgrade and corrected constructor-failure classification. Compatibility guidance
|
||||
distinguishes the prepared candidate from published releases. Independent-module
|
||||
tests and aligned-workspace composition substantiate the integration.
|
||||
|
||||
The sprint ends with a locally committed candidate. Subsequent publication uses
|
||||
the existing [release procedure](../release.md) under separate authorization.
|
||||
ckprompt can release independently under the
|
||||
[module alignment policy](../policy/release.md#commandkit-downstream-dependency-alignment).
|
||||
Reference in New Issue
Block a user