fix: CLI consistency — remove emojis from output, add -v flag, fix docs

docs/cli-reference.md

@@ -109,7 +109,7 @@ apm init my-project --yes
 Install APM package and MCP server dependencies from `apm.yml` (like `npm install`). Auto-creates minimal `apm.yml` when packages are specified but no manifest exists.
 
 ```bash
-apm install [PACKAGES...] [OPTIONS]
+apm install [OPTIONS] [PACKAGES...]
 ```
 
 **Arguments:**
@@ -120,11 +120,11 @@ apm install [PACKAGES...] [OPTIONS]
 - `--exclude TEXT` - Exclude specific runtime from installation
 - `--only [apm|mcp]` - Install only specific dependency type
 - `--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)
+- `--force` - Overwrite locally-authored files on collision
 - `--verbose` - Show detailed installation information
 - `--trust-transitive-mcp` - Trust self-defined MCP servers from transitive packages (skip re-declaration requirement)
+- `--parallel-downloads INT` - Max concurrent package downloads (default: 4, 0 to disable)
 
 **Behavior:**
 - `apm install` (no args): Installs **all** packages from `apm.yml`
@@ -548,11 +548,11 @@ company-website (local)
 Display comprehensive information about a specific installed package.
 
 ```bash
-apm deps info PACKAGE_NAME
+apm deps info PACKAGE
 ```
 
 **Arguments:**
-- `PACKAGE_NAME` - Name of the package to show information about
+- `PACKAGE` - Name of the package to show information about
 
 **Examples:**
 ```bash
@@ -595,11 +595,11 @@ apm deps clean
 Update installed APM dependencies to their latest versions.
 
 ```bash
-apm deps update [PACKAGE_NAME]
+apm deps update [PACKAGE]
 ```
 
 **Arguments:**
-- `PACKAGE_NAME` - Optional. Update specific package only
+- `PACKAGE` - Optional. Update specific package only
 
 **Examples:**
 ```bash
@@ -627,7 +627,7 @@ apm mcp list [OPTIONS]
 ```
 
 **Options:**
-- `--limit INTEGER` - Number of results to show
+- `--limit INTEGER` - Number of results to show (default: 20)
 
 **Examples:**
 ```bash
@@ -1087,7 +1087,7 @@ apm runtime remove RUNTIME_NAME
 **Options:**
 - `--yes` - Confirm the action without prompting
 
-#### `apm runtime status` - Show runtime status
+#### `apm runtime status` - Check which runtime will be used
 
 Display which runtime APM will use for execution and runtime preference order.
 

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",
             )

src/apm_cli/commands/deps.py

@@ -44,10 +44,10 @@ def list_packages():
         # Check if apm_modules exists
         if not apm_modules_path.exists():
             if has_rich:
-                console.print("💡 No APM dependencies installed yet", style="cyan")
+                console.print("No APM dependencies installed yet", style="cyan")
                 console.print("Run 'apm install' to install dependencies from apm.yml", style="dim")
             else:
-                click.echo("💡 No APM dependencies installed yet")
+                click.echo("No APM dependencies installed yet")
                 click.echo("Run 'apm install' to install dependencies from apm.yml")
             return
 
@@ -157,18 +157,18 @@ def list_packages():
                     'is_orphaned': is_orphaned
                 })
             except Exception as e:
-                click.echo(f"⚠️ Warning: Failed to read package {org_repo_name}: {e}")
+                click.echo(f"Warning: Failed to read package {org_repo_name}: {e}")
 
         if not installed_packages:
             if has_rich:
-                console.print("💡 apm_modules/ directory exists but contains no valid packages", style="cyan")
+                console.print("apm_modules/ directory exists but contains no valid packages", style="cyan")
             else:
-                click.echo("💡 apm_modules/ directory exists but contains no valid packages")
+                click.echo("apm_modules/ directory exists but contains no valid packages")
             return
 
         # Display packages in table format
         if has_rich:
-            table = Table(title="📋 APM Dependencies", show_header=True, header_style="bold cyan")
+            table = Table(title="APM Dependencies", show_header=True, header_style="bold cyan")
             table.add_column("Package", style="bold white")
             table.add_column("Version", style="yellow") 
             table.add_column("Source", style="blue")
@@ -195,13 +195,13 @@ def list_packages():
 
             # Show orphaned packages warning
             if orphaned_packages:
-                console.print(f"\n⚠️  {len(orphaned_packages)} orphaned package(s) found (not in apm.yml):", style="yellow")
+                console.print(f"\n{len(orphaned_packages)} orphaned package(s) found (not in apm.yml):", style="yellow")
                 for pkg in orphaned_packages:
                     console.print(f"  • {pkg}", style="dim yellow")
-                console.print("\n💡 Run 'apm prune' to remove orphaned packages", style="cyan")
+                console.print("\nRun 'apm prune' to remove orphaned packages", style="cyan")
         else:
             # Fallback text table
-            click.echo("📋 APM Dependencies:")
+            click.echo("APM Dependencies:")
             click.echo(f"{'Package':<30} {'Version':<10} {'Source':<12} {'Prompts':>7} {'Instr':>7} {'Agents':>7} {'Skills':>7} {'Hooks':>7}")
             click.echo("-" * 98)
 
@@ -219,10 +219,10 @@ def list_packages():
 
             # Show orphaned packages warning
             if orphaned_packages:
-                click.echo(f"\n⚠️  {len(orphaned_packages)} orphaned package(s) found (not in apm.yml):")
+                click.echo(f"\n{len(orphaned_packages)} orphaned package(s) found (not in apm.yml):")
                 for pkg in orphaned_packages:
                     click.echo(f"  • {pkg}")
-                click.echo("\n💡 Run 'apm prune' to remove orphaned packages")
+                click.echo("\nRun 'apm prune' to remove orphaned packages")
 
     except Exception as e:
         _rich_error(f"Error listing dependencies: {e}")

src/apm_cli/commands/install.py

@@ -287,7 +287,7 @@ def _validate_package_exists(package):
     "--dry-run", is_flag=True, help="Show what would be installed without installing"
 )
 @click.option("--force", is_flag=True, help="Overwrite locally-authored files on collision")
-@click.option("--verbose", is_flag=True, help="Show detailed installation information")
+@click.option("-v", "--verbose", is_flag=True, help="Show detailed installation information")
 @click.option(
     "--trust-transitive-mcp",
     is_flag=True,

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."""
@@ -288,7 +288,7 @@ def show(ctx, server_name):
 
 
 @mcp.command(help="List all available MCP servers")
-@click.option("--limit", default=20, help="Number of results to show")
+@click.option("--limit", default=20, show_default=True, help="Number of results to show")
 @click.pass_context
 def list(ctx, limit):
     """List all available MCP servers in the registry."""