cli/cmd/core.go
Snider 9931593f9d refactor(cli): move commands from cmd/ to pkg/ with self-registration
Implements defence in depth through build variants - only compiled code
exists in the binary. Commands now self-register via cli.RegisterCommands()
in their init() functions, mirroring the i18n.RegisterLocales() pattern.

Structure changes:
- cmd/{ai,build,ci,dev,docs,doctor,go,php,pkg,sdk,setup,test,vm}/ → pkg/*/cmd_*.go
- cmd/core_dev.go, cmd/core_ci.go → cmd/variants/{full,ci,php,minimal}.go
- Added pkg/cli/commands.go with RegisterCommands API
- Updated pkg/cli/runtime.go to attach registered commands

Build variants:
- go build           → full (21MB, all 13 command groups)
- go build -tags ci  → ci (18MB, build/ci/sdk/doctor)
- go build -tags php → php (14MB, php/doctor)
- go build -tags minimal → minimal (11MB, doctor only)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 21:55:55 +00:00

118 lines
3.4 KiB
Go

// Package cmd implements the core CLI application.
//
// The CLI provides commands for:
// - Multi-repo development workflows (dev)
// - AI agent task management (ai)
// - Go and PHP development tools (go, php)
// - Build and release automation (build, ci)
// - SDK validation and API compatibility (sdk)
// - Package and environment management (pkg, vm)
// - Documentation and testing (docs, test)
// - Environment health checks (doctor)
// - Repository setup and cloning (setup)
//
// Two build variants exist:
// - Default build: Full development toolset
// - CI build (-tags ci): Minimal release toolset
package cmd
import (
"os"
"github.com/host-uk/core/pkg/cli"
"github.com/host-uk/core/pkg/framework"
"github.com/spf13/cobra"
// Build variants import commands via self-registration.
// See cmd/variants/ for available variants: full, ci, php, minimal.
_ "github.com/host-uk/core/cmd/variants"
)
const (
appName = "core"
appVersion = "0.1.0"
)
// Execute initialises and runs the CLI application.
// Commands are registered based on build tags (see core_ci.go and core_dev.go).
func Execute() error {
// Initialise CLI runtime with services
if err := cli.Init(cli.Options{
AppName: appName,
Version: appVersion,
Services: []framework.Option{
framework.WithName("i18n", cli.NewI18nService(cli.I18nOptions{})),
framework.WithName("log", cli.NewLogService(cli.LogOptions{
Level: cli.LogLevelInfo,
})),
},
}); err != nil {
return err
}
defer cli.Shutdown()
// Add completion command to the CLI's root
cli.RootCmd().AddCommand(completionCmd)
return cli.Execute()
}
// completionCmd generates shell completion scripts.
var completionCmd = &cobra.Command{
Use: "completion [bash|zsh|fish|powershell]",
Short: "Generate shell completion script",
Long: `Generate shell completion script for the specified shell.
To load completions:
Bash:
$ source <(core completion bash)
# To load completions for each session, execute once:
# Linux:
$ core completion bash > /etc/bash_completion.d/core
# macOS:
$ core completion bash > $(brew --prefix)/etc/bash_completion.d/core
Zsh:
# If shell completion is not already enabled in your environment,
# you will need to enable it. You can execute the following once:
$ echo "autoload -U compinit; compinit" >> ~/.zshrc
# To load completions for each session, execute once:
$ core completion zsh > "${fpath[1]}/_core"
# You will need to start a new shell for this setup to take effect.
Fish:
$ core completion fish | source
# To load completions for each session, execute once:
$ core completion fish > ~/.config/fish/completions/core.fish
PowerShell:
PS> core completion powershell | Out-String | Invoke-Expression
# To load completions for every new session, run:
PS> core completion powershell > core.ps1
# and source this file from your PowerShell profile.
`,
DisableFlagsInUseLine: true,
ValidArgs: []string{"bash", "zsh", "fish", "powershell"},
Args: cobra.MatchAll(cobra.ExactArgs(1), cobra.OnlyValidArgs),
Run: func(cmd *cobra.Command, args []string) {
switch args[0] {
case "bash":
_ = cmd.Root().GenBashCompletion(os.Stdout)
case "zsh":
_ = cmd.Root().GenZshCompletion(os.Stdout)
case "fish":
_ = cmd.Root().GenFishCompletion(os.Stdout, true)
case "powershell":
_ = cmd.Root().GenPowerShellCompletionWithDesc(os.Stdout)
}
},
}