Migrate ckconfig to the vanity module path

2026-11-04 03:52:46 +00:00
parent f0121ad466
commit 92a327db97
36 changed files with 113 additions and 58 deletions
--- a/integrations/ckconfig/README.md
+++ b/integrations/ckconfig/README.md
@@ -7,9 +7,8 @@ itself.

 ## Module

-The module path is
-`gitea.maximumdirect.net/eric/CommandKit/integrations/ckconfig`. Its first
-release is prepared as `v0.1.0`. It uses the core `commandkit` package and
+The module path is `go.maximumdirect.net/ckconfig`. Version v0.2.0 uses
+`go.maximumdirect.net/commandkit v0.3.0` and
 ConfigKit; it does not import PromptKit. See the
 [consumer guide](https://gitea.maximumdirect.net/eric/CommandKit/src/branch/main/docs/consumers/guide.md#configkit-scopes)
 for exact callback and lifetime contracts.
--- a/integrations/ckconfig/comparison_adapter_test.go
+++ b/integrations/ckconfig/comparison_adapter_test.go
@@ -10,8 +10,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 type adapterSettings struct {
--- a/integrations/ckconfig/comparison_contract_test.go
+++ b/integrations/ckconfig/comparison_contract_test.go
@@ -7,8 +7,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestComparisonCapabilitiesAreIndependentAndCaptured(t *testing.T) {
--- a/integrations/ckconfig/comparison_input_test.go
+++ b/integrations/ckconfig/comparison_input_test.go
@@ -6,8 +6,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestComparisonSelectionInheritsFieldsIndependently(t *testing.T) {
--- a/integrations/ckconfig/comparison_preparation_test.go
+++ b/integrations/ckconfig/comparison_preparation_test.go
@@ -8,8 +8,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestComparisonPreparesEqualSelectionsWithSeparateTypedInputs(t *testing.T) {
--- a/integrations/ckconfig/completion.go
+++ b/integrations/ckconfig/completion.go
@@ -1,6 +1,6 @@
 package ckconfig

-import commandkit "gitea.maximumdirect.net/eric/CommandKit"
+import commandkit "go.maximumdirect.net/commandkit"

 func completionChoices(values ...string) commandkit.CompletionHint {
 	choices := make([]commandkit.CompletionChoice, len(values))
--- a/integrations/ckconfig/completion_test.go
+++ b/integrations/ckconfig/completion_test.go
@@ -7,8 +7,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestCompletionUsesInstalledScopeCapabilitiesWithoutAcquisition(t *testing.T) {
--- a/integrations/ckconfig/configkit_adapter.go
+++ b/integrations/ckconfig/configkit_adapter.go
@@ -7,8 +7,8 @@ import (
 	"io"
 	"strconv"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 // FromConfigKit adapts a typed ConfigKit loader to all five native
--- a/integrations/ckconfig/contracts.go
+++ b/integrations/ckconfig/contracts.go
@@ -4,8 +4,8 @@ import (
 	"context"
 	"io"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 // Selection carries the configuration and overlay choices supplied for a
--- a/integrations/ckconfig/contracts_adapter_test.go
+++ b/integrations/ckconfig/contracts_adapter_test.go
@@ -9,8 +9,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestWithScopeErrorCopiesAndRetainsCauses(t *testing.T) {
--- a/integrations/ckconfig/diff.go
+++ b/integrations/ckconfig/diff.go
@@ -4,7 +4,7 @@ import (
 	"errors"
 	"fmt"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func runConfigDiff[I, S any](invocation commandkit.Invocation, plan *configOperationPlan[I, S], state S) commandkit.Outcome {
--- a/integrations/ckconfig/diff_execution_test.go
+++ b/integrations/ckconfig/diff_execution_test.go
@@ -9,8 +9,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 	"go.yaml.in/yaml/v4"
 )

--- a/integrations/ckconfig/doc.go
+++ b/integrations/ckconfig/doc.go
@@ -1,4 +1,5 @@
-// Package ckconfig provides CommandKit's optional ConfigKit integration. Its
+// Package ckconfig, provided by go.maximumdirect.net/ckconfig, provides
+// CommandKit's optional ConfigKit integration. Its
 // canonical Command declaration installs the standard config command family
 // through the core commandkit package. Applications can install CommandKit
 // RoutingRule declarations alongside it through commandkit.New or
--- a/integrations/ckconfig/docs/oss/attribution.md
+++ b/integrations/ckconfig/docs/oss/attribution.md
@@ -153,16 +153,29 @@ License and notices: [MIT](licenses/MIT.txt) |

 ## ReleaseKit

-Selected module: `gitea.maximumdirect.net/eric/ReleaseKit` at `v0.4.2` (transitive Go tool requirement; not a runtime import).
+Selected module: `gitea.maximumdirect.net/eric/ReleaseKit` at `v0.4.1` (transitive Go tool requirement; not a runtime import).

 Copyright (C) 2026 Eric Rakestraw

 SPDX-License-Identifier: LGPL-3.0-or-later

 License and notices: [LGPL v3.0](../../LICENSE) |
-[LICENSE](https://gitea.maximumdirect.net/eric/ReleaseKit/src/commit/7d033c5ca1c95aec7db9690293638a0a1ac887b8/LICENSE).
+[LICENSE](https://gitea.maximumdirect.net/eric/ReleaseKit/src/commit/2d5a8110c61e31daf8698766114ae305d0e0e469/LICENSE).

-[Source](https://gitea.maximumdirect.net/eric/ReleaseKit/src/commit/7d033c5ca1c95aec7db9690293638a0a1ac887b8).
+[Source](https://gitea.maximumdirect.net/eric/ReleaseKit/src/commit/2d5a8110c61e31daf8698766114ae305d0e0e469).
+
+## ReleaseKit (vanity module)
+
+Selected module: `go.maximumdirect.net/releasekit` at `v0.9.0` (transitive Go tool requirement; not a runtime import).
+
+Copyright (C) 2026 Eric Rakestraw
+
+SPDX-License-Identifier: LGPL-3.0-or-later
+
+License and notices: [LGPL v3.0](../../LICENSE) |
+[LICENSE](https://forge.maximumdirect.net/base-layer/releasekit/src/commit/2180aa868ec2caa95fc8279fd59d5f0ebac41bd4/LICENSE).
+
+[Source](https://forge.maximumdirect.net/base-layer/releasekit/src/commit/2180aa868ec2caa95fc8279fd59d5f0ebac41bd4).

 ## Goldmark

--- a/integrations/ckconfig/docs/releases/v0.2.0.md
+++ b/integrations/ckconfig/docs/releases/v0.2.0.md
@@ -0,0 +1,35 @@
+# CommandKit ckconfig v0.2.0
+
+## Summary
+
+CommandKit ckconfig v0.2.0 moves the integration to
+`go.maximumdirect.net/ckconfig` and uses `go.maximumdirect.net/commandkit v0.3.0`
+with ConfigKit v0.8.0. It adopts core's invocation reporting and completion
+contracts while retaining ConfigKit-owned inspection and comparison behavior.
+
+## Migration
+
+Replace imports of `gitea.maximumdirect.net/eric/CommandKit/integrations/ckconfig`
+with `go.maximumdirect.net/ckconfig`, and update core imports to
+`go.maximumdirect.net/commandkit`. Select ckconfig v0.2.0 and core v0.3.0
+as a matched set. Old and new core paths have distinct Go type identities.
+Applications also using PromptKit should move to the forthcoming matched
+`go.maximumdirect.net/ckprompt v0.2.0` release.
+
+Handlers use `Invocation.Reporter()` for output and categorized messages;
+terminal failures carry an explanation and optional cause. The integration
+submits provider diagnostics through the invocation reporter, respecting shared
+reporting flags. Update callers that used `Invocation.Streams`,
+`Outcome.Diagnostics`, or the old error-first failure API as described in the
+[core migration guide](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/v0.3.0/docs/consumers/guide.md#invocation-reporting).
+The standard config commands also provide completion hints for applicable
+selectors and file paths when the application installs core's completion command.
+
+Go 1.26.0 remains the consumer minimum. Importing ckconfig does not install
+commands; pass its declarations to `commandkit.New` or `App.Register`.
+See the [module README](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckconfig/v0.2.0/integrations/ckconfig/README.md)
+and [consumer guide](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckconfig/v0.2.0/docs/consumers/guide.md#configkit-scopes).
+
+[COPYRIGHT](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckconfig/v0.2.0/integrations/ckconfig/COPYRIGHT) |
+[LICENSE](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckconfig/v0.2.0/integrations/ckconfig/LICENSE) |
+[ATTRIBUTION](https://forge.maximumdirect.net/base-layer/commandkit/src/tag/integrations/ckconfig/v0.2.0/integrations/ckconfig/docs/oss/attribution.md)
--- a/integrations/ckconfig/examples/simple/README.md
+++ b/integrations/ckconfig/examples/simple/README.md
@@ -1,5 +1,8 @@
 # Simple consumer

+This example imports `go.maximumdirect.net/ckconfig` and
+`go.maximumdirect.net/commandkit`; use ckconfig v0.2.0 with core v0.3.0.
+
 Run the maintained example with:

 ```sh
--- a/integrations/ckconfig/examples/simple/main.go
+++ b/integrations/ckconfig/examples/simple/main.go
@@ -7,9 +7,9 @@ import (
 	"os"
 	"strconv"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
-	"gitea.maximumdirect.net/eric/CommandKit/integrations/ckconfig"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	"go.maximumdirect.net/ckconfig"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 type appConfiguration struct {
--- a/integrations/ckconfig/examples/simple/main_test.go
+++ b/integrations/ckconfig/examples/simple/main_test.go
@@ -7,8 +7,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
-	"gitea.maximumdirect.net/eric/CommandKit/integrations/ckconfig"
+	"go.maximumdirect.net/ckconfig"
+	commandkit "go.maximumdirect.net/commandkit"
 	"go.yaml.in/yaml/v4"
 )

--- a/integrations/ckconfig/explain.go
+++ b/integrations/ckconfig/explain.go
@@ -5,8 +5,8 @@ import (
 	"fmt"
 	"io"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 type explanationReport struct {
--- a/integrations/ckconfig/family.go
+++ b/integrations/ckconfig/family.go
@@ -9,8 +9,8 @@ import (
 	"sort"
 	"strings"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 type scopeMetadata struct {
--- a/integrations/ckconfig/family_reports_test.go
+++ b/integrations/ckconfig/family_reports_test.go
@@ -9,8 +9,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestScopeDiscoveryIsOrderedAndDoesNotUseSuiteFactories(t *testing.T) {
--- a/integrations/ckconfig/go.mod
+++ b/integrations/ckconfig/go.mod
@@ -1,9 +1,8 @@
-module gitea.maximumdirect.net/eric/CommandKit/integrations/ckconfig
+module go.maximumdirect.net/ckconfig

 go 1.26.0

 require (
-	gitea.maximumdirect.net/eric/CommandKit v0.2.0
 	gitea.maximumdirect.net/eric/ConfigKit v0.8.0
 	go.yaml.in/yaml/v4 v4.0.0-rc.6
 )
@@ -12,4 +11,5 @@ require (
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/spf13/cobra v1.10.1 // indirect
 	github.com/spf13/pflag v1.0.9 // indirect
+	go.maximumdirect.net/commandkit v0.3.0
 )
--- a/integrations/ckconfig/go.sum
+++ b/integrations/ckconfig/go.sum
@@ -1,5 +1,3 @@
-gitea.maximumdirect.net/eric/CommandKit v0.2.0 h1:UNBjSq6XDZHdPqvZLOL3N5R1E1ol0jnfldgradU7eqw=
-gitea.maximumdirect.net/eric/CommandKit v0.2.0/go.mod h1:47DQ6Mo/yZqUVn5PAFRmPck91Zhf1jfaHDMoEZvUzsQ=
 gitea.maximumdirect.net/eric/ConfigKit v0.8.0 h1:xCIhYnOHjw7rFvB+vIremPKGeROOxKTomnUEUipuQno=
 gitea.maximumdirect.net/eric/ConfigKit v0.8.0/go.mod h1:C82sbyKHYMV1OwaD2GJanFrwTfcZfjlW2JsGze5b0kA=
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
@@ -10,6 +8,8 @@ github.com/spf13/cobra v1.10.1 h1:lJeBwCfmrnXthfAupyUTzJ/J4Nc1RsHC/mSRU2dll/s=
 github.com/spf13/cobra v1.10.1/go.mod h1:7SmJGaTHFVBY0jW4NXGluQoLvhqFQM+6XSKD+P4XaB0=
 github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
 github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+go.maximumdirect.net/commandkit v0.3.0 h1:RCmg2GS8uzlLSJCIqarpn1uFDec0W3ylNNRRPT6kUFE=
+go.maximumdirect.net/commandkit v0.3.0/go.mod h1:ZS98DewKNVBygKVDoh5MFD09CnPlP37dS9pVsID5Eoc=
 go.yaml.in/yaml/v4 v4.0.0-rc.6 h1:1h7H1ohdUh93/FyE4YaDa1Zh64K6VVbjF4K6WUxMtH4=
 go.yaml.in/yaml/v4 v4.0.0-rc.6/go.mod h1:aZqd9kCMsGL7AuUv/m/PvWLdg5sjJsZ4oHDEnfPPfY0=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
--- a/integrations/ckconfig/input.go
+++ b/integrations/ckconfig/input.go
@@ -4,8 +4,8 @@ import (
 	"fmt"
 	"strings"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 type configCommandInput[I, S any] struct {
--- a/integrations/ckconfig/operations.go
+++ b/integrations/ckconfig/operations.go
@@ -4,7 +4,7 @@ import (
 	"fmt"
 	"io"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func runConfigOperation[I, S any](invocation commandkit.Invocation, operation Operation, input *configCommandInput[I, S]) commandkit.Outcome {
--- a/integrations/ckconfig/report_cancellation_test.go
+++ b/integrations/ckconfig/report_cancellation_test.go
@@ -6,7 +6,7 @@ import (
 	"io"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 func TestBufferedReportCancellationBeforeDelivery(t *testing.T) {
--- a/integrations/ckconfig/show.go
+++ b/integrations/ckconfig/show.go
@@ -7,7 +7,7 @@ import (
 	"strconv"
 	"unicode"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
+	commandkit "go.maximumdirect.net/commandkit"
 )

 type effectiveDocument struct {
--- a/integrations/ckconfig/sources.go
+++ b/integrations/ckconfig/sources.go
@@ -6,8 +6,8 @@ import (
 	"io"
 	"strconv"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 	"go.yaml.in/yaml/v4"
 )

--- a/integrations/ckconfig/sources_test.go
+++ b/integrations/ckconfig/sources_test.go
@@ -8,8 +8,8 @@ import (
 	"strings"
 	"testing"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
 	configkit "gitea.maximumdirect.net/eric/ConfigKit"
+	commandkit "go.maximumdirect.net/commandkit"
 	"go.yaml.in/yaml/v4"
 )

--- a/integrations/ckconfig/validate.go
+++ b/integrations/ckconfig/validate.go
@@ -6,7 +6,7 @@ import (
 	"io"
 	"strings"

-	commandkit "gitea.maximumdirect.net/eric/CommandKit"
+	commandkit "go.maximumdirect.net/commandkit"
 	"go.yaml.in/yaml/v4"
 )