core/cli
8
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions 1
cli/docs/cmd/dev/example.md
Snider 654f8df1ad docs: add guides and fix documentation issues 
New documentation:
- getting-started.md: installation, first build, first release
- troubleshooting.md: common errors and fixes
- workflows.md: end-to-end task sequences
- glossary.md: term definitions
- migration.md: upgrading from legacy tools

Fixes:
- Command examples: core dev task* → core ai task*
- CI flag: --were-go-for-launch → --we-are-go-for-launch
- Setup commands: core health → core dev health
- Installation: circular core go install reference
- Cross-references: broken fragment links

Improvements:
- Added complete repos.yaml documentation
- Added comprehensive environment variables reference
- Added multiple installation methods (go install, binary, source)
- Moved TODO.md to docs/.internal/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:59:49 +00:00

3 KiB
Raw Blame History

Dev Examples

Multi-Repo Workflow

# Quick status
core dev health

# Detailed breakdown
core dev health --verbose

# Full workflow
core dev work

# Status only
core dev work --status

# Commit and push
core dev work --commit

# Commit dirty repos
core dev commit

# Commit all without prompting
core dev commit --all

# Push unpushed
core dev push

# Push without confirmation
core dev push --force

# Pull behind repos
core dev pull

# Pull all repos
core dev pull --all

GitHub Integration

# Open issues
core dev issues

# Filter by assignee
core dev issues --assignee @me

# Limit results
core dev issues --limit 5

# PRs needing review
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

# What depends on core-php?
core dev impact core-php

Task Management

# List tasks
core ai tasks

# Filter by status and priority
core ai tasks --status pending --priority high

# Filter by labels
core ai tasks --labels bug,urgent

# Show task details
core ai task abc123

# Auto-select highest priority task
core ai task --auto

# Claim a task
core ai task abc123 --claim

# Update task status
core ai task:update abc123 --status in_progress

# Add progress notes
core ai task:update abc123 --progress 50 --notes 'Halfway done'

# Complete a task
core ai task:complete abc123 --output 'Feature implemented'

# Mark as failed
core ai task:complete abc123 --failed --error 'Build failed'

# Commit with task reference
core ai task:commit abc123 -m 'add user authentication'

# Commit with scope and push
core ai task:commit abc123 -m 'fix login bug' --scope auth --push

# Create PR for task
core ai task:pr abc123

# Create draft PR with labels
core ai task:pr abc123 --draft --labels 'enhancement,needs-review'

Service API Management

# Synchronize public service APIs
core dev sync

# Or using the api command
core dev api sync

Dev Environment

# First time setup
core dev install
core dev boot

# Open shell
core dev shell

# Mount and serve
core dev serve

# Run tests
core dev test

# Sandboxed Claude
core dev claude

Configuration

repos.yaml

org: host-uk
repos:
  core-php:
    type: package
    description: Foundation framework
  core-tenant:
    type: package
    depends: [core-php]

~/.core/config.yaml

version: 1

images:
  source: auto  # auto | github | registry | cdn

  cdn:
    url: https://images.example.com/core-devops

  github:
    repo: host-uk/core-images

  registry:
    image: ghcr.io/host-uk/core-devops

.core/test.yaml

version: 1

commands:
  - name: unit
    run: vendor/bin/pest --parallel
  - name: types
    run: vendor/bin/phpstan analyse
  - name: lint
    run: vendor/bin/pint --test

env:
  APP_ENV: testing
  DB_CONNECTION: sqlite