core/go
8
0
Fork 0
generated from lthn/LEM
Code Issues 2 Pull requests 1 Projects Releases Packages Wiki Activity Actions

docs: sync core dev and core go with CLI

Browse source 
Updated by technical writer agents:
- core dev: added task management, api, sync, ci commands
- core dev: fixed all flag discrepancies
- core go: added work subcommands (init, sync, use)
- core go: added missing flags (--json, --check, --open, --threshold)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Snider 2026-01-29 16:10:23 +00:00
parent ab1a808657
commit dea8f59c10
12 changed files with 595 additions and 218 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

141
docs/cmd/TODO.md
View file

@ -4,26 +4,6 @@ Commands and flags found in CLI but missing from documentation.
## Missing Commands ## Missing Commands
### core dev
- `core dev api` - Tools for managing service APIs
- `core dev api sync` - Synchronizes the public service APIs with their internal implementations
- `core dev sync` - Synchronizes the public service APIs (duplicate of api sync)
- `core dev ci` - Check CI status across all repos
- `core dev tasks` - List available tasks from core-agentic
- `core dev task` - Show task details or auto-select a task
- `core dev task:update` - Update task status or progress
- `core dev task:complete` - Mark a task as completed
- `core dev task:commit` - Auto-commit changes with task reference
- `core dev task:pr` - Create a pull request for a task
### core go
- `core go work` - Workspace management (init, sync, use)
- `core go work sync` - Sync workspace
- `core go work init` - Initialize workspace
- `core go work use` - Add module to workspace
### core build ### core build
- `core build from-path` - Build from a local directory - `core build from-path` - Build from a local directory
@ -43,99 +23,6 @@ Commands and flags found in CLI but missing from documentation.
## Missing Flags ## Missing Flags
### core dev boot
- `--fresh` - Stop existing and start fresh
### core dev claude
- `--model` - Model to use (opus, sonnet)
### core dev install
- Docs mention `--source` and `--force` flags that don't appear in CLI help
### core dev tasks
- `--status` - Filter by status (pending, in_progress, completed, blocked)
- `--priority` - Filter by priority (critical, high, medium, low)
- `--labels` - Filter by labels (comma-separated)
- `--project` - Filter by project
- `--limit` - Max number of tasks to return (default 20)
### core dev task
- `--auto` - Auto-select highest priority pending task
- `--claim` - Claim the task after showing details
- `--context` - Show gathered context for AI collaboration
### core dev task:update
- `--status` - New status (pending, in_progress, completed, blocked)
- `--progress` - Progress percentage (0-100)
- `--notes` - Notes about the update
### core dev task:complete
- `--output` - Summary of the completed work
- `--failed` - Mark the task as failed
- `--error` - Error message if failed
### core dev task:commit
- `--message` / `-m` - Commit message
- `--scope` - Scope for the commit type
- `--push` - Push changes after committing
### core dev task:pr
- `--title` - PR title
- `--draft` - Create as draft PR
- `--labels` - Labels to add (comma-separated)
- `--base` - Base branch (defaults to main)
### core dev health
- `--verbose` - Show detailed breakdown
### core dev issues
- `--assignee` - Filter by assignee (use @me for yourself)
- `--limit` - Max issues per repo (default 10)
- Docs mention `--label` which is not in CLI; CLI has `--assignee` instead
### core dev reviews
- `--all` - Show all PRs including drafts
- `--author` - Filter by PR author
### core dev ci
- `--branch` - Filter by branch (default: main)
- `--failed` - Show only failed runs
### core dev update
- `--apply` - Download and apply the update (docs mention `--force` instead)
### core dev test
- `--name` - Run named test command from .core/test.yaml
- Docs mention `--unit` which is not in CLI
### core go test
- `--json` - Output JSON results
### core go cov
- `--open` - Generate and open HTML report in browser
- `--threshold` - Minimum coverage percentage (exit 1 if below)
### core go fmt
- `--check` - Check only, exit 1 if not formatted
### core build ### core build
- `--archive` - Create archives (tar.gz for linux/darwin, zip for windows) - `--archive` - Create archives (tar.gz for linux/darwin, zip for windows)
@ -198,30 +85,6 @@ Commands and flags found in CLI but missing from documentation.
- Docs describe `core sdk generate` command but CLI only has `core sdk diff` and `core sdk validate` - Docs describe `core sdk generate` command but CLI only has `core sdk diff` and `core sdk validate`
- SDK generation is actually at `core build sdk`, not `core sdk generate` - SDK generation is actually at `core build sdk`, not `core sdk generate`
### core dev install
- Docs mention `--source` and `--force` flags that are not shown in CLI help
### core dev update
- Docs mention `--force` flag but CLI has `--apply` instead
### core dev test
- Docs mention `--unit` flag but CLI has `--name` flag
### core dev issues
- Docs mention `--label` flag but CLI has `--assignee` flag and no `--label`
### core dev push
- Docs mention `--all` flag but CLI only has `--force` flag
### core dev pull
- Docs mention `--rebase` flag but CLI only has `--all` flag
### core setup ### core setup
- Docs mention `--path` and `--ssh` flags but CLI has `--dry-run` and `--only` flags instead - Docs mention `--path` and `--ssh` flags but CLI has `--dry-run` and `--only` flags instead
@ -234,7 +97,3 @@ Commands and flags found in CLI but missing from documentation.
### core php serve ### core php serve
- Docs mention `--production` flag but CLI has different flags: `--name`, `--tag`, `--port`, `--https-port`, `-d`, `--env-file`, `--container` - Docs mention `--production` flag but CLI has different flags: `--name`, `--tag`, `--port`, `--https-port`, `-d`, `--env-file`, `--container`
### core dev work/commit/push flags
- Documentation flags don't match CLI flags in several places (e.g., `--message` vs no such flag in CLI)

