From 5652b6b508f737fa3235ff7b423a003e0078b89c Mon Sep 17 00:00:00 2001 From: Snider Date: Thu, 29 Jan 2026 15:40:13 +0000 Subject: [PATCH] docs: fix command prefixes - use 'core dev' not 'core' Multi-repo commands are under 'core dev': - core dev work, core dev health, core dev commit, etc. Not root-level commands. Co-Authored-By: Claude Opus 4.5 --- docs/cmd/dev/index.md | 19 +++++++++-- docs/cmd/dev/work/index.md | 66 +++++++++++++++----------------------- docs/cmd/index.md | 2 +- docs/index.md | 2 +- 4 files changed, 43 insertions(+), 46 deletions(-) diff --git a/docs/cmd/dev/index.md b/docs/cmd/dev/index.md index 1ba0d291..9f5874b3 100644 --- a/docs/cmd/dev/index.md +++ b/docs/cmd/dev/index.md @@ -1,8 +1,21 @@ # core dev -Portable development environment based on LinuxKit. +Multi-repo workflow and portable development environment. -## Commands +## Multi-Repo Commands + +| Command | Description | +|---------|-------------| +| [work](work/) | Full workflow: status + commit + push | +| `health` | Quick health check across repos | +| `commit` | Claude-assisted commits | +| `push` | Push repos with unpushed commits | +| `pull` | Pull repos that are behind | +| `issues` | List open issues | +| `reviews` | List PRs needing review | +| `impact` | Show dependency impact | + +## Dev Environment Commands | Command | Description | |---------|-------------| @@ -328,4 +341,4 @@ Images are stored in `~/.core/images/`: ## See Also -- [work](work/) - Multi-repo workflow commands (`core work`, `core health`, `core commit`, etc.) +- [work](work/) - Multi-repo workflow commands (`core dev work`, `core dev health`, etc.) diff --git a/docs/cmd/dev/work/index.md b/docs/cmd/dev/work/index.md index 976999e7..f12c20f3 100644 --- a/docs/cmd/dev/work/index.md +++ b/docs/cmd/dev/work/index.md @@ -1,45 +1,44 @@ -# core work +# core dev work Multi-repo git operations for managing the host-uk organization. ## Overview -The `work` command and related commands (`health`, `issues`, `reviews`, `commit`, `push`, `pull`, `impact`, `ci`) help manage multiple repositories in the host-uk ecosystem simultaneously. +The `core dev work` command and related subcommands help manage multiple repositories in the host-uk ecosystem simultaneously. ## Commands | Command | Description | |---------|-------------| -| `core work` | Multi-repo git operations | -| `core health` | Quick health check across all repos | -| `core issues` | List open issues across all repos | -| `core reviews` | List PRs needing review | -| `core commit` | Claude-assisted commits across repos | -| `core push` | Push commits across all repos | -| `core pull` | Pull updates across all repos | -| `core impact` | Show impact of changing a repo | -| `core ci` | Check CI status across all repos | +| `core dev work` | Full workflow: status + commit + push | +| `core dev work --status` | Status table only | +| `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 push` | Push commits across all repos | +| `core dev pull` | Pull updates across all repos | +| `core dev impact` | Show impact of changing a repo | -## core health +## core dev health Quick health check showing status of all repos. ```bash -core health +core dev health ``` Output shows: - Git status (clean/dirty) - Current branch - Commits ahead/behind remote -- CI status -## core issues +## core dev issues List open issues across all repositories. ```bash -core issues [flags] +core dev issues [flags] ``` ### Flags @@ -50,12 +49,12 @@ core issues [flags] | `--label` | Filter by label | | `--limit` | Max issues per repo | -## core reviews +## core dev reviews List pull requests needing review. ```bash -core reviews [flags] +core dev reviews [flags] ``` Shows PRs where: @@ -63,12 +62,12 @@ Shows PRs where: - PR is open and not draft - CI is passing -## core commit +## core dev commit Create commits across repos with Claude assistance. ```bash -core commit [flags] +core dev commit [flags] ``` ### Flags @@ -80,12 +79,12 @@ core commit [flags] Claude analyzes changes and suggests conventional commit messages. -## core push +## core dev push Push commits across all repos. ```bash -core push [flags] +core dev push [flags] ``` ### Flags @@ -95,12 +94,12 @@ core push [flags] | `--all` | Push all repos with unpushed commits | | `--force` | Force push (use with caution) | -## core pull +## core dev pull Pull updates across all repos. ```bash -core pull [flags] +core dev pull [flags] ``` ### Flags @@ -110,12 +109,12 @@ core pull [flags] | `--all` | Pull all repos | | `--rebase` | Rebase instead of merge | -## core impact +## core dev impact Show the impact of changing a repository. ```bash -core impact +core dev impact ``` Shows: @@ -123,21 +122,6 @@ Shows: - Reverse dependencies - Potential breaking changes -## core ci - -Check CI status across all repos. - -```bash -core ci [flags] -``` - -### Flags - -| Flag | Description | -|------|-------------| -| `--watch` | Watch for status changes | -| `--failing` | Show only failing repos | - ## Registry These commands use `repos.yaml` to know which repos to manage: diff --git a/docs/cmd/index.md b/docs/cmd/index.md index b45be863..aa229709 100644 --- a/docs/cmd/index.md +++ b/docs/cmd/index.md @@ -11,7 +11,7 @@ Unified interface for Go/PHP development, multi-repo management, and deployment. | [build](build/) | Build projects | | [ci](ci/) | Publish releases | | [sdk](sdk/) | SDK validation | -| [dev](dev/) | Portable dev environment (LinuxKit) | +| [dev](dev/) | Multi-repo workflow + dev environment | | [pkg](pkg/) | Package management | | [vm](vm/) | LinuxKit VM management | | [docs](docs/) | Documentation management | diff --git a/docs/index.md b/docs/index.md index 5bfa5f7a..7e7f9018 100644 --- a/docs/index.md +++ b/docs/index.md @@ -25,7 +25,7 @@ See [cmd/](cmd/) for full command documentation. | [build](cmd/build/) | Build Go, Wails, Docker, LinuxKit projects | | [ci](cmd/ci/) | Publish releases (dry-run by default) | | [sdk](cmd/sdk/) | SDK validation | -| [dev](cmd/dev/) | Multi-repo workflow | +| [dev](cmd/dev/) | Multi-repo workflow + dev environment | | [pkg](cmd/pkg/) | Package search and install | | [vm](cmd/vm/) | LinuxKit VM management | | [docs](cmd/docs/) | Documentation management |