2026-01-30 00:22:47 +00:00
|
|
|
// Package dev provides multi-repo development workflow commands.
|
|
|
|
|
//
|
|
|
|
|
// Git Operations:
|
|
|
|
|
// - work: Combined status, commit, and push workflow
|
|
|
|
|
// - health: Quick health check across all repos
|
|
|
|
|
// - commit: Claude-assisted commit message generation
|
|
|
|
|
// - push: Push repos with unpushed commits
|
|
|
|
|
// - pull: Pull repos that are behind remote
|
|
|
|
|
//
|
|
|
|
|
// GitHub Integration (requires gh CLI):
|
|
|
|
|
// - issues: List open issues across repos
|
|
|
|
|
// - reviews: List PRs needing review
|
|
|
|
|
// - ci: Check GitHub Actions CI status
|
|
|
|
|
// - impact: Analyse dependency impact of changes
|
|
|
|
|
//
|
2026-02-01 05:20:46 +00:00
|
|
|
// CI/Workflow Management:
|
|
|
|
|
// - workflow list: Show table of repos vs workflows
|
|
|
|
|
// - workflow sync: Copy workflow template to all repos
|
|
|
|
|
//
|
2026-01-30 00:22:47 +00:00
|
|
|
// API Tools:
|
|
|
|
|
// - api sync: Synchronize public service APIs
|
|
|
|
|
//
|
|
|
|
|
// Dev Environment (VM management):
|
|
|
|
|
// - install: Download dev environment image
|
|
|
|
|
// - boot: Start dev environment VM
|
|
|
|
|
// - stop: Stop dev environment VM
|
|
|
|
|
// - status: Check dev VM status
|
|
|
|
|
// - shell: Open shell in dev VM
|
|
|
|
|
// - serve: Mount project and start dev server
|
|
|
|
|
// - test: Run tests in dev environment
|
|
|
|
|
// - claude: Start sandboxed Claude session
|
|
|
|
|
// - update: Check for and apply updates
|
refactor(cli): restructure cmd packages into subdirectories
- Move CLI commands into subdirectories matching command hierarchy:
dev/, go/, php/, build/, ci/, sdk/, pkg/, vm/, docs/, setup/, doctor/, test/, ai/
- Create shared/ package for common styles and utilities
- Add new `core ai` root command with claude subcommand
- Update package declarations and imports across all files
- Create commands.go entry points for each package
- Remove GUI-related files (moved to core-gui repo)
This makes the filesystem structure match the CLI command structure,
improving context capture and code organization.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 18:02:43 +00:00
|
|
|
package dev
|
2026-01-29 02:23:29 +00:00
|
|
|
|
|
|
|
|
import (
|
2026-02-16 14:24:37 +00:00
|
|
|
"forge.lthn.ai/core/go/pkg/cli"
|
|
|
|
|
"forge.lthn.ai/core/go/pkg/i18n"
|
2026-01-29 02:23:29 +00:00
|
|
|
)
|
|
|
|
|
|
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
|
|
|
func init() {
|
|
|
|
|
cli.RegisterCommands(AddDevCommands)
|
|
|
|
|
}
|
|
|
|
|
|
2026-01-30 00:22:47 +00:00
|
|
|
// Style aliases from shared package
|
2026-01-29 02:23:29 +00:00
|
|
|
var (
|
2026-01-30 10:32:05 +00:00
|
|
|
successStyle = cli.SuccessStyle
|
|
|
|
|
errorStyle = cli.ErrorStyle
|
|
|
|
|
warningStyle = cli.WarningStyle
|
|
|
|
|
dimStyle = cli.DimStyle
|
|
|
|
|
valueStyle = cli.ValueStyle
|
|
|
|
|
headerStyle = cli.HeaderStyle
|
2026-01-31 23:36:43 +00:00
|
|
|
repoNameStyle = cli.RepoStyle
|
2026-01-30 00:22:47 +00:00
|
|
|
)
|
2026-01-29 02:23:29 +00:00
|
|
|
|
2026-01-30 01:35:13 +00:00
|
|
|
// Table styles for status display (extends shared styles with cell padding)
|
2026-01-30 00:22:47 +00:00
|
|
|
var (
|
2026-01-31 23:36:43 +00:00
|
|
|
dirtyStyle = cli.NewStyle().Foreground(cli.ColourRed500)
|
|
|
|
|
aheadStyle = cli.NewStyle().Foreground(cli.ColourAmber500)
|
|
|
|
|
cleanStyle = cli.NewStyle().Foreground(cli.ColourGreen500)
|
2026-01-29 02:23:29 +00:00
|
|
|
)
|
|
|
|
|
|
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
|
|
|
// AddDevCommands registers the 'dev' command and all subcommands.
|
2026-01-31 11:39:19 +00:00
|
|
|
func AddDevCommands(root *cli.Command) {
|
|
|
|
|
devCmd := &cli.Command{
|
2026-01-30 00:47:54 +00:00
|
|
|
Use: "dev",
|
feat(i18n): add translation keys to all CLI commands
Replace hardcoded strings with i18n.T() calls across all cmd/* packages:
- ai, build, ci, dev, docs, doctor, go, php, pkg, sdk, setup, test, vm
Adds 500+ translation keys to en.json for command descriptions,
flag descriptions, labels, messages, and error strings.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 02:37:57 +00:00
|
|
|
Short: i18n.T("cmd.dev.short"),
|
|
|
|
|
Long: i18n.T("cmd.dev.long"),
|
2026-01-30 00:47:54 +00:00
|
|
|
}
|
|
|
|
|
root.AddCommand(devCmd)
|
2026-01-30 00:22:47 +00:00
|
|
|
|
feat: git command, build improvements, and go fmt git-aware (#74)
* feat(go): make go fmt git-aware by default
- By default, only check changed Go files (modified, staged, untracked)
- Add --all flag to check all files (previous behaviour)
- Reduces noise when running fmt on large codebases
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(build): minimal output by default, add missing i18n
- Default output now shows single line: "Success Built N artifacts (dir)"
- Add --verbose/-v flag to show full detailed output
- Add all missing i18n translations for build commands
- Errors still show failure reason in minimal mode
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add root-level `core git` command
- Create pkg/gitcmd with git workflow commands as root menu
- Export command builders from pkg/dev (AddCommitCommand, etc.)
- Commands available under both `core git` and `core dev` for compatibility
- Git commands: health, commit, push, pull, work, sync, apply
- GitHub orchestration stays in dev: issues, reviews, ci, impact
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(qa): add docblock coverage checking
Implement docblock/docstring coverage analysis for Go code:
- New `core qa docblock` command to check coverage
- Shows compact file:line list when under threshold
- Integrate with `core go qa` as a default check
- Add --docblock-threshold flag (default 80%)
The checker uses Go AST parsing to find exported symbols
(functions, types, consts, vars) without documentation.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback
- Fix doc comment: "status" → "health" in gitcmd package
- Implement --check flag for `core go fmt` (exits non-zero if files need formatting)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: add docstrings for 100% coverage
Add documentation comments to all exported symbols:
- pkg/build: ProjectType constants
- pkg/cli: LogLevel, RenderStyle, TableStyle
- pkg/framework: ServiceFor, MustServiceFor, Core.Core
- pkg/git: GitError.Error, GitError.Unwrap
- pkg/i18n: Handler Match/Handle methods
- pkg/log: Level constants
- pkg/mcp: Tool input/output types
- pkg/php: Service constants, QA types, service methods
- pkg/process: ServiceError.Error
- pkg/repos: RepoType constants
- pkg/setup: ChangeType, ChangeCategory constants
- pkg/workspace: AddWorkspaceCommands
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: standardize line endings to LF
Add .gitattributes to enforce LF line endings for all text files.
Normalize all existing files to use Unix-style line endings.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback
- cmd_format.go: validate --check/--fix mutual exclusivity, capture stderr
- cmd_docblock.go: return error instead of os.Exit(1) for proper error handling
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback (round 2)
- linuxkit.go: propagate state update errors, handle cmd.Wait() errors in waitForExit
- mcp.go: guard against empty old_string in editDiff to prevent runaway edits
- cmd_docblock.go: log parse errors instead of silently skipping
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 10:48:44 +00:00
|
|
|
// Git operations (also available under 'core git')
|
|
|
|
|
AddWorkCommand(devCmd)
|
|
|
|
|
AddHealthCommand(devCmd)
|
|
|
|
|
AddCommitCommand(devCmd)
|
|
|
|
|
AddPushCommand(devCmd)
|
|
|
|
|
AddPullCommand(devCmd)
|
2026-01-30 00:22:47 +00:00
|
|
|
|
feat: git command, build improvements, and go fmt git-aware (#74)
* feat(go): make go fmt git-aware by default
- By default, only check changed Go files (modified, staged, untracked)
- Add --all flag to check all files (previous behaviour)
- Reduces noise when running fmt on large codebases
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(build): minimal output by default, add missing i18n
- Default output now shows single line: "Success Built N artifacts (dir)"
- Add --verbose/-v flag to show full detailed output
- Add all missing i18n translations for build commands
- Errors still show failure reason in minimal mode
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add root-level `core git` command
- Create pkg/gitcmd with git workflow commands as root menu
- Export command builders from pkg/dev (AddCommitCommand, etc.)
- Commands available under both `core git` and `core dev` for compatibility
- Git commands: health, commit, push, pull, work, sync, apply
- GitHub orchestration stays in dev: issues, reviews, ci, impact
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(qa): add docblock coverage checking
Implement docblock/docstring coverage analysis for Go code:
- New `core qa docblock` command to check coverage
- Shows compact file:line list when under threshold
- Integrate with `core go qa` as a default check
- Add --docblock-threshold flag (default 80%)
The checker uses Go AST parsing to find exported symbols
(functions, types, consts, vars) without documentation.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback
- Fix doc comment: "status" → "health" in gitcmd package
- Implement --check flag for `core go fmt` (exits non-zero if files need formatting)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: add docstrings for 100% coverage
Add documentation comments to all exported symbols:
- pkg/build: ProjectType constants
- pkg/cli: LogLevel, RenderStyle, TableStyle
- pkg/framework: ServiceFor, MustServiceFor, Core.Core
- pkg/git: GitError.Error, GitError.Unwrap
- pkg/i18n: Handler Match/Handle methods
- pkg/log: Level constants
- pkg/mcp: Tool input/output types
- pkg/php: Service constants, QA types, service methods
- pkg/process: ServiceError.Error
- pkg/repos: RepoType constants
- pkg/setup: ChangeType, ChangeCategory constants
- pkg/workspace: AddWorkspaceCommands
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: standardize line endings to LF
Add .gitattributes to enforce LF line endings for all text files.
Normalize all existing files to use Unix-style line endings.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback
- cmd_format.go: validate --check/--fix mutual exclusivity, capture stderr
- cmd_docblock.go: return error instead of os.Exit(1) for proper error handling
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: address CodeRabbit review feedback (round 2)
- linuxkit.go: propagate state update errors, handle cmd.Wait() errors in waitForExit
- mcp.go: guard against empty old_string in editDiff to prevent runaway edits
- cmd_docblock.go: log parse errors instead of silently skipping
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 10:48:44 +00:00
|
|
|
// Safe git operations for AI agents (also available under 'core git')
|
|
|
|
|
AddFileSyncCommand(devCmd)
|
|
|
|
|
AddApplyCommand(devCmd)
|
2026-02-01 06:11:24 +00:00
|
|
|
|
2026-01-30 00:22:47 +00:00
|
|
|
// GitHub integration
|
|
|
|
|
addIssuesCommand(devCmd)
|
|
|
|
|
addReviewsCommand(devCmd)
|
|
|
|
|
addCICommand(devCmd)
|
|
|
|
|
addImpactCommand(devCmd)
|
|
|
|
|
|
2026-02-01 05:20:46 +00:00
|
|
|
// CI/Workflow management
|
|
|
|
|
addWorkflowCommands(devCmd)
|
|
|
|
|
|
2026-01-30 00:22:47 +00:00
|
|
|
// API tools
|
|
|
|
|
addAPICommands(devCmd)
|
|
|
|
|
|
|
|
|
|
// Dev environment
|
|
|
|
|
addVMCommands(devCmd)
|
2026-01-29 02:23:29 +00:00
|
|
|
}
|