95
docs/cmd/dev/example.md
View file

@ -6,20 +6,35 @@
# Quick status # Quick status
core dev health core dev health
# Detailed breakdown
core dev health --verbose
# Full workflow # Full workflow
core dev work core dev work
# Status only # Status only
core dev work --status core dev work --status
# Commit and push
core dev work --commit
# Commit dirty repos # Commit dirty repos
core dev commit core dev commit
# Commit all without prompting
core dev commit --all
# Push unpushed # Push unpushed
core dev push core dev push
# Pull behind # Push without confirmation
core dev push --force
# Pull behind repos
core dev pull core dev pull
# Pull all repos
core dev pull --all
``` ```
## GitHub Integration ## GitHub Integration
@ -28,11 +43,29 @@ core dev pull
# Open issues # Open issues
core dev issues core dev issues
# Include closed # Filter by assignee
core dev issues --all core dev issues --assignee @me
# Limit results
core dev issues --limit 5
# PRs needing review # PRs needing review
core dev reviews core dev reviews
# All PRs including drafts
core dev reviews --all
# Filter by author
core dev reviews --author username
# CI status
core dev ci
# Only failed runs
core dev ci --failed
# Specific branch
core dev ci --branch develop
``` ```
## Dependency Analysis ## Dependency Analysis
@ -42,6 +75,62 @@ core dev reviews
core dev impact core-php core dev impact core-php
``` ```
## Task Management
```bash
# List tasks
core dev tasks
# Filter by status and priority
core dev tasks --status pending --priority high
# Filter by labels
core dev tasks --labels bug,urgent
# Show task details
core dev task abc123
# Auto-select highest priority task
core dev task --auto
# Claim a task
core dev task abc123 --claim
# Update task status
core dev task:update abc123 --status in_progress
# Add progress notes
core dev task:update abc123 --progress 50 --notes 'Halfway done'
# Complete a task
core dev task:complete abc123 --output 'Feature implemented'
# Mark as failed
core dev task:complete abc123 --failed --error 'Build failed'
# Commit with task reference
core dev task:commit abc123 -m 'add user authentication'
# Commit with scope and push
core dev task:commit abc123 -m 'fix login bug' --scope auth --push
# Create PR for task
core dev task:pr abc123
# Create draft PR with labels
core dev task:pr abc123 --draft --labels 'enhancement,needs-review'
```
## Service API Management
```bash
# Synchronize public service APIs
core dev sync
# Or using the api command
core dev api sync
```
## Dev Environment ## Dev Environment
```bash ```bash

