feat-forge 1.0.2 → 1.1.0

package/dist/commands/CompletionCommands.js

@@ -1,5 +1,3 @@
-import { readdir } from 'fs/promises';
-import { pathExists } from '../lib/fs.js';
 import { AbstractCommands } from './AbstractCommands.js';
 /**
  * Commands for managing shell completion/autocomplete
@@ -13,12 +11,6 @@ export class CompletionCommands extends AbstractCommands {
     // ============================================================================
     // PUBLIC COMMAND METHODS
     // ============================================================================
-    /**
-     * Generate and display shell completion script for the specified shell.
-     * Outputs only the script to stdout for piping or sourcing.
-     *
-     * @param shell - The target shell type (bash, zsh, or fish)
-     */
     /**
      * Generate and display shell completion script for the specified shell.
      * Outputs only the script to stdout for piping or sourcing.
@@ -34,9 +26,6 @@ export class CompletionCommands extends AbstractCommands {
     // ============================================================================
     /**
      * Generate the appropriate completion script based on shell type.
-     *
-     * @param shell - The target shell type
-     * @returns The generated completion script as a string
      */
     async generateCompletionScript(shell) {
         switch (shell) {
@@ -53,33 +42,8 @@ export class CompletionCommands extends AbstractCommands {
                 throw new Error(`Unsupported shell: ${shell}`);
         }
     }
-    /**
-     * Get list of available feature slugs for contextual completion.
-     * Returns empty array if features directory doesn't exist or if there's an error.
-     *
-     * @returns Array of feature slugs
-     */
-    async getAvailableFeatures() {
-        try {
-            if (!(await pathExists(this.context.paths.worktreesRoot))) {
-                return [];
-            }
-            const entries = await readdir(this.context.paths.worktreesRoot, { withFileTypes: true });
-            return entries
-                .filter((entry) => entry.isDirectory())
-                .map((entry) => entry.name)
-                .sort();
-        }
-        catch {
-            return [];
-        }
-    }
     /**
      * Extract command information from Commander.js program.
-     * Recursively extracts all commands and their subcommands.
-     *
-     * @param command - Commander.js Command object
-     * @returns Structured command information
      */
     extractCommandInfo(command) {
         const name = command.name();
@@ -90,82 +54,175 @@ export class CompletionCommands extends AbstractCommands {
     }
     /**
      * Get all main commands from the program.
-     *
-     * @returns Array of command information
      */
     getMainCommands() {
         return this.program.commands.filter((cmd) => !cmd.name().includes('help')).map((cmd) => this.extractCommandInfo(cmd));
     }
     /**
      * Find a specific command by name.
-     *
-     * @param commandName - Name of the command to find
-     * @returns Command information or undefined
      */
     findCommand(commandName) {
         return this.getMainCommands().find((cmd) => cmd.name === commandName);
     }
-    escapeDoubleQuotes(value) {
-        return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    /**
+     * Centralized extraction of all completion metadata.
+     */
+    getCompletionData() {
+        const mainCommands = this.getMainCommands();
+        return {
+            mainCommands,
+            featureCmd: this.findCommand('feature'),
+            fixCmd: this.findCommand('fix'),
+            releaseCmd: this.findCommand('release'),
+            servicesCmd: this.findCommand('services'),
+            envCmd: this.findCommand('env'),
+            maintenanceCmd: this.findCommand('maintenance'),
+            modeCmd: this.findCommand('mode'),
+            agentCmd: this.findCommand('agent'),
+            slugSubcommands: ['stop', 'start', 'archive', 'resync', 'merge', 'rebase', 'open', 'path'],
+            rootSlugCommands: ['stop', 'start', 'archive', 'resync', 'merge', 'rebase', 'open', 'path'],
+        };
     }
-    escapeSingleQuotes(value) {
-        return value.replace(/'/g, "''");
+    /**
+     * Generate the Node.js config-reading snippet used by bash/zsh.
+     * Returns variables: _FORGE_WORKTREES_ROOT, _FORGE_FEATURE_PREFIX, _FORGE_FIX_PREFIX, _FORGE_RELEASE_PREFIX, _FORGE_MODES
+     */
+    nodeConfigSnippet() {
+        return `'const fs=require("fs");const path=require("path");
+try{
+  const file=process.argv[1];
+  const configRoot=path.dirname(file);
+  const data=JSON.parse(fs.readFileSync(file,"utf8"));
+  let rootDir=data.rootDir;
+  if(rootDir){ if(!path.isAbsolute(rootDir)) rootDir=path.join(configRoot, rootDir); }
+  else { rootDir=configRoot; }
+  const opts=data.options||{};
+  const folders=opts.folders||data.folders||{};
+  const git=opts.git||data.git||{};
+  const worktrees=folders.worktrees||"worktrees";
+  const fp=git.featureBranchPrefix||"feature/";
+  const xp=git.fixBranchPrefix||"fix/";
+  const rp=git.releaseBranchPrefix||"release/";
+  const modes=(data.modes||[]).map(m=>m.name||path.basename(m.agentFile||"",".md")).filter(Boolean).join(" ");
+  process.stdout.write("_FORGE_WORKTREES_ROOT="+path.join(rootDir, worktrees)+"\\n");
+  process.stdout.write("_FORGE_FEATURE_PREFIX="+fp+"\\n");
+  process.stdout.write("_FORGE_FIX_PREFIX="+xp+"\\n");
+  process.stdout.write("_FORGE_RELEASE_PREFIX="+rp+"\\n");
+  process.stdout.write("_FORGE_MODES="+modes+"\\n");
+}catch(e){}'`;
     }
     /**
-     * Get list of command names that have a required slug argument.
-     *
-     * @returns Array of command names
+     * Generate the Node.js config-reading snippet for fish shell.
+     * Outputs `set -g` commands instead of VAR= assignments.
      */
-    getCommandsWithSlug() {
-        const commands = [];
-        const checkCommand = (cmd, parentName) => {
-            const fullName = parentName ? `${parentName}|${cmd.name}` : cmd.name;
-            if (cmd.hasSlugArgument) {
-                commands.push(cmd.name);
-            }
-            cmd.subcommands.forEach((sub) => checkCommand(sub, cmd.name));
-        };
-        this.getMainCommands().forEach((cmd) => checkCommand(cmd));
-        return commands;
+    nodeConfigSnippetFish() {
+        return `'const fs=require("fs");const path=require("path");
+try{
+  const file=process.argv[1];
+  const configRoot=path.dirname(file);
+  const data=JSON.parse(fs.readFileSync(file,"utf8"));
+  let rootDir=data.rootDir;
+  if(rootDir){ if(!path.isAbsolute(rootDir)) rootDir=path.join(configRoot, rootDir); }
+  else { rootDir=configRoot; }
+  const opts=data.options||{};
+  const folders=opts.folders||data.folders||{};
+  const git=opts.git||data.git||{};
+  const worktrees=folders.worktrees||"worktrees";
+  const fp=git.featureBranchPrefix||"feature/";
+  const xp=git.fixBranchPrefix||"fix/";
+  const rp=git.releaseBranchPrefix||"release/";
+  const modes=(data.modes||[]).map(m=>m.name||path.basename(m.agentFile||"",".md")).filter(Boolean).join(" ");
+  process.stdout.write("set -g _FORGE_WORKTREES_ROOT "+path.join(rootDir, worktrees)+"\\n");
+  process.stdout.write("set -g _FORGE_FEATURE_PREFIX "+fp+"\\n");
+  process.stdout.write("set -g _FORGE_FIX_PREFIX "+xp+"\\n");
+  process.stdout.write("set -g _FORGE_RELEASE_PREFIX "+rp+"\\n");
+  process.stdout.write("set -g _FORGE_MODES "+modes+"\\n");
+}catch(e){}'`;
     }
     /**
-     * Generate bash completion script.
-     *
-     * @returns Bash completion script content
+     * Generate the Node.js config-reading snippet for PowerShell.
+     * Outputs a JSON object parsable with ConvertFrom-Json.
      */
+    nodeConfigSnippetPowerShell() {
+        return `'const fs=require("fs");const path=require("path");
+try{
+  const file=process.argv[1];
+  const configRoot=path.dirname(file);
+  const data=JSON.parse(fs.readFileSync(file,"utf8"));
+  let rootDir=data.rootDir;
+  if(rootDir){ if(!path.isAbsolute(rootDir)) rootDir=path.join(configRoot, rootDir); }
+  else { rootDir=configRoot; }
+  const opts=data.options||{};
+  const folders=opts.folders||data.folders||{};
+  const git=opts.git||data.git||{};
+  const worktrees=folders.worktrees||"worktrees";
+  const fp=git.featureBranchPrefix||"feature/";
+  const xp=git.fixBranchPrefix||"fix/";
+  const rp=git.releaseBranchPrefix||"release/";
+  const modes=(data.modes||[]).map(m=>m.name||path.basename(m.agentFile||"",".md")).filter(Boolean);
+  process.stdout.write(JSON.stringify({worktreesRoot:path.join(rootDir,worktrees),featurePrefix:fp,fixPrefix:xp,releasePrefix:rp,modes:modes}));
+}catch(e){process.stdout.write("{}");}'`;
+    }
+    // ============================================================================
+    // BASH COMPLETION
+    // ============================================================================
     generateBashCompletion() {
-        const mainCommands = this.getMainCommands();
-        const featureCmd = this.findCommand('feature');
-        const modeCmd = this.findCommand('mode');
-        const agentCmd = this.findCommand('agent');
-        // Build command lists
-        const commands = mainCommands.map((cmd) => cmd.name).join(' ');
-        const featureCommands = featureCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
-        const modeCommands = modeCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
-        const agentCommands = agentCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
-        // Limit slug completions to active feature commands only
-        const activeFeatureSlugCommands = ['stop', 'archive', 'resync', 'merge', 'rebase', 'open'];
-        const featureWithActiveSlug = featureCmd?.subcommands.filter((cmd) => activeFeatureSlugCommands.includes(cmd.name)).map((cmd) => cmd.name) || [];
-        const mainWithActiveSlug = mainCommands.filter((cmd) => ['merge', 'rebase', 'open'].includes(cmd.name)).map((cmd) => cmd.name);
-        const featureSlugCase = featureWithActiveSlug.length > 0
-            ? `                ${featureWithActiveSlug.join('|')})
-                    # Suggest available features
+        const data = this.getCompletionData();
+        const commands = data.mainCommands.map((cmd) => cmd.name).join(' ');
+        const featureCommands = data.featureCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const fixCommands = data.fixCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const releaseCommands = data.releaseCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const servicesCommands = data.servicesCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const envCommands = data.envCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const maintenanceCommands = data.maintenanceCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const agentCommands = data.agentCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
+        const featureSlugCmds = data.featureCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || [];
+        const fixSlugCmds = data.fixCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || [];
+        const releaseSlugCmds = data.releaseCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || [];
+        const mainSlugCmds = data.mainCommands
+            .filter((cmd) => data.rootSlugCommands.includes(cmd.name))
+            .map((cmd) => cmd.name);
+        const featureSlugCase = featureSlugCmds.length > 0
+            ? `                ${featureSlugCmds.join('|')})
+                    if [[ \${cword} -eq 3 ]]; then
+                        local slugs="\$(_forge_feature_slugs)"
+                        COMPREPLY=( \$(compgen -W "\${slugs}" -- "\${cur}") )
+                        return 0
+                    fi
+                    ;;
+`
+            : '';
+        const fixSlugCase = fixSlugCmds.length > 0
+            ? `                ${fixSlugCmds.join('|')})
+                    if [[ \${cword} -eq 3 ]]; then
+                        local slugs="\$(_forge_fix_slugs)"
+                        COMPREPLY=( \$(compgen -W "\${slugs}" -- "\${cur}") )
+                        return 0
+                    fi
+                    ;;
+`
+            : '';
+        const releaseSlugCase = releaseSlugCmds.length > 0
+            ? `                ${releaseSlugCmds.join('|')})
                     if [[ \${cword} -eq 3 ]]; then
-                        local worktrees_root="\$(_forge_worktrees_root)"
-                        local features=\$(find "\${worktrees_root}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null)
-                        COMPREPLY=( \$(compgen -W "\${features}" -- "\${cur}") )
+                        local slugs="\$(_forge_release_slugs)"
+                        COMPREPLY=( \$(compgen -W "\${slugs}" -- "\${cur}") )
                         return 0
                     fi
                     ;;
 `
             : '';
-        const mainSlugCase = mainWithActiveSlug.length > 0
-            ? `        ${mainWithActiveSlug.join('|')})
-            # Suggest available features for commands with slug argument
+        const mainSlugCase = mainSlugCmds.length > 0
+            ? `        ${mainSlugCmds.join('|')})
             if [[ \${cword} -eq 2 ]]; then
-                local worktrees_root="\$(_forge_worktrees_root)"
-                local features=\$(find "\${worktrees_root}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null)
-                COMPREPLY=( \$(compgen -W "\${features}" -- "\${cur}") )
+                local branches="\$(_forge_all_branches)"
+                COMPREPLY=( \$(compgen -W "\${branches}" -- "\${cur}") )
                 return 0
             fi
             ;;
@@ -185,57 +242,125 @@ _forge_find_config() {
     return 1
 }
 
-_forge_worktrees_root() {
-    if [[ -n "\${FORGE_WORKTREES_ROOT}" ]]; then
-        echo "\${FORGE_WORKTREES_ROOT}"
+# Load forge config once and cache variables for the current completion
+_forge_config_loaded=0
+_forge_load_config() {
+    if [[ \${_forge_config_loaded} -eq 1 ]]; then
         return 0
     fi
+    _FORGE_WORKTREES_ROOT=""
+    _FORGE_FEATURE_PREFIX="feature/"
+    _FORGE_FIX_PREFIX="fix/"
+    _FORGE_RELEASE_PREFIX="release/"
+    _FORGE_MODES=""
+
+    if [[ -n "\${FORGE_WORKTREES_ROOT}" ]]; then
+        _FORGE_WORKTREES_ROOT="\${FORGE_WORKTREES_ROOT}"
+    fi
+
     local start="\${PWD}"
     local config_root
     config_root="\$(_forge_find_config "\${start}")" || true
     if [[ -n "\${config_root}" ]]; then
-        local worktrees
-        worktrees=\$(node -e 'const fs=require("fs");const path=require("path");
-try{
-  const file=process.argv[1];
-  const configRoot=path.dirname(file);
-  const data=JSON.parse(fs.readFileSync(file,"utf8"));
-  let rootDir=data.rootDir;
-  if(rootDir){ if(!path.isAbsolute(rootDir)) rootDir=path.join(configRoot, rootDir); }
-  else { rootDir=configRoot; }
-  const folders=(data.options && data.options.folders) || data.folders || {};
-  const worktrees=folders.worktrees || "features";
-  process.stdout.write(path.join(rootDir, worktrees));
-}catch(e){}
-' "\${config_root}/.feat-forge.json" 2>/dev/null)
-        if [[ -n "\${worktrees}" ]]; then
-            echo "\${worktrees}"
-            return 0
+        local output
+        output=\$(node -e ${this.nodeConfigSnippet()} "\${config_root}/.feat-forge.json" 2>/dev/null)
+        if [[ -n "\${output}" ]]; then
+            eval "\${output}"
+        elif [[ -z "\${_FORGE_WORKTREES_ROOT}" ]]; then
+            _FORGE_WORKTREES_ROOT="\${config_root}/worktrees"
         fi
-        echo "\${config_root}/features"
-        return 0
+    elif [[ -z "\${_FORGE_WORKTREES_ROOT}" ]]; then
+        _FORGE_WORKTREES_ROOT="worktrees"
     fi
-    echo "features"
+    _forge_config_loaded=1
+}
+
+_forge_feature_slugs() {
+    _forge_load_config
+    local prefix_dir="\${_FORGE_FEATURE_PREFIX%/}"
+    local dir="\${_FORGE_WORKTREES_ROOT}/\${prefix_dir}"
+    if [[ -d "\${dir}" ]]; then
+        find "\${dir}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null
+    fi
+}
+
+_forge_fix_slugs() {
+    _forge_load_config
+    local prefix_dir="\${_FORGE_FIX_PREFIX%/}"
+    local dir="\${_FORGE_WORKTREES_ROOT}/\${prefix_dir}"
+    if [[ -d "\${dir}" ]]; then
+        find "\${dir}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null
+    fi
+}
+
+_forge_release_slugs() {
+    _forge_load_config
+    local prefix_dir="\${_FORGE_RELEASE_PREFIX%/}"
+    local dir="\${_FORGE_WORKTREES_ROOT}/\${prefix_dir}"
+    if [[ -d "\${dir}" ]]; then
+        find "\${dir}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null
+    fi
+}
+
+_forge_all_branches() {
+    _forge_load_config
+    local root="\${_FORGE_WORKTREES_ROOT}"
+    if [[ ! -d "\${root}" ]]; then
+        return
+    fi
+    local prefix_dirs=()
+    for p in "\${_FORGE_FEATURE_PREFIX%/}" "\${_FORGE_FIX_PREFIX%/}" "\${_FORGE_RELEASE_PREFIX%/}"; do
+        if [[ -n "\${p}" ]]; then
+            prefix_dirs+=("\${p}")
+        fi
+    done
+    for entry in "\${root}"/*/; do
+        [[ -d "\${entry}" ]] || continue
+        local name="\$(basename "\${entry}")"
+        local is_prefix=0
+        for pd in "\${prefix_dirs[@]}"; do
+            if [[ "\${name}" == "\${pd}" ]]; then
+                is_prefix=1
+                break
+            fi
+        done
+        if [[ \${is_prefix} -eq 1 ]]; then
+            for sub in "\${entry}"*/; do
+                [[ -d "\${sub}" ]] || continue
+                echo "\${name}/\$(basename "\${sub}")"
+            done
+        else
+            echo "\${name}"
+        fi
+    done
+}
+
+_forge_modes() {
+    _forge_load_config
+    echo "\${_FORGE_MODES}"
 }
 
 _forge_completion() {
     local cur prev words cword
     _init_completion || return
 
-    # Main commands available at root level
+    # Reset config cache for each completion
+    _forge_config_loaded=0
+
     local commands="${commands}"
 
-    # Subcommands for each main command
     local feature_commands="${featureCommands}"
-    local mode_commands="${modeCommands}"
+    local fix_commands="${fixCommands}"
+    local release_commands="${releaseCommands}"
+    local services_commands="${servicesCommands}"
+    local env_commands="${envCommands}"
+    local maintenance_commands="${maintenanceCommands}"
     local agent_commands="${agentCommands}"
 
-    # Get previous word for context
     case "\${words[1]}" in
         feature)
             case "\${words[2]}" in
 ${featureSlugCase}                *)
-                    # Suggest feature subcommands
                     if [[ \${cword} -eq 2 ]]; then
                         COMPREPLY=( \$(compgen -W "\${feature_commands}" -- "\${cur}") )
                         return 0
@@ -243,29 +368,75 @@ ${featureSlugCase}                *)
                     ;;
             esac
             ;;
+        fix)
+            case "\${words[2]}" in
+${fixSlugCase}                *)
+                    if [[ \${cword} -eq 2 ]]; then
+                        COMPREPLY=( \$(compgen -W "\${fix_commands}" -- "\${cur}") )
+                        return 0
+                    fi
+                    ;;
+            esac
+            ;;
+        release)
+            case "\${words[2]}" in
+${releaseSlugCase}                *)
+                    if [[ \${cword} -eq 2 ]]; then
+                        COMPREPLY=( \$(compgen -W "\${release_commands}" -- "\${cur}") )
+                        return 0
+                    fi
+                    ;;
+            esac
+            ;;
+        services)
+            if [[ \${cword} -eq 2 ]]; then
+                COMPREPLY=( \$(compgen -W "\${services_commands}" -- "\${cur}") )
+                return 0
+            fi
+            ;;
+        env)
+            if [[ \${cword} -eq 2 ]]; then
+                COMPREPLY=( \$(compgen -W "\${env_commands}" -- "\${cur}") )
+                return 0
+            fi
+            ;;
+        maintenance)
+            if [[ \${cword} -eq 2 ]]; then
+                COMPREPLY=( \$(compgen -W "\${maintenance_commands}" -- "\${cur}") )
+                return 0
+            fi
+            if [[ \${cword} -eq 3 ]]; then
+                local branches="\$(_forge_all_branches)"
+                COMPREPLY=( \$(compgen -W "\${branches}" -- "\${cur}") )
+                return 0
+            fi
+            ;;
         mode)
-            # Suggest mode subcommands
             if [[ \${cword} -eq 2 ]]; then
-                COMPREPLY=( \$(compgen -W "\${mode_commands}" -- "\${cur}") )
+                local modes="\$(_forge_modes)"
+                COMPREPLY=( \$(compgen -W "\${modes}" -- "\${cur}") )
                 return 0
             fi
             ;;
         agent)
-            # Suggest agent subcommands
             if [[ \${cword} -eq 2 ]]; then
                 COMPREPLY=( \$(compgen -W "\${agent_commands}" -- "\${cur}") )
                 return 0
             fi
             ;;
 ${mainSlugCase}        completion)
-            # Suggest shell types for completion
+            if [[ \${cword} -eq 2 ]]; then
+                COMPREPLY=( \$(compgen -W "bash zsh fish powershell pwsh" -- "\${cur}") )
+                return 0
+            fi
+            ;;
+        alias)
             if [[ \${cword} -eq 2 ]]; then
                 COMPREPLY=( \$(compgen -W "bash zsh fish powershell pwsh" -- "\${cur}") )
                 return 0
             fi
             ;;
         *)
-            # Suggest main commands at root level
             if [[ \${cword} -eq 1 ]]; then
                 COMPREPLY=( \$(compgen -W "\${commands}" -- "\${cur}") )
                 return 0
@@ -284,44 +455,64 @@ complete -F _forge_completion forge
 #   Option 2 - Save to file:
 #     forge completion bash > ~/.local/share/bash-completion/completions/forge
 #     # Or system-wide: /etc/bash_completion.d/forge
+#
+# Tip: Run 'forge alias bash' to generate shell aliases for quick access.
 `;
     }
-    /**
-     * Generate zsh completion script.
-     *
-     * @returns Zsh completion script content
-     */
+    // ============================================================================
+    // ZSH COMPLETION
+    // ============================================================================
     generateZshCompletion() {
-        const mainCommands = this.getMainCommands();
-        const featureCmd = this.findCommand('feature');
-        const modeCmd = this.findCommand('mode');
-        const agentCmd = this.findCommand('agent');
-        // Build command arrays with descriptions
-        const commandsArray = mainCommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n');
-        const featureArray = featureCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
-        const modeArray = modeCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
-        const agentArray = agentCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
-        // Limit slug completions to active feature commands only
-        const activeFeatureSlugCommands = ['stop', 'archive', 'resync', 'merge', 'rebase', 'open'];
-        const featureWithActiveSlug = featureCmd?.subcommands.filter((cmd) => activeFeatureSlugCommands.includes(cmd.name)).map((cmd) => cmd.name) || [];
-        const mainWithActiveSlug = mainCommands.filter((cmd) => ['merge', 'rebase', 'open'].includes(cmd.name)).map((cmd) => cmd.name);
-        const featureSlugCase = featureWithActiveSlug.length > 0
-            ? `                        ${featureWithActiveSlug.join('|')})
-                            # Suggest available features
-                            local features
-                            local worktrees_root="\$(_forge_worktrees_root)"
-                            features=(\${(f)"\$(find "\${worktrees_root}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null)"})
-                            _describe 'feature slug' features
+        const data = this.getCompletionData();
+        const commandsArray = data.mainCommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n');
+        const featureArray = data.featureCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const fixArray = data.fixCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const releaseArray = data.releaseCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const servicesArray = data.servicesCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const envArray = data.envCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const maintenanceArray = data.maintenanceCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const agentArray = data.agentCmd?.subcommands.map((cmd) => `        '${cmd.name}:${cmd.description.replace(/'/g, "''")}'`).join('\n') || '';
+        const featureSlugCmds = data.featureCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || [];
+        const fixSlugCmds = data.fixCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || [];
+        const releaseSlugCmds = data.releaseCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || [];
+        const mainSlugCmds = data.mainCommands
+            .filter((cmd) => data.rootSlugCommands.includes(cmd.name))
+            .map((cmd) => cmd.name);
+        const featureSlugCase = featureSlugCmds.length > 0
+            ? `                        ${featureSlugCmds.join('|')})
+                            local -a slugs
+                            slugs=(\${(f)"\$(_forge_feature_slugs)"})
+                            _describe 'feature slug' slugs
+                            ;;
+`
+            : '';
+        const fixSlugCase = fixSlugCmds.length > 0
+            ? `                        ${fixSlugCmds.join('|')})
+                            local -a slugs
+                            slugs=(\${(f)"\$(_forge_fix_slugs)"})
+                            _describe 'fix slug' slugs
+                            ;;
+`
+            : '';
+        const releaseSlugCase = releaseSlugCmds.length > 0
+            ? `                        ${releaseSlugCmds.join('|')})
+                            local -a slugs
+                            slugs=(\${(f)"\$(_forge_release_slugs)"})
+                            _describe 'release slug' slugs
                             ;;
 `
             : '';
-        const mainSlugCase = mainWithActiveSlug.length > 0
-            ? `                ${mainWithActiveSlug.join('|')})
-                    # Suggest available features for shortcut commands
-                    local features
-                    local worktrees_root="\$(_forge_worktrees_root)"
-                    features=(\${(f)"\$(find "\${worktrees_root}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null)"})
-                    _describe 'feature slug' features
+        const mainSlugCase = mainSlugCmds.length > 0
+            ? `                ${mainSlugCmds.join('|')})
+                    local -a branches
+                    branches=(\${(f)"\$(_forge_all_branches)"})
+                    _describe 'branch name' branches
                     ;;
 `
             : '';
@@ -340,41 +531,111 @@ _forge_find_config() {
     return 1
 }
 
-_forge_worktrees_root() {
-    if [[ -n "\${FORGE_WORKTREES_ROOT}" ]]; then
-        echo "\${FORGE_WORKTREES_ROOT}"
+# Load forge config once and cache variables for the current completion
+_forge_config_loaded=0
+_forge_load_config() {
+    if [[ \${_forge_config_loaded} -eq 1 ]]; then
         return 0
     fi
+    _FORGE_WORKTREES_ROOT=""
+    _FORGE_FEATURE_PREFIX="feature/"
+    _FORGE_FIX_PREFIX="fix/"
+    _FORGE_RELEASE_PREFIX="release/"
+    _FORGE_MODES=""
+
+    if [[ -n "\${FORGE_WORKTREES_ROOT}" ]]; then
+        _FORGE_WORKTREES_ROOT="\${FORGE_WORKTREES_ROOT}"
+    fi
+
     local start="\${PWD}"
     local config_root
     config_root="\$(_forge_find_config "\${start}")" || true
     if [[ -n "\${config_root}" ]]; then
-        local worktrees
-        worktrees=\$(node -e 'const fs=require("fs");const path=require("path");
-try{
-  const file=process.argv[1];
-  const configRoot=path.dirname(file);
-  const data=JSON.parse(fs.readFileSync(file,"utf8"));
-  let rootDir=data.rootDir;
-  if(rootDir){ if(!path.isAbsolute(rootDir)) rootDir=path.join(configRoot, rootDir); }
-  else { rootDir=configRoot; }
-  const folders=(data.options && data.options.folders) || data.folders || {};
-  const worktrees=folders.worktrees || "features";
-  process.stdout.write(path.join(rootDir, worktrees));
-}catch(e){}
-' "\${config_root}/.feat-forge.json" 2>/dev/null)
-        if [[ -n "\${worktrees}" ]]; then
-            echo "\${worktrees}"
-            return 0
+        local output
+        output=\$(node -e ${this.nodeConfigSnippet()} "\${config_root}/.feat-forge.json" 2>/dev/null)
+        if [[ -n "\${output}" ]]; then
+            eval "\${output}"
+        elif [[ -z "\${_FORGE_WORKTREES_ROOT}" ]]; then
+            _FORGE_WORKTREES_ROOT="\${config_root}/worktrees"
         fi
-        echo "\${config_root}/features"
-        return 0
+    elif [[ -z "\${_FORGE_WORKTREES_ROOT}" ]]; then
+        _FORGE_WORKTREES_ROOT="worktrees"
     fi
-    echo "features"
+    _forge_config_loaded=1
+}
+
+_forge_feature_slugs() {
+    _forge_load_config
+    local prefix_dir="\${_FORGE_FEATURE_PREFIX%/}"
+    local dir="\${_FORGE_WORKTREES_ROOT}/\${prefix_dir}"
+    if [[ -d "\${dir}" ]]; then
+        find "\${dir}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null
+    fi
+}
+
+_forge_fix_slugs() {
+    _forge_load_config
+    local prefix_dir="\${_FORGE_FIX_PREFIX%/}"
+    local dir="\${_FORGE_WORKTREES_ROOT}/\${prefix_dir}"
+    if [[ -d "\${dir}" ]]; then
+        find "\${dir}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null
+    fi
+}
+
+_forge_release_slugs() {
+    _forge_load_config
+    local prefix_dir="\${_FORGE_RELEASE_PREFIX%/}"
+    local dir="\${_FORGE_WORKTREES_ROOT}/\${prefix_dir}"
+    if [[ -d "\${dir}" ]]; then
+        find "\${dir}" -mindepth 1 -maxdepth 1 -type d -exec basename {} \\; 2>/dev/null
+    fi
+}
+
+_forge_all_branches() {
+    _forge_load_config
+    local root="\${_FORGE_WORKTREES_ROOT}"
+    if [[ ! -d "\${root}" ]]; then
+        return
+    fi
+    local prefix_dirs=()
+    for p in "\${_FORGE_FEATURE_PREFIX%/}" "\${_FORGE_FIX_PREFIX%/}" "\${_FORGE_RELEASE_PREFIX%/}"; do
+        if [[ -n "\${p}" ]]; then
+            prefix_dirs+=("\${p}")
+        fi
+    done
+    for entry in "\${root}"/*/; do
+        [[ -d "\${entry}" ]] || continue
+        local name="\$(basename "\${entry}")"
+        local is_prefix=0
+        for pd in "\${prefix_dirs[@]}"; do
+            if [[ "\${name}" == "\${pd}" ]]; then
+                is_prefix=1
+                break
+            fi
+        done
+        if [[ \${is_prefix} -eq 1 ]]; then
+            for sub in "\${entry}"*/; do
+                [[ -d "\${sub}" ]] || continue
+                echo "\${name}/\$(basename "\${sub}")"
+            done
+        else
+            echo "\${name}"
+        fi
+    done
+}
+
+_forge_modes() {
+    _forge_load_config
+    echo "\${_FORGE_MODES}"
 }
 
 _forge() {
-    local -a commands feature_commands mode_commands agent_commands
+    local -a commands feature_commands fix_commands release_commands
+    local -a services_commands env_commands maintenance_commands
+    local -a agent_commands
+
+    # Reset config cache for each completion
+    _forge_config_loaded=0
 
     commands=(
 ${commandsArray}
@@ -384,8 +645,24 @@ ${commandsArray}
 ${featureArray}
     )
 
-    mode_commands=(
-${modeArray}
+    fix_commands=(
+${fixArray}
+    )
+
+    release_commands=(
+${releaseArray}
+    )
+
+    services_commands=(
+${servicesArray}
+    )
+
+    env_commands=(
+${envArray}
+    )
+
+    maintenance_commands=(
+${maintenanceArray}
     )
 
     agent_commands=(
@@ -409,14 +686,52 @@ ${featureSlugCase}                        *)
                             ;;
                     esac
                     ;;
+                fix)
+                    case \${words[2]} in
+${fixSlugCase}                        *)
+                            _describe 'fix command' fix_commands
+                            ;;
+                    esac
+                    ;;
+                release)
+                    case \${words[2]} in
+${releaseSlugCase}                        *)
+                            _describe 'release command' release_commands
+                            ;;
+                    esac
+                    ;;
+                services)
+                    _describe 'services command' services_commands
+                    ;;
+                env)
+                    _describe 'env command' env_commands
+                    ;;
+                maintenance)
+                    if (( CURRENT == 2 )); then
+                        _describe 'maintenance command' maintenance_commands
+                    else
+                        local -a branches
+                        branches=(\${(f)"\$(_forge_all_branches)"})
+                        _describe 'branch name' branches
+                    fi
+                    ;;
                 mode)
-                    _describe 'mode command' mode_commands
+                    local -a modes
+                    modes=(\${(f)"\$(_forge_modes)"})
+                    if [[ \${#modes} -gt 0 ]]; then
+                        _describe 'mode name' modes
+                    fi
                     ;;
                 agent)
                     _describe 'agent command' agent_commands
                     ;;
 ${mainSlugCase}                completion)
-                    local shells
+                    local -a shells
+                    shells=('bash' 'zsh' 'fish' 'powershell' 'pwsh')
+                    _describe 'shell type' shells
+                    ;;
+                alias)
+                    local -a shells
                     shells=('bash' 'zsh' 'fish' 'powershell' 'pwsh')
                     _describe 'shell type' shells
                     ;;
@@ -436,50 +751,60 @@ compdef _forge forge
 #     forge completion zsh > ~/.zsh/completions/_forge
 #     # Add to .zshrc: fpath=(~/.zsh/completions $fpath)
 #     # Then run: autoload -Uz compinit && compinit
+#
+# Tip: Run 'forge alias zsh' to generate shell aliases for quick access.
 `;
     }
