go/docs/cmd/TODO.md

Documentation TODO

Commands and flags found in CLI but missing from documentation.

Missing Commands

core php

• core php packages link - Link local packages (subcommand documentation exists but not detailed)
• core php packages unlink - Unlink packages
• core php packages update - Update linked packages
• core php packages list - List linked packages

core vm

• core vm templates show - Display template content
• core vm templates vars - Show template variables

Missing Flags

core setup

• --dry-run - Show what would be cloned without cloning
• --only - Only clone repos of these types (comma-separated: foundation,module,product)
• Docs mention --path and --ssh which are not in CLI

core doctor

• --verbose - Show detailed version information

core test

• All flags are missing from the minimal docs page:
  • --coverage - Show detailed per-package coverage
  • --json - Output JSON for CI/agents
  • --pkg - Package pattern to test
  • --race - Enable race detector
  • --run - Run only tests matching this regex
  • --short - Skip long-running tests
  • --verbose - Show test output as it runs

core pkg search

• --refresh - Bypass cache and fetch fresh data
• --type - Filter by type in name (mod, services, plug, website)

core pkg install

• --add - Add to repos.yaml registry

core vm run

• --ssh-port - SSH port for exec commands (default: 2222)

Discrepancies

core sdk

• 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

core setup

• Docs mention --path and --ssh flags but CLI has --dry-run and --only flags instead

core pkg

• Docs describe package management for "Go modules" but CLI help says it's for "core-* repos" (GitHub repos)
• core pkg install works differently: docs show Go module paths, CLI shows GitHub repo format

core php serve

• Docs mention --production flag but CLI has different flags: --name, --tag, --port, --https-port, -d, --env-file, --container