refactor: complete forge→commando rename in bin scripts and examples

- bin/cmdo: rename run_forge→run_commando, update Cellar paths and error messages
- bin/cmdo-dev: rename run_forge→run_commando, update comments
- bin/install.sh: update default repo URLs to jdillon/commando
- examples/*/README.md: update commands (forge→cmdo), paths (.forge→.commando)
- examples/*/cmdo: new symlinks replacing forge symlinks
- beads: set issue_prefix=commando, close forge-kdf, update forge-dfh

Related: forge-aaj

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: jdillon

.beads/beads.jsonl

@@ -1,5 +1,5 @@
 {
   "database": "beads.db",
   "jsonl_export": "beads.jsonl",
-  "last_bd_version": "0.28.0"
+  "last_bd_version": "0.27.0"
 }

.beads/metadata.json

@@ -38,7 +38,7 @@ resolve_paths() {
     [[ "${script_path}" != /* ]] && script_path="${script_dir}/${script_path}"
   done
 
-  # Installed mode only - forge-dev handles dev mode
+  # Installed mode only - cmdo-dev handles dev mode
   SCRIPT_DIR="$(cd "$(dirname "${script_path}")" && pwd)"
 }
 
@@ -48,9 +48,9 @@ resolve_paths() {
 
 detect_homebrew_install() {
   # Check if we're running from a Homebrew Cellar path
-  # Pattern: /opt/homebrew/Cellar/forge/<version>/libexec/bin
-  # or: /usr/local/Cellar/forge/<version>/libexec/bin (Intel Mac)
-  if [[ "${SCRIPT_DIR}" == */Cellar/forge/*/libexec/bin ]]; then
+  # Pattern: /opt/homebrew/Cellar/commando/<version>/libexec/bin
+  # or: /usr/local/Cellar/commando/<version>/libexec/bin (Intel Mac)
+  if [[ "${SCRIPT_DIR}" == */Cellar/commando/*/libexec/bin ]]; then
     # Return libexec path (parent of bin)
     echo "${SCRIPT_DIR%/bin}"
     return 0
@@ -93,22 +93,22 @@ validate_installation() {
       run_homebrew_bootstrap "${libexec}"
       # Verify bootstrap succeeded
       if [[ ! -f "${COMMANDO_CLI}" ]]; then
-        echo "ERROR: Homebrew bootstrap failed - forge CLI not found" >&2
+        echo "ERROR: Homebrew bootstrap failed - commando CLI not found" >&2
         exit 1
       fi
     else
-      echo "ERROR: Forge installation is corrupted" >&2
+      echo "ERROR: Commando installation is corrupted" >&2
       echo "Expected: ${COMMANDO_CLI}" >&2
       exit 1
     fi
   fi
 }
 
 #
-# Forge execution
+# Commando execution
 #
 
-run_forge() {
+run_commando() {
   local is_restarted="$1"
   shift
 
@@ -118,7 +118,7 @@ run_forge() {
   fi
 
   # Use --preserve-symlinks to prevent Bun from resolving through symlinks
-  # This allows user commands symlinked into node_modules to resolve forge correctly
+  # This allows user commands symlinked into node_modules to resolve commando correctly
   bun run --preserve-symlinks "${COMMANDO_CLI}" "$@"
 }
 
@@ -130,7 +130,7 @@ handle_restart() {
   # "I checked it very thoroughly, and that quite definitely is the answer."
   if [[ $exit_code -eq 42 ]]; then
     # Re-run with COMMANDO_RESTARTED=1 to prevent infinite loops
-    run_forge "true" "$@"
+    run_commando "true" "$@"
     return $?
   fi
 
@@ -147,9 +147,9 @@ main() {
   setup_environment
   validate_installation
 
-  # Run forge and handle restart if needed
+  # Run commando and handle restart if needed
   set +e  # Don't exit on non-zero
-  run_forge "false" "$@"
+  run_commando "false" "$@"
   local exit_code=$?
   set -e
 

bin/cmdo

@@ -30,7 +30,7 @@ set -euo pipefail
 #
 
 PROJECT_ROOT=""
-# COMMANDO_HOME set in setup_environment() to dev-home/forge
+# COMMANDO_HOME set in setup_environment() to dev-home/commando
 
 #
 # Path resolution
@@ -55,7 +55,7 @@ setup_environment() {
   export COMMANDO_HOME
   export NODE_PATH="${COMMANDO_HOME}/node_modules"
 
-  # Ensure dev-home forge structure exists
+  # Ensure dev-home commando structure exists
   mkdir -p "${COMMANDO_HOME}"
 }
 
@@ -192,7 +192,7 @@ generate_version_info() {
   # Build semver
   local semver="${version}+${date_time}.${hash}"
 
-  # Write version.json to forge home
+  # Write version.json to commando home
   cat > "${COMMANDO_HOME}/version.json" <<EOF
 {
   "version": "$version",
@@ -229,7 +229,7 @@ rebuild_and_install() {
 # Delegate to bin/cmdo
 #
 
-run_forge() {
+run_commando() {
   # Delegate to bin/cmdo script (installed mode bootstrap)
   # It will use our COMMANDO_HOME environment variable
   exec "${PROJECT_ROOT}/bin/cmdo" "$@"
@@ -251,7 +251,7 @@ main() {
 
   # Delegate to bin/cmdo (will exec, replacing this process)
   # bin/cmdo handles restart logic (exit code 42)
-  run_forge "$@"
+  run_commando "$@"
 }
 
 # Execute main with all arguments

bin/cmdo-dev

@@ -14,8 +14,8 @@
 # limitations under the License.
 set -euo pipefail
 
-# Forge v2 Installation Script
-# Installs forge to ~/.commando and creates wrapper at ~/.local/bin/cmdo
+# Commando Installation Script
+# Installs commando to ~/.commando and creates wrapper at ~/.local/bin/cmdo
 
 # Color output (only if terminal supports it)
 if [[ -t 1 ]] && command -v tput &>/dev/null && tput colors &>/dev/null && [[ $(tput colors) -ge 8 ]]; then
@@ -79,7 +79,7 @@ while [[ $# -gt 0 ]]; do
       echo "  -h, --help   Show this help message"
       echo ""
       echo "Environment variables:"
-      echo "  COMMANDO_REPO    Repository URL (default: git+ssh://git@github.com/jdillon/forge)"
+      echo "  COMMANDO_REPO    Repository URL (default: git+ssh://git@github.com/jdillon/commando)"
       echo "  COMMANDO_BRANCH  Branch to install (default: module-system)"
       exit 0
       ;;
@@ -106,7 +106,7 @@ if [[ -z "${COMMANDO_REPO:-}" ]]; then
   SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
   REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
 
-  # Check if we're in the forge git repo and have a local tarball
+  # Check if we're in the commando git repo and have a local tarball
   if [[ -d "${REPO_ROOT}/.git" ]]; then
     # Find any planet57-commando-*.tgz tarball
     TARBALL=$(ls -t "${REPO_ROOT}/build/planet57-commando-"*.tgz 2>/dev/null | head -n1)
@@ -117,15 +117,15 @@ if [[ -z "${COMMANDO_REPO:-}" ]]; then
       info "Detected local development mode - using tarball: $(basename "${TARBALL}")"
     else
       # Use GitHub for production installs
-      COMMANDO_REPO="git+ssh://git@github.com/jdillon/forge"
+      COMMANDO_REPO="git+ssh://git@github.com/jdillon/commando"
       # Determine branch (default to module-system for Phase 1, unless explicitly set to empty)
       if [[ -z "${COMMANDO_BRANCH+x}" ]]; then
         COMMANDO_BRANCH="module-system"
       fi
     fi
   else
     # Use GitHub for production installs
-    COMMANDO_REPO="git+ssh://git@github.com/jdillon/forge"
+    COMMANDO_REPO="git+ssh://git@github.com/jdillon/commando"
     # Determine branch (default to module-system for Phase 1, unless explicitly set to empty)
     if [[ -z "${COMMANDO_BRANCH+x}" ]]; then
       COMMANDO_BRANCH="module-system"
@@ -260,7 +260,7 @@ else
   SEMVER="${VERSION}+${DATE_TIME}"
 fi
 
-# Write version.json to forge home
+# Write version.json to commando home
 cat > "${COMMANDO_HOME}/version.json" <<EOF
 {
   "version": "$VERSION",

bin/install.sh

@@ -1,6 +1,6 @@
 # Basic Example
 
-Minimal Forge module demonstrating simple command patterns.
+Minimal Commando module demonstrating simple command patterns.
 
 ## What This Demonstrates
 
@@ -13,8 +13,8 @@ Minimal Forge module demonstrating simple command patterns.
 
 ```
 basic/
-├── .forge/
-│   ├── config.yml      # Forge configuration
+├── .commando/
+│   ├── config.yml      # Commando configuration
 │   ├── simple.ts       # Command module
 │   └── .gitignore
 └── README.md
@@ -27,11 +27,11 @@ basic/
 cd examples/basic
 
 # Run commands
-forge basic ping
-forge basic greet
-forge basic greet Alice
-forge basic greet --loud
-forge basic greet Alice --loud
+cmdo basic ping
+cmdo basic greet
+cmdo basic greet Alice
+cmdo basic greet --loud
+cmdo basic greet Alice --loud
 ```
 
 ## Commands
@@ -54,19 +54,19 @@ Greet someone by name.
 
 **Examples**:
 ```bash
-forge basic greet                # Hello, Forge User!
-forge basic greet Alice          # Hello, Alice!
-forge basic greet --loud         # HELLO, FORGE USER!
-forge basic greet Bob --loud     # HELLO, BOB!
+cmdo basic greet                # Hello, Commando User!
+cmdo basic greet Alice          # Hello, Alice!
+cmdo basic greet --loud         # HELLO, COMMANDO USER!
+cmdo basic greet Bob --loud     # HELLO, BOB!
 ```
 
 ## Module Code
 
-See `.forge/simple.ts` for the implementation. Key features:
+See `.commando/simple.ts` for the implementation. Key features:
 
 1. **Module metadata** - Uses `__module__` export to customize group name:
    ```typescript
-   export const __module__: ForgeModuleMetadata = {
+   export const __module__: CommandoModuleMetadata = {
      group: 'basic',
      description: 'Basic example commands'
    };
@@ -84,7 +84,7 @@ See `.forge/simple.ts` for the implementation. Key features:
 
 3. **Command with options** - Use `defineCommand` to add arguments/flags:
    ```typescript
-   export const greet: ForgeCommand = {
+   export const greet: CommandoCommand = {
      description: 'Greet someone',
      defineCommand: (cmd) =>
        cmd.argument('[name]', '...').option('-l, --loud', '...'),
@@ -101,15 +101,15 @@ See `.forge/simple.ts` for the implementation. Key features:
 
 ## Config
 
-See `.forge/config.yml`:
+See `.commando/config.yml`:
 
 ```yaml
 modules:
   - ./simple
 
 settings:
   basic.greet:
-    defaultName: Forge User
+    defaultName: Commando User
 ```
 
 ## Comparison with Website Example

examples/basic/README.md

@@ -0,0 +1 @@
+../../bin/cmdo-dev

examples/basic/cmdo

@@ -1,11 +1,11 @@
 # Dependencies Example
 
-This example demonstrates Phase 2 dependency management - installing npm packages to forge home and importing them in modules.
+This example demonstrates Phase 2 dependency management - installing npm packages to commando home and importing them in modules.
 
 ## What This Does
 
 - Declares `cowsay` as a dependency in `config.yml`
-- Auto-installs to `~/.local/share/forge/node_modules/` on first run
+- Auto-installs to `~/.commando/node_modules/` on first run
 - Imports and uses `cowsay` in the `moo` module
 
 ## Usage
@@ -14,7 +14,7 @@ This example demonstrates Phase 2 dependency management - installing npm package
 
 ```bash
 cd examples/deps
-forge moo say hello
+cmdo moo say hello
 ```
 
 On first run, you'll see:
@@ -36,18 +36,18 @@ Restarting to pick up changes...
 ### Subsequent Runs (No Install)
 
 ```bash
-forge moo say "Phase 2 is working!"
-forge moo think "Dependencies are seamless..."
+cmdo moo say "Phase 2 is working!"
+cmdo moo think "Dependencies are seamless..."
 ```
 
 ## Commands
 
-- `forge moo say <text>` - Make a cow say something
-- `forge moo think <text>` - Make a cow think something (with thought bubbles)
+- `cmdo moo say <text>` - Make a cow say something
+- `cmdo moo think <text>` - Make a cow think something (with thought bubbles)
 
 ## How It Works
 
-1. **Config** (`.forge/config.yml`):
+1. **Config** (`.commando/config.yml`):
    ```yaml
    dependencies:
      - cowsay
@@ -56,11 +56,11 @@ forge moo think "Dependencies are seamless..."
      - ./moo
    ```
 
-2. **Module** (`.forge/moo.ts`):
+2. **Module** (`.commando/moo.ts`):
    ```typescript
    import cowsay from 'cowsay';
 
-   export const say: ForgeCommand = {
+   export const say: CommandoCommand = {
      description: 'Make a cow say something',
      execute: async (options, args, context) => {
        const text = args.join(' ');
@@ -70,18 +70,18 @@ forge moo think "Dependencies are seamless..."
    ```
 
 3. **Magic**:
-   - Forge detects missing dependency
-   - Runs `bun add cowsay` in `~/.local/share/forge/`
+   - Commando detects missing dependency
+   - Runs `bun add cowsay` in `~/.commando/`
    - Exits with code 42
-   - Wrapper restarts with `--forge-restarted` flag
+   - Wrapper restarts with `--commando-restarted` flag
    - Module imports work, command executes
 
 ## Verify Installation
 
 ```bash
-# Check what's installed in forge home
-ls ~/.local/share/forge/node_modules/
+# Check what's installed in commando home
+ls ~/.commando/node_modules/
 
 # Check package.json
-cat ~/.local/share/forge/package.json
+cat ~/.commando/package.json
 ```