292
docs/cmd/dev/index.md
View file

@ -13,7 +13,21 @@ Multi-repo workflow and portable development environment.
| `pull` | Pull repos that are behind | | `pull` | Pull repos that are behind |
| `issues` | List open issues | | `issues` | List open issues |
| `reviews` | List PRs needing review | | `reviews` | List PRs needing review |
| `ci` | Check CI status |
| `impact` | Show dependency impact | | `impact` | Show dependency impact |
| `api` | Tools for managing service APIs |
| `sync` | Synchronize public service APIs |
## Task Management Commands
| Command | Description |
|---------|-------------|
| `tasks` | List available tasks from core-agentic |
| `task` | Show task details or auto-select a task |
| `task:update` | Update task status or progress |
| `task:complete` | Mark a task as completed |
| `task:commit` | Auto-commit changes with task reference |
| `task:pr` | Create a pull request for a task |
## Dev Environment Commands ## Dev Environment Commands
@ -54,24 +68,16 @@ core dev serve
Download the core-devops image for your platform. Download the core-devops image for your platform.
```bash ```bash
core dev install [flags] core dev install
``` ```
### Flags Downloads the platform-specific dev environment image including Go, PHP, Node.js, Python, Docker, and Claude CLI. Downloads are cached at `~/.core/images/`.
| Flag | Description |
|------|-------------|
| `--source` | Image source: `github`, `registry`, `cdn` (default: auto) |
| `--force` | Force re-download even if exists |
### Examples ### Examples
```bash ```bash
# Download image (auto-detects platform) # Download image (auto-detects platform)
core dev install core dev install
# Force re-download
core dev install --force
``` ```
## dev boot ## dev boot
@ -87,8 +93,8 @@ core dev boot [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--memory` | Memory allocation in MB (default: 4096) | | `--memory` | Memory allocation in MB (default: 4096) |
| `--cpus` | Number of CPUs (default: 4) | | `--cpus` | Number of CPUs (default: 2) |
| `--name` | Container name (default: core-dev) | | `--fresh` | Stop existing and start fresh |
### Examples ### Examples
@ -97,7 +103,10 @@ core dev boot [flags]
core dev boot core dev boot
# More resources # More resources
core dev boot --memory 8192 --cpus 8 core dev boot --memory 8192 --cpus 4
# Fresh start
core dev boot --fresh
``` ```
## dev shell ## dev shell
@ -105,9 +114,11 @@ core dev boot --memory 8192 --cpus 8
Open a shell in the running environment. Open a shell in the running environment.
```bash ```bash
core dev shell [flags] core dev shell [flags] [-- command]
``` ```
Uses SSH by default, or serial console with `--console`.
### Flags ### Flags
| Flag | Description | | Flag | Description |
@ -122,6 +133,9 @@ core dev shell
# Serial console (for debugging) # Serial console (for debugging)
core dev shell --console core dev shell --console
# Run a command
core dev shell -- ls -la
``` ```
## dev serve ## dev serve
@ -170,11 +184,11 @@ core dev test [flags] [-- custom command]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--unit` | Run only unit tests | | `--name` | Run named test command from `.core/test.yaml` |
### Test Detection ### Test Detection
Core auto-detects the test framework: Core auto-detects the test framework or uses `.core/test.yaml`:
1. `.core/test.yaml` - Custom config 1. `.core/test.yaml` - Custom config
2. `composer.json` → `composer test` 2. `composer.json` → `composer test`
@ -189,6 +203,9 @@ Core auto-detects the test framework:
# Auto-detect and run tests # Auto-detect and run tests
core dev test core dev test
# Run named test from config
core dev test --name integration
# Custom command # Custom command
core dev test -- go test -v ./pkg/... core dev test -- go test -v ./pkg/...
``` ```
@ -225,8 +242,9 @@ core dev claude [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--no-auth` | Clean session without host credentials | | `--model` | Model to use (`opus`, `sonnet`) |
| `--auth` | Selective auth forwarding (e.g., `gh,anthropic`) | | `--no-auth` | Don't forward any auth credentials |
| `--auth` | Selective auth forwarding (`gh`, `anthropic`, `ssh`, `git`) |
### What Gets Forwarded ### What Gets Forwarded
@ -242,11 +260,14 @@ By default, these are forwarded to the sandbox:
# Full auth forwarding (default) # Full auth forwarding (default)
core dev claude core dev claude
# Use Opus model
core dev claude --model opus
# Clean sandbox # Clean sandbox
core dev claude --no-auth core dev claude --no-auth
# Only GitHub auth # Only GitHub and Anthropic auth
core dev claude --auth=gh core dev claude --auth gh,anthropic
``` ```
### Why Use This? ### Why Use This?
@ -273,7 +294,7 @@ Output includes:
## dev update ## dev update
Check for and download newer images. Check for and apply updates.
```bash ```bash
core dev update [flags] core dev update [flags]
@ -283,7 +304,17 @@ core dev update [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--force` | Force download even if up to date | | `--apply` | Download and apply the update |
### Examples
```bash
# Check for updates
core dev update
# Apply available update
core dev update --apply
```
## Embedded Tools ## Embedded Tools
@ -339,6 +370,223 @@ Images are stored in `~/.core/images/`:
└── manifest.json └── manifest.json
``` ```
## Multi-Repo Commands
See the [work](work/) page for detailed documentation on multi-repo commands.
### dev ci
Check GitHub Actions workflow status across all repos.
```bash
core dev ci [flags]
```
#### Flags
| Flag | Description |
|------|-------------|
| `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--branch` | Filter by branch (default: main) |
| `--failed` | Show only failed runs |
Requires the `gh` CLI to be installed and authenticated.
### dev api
Tools for managing service APIs.
```bash
core dev api sync
```
Synchronizes the public service APIs with their internal implementations.
### dev sync
Alias for `core dev api sync`. Synchronizes the public service APIs with their internal implementations.
```bash
core dev sync
```
This command scans the `pkg` directory for services and ensures that the top-level public API for each service is in sync with its internal implementation. It automatically generates the necessary Go files with type aliases.
## Task Management Commands
The task commands integrate with the core-agentic service for AI-powered task management.
### Configuration
Task commands load configuration from:
1. Environment variables (`AGENTIC_TOKEN`, `AGENTIC_BASE_URL`)
2. `.env` file in current directory
3. `~/.core/agentic.yaml`
### dev tasks
List available tasks from core-agentic.
```bash
core dev tasks [flags]
```
#### Flags
| Flag | Description |
|------|-------------|
| `--status` | Filter by status (`pending`, `in_progress`, `completed`, `blocked`) |
| `--priority` | Filter by priority (`critical`, `high`, `medium`, `low`) |
| `--labels` | Filter by labels (comma-separated) |
| `--project` | Filter by project |
| `--limit` | Max number of tasks to return (default: 20) |
#### Examples
```bash
core dev tasks
core dev tasks --status pending --priority high
core dev tasks --labels bug,urgent
```
### dev task
Show task details or auto-select a task.
```bash
core dev task [task-id] [flags]
```
#### Flags
| Flag | Description |
|------|-------------|
| `--auto` | Auto-select highest priority pending task |
| `--claim` | Claim the task after showing details |
| `--context` | Show gathered context for AI collaboration |
#### Examples
```bash
# Show task details
core dev task abc123
# Show and claim
core dev task abc123 --claim
# Show with context
core dev task abc123 --context
# Auto-select highest priority pending task
core dev task --auto
```
### dev task:update
Update a task's status, progress, or notes.
```bash
core dev task:update <task-id> [flags]
```
#### Flags
| Flag | Description |
|------|-------------|
| `--status` | New status (`pending`, `in_progress`, `completed`, `blocked`) |
| `--progress` | Progress percentage (0-100) |
| `--notes` | Notes about the update |
#### Examples
```bash
core dev task:update abc123 --status in_progress
core dev task:update abc123 --progress 50 --notes 'Halfway done'
```
### dev task:complete
Mark a task as completed with optional output and artifacts.
```bash
core dev task:complete <task-id> [flags]
```
#### Flags
| Flag | Description |
|------|-------------|
| `--output` | Summary of the completed work |
| `--failed` | Mark the task as failed |
| `--error` | Error message if failed |
#### Examples
```bash
core dev task:complete abc123 --output 'Feature implemented'
core dev task:complete abc123 --failed --error 'Build failed'
```
### dev task:commit
Create a git commit with a task reference and co-author attribution.
```bash
core dev task:commit <task-id> [flags]
```
Commit message format:
```
feat(scope): description
Task: #123
Co-Authored-By: Claude <noreply@anthropic.com>
```
#### Flags
| Flag | Description |
|------|-------------|
| `-m`, `--message` | Commit message (without task reference) |
| `--scope` | Scope for the commit type (e.g., `auth`, `api`, `ui`) |
| `--push` | Push changes after committing |
#### Examples
```bash
core dev task:commit abc123 --message 'add user authentication'
core dev task:commit abc123 -m 'fix login bug' --scope auth
core dev task:commit abc123 -m 'update docs' --push
```
### dev task:pr
Create a GitHub pull request linked to a task.
```bash
core dev task:pr <task-id> [flags]
```
Requires the GitHub CLI (`gh`) to be installed and authenticated.
#### Flags
| Flag | Description |
|------|-------------|
| `--title` | PR title (defaults to task title) |
| `--base` | Base branch (defaults to main) |
| `--draft` | Create as draft PR |
| `--labels` | Labels to add (comma-separated) |
#### Examples
```bash
core dev task:pr abc123
core dev task:pr abc123 --title 'Add authentication feature'
core dev task:pr abc123 --draft --labels 'enhancement,needs-review'
core dev task:pr abc123 --base develop
```
## See Also ## See Also
- [work](work/) - Multi-repo workflow commands (`core dev work`, `core dev health`, etc.) - [work](work/) - Multi-repo workflow commands (`core dev work`, `core dev health`, etc.)

213
docs/cmd/dev/work/index.md
View file

@ -12,26 +12,77 @@ The `core dev work` command and related subcommands help manage multiple reposit
|---------|-------------| |---------|-------------|
| `core dev work` | Full workflow: status + commit + push | | `core dev work` | Full workflow: status + commit + push |
| `core dev work --status` | Status table only | | `core dev work --status` | Status table only |
| `core dev work --commit` | Use Claude to commit dirty repos |
| `core dev health` | Quick health check across all repos | | `core dev health` | Quick health check across all repos |
| `core dev issues` | List open issues across all repos |
| `core dev reviews` | List PRs needing review |
| `core dev commit` | Claude-assisted commits across repos | | `core dev commit` | Claude-assisted commits across repos |
| `core dev push` | Push commits across all repos | | `core dev push` | Push commits across all repos |
| `core dev pull` | Pull updates across all repos | | `core dev pull` | Pull updates across all repos |
| `core dev issues` | List open issues across all repos |
| `core dev reviews` | List PRs needing review |
| `core dev ci` | Check CI status across all repos |
| `core dev impact` | Show impact of changing a repo | | `core dev impact` | Show impact of changing a repo |
## core dev work
Manage git status, commits, and pushes across multiple repositories.
```bash
core dev work [flags]
```
Reads `repos.yaml` to discover repositories and their relationships. Shows status, optionally commits with Claude, and pushes changes.
### Flags
| Flag | Description |
|------|-------------|
| `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--status` | Show status only, don't push |
| `--commit` | Use Claude to commit dirty repos before pushing |
### Examples
```bash
# Full workflow
core dev work
# Status only
core dev work --status
# Commit and push
core dev work --commit
```
## core dev health ## core dev health
Quick health check showing status of all repos. Quick health check showing summary of repository health across all repos.
```bash ```bash
core dev health core dev health [flags]
``` ```
### Flags
| Flag | Description |
|------|-------------|
| `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--verbose` | Show detailed breakdown |
Output shows: Output shows:
- Git status (clean/dirty) - Total repos
- Current branch - Dirty repos
- Commits ahead/behind remote - Unpushed commits
- Repos behind remote
### Examples
```bash
# Quick summary
core dev health
# Detailed breakdown
core dev health --verbose
```
## core dev issues ## core dev issues
@ -41,26 +92,59 @@ List open issues across all repositories.
core dev issues [flags] core dev issues [flags]
``` ```
Fetches open issues from GitHub for all repos in the registry. Requires the `gh` CLI to be installed and authenticated.
### Flags ### Flags
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--assignee` | Filter by assignee | | `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--label` | Filter by label | | `--assignee` | Filter by assignee (use `@me` for yourself) |
| `--limit` | Max issues per repo | | `--limit` | Max issues per repo (default: 10) |
### Examples
```bash
# List all open issues
core dev issues
# Filter by assignee
core dev issues --assignee @me
# Limit results
core dev issues --limit 5
```
## core dev reviews ## core dev reviews
List pull requests needing review. List pull requests needing review across all repos.
```bash ```bash
core dev reviews [flags] core dev reviews [flags]
``` ```
Shows PRs where: Fetches open PRs from GitHub for all repos in the registry. Shows review status (approved, changes requested, pending). Requires the `gh` CLI to be installed and authenticated.
- You are a requested reviewer
- PR is open and not draft ### Flags
- CI is passing
| Flag | Description |
|------|-------------|
| `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--all` | Show all PRs including drafts |
| `--author` | Filter by PR author |
### Examples
```bash
# List PRs needing review
core dev reviews
# Show all PRs including drafts
core dev reviews --all
# Filter by author
core dev reviews --author username
```
## core dev commit ## core dev commit
@ -70,14 +154,24 @@ Create commits across repos with Claude assistance.
core dev commit [flags] core dev commit [flags]
``` ```
Uses Claude to create commits for dirty repos. Shows uncommitted changes and invokes Claude to generate commit messages.
### Flags ### Flags
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--message` | Commit message (auto-generated if not provided) | | `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--all` | Commit in all dirty repos | | `--all` | Commit all dirty repos without prompting |
Claude analyzes changes and suggests conventional commit messages. ### Examples
```bash
# Commit with prompts
core dev commit
# Commit all automatically
core dev commit --all
```
## core dev push ## core dev push
@ -87,12 +181,24 @@ Push commits across all repos.
core dev push [flags] core dev push [flags]
``` ```
Pushes unpushed commits for all repos. Shows repos with commits to push and confirms before pushing.
### Flags ### Flags
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--all` | Push all repos with unpushed commits | | `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--force` | Force push (use with caution) | | `--force` | Skip confirmation prompt |
### Examples
```bash
# Push with confirmation
core dev push
# Skip confirmation
core dev push --force
```
## core dev pull ## core dev pull
@ -102,25 +208,78 @@ Pull updates across all repos.
core dev pull [flags] core dev pull [flags]
``` ```
Pulls updates for all repos. By default only pulls repos that are behind. Use `--all` to pull all repos.
### Flags ### Flags
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--all` | Pull all repos | | `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--rebase` | Rebase instead of merge | | `--all` | Pull all repos, not just those behind |
### Examples
```bash
# Pull repos that are behind
core dev pull
# Pull all repos
core dev pull --all
```
## core dev ci
Check GitHub Actions workflow status across all repos.
```bash
core dev ci [flags]
```
Fetches GitHub Actions workflow status for all repos. Shows latest run status for each repo. Requires the `gh` CLI to be installed and authenticated.
### Flags
| Flag | Description |
|------|-------------|
| `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
| `--branch` | Filter by branch (default: main) |
| `--failed` | Show only failed runs |
### Examples
```bash
# Show CI status for all repos
core dev ci
# Show only failed runs
core dev ci --failed
# Check specific branch
core dev ci --branch develop
```
## core dev impact ## core dev impact
Show the impact of changing a repository. Show the impact of changing a repository.
```bash ```bash
core dev impact <repo> core dev impact <repo> [flags]
``` ```
Shows: Analyzes the dependency graph to show which repos would be affected by changes to the specified repo.
- Dependent repos
- Reverse dependencies ### Flags
- Potential breaking changes
| Flag | Description |
|------|-------------|
| `--registry` | Path to `repos.yaml` (auto-detected if not specified) |
### Examples
```bash
# Show impact of changing core-php
core dev impact core-php
```
## Registry ## Registry

6
docs/cmd/go/cov/index.md
View file

@ -13,9 +13,9 @@ core go cov [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--pkg` | Package to test (default: `./...`) | | `--pkg` | Package to test (default: `./...`) |
| `--html` | Generate HTML report | | `--html` | Generate HTML coverage report |
| `--open` | Open in browser | | `--open` | Generate and open HTML report in browser |
| `--threshold` | Fail if coverage below % | | `--threshold` | Minimum coverage percentage (exit 1 if below) |
## Examples ## Examples

9
docs/cmd/go/fmt/index.md
View file

@ -12,13 +12,14 @@ core go fmt [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--fix` | Apply fixes (default: check only) | | `--fix` | Fix formatting in place |
| `--diff` | Show diff | | `--diff` | Show diff of changes |
| `--check` | Check only, exit 1 if not formatted |
## Examples ## Examples
```bash ```bash
core go fmt # Check core go fmt # Check formatting
core go fmt --fix # Apply fixes core go fmt --fix # Fix formatting
core go fmt --diff # Show diff core go fmt --diff # Show diff
``` ```

13
docs/cmd/go/index.md
View file

@ -1,14 +1,15 @@
# core go # core go
Go development tools. Go development tools with enhanced output and environment setup.
## Subcommands ## Subcommands
| Command | Description | | Command | Description |
|---------|-------------| |---------|-------------|
| [test](test/) | Run tests | | [test](test/) | Run tests with coverage |
| [cov](cov/) | Coverage report | | [cov](cov/) | Run tests with coverage report |
| [fmt](fmt/) | Format code | | [fmt](fmt/) | Format Go code |
| [lint](lint/) | Lint code | | [lint](lint/) | Run golangci-lint |
| [install](install/) | Install binary | | [install](install/) | Install Go binary |
| [mod](mod/) | Module management | | [mod](mod/) | Module management |
| [work](work/) | Workspace management |

7
docs/cmd/go/install/index.md
View file

@ -18,7 +18,8 @@ core go install [path] [flags]
## Examples ## Examples
```bash ```bash
core go install # Auto-detect cmd/ core go install # Install current module
core go install ./cmd/core # Specific path core go install ./cmd/core # Install specific path
core go install --no-cgo # Pure Go core go install --no-cgo # Pure Go (no C dependencies)
core go install -v # Verbose output
``` ```

2
docs/cmd/go/lint/index.md
View file

@ -12,7 +12,7 @@ core go lint [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--fix` | Auto-fix issues | | `--fix` | Fix issues automatically |
## Examples ## Examples

6
docs/cmd/go/mod/index.md
View file

@ -6,10 +6,10 @@ Module management.
| Command | Description | | Command | Description |
|---------|-------------| |---------|-------------|
| `tidy` | Tidy go.mod | | `tidy` | Add missing and remove unused modules |
| `download` | Download dependencies | | `download` | Download modules to local cache |
| `verify` | Verify dependencies | | `verify` | Verify dependencies |
| `graph` | Show dependency graph | | `graph` | Print module dependency graph |
## Examples ## Examples

10
docs/cmd/go/test/index.md
View file

@ -13,11 +13,11 @@ core go test [flags]
| Flag | Description | | Flag | Description |
|------|-------------| |------|-------------|
| `--pkg` | Package to test (default: `./...`) | | `--pkg` | Package to test (default: `./...`) |
| `--run` | Run specific tests | | `--run` | Run only tests matching regexp |
| `--short` | Skip long-running tests | | `--short` | Run only short tests |
| `--race` | Enable race detection | | `--race` | Enable race detector |
| `--coverage` | Show coverage summary | | `--coverage` | Show detailed per-package coverage |
| `--json` | JSON output for CI | | `--json` | Output JSON results |
| `-v` | Verbose output | | `-v` | Verbose output |
## Examples ## Examples

19
docs/cmd/go/work/index.md Normal file
View file

@ -0,0 +1,19 @@
# core go work
Go workspace management commands.
## Subcommands
| Command | Description |
|---------|-------------|
| `sync` | Sync go.work with modules |
| `init` | Initialize go.work |
| `use` | Add module to workspace |
## Examples
```bash
core go work sync # Sync workspace
core go work init # Initialize workspace
core go work use ./pkg/mymodule # Add module to workspace
```