-    /**
-     * Generate fish completion script.
-     *
-     * @returns Fish completion script content
-     */
+    // ============================================================================
+    // FISH COMPLETION
+    // ============================================================================
     generateFishCompletion() {
-        const mainCommands = this.getMainCommands();
-        const featureCmd = this.findCommand('feature');
-        const modeCmd = this.findCommand('mode');
-        const agentCmd = this.findCommand('agent');
-        // Generate main commands
-        const mainCommandsLines = mainCommands
+        const data = this.getCompletionData();
+        // Main commands
+        const mainCommandsLines = data.mainCommands
             .map((cmd) => `complete -c forge -n "__fish_use_subcommand" -a ${cmd.name} -d "${cmd.description.replace(/"/g, '\\"')}"`)
             .join('\n');
-        // Generate feature subcommands
-        const featureSubLines = featureCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
-        const featureSubCmds = featureCmd?.subcommands
-            .map((cmd) => `complete -c forge -n "__fish_seen_subcommand_from feature; and not __fish_seen_subcommand_from ${featureSubLines}" -a ${cmd.name} -d "${cmd.description.replace(/"/g, '\\"')}"`)
-            .join('\n') || '';
-        // Generate mode subcommands
-        const modeSubLines = modeCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
-        const modeSubCmds = modeCmd?.subcommands
-            .map((cmd) => `complete -c forge -n "__fish_seen_subcommand_from mode; and not __fish_seen_subcommand_from ${modeSubLines}" -a ${cmd.name} -d "${cmd.description.replace(/"/g, '\\"')}"`)
-            .join('\n') || '';
-        // Generate agent subcommands
-        const agentSubLines = agentCmd?.subcommands.map((cmd) => cmd.name).join(' ') || '';
-        const agentSubCmds = agentCmd?.subcommands
-            .map((cmd) => `complete -c forge -n "__fish_seen_subcommand_from agent; and not __fish_seen_subcommand_from ${agentSubLines}" -a ${cmd.name} -d "${cmd.description.replace(/"/g, '\\"')}"`)
-            .join('\n') || '';
-        // Limit slug completions to active feature commands only
-        const activeFeatureSlugCommands = ['stop', 'archive', 'resync', 'merge', 'rebase', 'open'];
-        const featureWithActiveSlug = featureCmd?.subcommands.filter((cmd) => activeFeatureSlugCommands.includes(cmd.name)) || [];
-        const featureSlugCompletions = featureWithActiveSlug
-            .map((cmd) => `complete -c forge -n "__fish_seen_subcommand_from feature; and __fish_seen_subcommand_from ${cmd.name}" -a "(__forge_features)"`)
-            .join('\n');
-        const mainWithActiveSlug = mainCommands.filter((cmd) => ['merge', 'rebase', 'open'].includes(cmd.name));
-        const mainSlugCompletions = mainWithActiveSlug
-            .map((cmd) => `complete -c forge -n "__fish_seen_subcommand_from ${cmd.name}" -a "(__forge_features)"`)
+        // Helper to generate subcommand completions for a group
+        const genSubCmds = (parentName, cmd) => {
+            if (!cmd || !cmd.subcommands.length)
+                return '';
+            const subNames = cmd.subcommands.map((c) => c.name).join(' ');
+            return cmd.subcommands
+                .map((c) => `complete -c forge -n "__fish_seen_subcommand_from ${parentName}; and not __fish_seen_subcommand_from ${subNames}" -a ${c.name} -d "${c.description.replace(/"/g, '\\"')}"`)
+                .join('\n');
+        };
+        const featureSubCmds = genSubCmds('feature', data.featureCmd);
+        const fixSubCmds = genSubCmds('fix', data.fixCmd);
+        const releaseSubCmds = genSubCmds('release', data.releaseCmd);
+        const servicesSubCmds = genSubCmds('services', data.servicesCmd);
+        const envSubCmds = genSubCmds('env', data.envCmd);
+        const maintenanceSubCmds = genSubCmds('maintenance', data.maintenanceCmd);
+        const agentSubCmds = genSubCmds('agent', data.agentCmd);
+        // Slug completions for feature/fix/release
+        const genSlugCompletions = (parentName, cmd, slugFn) => {
+            if (!cmd)
+                return '';
+            const slugCmds = cmd.subcommands.filter((c) => data.slugSubcommands.includes(c.name));
+            return slugCmds
+                .map((c) => `complete -c forge -n "__fish_seen_subcommand_from ${parentName}; and __fish_seen_subcommand_from ${c.name}" -a "(${slugFn})"`)
+                .join('\n');
+        };
+        const featureSlugCompletions = genSlugCompletions('feature', data.featureCmd, '__forge_feature_slugs');
+        const fixSlugCompletions = genSlugCompletions('fix', data.fixCmd, '__forge_fix_slugs');
+        const releaseSlugCompletions = genSlugCompletions('release', data.releaseCmd, '__forge_release_slugs');
+        // Root-level slug commands
+        const mainSlugCmds = data.mainCommands
+            .filter((cmd) => data.rootSlugCommands.includes(cmd.name));
+        const mainSlugCompletions = mainSlugCmds
+            .map((cmd) => `complete -c forge -n "__fish_seen_subcommand_from ${cmd.name}" -a "(__forge_all_branches)"`)
             .join('\n');
+        // Maintenance slug completion at position 3
+        const maintenanceSlugCompletion = data.maintenanceCmd?.subcommands
+            .map((c) => `complete -c forge -n "__fish_seen_subcommand_from maintenance; and __fish_seen_subcommand_from ${c.name}" -a "(__forge_all_branches)"`)
+            .join('\n') || '';
         return `# forge fish completion script
 
-# Helper functions to get available features
+# Helper functions
 function __forge_find_config_root
     set -l dir $PWD
     while test -n "$dir" -a "$dir" != "/"
@@ -492,45 +817,107 @@ function __forge_find_config_root
     return 1
 end
 
-function __forge_worktrees_root
-    if test -n "$FORGE_WORKTREES_ROOT"
-        echo $FORGE_WORKTREES_ROOT
+set -g _forge_config_loaded 0
+
+function __forge_load_config
+    if test $_forge_config_loaded -eq 1
         return 0
     end
+    set -g _FORGE_WORKTREES_ROOT ""
+    set -g _FORGE_FEATURE_PREFIX "feature/"
+    set -g _FORGE_FIX_PREFIX "fix/"
+    set -g _FORGE_RELEASE_PREFIX "release/"
+    set -g _FORGE_MODES ""
+
+    if test -n "$FORGE_WORKTREES_ROOT"
+        set -g _FORGE_WORKTREES_ROOT $FORGE_WORKTREES_ROOT
+    end
+
     set -l config_root (__forge_find_config_root)
     if test -n "$config_root"
-        set -l worktrees (node -e 'const fs=require("fs");const path=require("path");
-try{
-  const file=process.argv[1];
-  const configRoot=path.dirname(file);
-  const data=JSON.parse(fs.readFileSync(file,"utf8"));
-  let rootDir=data.rootDir;
-  if(rootDir){ if(!path.isAbsolute(rootDir)) rootDir=path.join(configRoot, rootDir); }
-  else { rootDir=configRoot; }
-  const folders=(data.options && data.options.folders) || data.folders || {};
-  const worktrees=folders.worktrees || "features";
-  process.stdout.write(path.join(rootDir, worktrees));
-}catch(e){}
-' "$config_root/.feat-forge.json" 2>/dev/null)
-        if test -n "$worktrees"
-            echo "$worktrees"
-            return 0
+        set -l output (node -e ${this.nodeConfigSnippetFish()} "$config_root/.feat-forge.json" 2>/dev/null)
+        if test -n "$output"
+            eval $output
+        else if test -z "$_FORGE_WORKTREES_ROOT"
+            set -g _FORGE_WORKTREES_ROOT "$config_root/worktrees"
+        end
+    else if test -z "$_FORGE_WORKTREES_ROOT"
+        set -g _FORGE_WORKTREES_ROOT "worktrees"
+    end
+    set -g _forge_config_loaded 1
+end
+
+function __forge_feature_slugs
+    __forge_load_config
+    set -l prefix_dir (string trim --right --chars=/ $_FORGE_FEATURE_PREFIX)
+    set -l dir "$_FORGE_WORKTREES_ROOT/$prefix_dir"
+    if test -d "$dir"
+        for entry in $dir/*/
+            basename $entry
+        end
+    end
+end
+
+function __forge_fix_slugs
+    __forge_load_config
+    set -l prefix_dir (string trim --right --chars=/ $_FORGE_FIX_PREFIX)
+    set -l dir "$_FORGE_WORKTREES_ROOT/$prefix_dir"
+    if test -d "$dir"
+        for entry in $dir/*/
+            basename $entry
+        end
+    end
+end
+
+function __forge_release_slugs
+    __forge_load_config
+    set -l prefix_dir (string trim --right --chars=/ $_FORGE_RELEASE_PREFIX)
+    set -l dir "$_FORGE_WORKTREES_ROOT/$prefix_dir"
+    if test -d "$dir"
+        for entry in $dir/*/
+            basename $entry
         end
-        echo "$config_root/features"
-        return 0
     end
-    echo "features"
 end
 
-function __forge_features
-    set -l worktrees_root (__forge_worktrees_root)
-    if test -d $worktrees_root
-        for dir in $worktrees_root/*/
-            basename $dir
+function __forge_all_branches
+    __forge_load_config
+    set -l root $_FORGE_WORKTREES_ROOT
+    if not test -d "$root"
+        return
+    end
+    set -l prefix_dirs (string trim --right --chars=/ $_FORGE_FEATURE_PREFIX) (string trim --right --chars=/ $_FORGE_FIX_PREFIX) (string trim --right --chars=/ $_FORGE_RELEASE_PREFIX)
+    for entry in $root/*/
+        set -l name (basename $entry)
+        set -l is_prefix 0
+        for pd in $prefix_dirs
+            if test "$name" = "$pd"
+                set is_prefix 1
+                break
+            end
+        end
+        if test $is_prefix -eq 1
+            for sub in $entry*/
+                if test -d "$sub"
+                    echo "$name/"(basename $sub)
+                end
+            end
+        else
+            echo $name
         end
     end
 end
 
+function __forge_modes
+    __forge_load_config
+    string split " " $_FORGE_MODES
+end
+
+# Reset config cache on each completion invocation
+function __forge_reset_config --on-event fish_prompt
+    set -g _forge_config_loaded 0
+end
+
 # Disable file completion by default
 complete -c forge -f
 
@@ -540,18 +927,42 @@ ${mainCommandsLines}
 # Feature subcommands
 ${featureSubCmds}
 
-# Feature commands with slug completion
+# Feature slug completions
 ${featureSlugCompletions}
 
-# Mode subcommands
-${modeSubCmds}
+# Fix subcommands
+${fixSubCmds}
+
+# Fix slug completions
+${fixSlugCompletions}
+
+# Release subcommands
+${releaseSubCmds}
+
+# Release slug completions
+${releaseSlugCompletions}
+
+# Services subcommands
+${servicesSubCmds}
+
+# Env subcommands
+${envSubCmds}
+
+# Maintenance subcommands
+${maintenanceSubCmds}
+
+# Maintenance slug completions
+${maintenanceSlugCompletion}
 
 # Agent subcommands
 ${agentSubCmds}
 
-# Main commands with feature slug completion
+# Root-level commands with branch completion
 ${mainSlugCompletions}
 
+# Mode command with mode name completion
+complete -c forge -n "__fish_seen_subcommand_from mode" -a "(__forge_modes)"
+
 # Completion command with shell types
 complete -c forge -n "__fish_seen_subcommand_from completion" -a bash -d "Generate bash completion"
 complete -c forge -n "__fish_seen_subcommand_from completion" -a zsh -d "Generate zsh completion"
@@ -559,33 +970,49 @@ complete -c forge -n "__fish_seen_subcommand_from completion" -a fish -d "Genera
 complete -c forge -n "__fish_seen_subcommand_from completion" -a powershell -d "Generate PowerShell completion"
 complete -c forge -n "__fish_seen_subcommand_from completion" -a pwsh -d "Generate PowerShell completion"
 
+# Alias command with shell types
+complete -c forge -n "__fish_seen_subcommand_from alias" -a bash -d "Generate bash aliases"
+complete -c forge -n "__fish_seen_subcommand_from alias" -a zsh -d "Generate zsh aliases"
+complete -c forge -n "__fish_seen_subcommand_from alias" -a fish -d "Generate fish aliases"
+complete -c forge -n "__fish_seen_subcommand_from alias" -a powershell -d "Generate PowerShell aliases"
+complete -c forge -n "__fish_seen_subcommand_from alias" -a pwsh -d "Generate PowerShell aliases"
+
 # Installation instructions:
 #   Option 1 - Add to ~/.config/fish/config.fish:
 #     forge completion fish | source
 #
 #   Option 2 - Save to completions directory:
 #     forge completion fish > ~/.config/fish/completions/forge.fish
+#
+# Tip: Run 'forge alias fish' to generate shell aliases for quick access.
 `;
     }
