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>
118 lines
3.4 KiB
Go
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)
|
|
}
|
|
},
|
|
}
|