From 9376e9b99d3cd9feb073df7a1ed63ff1adca768a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 12 Mar 2026 20:17:59 +0000 Subject: [PATCH 1/3] Initial plan From 8d5fe8cd93d7a6c92668f18b9207c79262978709 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 12 Mar 2026 20:21:31 +0000 Subject: [PATCH 2/3] Fix CLI consistency issues: docs alignment, emoji removal, show_default - Fix pack --target docs to include copilot option and alias note - Fix runtime setup/remove synopsis to match CLI ({copilot|codex|llm}) - Fix unpack --output docs to show -o shorthand and PATH type - Add show_default=True to mcp search --limit option - Fix --parallel-downloads type from INT to INTEGER in docs - Remove emoji from apm config table title - Update pack-distribute guide target tables Co-authored-by: danielmeppiel <51440732+danielmeppiel@users.noreply.github.com> --- docs/src/content/docs/guides/pack-distribute.md | 5 +++-- docs/src/content/docs/reference/cli-commands.md | 14 +++++++------- src/apm_cli/commands/config.py | 2 +- src/apm_cli/commands/mcp.py | 2 +- 4 files changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/src/content/docs/guides/pack-distribute.md b/docs/src/content/docs/guides/pack-distribute.md index ffb33b57..78d98c70 100644 --- a/docs/src/content/docs/guides/pack-distribute.md +++ b/docs/src/content/docs/guides/pack-distribute.md @@ -62,7 +62,7 @@ apm pack --dry-run | Flag | Default | Description | |------|---------|-------------| | `--format` | `apm` | Bundle format (`apm` or `plugin`) | -| `-t, --target` | auto-detect | File filter: `vscode`, `claude`, `all` | +| `-t, --target` | auto-detect | File filter: `copilot`, `vscode`, `claude`, `all`. `vscode` is an alias for `copilot` | | `--archive` | off | Produce `.tar.gz` instead of directory | | `-o, --output` | `./build` | Output directory | | `--dry-run` | off | List files without writing | @@ -73,7 +73,8 @@ The target flag controls which deployed files are included based on path prefix: | Target | Includes | |--------|----------| -| `vscode` | Paths starting with `.github/` | +| `copilot` | Paths starting with `.github/` | +| `vscode` | Alias for `copilot` | | `claude` | Paths starting with `.claude/` | | `all` | Both `.github/` and `.claude/` | diff --git a/docs/src/content/docs/reference/cli-commands.md b/docs/src/content/docs/reference/cli-commands.md index 081917f5..28a0c645 100644 --- a/docs/src/content/docs/reference/cli-commands.md +++ b/docs/src/content/docs/reference/cli-commands.md @@ -84,7 +84,7 @@ apm install [PACKAGES...] [OPTIONS] - `--update` - Update dependencies to latest Git references - `--force` - Overwrite locally-authored files on collision - `--dry-run` - Show what would be installed without installing -- `--parallel-downloads INT` - Max concurrent package downloads (default: 4, 0 to disable) +- `--parallel-downloads INTEGER` - Max concurrent package downloads (default: 4, 0 to disable) - `--verbose` - Show detailed installation information - `--trust-transitive-mcp` - Trust self-defined MCP servers from transitive packages (skip re-declaration requirement) @@ -307,7 +307,7 @@ apm pack [OPTIONS] **Options:** - `-o, --output TEXT` - Output directory (default: `./build/`) -- `-t, --target [vscode|claude|all]` - Filter files by target. Auto-detects from `apm.yml` if not specified +- `-t, --target [copilot|vscode|claude|all]` - Filter files by target. Auto-detects from `apm.yml` if not specified. `vscode` is an alias for `copilot` - `--archive` - Produce a `.tar.gz` archive instead of a directory - `--dry-run` - List files that would be packed without writing anything - `--format [apm|plugin]` - Bundle format (default: `apm`) @@ -368,7 +368,7 @@ apm unpack BUNDLE_PATH [OPTIONS] - `BUNDLE_PATH` - Path to a `.tar.gz` archive or an unpacked bundle directory **Options:** -- `--output TEXT` - Target project directory (default: current directory) +- `-o, --output PATH` - Target project directory (default: current directory) - `--skip-verify` - Skip completeness verification against the bundle lockfile - `--dry-run` - Show what would be extracted without writing anything @@ -994,11 +994,11 @@ apm runtime COMMAND [OPTIONS] Download and configure an AI runtime from official sources. ```bash -apm runtime setup RUNTIME_NAME [OPTIONS] +apm runtime setup [OPTIONS] {copilot|codex|llm} ``` **Arguments:** -- `RUNTIME_NAME` - Runtime to install: `copilot`, `codex`, or `llm` +- `{copilot|codex|llm}` - Runtime to install **Options:** - `--version TEXT` - Specific version to install @@ -1044,11 +1044,11 @@ apm runtime list Remove an installed runtime and its configuration. ```bash -apm runtime remove RUNTIME_NAME +apm runtime remove [OPTIONS] {copilot|codex|llm} ``` **Arguments:** -- `RUNTIME_NAME` - Runtime to remove: `copilot`, `codex`, or `llm` +- `{copilot|codex|llm}` - Runtime to remove **Options:** - `--yes` - Confirm the action without prompting diff --git a/src/apm_cli/commands/config.py b/src/apm_cli/commands/config.py index a9769e02..90fff9a4 100644 --- a/src/apm_cli/commands/config.py +++ b/src/apm_cli/commands/config.py @@ -27,7 +27,7 @@ def config(ctx): console = _get_console() # Create configuration display config_table = Table( - title="⚙️ Current APM Configuration", + title="Current APM Configuration", show_header=True, header_style="bold cyan", ) diff --git a/src/apm_cli/commands/mcp.py b/src/apm_cli/commands/mcp.py index 19d11e94..aeee90c0 100644 --- a/src/apm_cli/commands/mcp.py +++ b/src/apm_cli/commands/mcp.py @@ -20,7 +20,7 @@ def mcp(): @mcp.command(help="Search MCP servers in registry") @click.argument("query", required=True) -@click.option("--limit", default=10, help="Number of results to show") +@click.option("--limit", default=10, show_default=True, help="Number of results to show") @click.pass_context def search(ctx, query, limit): """Search for MCP servers in the registry.""" From ceae918b3b9b5b298a7cc0609218db9ad17d2761 Mon Sep 17 00:00:00 2001 From: Daniel Meppiel <51440732+danielmeppiel@users.noreply.github.com> Date: Thu, 12 Mar 2026 21:37:21 +0100 Subject: [PATCH 3/3] Update docs/src/content/docs/reference/cli-commands.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/src/content/docs/reference/cli-commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/content/docs/reference/cli-commands.md b/docs/src/content/docs/reference/cli-commands.md index 28a0c645..fdb53a9c 100644 --- a/docs/src/content/docs/reference/cli-commands.md +++ b/docs/src/content/docs/reference/cli-commands.md @@ -306,7 +306,7 @@ apm pack [OPTIONS] ``` **Options:** -- `-o, --output TEXT` - Output directory (default: `./build/`) +- `-o, --output PATH` - Output directory (default: `./build`) - `-t, --target [copilot|vscode|claude|all]` - Filter files by target. Auto-detects from `apm.yml` if not specified. `vscode` is an alias for `copilot` - `--archive` - Produce a `.tar.gz` archive instead of a directory - `--dry-run` - List files that would be packed without writing anything