-    /**
-     * Generate PowerShell completion script.
-     *
-     * @returns PowerShell completion script content
-     */
+    // ============================================================================
+    // POWERSHELL COMPLETION
+    // ============================================================================
     generatePowerShellCompletion() {
-        const mainCommands = this.getMainCommands();
-        const featureCmd = this.findCommand('feature');
-        const modeCmd = this.findCommand('mode');
-        const agentCmd = this.findCommand('agent');
+        const data = this.getCompletionData();
         const toPsArray = (items) => items.length > 0 ? items.map((item) => `'${item.replace(/'/g, "''")}'`).join(', ') : '';
-        const mainCommandsList = toPsArray(mainCommands.map((cmd) => cmd.name));
-        const featureCommandsList = toPsArray(featureCmd?.subcommands.map((cmd) => cmd.name) || []);
-        const modeCommandsList = toPsArray(modeCmd?.subcommands.map((cmd) => cmd.name) || []);
-        const agentCommandsList = toPsArray(agentCmd?.subcommands.map((cmd) => cmd.name) || []);
-        const activeFeatureSlugCommands = ['stop', 'archive', 'resync', 'merge', 'rebase', 'open'];
-        const featureWithActiveSlug = featureCmd?.subcommands.filter((cmd) => activeFeatureSlugCommands.includes(cmd.name)) || [];
-        const featureSlugCommandsList = toPsArray(featureWithActiveSlug.map((cmd) => cmd.name));
-        const mainSlugCommandsList = toPsArray(mainCommands.filter((cmd) => ['merge', 'rebase', 'open'].includes(cmd.name)).map((cmd) => cmd.name));
+        const mainCommandsList = toPsArray(data.mainCommands.map((cmd) => cmd.name));
+        const featureCommandsList = toPsArray(data.featureCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const fixCommandsList = toPsArray(data.fixCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const releaseCommandsList = toPsArray(data.releaseCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const servicesCommandsList = toPsArray(data.servicesCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const envCommandsList = toPsArray(data.envCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const maintenanceCommandsList = toPsArray(data.maintenanceCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const agentCommandsList = toPsArray(data.agentCmd?.subcommands.map((cmd) => cmd.name) || []);
+        const featureSlugCommandsList = toPsArray(data.featureCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || []);
+        const fixSlugCommandsList = toPsArray(data.fixCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || []);
+        const releaseSlugCommandsList = toPsArray(data.releaseCmd?.subcommands
+            .filter((cmd) => data.slugSubcommands.includes(cmd.name))
+            .map((cmd) => cmd.name) || []);
+        const mainSlugCommandsList = toPsArray(data.mainCommands
+            .filter((cmd) => data.rootSlugCommands.includes(cmd.name))
+            .map((cmd) => cmd.name));
         const completionShellsList = toPsArray(['bash', 'zsh', 'fish', 'powershell', 'pwsh']);
         return `# forge PowerShell completion script
 
@@ -600,40 +1027,100 @@ function __ForgeFindConfigRoot {
     return $null
 }
 
-function __ForgeWorktreesRoot {
-    if ($env:FORGE_WORKTREES_ROOT) { return $env:FORGE_WORKTREES_ROOT }
+$script:__ForgeConfigLoaded = $false
+$script:__ForgeConfig = $null
+
+function __ForgeLoadConfig {
+    if ($script:__ForgeConfigLoaded) { return }
+
+    $script:__ForgeConfig = @{
+        WorktreesRoot = ""
+        FeaturePrefix = "feature/"
+        FixPrefix = "fix/"
+        ReleasePrefix = "release/"
+        Modes = @()
+    }
+
+    if ($env:FORGE_WORKTREES_ROOT) {
+        $script:__ForgeConfig.WorktreesRoot = $env:FORGE_WORKTREES_ROOT
+    }
+
     $configRoot = __ForgeFindConfigRoot
     if ($configRoot) {
         try {
-            $json = Get-Content -Raw -Path (Join-Path $configRoot ".feat-forge.json") | ConvertFrom-Json
-            $rootDir = $json.rootDir
-            if ($rootDir) {
-                if (-not [System.IO.Path]::IsPathRooted($rootDir)) {
-                    $rootDir = Join-Path $configRoot $rootDir
-                }
-            } else {
-                $rootDir = $configRoot
-            }
-            if ($json.options -and $json.options.folders -and $json.options.folders.worktrees) {
-                return (Join-Path $rootDir $json.options.folders.worktrees)
+            $output = node -e ${this.nodeConfigSnippetPowerShell()} (Join-Path $configRoot ".feat-forge.json") 2>$null
+            if ($output) {
+                $parsed = $output | ConvertFrom-Json
+                if ($parsed.worktreesRoot) { $script:__ForgeConfig.WorktreesRoot = $parsed.worktreesRoot }
+                if ($parsed.featurePrefix) { $script:__ForgeConfig.FeaturePrefix = $parsed.featurePrefix }
+                if ($parsed.fixPrefix) { $script:__ForgeConfig.FixPrefix = $parsed.fixPrefix }
+                if ($parsed.releasePrefix) { $script:__ForgeConfig.ReleasePrefix = $parsed.releasePrefix }
+                if ($parsed.modes) { $script:__ForgeConfig.Modes = $parsed.modes }
             }
-            if ($json.folders -and $json.folders.worktrees) {
-                return (Join-Path $rootDir $json.folders.worktrees)
-            }
-        } catch {
+        } catch {}
+        if (-not $script:__ForgeConfig.WorktreesRoot) {
+            $script:__ForgeConfig.WorktreesRoot = Join-Path $configRoot "worktrees"
         }
-        return (Join-Path $rootDir "features")
     }
-    return "features"
+    if (-not $script:__ForgeConfig.WorktreesRoot) {
+        $script:__ForgeConfig.WorktreesRoot = "worktrees"
+    }
+    $script:__ForgeConfigLoaded = $true
 }
 
 function __ForgeFeatureSlugs {
-    $worktreesRoot = __ForgeWorktreesRoot
-    if (Test-Path $worktreesRoot) {
-        Get-ChildItem -Directory -Path $worktreesRoot | ForEach-Object { $_.Name }
+    __ForgeLoadConfig
+    $prefix = $script:__ForgeConfig.FeaturePrefix.TrimEnd('/')
+    $dir = Join-Path $script:__ForgeConfig.WorktreesRoot $prefix
+    if (Test-Path $dir) {
+        Get-ChildItem -Directory -Path $dir | ForEach-Object { $_.Name }
+    }
+}
+
+function __ForgeFixSlugs {
+    __ForgeLoadConfig
+    $prefix = $script:__ForgeConfig.FixPrefix.TrimEnd('/')
+    $dir = Join-Path $script:__ForgeConfig.WorktreesRoot $prefix
+    if (Test-Path $dir) {
+        Get-ChildItem -Directory -Path $dir | ForEach-Object { $_.Name }
     }
 }
 
+function __ForgeReleaseSlugs {
+    __ForgeLoadConfig
+    $prefix = $script:__ForgeConfig.ReleasePrefix.TrimEnd('/')
+    $dir = Join-Path $script:__ForgeConfig.WorktreesRoot $prefix
+    if (Test-Path $dir) {
+        Get-ChildItem -Directory -Path $dir | ForEach-Object { $_.Name }
+    }
+}
+
+function __ForgeAllBranches {
+    __ForgeLoadConfig
+    $root = $script:__ForgeConfig.WorktreesRoot
+    if (-not (Test-Path $root)) { return }
+    $prefixDirs = @(
+        $script:__ForgeConfig.FeaturePrefix.TrimEnd('/'),
+        $script:__ForgeConfig.FixPrefix.TrimEnd('/'),
+        $script:__ForgeConfig.ReleasePrefix.TrimEnd('/')
+    )
+    Get-ChildItem -Directory -Path $root | ForEach-Object {
+        $name = $_.Name
+        if ($prefixDirs -contains $name) {
+            Get-ChildItem -Directory -Path $_.FullName | ForEach-Object {
+                "$name/$($_.Name)"
+            }
+        } else {
+            $name
+        }
+    }
+}
+
+function __ForgeModes {
+    __ForgeLoadConfig
+    $script:__ForgeConfig.Modes
+}
+
 function __ForgeCompletionResults {
     param([string[]]$Items, [string]$Word)
     if (-not $Items) { return }
@@ -644,15 +1131,24 @@ function __ForgeCompletionResults {
 
 $mainCommands = @(${mainCommandsList})
 $featureCommands = @(${featureCommandsList})
-$modeCommands = @(${modeCommandsList})
+$fixCommands = @(${fixCommandsList})
+$releaseCommands = @(${releaseCommandsList})
+$servicesCommands = @(${servicesCommandsList})
+$envCommands = @(${envCommandsList})
+$maintenanceCommands = @(${maintenanceCommandsList})
 $agentCommands = @(${agentCommandsList})
 $featureSlugCommands = @(${featureSlugCommandsList})
+$fixSlugCommands = @(${fixSlugCommandsList})
+$releaseSlugCommands = @(${releaseSlugCommandsList})
 $mainSlugCommands = @(${mainSlugCommandsList})
 $completionShells = @(${completionShellsList})
 
 Register-ArgumentCompleter -CommandName forge -ScriptBlock {
     param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
 
+    # Reset config cache for each completion
+    $script:__ForgeConfigLoaded = $false
+
     $elements = $commandAst.CommandElements | ForEach-Object { $_.Value }
 
     if ($elements.Count -le 1) {
@@ -673,8 +1169,46 @@ Register-ArgumentCompleter -CommandName forge -ScriptBlock {
                 return
             }
         }
+        'fix' {
+            if ($elements.Count -le 2) {
+                __ForgeCompletionResults -Items $fixCommands -Word $wordToComplete
+                return
+            }
+            $sub = $elements[2]
+            if ($fixSlugCommands -contains $sub) {
+                __ForgeCompletionResults -Items (__ForgeFixSlugs) -Word $wordToComplete
+                return
+            }
+        }
+        'release' {
+            if ($elements.Count -le 2) {
+                __ForgeCompletionResults -Items $releaseCommands -Word $wordToComplete
+                return
+            }
+            $sub = $elements[2]
+            if ($releaseSlugCommands -contains $sub) {
+                __ForgeCompletionResults -Items (__ForgeReleaseSlugs) -Word $wordToComplete
+                return
+            }
+        }
+        'services' {
+            __ForgeCompletionResults -Items $servicesCommands -Word $wordToComplete
+            return
+        }
+        'env' {
+            __ForgeCompletionResults -Items $envCommands -Word $wordToComplete
+            return
+        }
+        'maintenance' {
+            if ($elements.Count -le 2) {
+                __ForgeCompletionResults -Items $maintenanceCommands -Word $wordToComplete
+                return
+            }
+            __ForgeCompletionResults -Items (__ForgeAllBranches) -Word $wordToComplete
+            return
+        }
         'mode' {
-            __ForgeCompletionResults -Items $modeCommands -Word $wordToComplete
+            __ForgeCompletionResults -Items (__ForgeModes) -Word $wordToComplete
             return
         }
         'agent' {
@@ -685,9 +1219,13 @@ Register-ArgumentCompleter -CommandName forge -ScriptBlock {
             __ForgeCompletionResults -Items $completionShells -Word $wordToComplete
             return
         }
+        'alias' {
+            __ForgeCompletionResults -Items $completionShells -Word $wordToComplete
+            return
+        }
         default {
             if ($mainSlugCommands -contains $first) {
-                __ForgeCompletionResults -Items (__ForgeFeatureSlugs) -Word $wordToComplete
+                __ForgeCompletionResults -Items (__ForgeAllBranches) -Word $wordToComplete
                 return
             }
         }
@@ -695,8 +1233,10 @@ Register-ArgumentCompleter -CommandName forge -ScriptBlock {
 }
 
 # Installation instructions:
-#   Option 1 - Add to $PROFILE:
+#   Option 1 - Add to \$PROFILE:
 #     forge completion powershell | Out-String | Invoke-Expression
+#
+# Tip: Run 'forge alias powershell' to generate shell aliases for quick access.
 `;
     }
 }