bktide 1.0.1755267617 → 1.0.1755559112

package/completions/bktide.zsh

@@ -0,0 +1,139 @@
+#compdef bktide
+# Zsh completions for bktide CLI
+# Install by adding to ~/.zshrc: source <(bktide completions zsh)
+# Or copy to a directory in your $fpath
+
+_bktide() {
+    local -a commands global_opts
+    
+    commands=(
+        'viewer:Show logged in user information'
+        'orgs:List organizations'
+        'pipelines:List pipelines for an organization'
+        'builds:List builds for the current user'
+        'token:Manage API tokens'
+        'annotations:Show annotations for a build'
+        'completions:Generate shell completions'
+        'boom:Test error handling'
+    )
+    
+    global_opts=(
+        '--log-level[Set logging level]:level:(trace debug info warn error fatal)'
+        {-d,--debug}'[Show debug information for errors]'
+        '--no-cache[Disable caching of API responses]'
+        '--cache-ttl[Set cache TTL in milliseconds]:milliseconds:'
+        '--clear-cache[Clear all cached data before executing]'
+        {-t,--token}'[Buildkite API token]:token:'
+        '--save-token[Save the token to system keychain]'
+        {-f,--format}'[Output format]:format:(plain json alfred)'
+        '--color[Color output mode]:mode:(auto always never)'
+        {-q,--quiet}'[Suppress non-error output]'
+        '--tips[Show helpful tips and suggestions]'
+        '--no-tips[Hide helpful tips and suggestions]'
+        '--ascii[Use ASCII symbols instead of Unicode]'
+        {-h,--help}'[Show help]'
+        {-V,--version}'[Show version]'
+    )
+    
+    # Main command completion
+    if (( CURRENT == 2 )); then
+        _describe -t commands 'bktide commands' commands
+        return
+    fi
+    
+    local cmd="${words[2]}"
+    
+    # Command-specific completions
+    case "$cmd" in
+        pipelines)
+            _arguments \
+                {-o,--org}'[Organization slug]:org:->orgs' \
+                {-n,--count}'[Limit to specified number]:count:' \
+                '--filter[Filter pipelines by name]:filter:' \
+                $global_opts
+            
+            case "$state" in
+                orgs)
+                    # Dynamic org completion
+                    local -a orgs
+                    orgs=(${(f)"$(bktide orgs --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null)"})
+                    _describe -t orgs 'organizations' orgs
+                    ;;
+            esac
+            ;;
+            
+        builds)
+            _arguments \
+                {-o,--org}'[Organization slug]:org:->orgs' \
+                {-p,--pipeline}'[Filter by pipeline slug]:pipeline:->pipelines' \
+                {-b,--branch}'[Filter by branch name]:branch:->branches' \
+                {-s,--state}'[Filter by build state]:state:(running scheduled passed failing failed canceled blocked canceling skipped not_run)' \
+                {-n,--count}'[Number of builds per page]:count:' \
+                '--page[Page number]:page:' \
+                '--filter[Fuzzy filter builds]:filter:' \
+                $global_opts
+            
+            case "$state" in
+                orgs)
+                    local -a orgs
+                    orgs=(${(f)"$(bktide orgs --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null)"})
+                    _describe -t orgs 'organizations' orgs
+                    ;;
+                pipelines)
+                    local -a pipelines
+                    pipelines=(${(f)"$(bktide pipelines --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null)"})
+                    _describe -t pipelines 'pipelines' pipelines
+                    ;;
+                branches)
+                    local -a branches
+                    branches=(main master develop staging production)
+                    if git rev-parse --git-dir &>/dev/null; then
+                        branches+=(${(f)"$(git branch -r 2>/dev/null | sed 's/.*origin\///' | grep -v HEAD)"})
+                    fi
+                    _describe -t branches 'branches' branches
+                    ;;
+            esac
+            ;;
+            
+        token)
+            _arguments \
+                '--check[Check if a token is stored]' \
+                '--store[Store a token in the system keychain]' \
+                '--reset[Delete the stored token]' \
+                $global_opts
+            ;;
+            
+        annotations)
+            _arguments \
+                ':build reference:(org/pipeline/123)' \
+                '--context[Filter annotations by context]:context:' \
+                $global_opts
+            ;;
+            
+        completions)
+            if (( CURRENT == 3 )); then
+                local -a shells
+                shells=(fish bash zsh)
+                _describe -t shells 'shell type' shells
+            else
+                _arguments $global_opts
+            fi
+            ;;
+            
+        boom)
+            _arguments \
+                '--type[Type of error to throw]:type:(basic api object)' \
+                $global_opts
+            ;;
+            
+        *)
+            _arguments $global_opts
+            ;;
+    esac
+}
+
+# Also support bin/bktide
+compdef _bktide bin/bktide
+
+_bktide "$@"
+

package/dist/commands/BaseCommand.js

@@ -118,7 +118,12 @@ export class BaseCommand {
         if (options.token) {
             return options.token;
         }
-        // Next try to get token from keyring
+        // Prefer environment variables first under Alfred or if explicitly provided
+        const envToken = process.env.BUILDKITE_API_TOKEN || process.env.BK_TOKEN;
+        if (envToken) {
+            return envToken;
+        }
+        // Next try to get token from keyring (outside Alfred this will lazy-load)
         try {
             const storedToken = await this.credentialManager.getToken();
             if (storedToken) {
@@ -129,13 +134,8 @@ export class BaseCommand {
         catch (error) {
             logger.debug('Error retrieving token from keychain', error);
         }
-        // Finally fall back to environment variable
-        const envToken = process.env.BK_TOKEN;
-        if (envToken) {
-            return envToken;
-        }
         if (options.requiresToken) {
-            throw new Error('API token required. Set via --token, BK_TOKEN environment variable, or store it using --save-token.');
+            throw new Error('API token required. Set via --token, BUILDKITE_API_TOKEN/BK_TOKEN env vars, or store it using --save-token.');
         }
         else {
             return;

package/dist/commands/BaseCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCommand.js","sourceRoot":"/","sources":["commands/BaseCommand.ts"],"names":[],"mappings":"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","sourcesContent":["import { BuildkiteClient } from '../services/BuildkiteClient.js';\nimport { BuildkiteRestClient, BuildkiteRestClientOptions } from '../services/BuildkiteRestClient.js';\nimport { FormatterFactory, FormatterType } from '../formatters/index.js';\nimport { logger } from '../services/logger.js';\nimport { CredentialManager } from '../services/CredentialManager.js';\n\nexport interface BaseCommandOptions {\n  cacheTTL?: number;\n  clearCache?: boolean;\n  debug?: boolean;\n  filter?: string;\n  format?: string;\n  noCache?: boolean;\n  token?: string;\n}\n\n// Extended Error interface for API and GraphQL errors\ninterface ApiError extends Error {\n  response?: {\n    errors?: Array<{\n      message: string;\n      path?: string[];\n      locations?: Array<{line: number; column: number}>;\n    }>;\n  };\n  request?: {\n    url?: string;\n    method?: string;\n  };\n}\n\nexport abstract class BaseCommand {\n  protected token: string | undefined;\n  protected requiresToken: boolean = true;\n  private _client: BuildkiteClient | undefined;\n  private _restClient: BuildkiteRestClient | undefined;\n  private _restClientOptions: BuildkiteRestClientOptions | undefined;\n  \n  protected options: Partial<BaseCommandOptions>;\n  protected initialized: boolean = false;\n  protected static credentialManager = new CredentialManager();\n\n  constructor(options?: Partial<BaseCommandOptions>) {\n    this.options = options || {};\n    this.token = this.options.token;\n    \n    if (this.options.debug) {\n      // Include token length (not the actual token) for debugging auth issues\n      // Debug mode is already handled here by logger.debug use\n      logger.debug('BaseCommandHandler options:', {\n        ...options,\n        token: this.token ? `${this.token.substring(0, 4)}...${this.token.substring(this.token.length - 4)} (${this.token.length} chars)` : 'Not provided'\n      });\n    }\n  }\n\n  get client(): BuildkiteClient {\n    if (this._client) {\n      return this._client;\n    } else {\n      if (this.token) {\n        this._client = new BuildkiteClient(this.token, this.options);\n        return this._client;\n      } else {\n        throw new Error('No token provided');\n      }\n    }\n  }\n\n  get restClient(): BuildkiteRestClient {\n    if (this._restClient) {\n      return this._restClient;\n    } else {\n      if (this.token) {\n        this._restClient = new BuildkiteRestClient(this.token, this.options);\n        return this._restClient;\n      } else {\n        throw new Error('No token provided');\n      }\n    }\n  }\n\n  get restClientOptions(): BuildkiteRestClientOptions {\n    if (this._restClientOptions) {\n      return this._restClientOptions;\n    } else {\n      // Configure REST client with the same caching options\n        const restClientOptions: BuildkiteRestClientOptions = {\n          debug: this.options?.debug,\n          caching: !this.options?.noCache,\n        };\n        \n        // If a specific cache TTL is provided, apply it to REST client\n        if (this.options?.cacheTTL) {\n          restClientOptions.cacheTTLs = {\n            default: this.options.cacheTTL,\n            builds: this.options.cacheTTL,\n          };\n      }\n      return restClientOptions;\n    }\n  }\n\n  static get requiresToken(): boolean {\n    return true;\n  }\n  \n  protected async ensureInitialized(): Promise<void> {\n    // No additional initialization needed\n    return Promise.resolve();\n  }\n\n  protected handleError(error: any, debug: boolean = false): void {\n    // Only log the error message and stack trace\n    if (error instanceof Error) {\n      logger.error(error, 'Error occurred');\n      \n      // If it's a GraphQL error or API error, show more details\n      const apiError = error as ApiError;\n      if (apiError.response?.errors) {\n        apiError.response.errors.forEach((gqlError, index) => {\n          logger.error({ path: gqlError.path }, `GraphQL Error ${index + 1}: ${gqlError.message}`);\n        });\n      }\n      \n      // Show request details if available and in debug mode\n      if (debug && apiError.request) {\n        logger.debug({ \n          url: apiError.request.url,\n          method: apiError.request.method \n        }, 'Request Details');\n      }\n    } else if (typeof error === 'object') {\n      logger.error({ error }, 'Unknown error occurred');\n    } else {\n      logger.error({ error }, 'Unknown error occurred');\n    }\n    \n    if (debug) {\n      logger.debug({ \n        timestamp: new Date().toISOString(),\n        nodeVersion: process.version,\n        platform: `${process.platform} (${process.arch})`\n      }, 'Debug Information');\n    }\n  }\n\n  // Static helper to get token from options, keyring, or environment\n  static async getToken(options: any): Promise<string | undefined> {\n    // First check if token is provided directly in options\n    if (options.token) {\n      return options.token;\n    }\n    \n    // Next try to get token from keyring\n    try {\n      const storedToken = await this.credentialManager.getToken();\n      if (storedToken) {\n        logger.debug('Using token from system keychain');\n        return storedToken;\n      }\n    } catch (error) {\n      logger.debug('Error retrieving token from keychain', error);\n    }\n    \n    // Finally fall back to environment variable\n    const envToken = process.env.BK_TOKEN;\n    if (envToken) {\n      return envToken;\n    }\n    \n    if (options.requiresToken) {\n      throw new Error('API token required. Set via --token, BK_TOKEN environment variable, or store it using --save-token.');\n    } else {\n      return\n    }\n  }\n\n  /**\n   * Get the appropriate formatter based on command-specific type and format option\n   * @param type The formatter type ('pipeline', 'build', 'viewer')\n   * @param options Command options that may include a format\n   * @returns The appropriate formatter\n   */\n  protected getFormatter(type: FormatterType, options: BaseCommandOptions) {\n    // Format precedence: command line option > constructor option > default\n    const format = options.format || this.options.format || 'plain';\n    if (options.debug) {\n      logger.debug(`Using ${format} formatter for ${type}`);\n    }\n    return FormatterFactory.getFormatter(type, format);\n  }\n\n  /**\n   * Execute the command with the given options\n   * @param options Command options\n   * @returns A promise that resolves to an exit code (0 for success, non-zero for errors)\n   */\n  abstract execute(options: BaseCommandOptions): Promise<number>;\n}"]}
+{"version":3,"file":"BaseCommand.js","sourceRoot":"/","sources":["commands/BaseCommand.ts"],"names":[],"mappings":"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","sourcesContent":["import { BuildkiteClient } from '../services/BuildkiteClient.js';\nimport { BuildkiteRestClient, BuildkiteRestClientOptions } from '../services/BuildkiteRestClient.js';\nimport { FormatterFactory, FormatterType } from '../formatters/index.js';\nimport { logger } from '../services/logger.js';\nimport { CredentialManager } from '../services/CredentialManager.js';\n\nexport interface BaseCommandOptions {\n  cacheTTL?: number;\n  clearCache?: boolean;\n  debug?: boolean;\n  filter?: string;\n  format?: string;\n  noCache?: boolean;\n  quiet?: boolean;\n  tips?: boolean;\n  token?: string;\n}\n\n// Extended Error interface for API and GraphQL errors\ninterface ApiError extends Error {\n  response?: {\n    errors?: Array<{\n      message: string;\n      path?: string[];\n      locations?: Array<{line: number; column: number}>;\n    }>;\n  };\n  request?: {\n    url?: string;\n    method?: string;\n  };\n}\n\nexport abstract class BaseCommand {\n  protected token: string | undefined;\n  protected requiresToken: boolean = true;\n  private _client: BuildkiteClient | undefined;\n  private _restClient: BuildkiteRestClient | undefined;\n  private _restClientOptions: BuildkiteRestClientOptions | undefined;\n  \n  protected options: Partial<BaseCommandOptions>;\n  protected initialized: boolean = false;\n  protected static credentialManager = new CredentialManager();\n\n  constructor(options?: Partial<BaseCommandOptions>) {\n    this.options = options || {};\n    this.token = this.options.token;\n    \n    if (this.options.debug) {\n      // Include token length (not the actual token) for debugging auth issues\n      // Debug mode is already handled here by logger.debug use\n      logger.debug('BaseCommandHandler options:', {\n        ...options,\n        token: this.token ? `${this.token.substring(0, 4)}...${this.token.substring(this.token.length - 4)} (${this.token.length} chars)` : 'Not provided'\n      });\n    }\n  }\n\n  get client(): BuildkiteClient {\n    if (this._client) {\n      return this._client;\n    } else {\n      if (this.token) {\n        this._client = new BuildkiteClient(this.token, this.options);\n        return this._client;\n      } else {\n        throw new Error('No token provided');\n      }\n    }\n  }\n\n  get restClient(): BuildkiteRestClient {\n    if (this._restClient) {\n      return this._restClient;\n    } else {\n      if (this.token) {\n        this._restClient = new BuildkiteRestClient(this.token, this.options);\n        return this._restClient;\n      } else {\n        throw new Error('No token provided');\n      }\n    }\n  }\n\n  get restClientOptions(): BuildkiteRestClientOptions {\n    if (this._restClientOptions) {\n      return this._restClientOptions;\n    } else {\n      // Configure REST client with the same caching options\n        const restClientOptions: BuildkiteRestClientOptions = {\n          debug: this.options?.debug,\n          caching: !this.options?.noCache,\n        };\n        \n        // If a specific cache TTL is provided, apply it to REST client\n        if (this.options?.cacheTTL) {\n          restClientOptions.cacheTTLs = {\n            default: this.options.cacheTTL,\n            builds: this.options.cacheTTL,\n          };\n      }\n      return restClientOptions;\n    }\n  }\n\n  static get requiresToken(): boolean {\n    return true;\n  }\n  \n  protected async ensureInitialized(): Promise<void> {\n    // No additional initialization needed\n    return Promise.resolve();\n  }\n\n  protected handleError(error: any, debug: boolean = false): void {\n    // Only log the error message and stack trace\n    if (error instanceof Error) {\n      logger.error(error, 'Error occurred');\n      \n      // If it's a GraphQL error or API error, show more details\n      const apiError = error as ApiError;\n      if (apiError.response?.errors) {\n        apiError.response.errors.forEach((gqlError, index) => {\n          logger.error({ path: gqlError.path }, `GraphQL Error ${index + 1}: ${gqlError.message}`);\n        });\n      }\n      \n      // Show request details if available and in debug mode\n      if (debug && apiError.request) {\n        logger.debug({ \n          url: apiError.request.url,\n          method: apiError.request.method \n        }, 'Request Details');\n      }\n    } else if (typeof error === 'object') {\n      logger.error({ error }, 'Unknown error occurred');\n    } else {\n      logger.error({ error }, 'Unknown error occurred');\n    }\n    \n    if (debug) {\n      logger.debug({ \n        timestamp: new Date().toISOString(),\n        nodeVersion: process.version,\n        platform: `${process.platform} (${process.arch})`\n      }, 'Debug Information');\n    }\n  }\n\n  // Static helper to get token from options, keyring, or environment\n  static async getToken(options: any): Promise<string | undefined> {\n    // First check if token is provided directly in options\n    if (options.token) {\n      return options.token;\n    }\n    \n    // Prefer environment variables first under Alfred or if explicitly provided\n    const envToken = process.env.BUILDKITE_API_TOKEN || process.env.BK_TOKEN;\n    if (envToken) {\n      return envToken;\n    }\n    \n    // Next try to get token from keyring (outside Alfred this will lazy-load)\n    try {\n      const storedToken = await this.credentialManager.getToken();\n      if (storedToken) {\n        logger.debug('Using token from system keychain');\n        return storedToken;\n      }\n    } catch (error) {\n      logger.debug('Error retrieving token from keychain', error);\n    }\n    \n    if (options.requiresToken) {\n      throw new Error('API token required. Set via --token, BUILDKITE_API_TOKEN/BK_TOKEN env vars, or store it using --save-token.');\n    } else {\n      return\n    }\n  }\n\n  /**\n   * Get the appropriate formatter based on command-specific type and format option\n   * @param type The formatter type ('pipeline', 'build', 'viewer')\n   * @param options Command options that may include a format\n   * @returns The appropriate formatter\n   */\n  protected getFormatter(type: FormatterType, options: BaseCommandOptions) {\n    // Format precedence: command line option > constructor option > default\n    const format = options.format || this.options.format || 'plain';\n    if (options.debug) {\n      logger.debug(`Using ${format} formatter for ${type}`);\n    }\n    return FormatterFactory.getFormatter(type, format);\n  }\n\n  /**\n   * Execute the command with the given options\n   * @param options Command options\n   * @returns A promise that resolves to an exit code (0 for success, non-zero for errors)\n   */\n  abstract execute(options: BaseCommandOptions): Promise<number>;\n}"]}

package/dist/commands/GenerateCompletions.js

@@ -0,0 +1,238 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { BaseCommand } from './BaseCommand.js';
+import { logger } from '../services/logger.js';
+export class GenerateCompletions extends BaseCommand {
+    static requiresToken = false;
+    async execute(options) {
+        const shell = options.shell || this.detectShell();
+        if (!shell) {
+            logger.error('Could not detect shell. Please specify with: bktide completions <shell>');
+            logger.info('Supported shells: fish, bash, zsh');
+            return 1;
+        }
+        try {
+            const completionScript = await this.getCompletionScript(shell);
+            if (completionScript) {
+                // Output the completion script to stdout
+                console.log(completionScript);
+                if (!options.quiet && process.stderr.isTTY) {
+                    // Show installation instructions on stderr
+                    this.showInstallInstructions(shell);
+                }
+                return 0;
+            }
+            else {
+                logger.error(`No completion script available for shell: ${shell}`);
+                logger.info('Supported shells: fish, bash, zsh');
+                return 1;
+            }
+        }
+        catch (error) {
+            this.handleError(error, options.debug);
+            return 1;
+        }
+    }
+    detectShell() {
+        // Try to detect the current shell
+        const shellEnv = process.env.SHELL;
+        if (shellEnv) {
+            const shellName = path.basename(shellEnv);
+            if (['fish', 'bash', 'zsh'].includes(shellName)) {
+                return shellName;
+            }
+        }
+        return undefined;
+    }
+    async getCompletionScript(shell) {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        // Look for completion scripts in the completions directory
+        const completionsDir = path.resolve(__dirname, '../../completions');
+        let scriptFile;
+        switch (shell) {
+            case 'fish':
+                // Use the dynamic version if jq is available, otherwise static
+                if (await this.isCommandAvailable('jq')) {
+                    scriptFile = path.join(completionsDir, 'bktide-dynamic.fish');
+                }
+                else {
+                    scriptFile = path.join(completionsDir, 'bktide.fish');
+                }
+                break;
+            case 'bash':
+                scriptFile = path.join(completionsDir, 'bktide.bash');
+                break;
+            case 'zsh':
+                scriptFile = path.join(completionsDir, 'bktide.zsh');
+                break;
+            default:
+                return undefined;
+        }
+        // Check if the completion script exists
+        if (fs.existsSync(scriptFile)) {
+            return fs.readFileSync(scriptFile, 'utf-8');
+        }
+        // Fallback: Generate basic completion based on shell type
+        return this.generateBasicCompletion(shell);
+    }
+    async isCommandAvailable(command) {
+        try {
+            const { exec } = await import('child_process');
+            return new Promise((resolve) => {
+                exec(`which ${command}`, (error) => {
+                    resolve(!error);
+                });
+            });
+        }
+        catch {
+            return false;
+        }
+    }
+    generateBasicCompletion(shell) {
+        // Basic completion generation for shells
+        const commands = ['viewer', 'orgs', 'pipelines', 'builds', 'token', 'annotations', 'completions', 'boom'];
+        const globalOptions = [
+            '--log-level', '--debug', '--no-cache', '--cache-ttl', '--clear-cache',
+            '--token', '--save-token', '--format', '--color', '--quiet', '--tips',
+            '--no-tips', '--ascii', '--help', '--version'
+        ];
+        switch (shell) {
+            case 'fish':
+                return this.generateFishCompletion(commands, globalOptions);
+            case 'bash':
+                return this.generateBashCompletion(commands, globalOptions);
+            case 'zsh':
+                return this.generateZshCompletion(commands, globalOptions);
+            default:
+                return '';
+        }
+    }
+    generateFishCompletion(commands, options) {
+        let script = '# Fish completions for bktide\n';
+        script += '# Generated by bktide completions fish\n\n';
+        script += '# Disable file completions\n';
+        script += 'complete -c bktide -f\n';
+        script += 'complete -c bin/bktide -f\n\n';
+        script += '# Commands\n';
+        for (const cmd of commands) {
+            script += `complete -c bktide -n __fish_use_subcommand -a ${cmd}\n`;
+            script += `complete -c bin/bktide -n __fish_use_subcommand -a ${cmd}\n`;
+        }
+        script += '\n# Global options\n';
+        for (const opt of options) {
+            const shortOpt = this.getShortOption(opt);
+            if (shortOpt) {
+                script += `complete -c bktide -s ${shortOpt} -l ${opt.replace('--', '')}\n`;
+                script += `complete -c bin/bktide -s ${shortOpt} -l ${opt.replace('--', '')}\n`;
+            }
+            else {
+                script += `complete -c bktide -l ${opt.replace('--', '')}\n`;
+                script += `complete -c bin/bktide -l ${opt.replace('--', '')}\n`;
+            }
+        }
+        return script;
+    }
+    generateBashCompletion(commands, options) {
+        let script = '#!/bin/bash\n';
+        script += '# Bash completions for bktide\n';
+        script += '# Generated by bktide completions bash\n\n';
+        script += '_bktide() {\n';
+        script += '  local cur prev commands options\n';
+        script += '  COMPREPLY=()\n';
+        script += '  cur="${COMP_WORDS[COMP_CWORD]}"\n';
+        script += '  prev="${COMP_WORDS[COMP_CWORD-1]}"\n';
+        script += `  commands="${commands.join(' ')}"\n`;
+        script += `  options="${options.join(' ')}"\n\n`;
+        script += '  if [[ ${COMP_CWORD} -eq 1 ]]; then\n';
+        script += '    COMPREPLY=( $(compgen -W "${commands}" -- ${cur}) )\n';
+        script += '  else\n';
+        script += '    COMPREPLY=( $(compgen -W "${options}" -- ${cur}) )\n';
+        script += '  fi\n';
+        script += '  return 0\n';
+        script += '}\n\n';
+        script += 'complete -F _bktide bktide\n';
+        script += 'complete -F _bktide bin/bktide\n';
+        return script;
+    }
+    generateZshCompletion(commands, options) {
+        let script = '#compdef bktide\n';
+        script += '# Zsh completions for bktide\n';
+        script += '# Generated by bktide completions zsh\n\n';
+        script += '_bktide() {\n';
+        script += '  local -a commands options\n';
+        script += `  commands=(${commands.map(c => `'${c}'`).join(' ')})\n`;
+        script += `  options=(${options.map(o => `'${o}'`).join(' ')})\n\n`;
+        script += '  if (( CURRENT == 2 )); then\n';
+        script += '    _describe -t commands "bktide commands" commands\n';
+        script += '  else\n';
+        script += '    _describe -t options "bktide options" options\n';
+        script += '  fi\n';
+        script += '}\n\n';
+        script += '_bktide "$@"\n';
+        return script;
+    }
+    getShortOption(longOption) {
+        const shortMap = {
+            '--debug': 'd',
+            '--token': 't',
+            '--format': 'f',
+            '--quiet': 'q',
+            '--help': 'h',
+            '--version': 'V',
+        };
+        return shortMap[longOption];
+    }
+    showInstallInstructions(shell) {
+        // Use console.error to ensure instructions go to stderr, not stdout
+        console.error('\n');
+        console.error(`To install ${shell} completions:`);
+        switch (shell) {
+            case 'fish':
+                console.error('  Option 1 (User-specific):');
+                console.error('    bktide completions fish > ~/.config/fish/completions/bktide.fish');
+                console.error('');
+                console.error('  Option 2 (System-wide - requires sudo):');
+                console.error('    bktide completions fish | sudo tee /usr/share/fish/vendor_completions.d/bktide.fish');
+                console.error('');
+                console.error('  For local development with bin/bktide:');
+                console.error('    The completions will work for both "bktide" and "bin/bktide" automatically');
+                break;
+            case 'bash':
+                console.error('  Option 1 (User-specific - add to ~/.bashrc):');
+                console.error('    source <(bktide completions bash)');
+                console.error('');
+                console.error('  Option 2 (System-wide - requires sudo):');
+                console.error('    bktide completions bash | sudo tee /etc/bash_completion.d/bktide');
+                console.error('');
+                console.error('  For macOS with Homebrew bash-completion:');
+                console.error('    bktide completions bash > $(brew --prefix)/etc/bash_completion.d/bktide');
+                break;
+            case 'zsh':
+                console.error('  Option 1 (User-specific - add to ~/.zshrc):');
+                console.error('    source <(bktide completions zsh)');
+                console.error('');
+                console.error('  Option 2 (Add to fpath - add to ~/.zshrc):');
+                console.error('    mkdir -p ~/.zsh/completions');
+                console.error('    bktide completions zsh > ~/.zsh/completions/_bktide');
+                console.error('    echo "fpath=(~/.zsh/completions $fpath)" >> ~/.zshrc');
+                console.error('    echo "autoload -U compinit && compinit" >> ~/.zshrc');
+                break;
+        }
+        console.error('');
+        console.error('After installation, restart your shell or run:');
+        switch (shell) {
+            case 'fish':
+                console.error('    source ~/.config/fish/config.fish');
+                break;
+            case 'bash':
+                console.error('    source ~/.bashrc');
+                break;
+            case 'zsh':
+                console.error('    source ~/.zshrc');
+                break;
+        }
+    }
+}
+//# sourceMappingURL=GenerateCompletions.js.map

package/dist/commands/GenerateCompletions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateCompletions.js","sourceRoot":"/","sources":["commands/GenerateCompletions.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { BaseCommand, BaseCommandOptions } from './BaseCommand.js';\nimport { logger } from '../services/logger.js';\n\nexport interface GenerateCompletionsOptions extends BaseCommandOptions {\n  shell?: string;\n}\n\nexport class GenerateCompletions extends BaseCommand {\n  static requiresToken = false;\n\n  async execute(options: GenerateCompletionsOptions): Promise<number> {\n    const shell = options.shell || this.detectShell();\n    \n    if (!shell) {\n      logger.error('Could not detect shell. Please specify with: bktide completions <shell>');\n      logger.info('Supported shells: fish, bash, zsh');\n      return 1;\n    }\n\n    try {\n      const completionScript = await this.getCompletionScript(shell);\n      \n      if (completionScript) {\n        // Output the completion script to stdout\n        console.log(completionScript);\n        \n        if (!options.quiet && process.stderr.isTTY) {\n          // Show installation instructions on stderr\n          this.showInstallInstructions(shell);\n        }\n        \n        return 0;\n      } else {\n        logger.error(`No completion script available for shell: ${shell}`);\n        logger.info('Supported shells: fish, bash, zsh');\n        return 1;\n      }\n    } catch (error) {\n      this.handleError(error, options.debug);\n      return 1;\n    }\n  }\n\n  private detectShell(): string | undefined {\n    // Try to detect the current shell\n    const shellEnv = process.env.SHELL;\n    if (shellEnv) {\n      const shellName = path.basename(shellEnv);\n      if (['fish', 'bash', 'zsh'].includes(shellName)) {\n        return shellName;\n      }\n    }\n    return undefined;\n  }\n\n  private async getCompletionScript(shell: string): Promise<string | undefined> {\n    const __filename = fileURLToPath(import.meta.url);\n    const __dirname = path.dirname(__filename);\n    \n    // Look for completion scripts in the completions directory\n    const completionsDir = path.resolve(__dirname, '../../completions');\n    \n    let scriptFile: string;\n    switch (shell) {\n      case 'fish':\n        // Use the dynamic version if jq is available, otherwise static\n        if (await this.isCommandAvailable('jq')) {\n          scriptFile = path.join(completionsDir, 'bktide-dynamic.fish');\n        } else {\n          scriptFile = path.join(completionsDir, 'bktide.fish');\n        }\n        break;\n      case 'bash':\n        scriptFile = path.join(completionsDir, 'bktide.bash');\n        break;\n      case 'zsh':\n        scriptFile = path.join(completionsDir, 'bktide.zsh');\n        break;\n      default:\n        return undefined;\n    }\n\n    // Check if the completion script exists\n    if (fs.existsSync(scriptFile)) {\n      return fs.readFileSync(scriptFile, 'utf-8');\n    }\n\n    // Fallback: Generate basic completion based on shell type\n    return this.generateBasicCompletion(shell);\n  }\n\n  private async isCommandAvailable(command: string): Promise<boolean> {\n    try {\n      const { exec } = await import('child_process');\n      return new Promise((resolve) => {\n        exec(`which ${command}`, (error) => {\n          resolve(!error);\n        });\n      });\n    } catch {\n      return false;\n    }\n  }\n\n  private generateBasicCompletion(shell: string): string {\n    // Basic completion generation for shells\n    const commands = ['viewer', 'orgs', 'pipelines', 'builds', 'token', 'annotations', 'completions', 'boom'];\n    const globalOptions = [\n      '--log-level', '--debug', '--no-cache', '--cache-ttl', '--clear-cache',\n      '--token', '--save-token', '--format', '--color', '--quiet', '--tips',\n      '--no-tips', '--ascii', '--help', '--version'\n    ];\n\n    switch (shell) {\n      case 'fish':\n        return this.generateFishCompletion(commands, globalOptions);\n      case 'bash':\n        return this.generateBashCompletion(commands, globalOptions);\n      case 'zsh':\n        return this.generateZshCompletion(commands, globalOptions);\n      default:\n        return '';\n    }\n  }\n\n  private generateFishCompletion(commands: string[], options: string[]): string {\n    let script = '# Fish completions for bktide\\n';\n    script += '# Generated by bktide completions fish\\n\\n';\n    script += '# Disable file completions\\n';\n    script += 'complete -c bktide -f\\n';\n    script += 'complete -c bin/bktide -f\\n\\n';\n    \n    script += '# Commands\\n';\n    for (const cmd of commands) {\n      script += `complete -c bktide -n __fish_use_subcommand -a ${cmd}\\n`;\n      script += `complete -c bin/bktide -n __fish_use_subcommand -a ${cmd}\\n`;\n    }\n    \n    script += '\\n# Global options\\n';\n    for (const opt of options) {\n      const shortOpt = this.getShortOption(opt);\n      if (shortOpt) {\n        script += `complete -c bktide -s ${shortOpt} -l ${opt.replace('--', '')}\\n`;\n        script += `complete -c bin/bktide -s ${shortOpt} -l ${opt.replace('--', '')}\\n`;\n      } else {\n        script += `complete -c bktide -l ${opt.replace('--', '')}\\n`;\n        script += `complete -c bin/bktide -l ${opt.replace('--', '')}\\n`;\n      }\n    }\n    \n    return script;\n  }\n\n  private generateBashCompletion(commands: string[], options: string[]): string {\n    let script = '#!/bin/bash\\n';\n    script += '# Bash completions for bktide\\n';\n    script += '# Generated by bktide completions bash\\n\\n';\n    \n    script += '_bktide() {\\n';\n    script += '  local cur prev commands options\\n';\n    script += '  COMPREPLY=()\\n';\n    script += '  cur=\"${COMP_WORDS[COMP_CWORD]}\"\\n';\n    script += '  prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\\n';\n    script += `  commands=\"${commands.join(' ')}\"\\n`;\n    script += `  options=\"${options.join(' ')}\"\\n\\n`;\n    \n    script += '  if [[ ${COMP_CWORD} -eq 1 ]]; then\\n';\n    script += '    COMPREPLY=( $(compgen -W \"${commands}\" -- ${cur}) )\\n';\n    script += '  else\\n';\n    script += '    COMPREPLY=( $(compgen -W \"${options}\" -- ${cur}) )\\n';\n    script += '  fi\\n';\n    script += '  return 0\\n';\n    script += '}\\n\\n';\n    \n    script += 'complete -F _bktide bktide\\n';\n    script += 'complete -F _bktide bin/bktide\\n';\n    \n    return script;\n  }\n\n  private generateZshCompletion(commands: string[], options: string[]): string {\n    let script = '#compdef bktide\\n';\n    script += '# Zsh completions for bktide\\n';\n    script += '# Generated by bktide completions zsh\\n\\n';\n    \n    script += '_bktide() {\\n';\n    script += '  local -a commands options\\n';\n    script += `  commands=(${commands.map(c => `'${c}'`).join(' ')})\\n`;\n    script += `  options=(${options.map(o => `'${o}'`).join(' ')})\\n\\n`;\n    \n    script += '  if (( CURRENT == 2 )); then\\n';\n    script += '    _describe -t commands \"bktide commands\" commands\\n';\n    script += '  else\\n';\n    script += '    _describe -t options \"bktide options\" options\\n';\n    script += '  fi\\n';\n    script += '}\\n\\n';\n    \n    script += '_bktide \"$@\"\\n';\n    \n    return script;\n  }\n\n  private getShortOption(longOption: string): string | undefined {\n    const shortMap: Record<string, string> = {\n      '--debug': 'd',\n      '--token': 't',\n      '--format': 'f',\n      '--quiet': 'q',\n      '--help': 'h',\n      '--version': 'V',\n    };\n    return shortMap[longOption];\n  }\n\n  private showInstallInstructions(shell: string): void {\n    // Use console.error to ensure instructions go to stderr, not stdout\n    console.error('\\n');\n    console.error(`To install ${shell} completions:`);\n    \n    switch (shell) {\n      case 'fish':\n        console.error('  Option 1 (User-specific):');\n        console.error('    bktide completions fish > ~/.config/fish/completions/bktide.fish');\n        console.error('');\n        console.error('  Option 2 (System-wide - requires sudo):');\n        console.error('    bktide completions fish | sudo tee /usr/share/fish/vendor_completions.d/bktide.fish');\n        console.error('');\n        console.error('  For local development with bin/bktide:');\n        console.error('    The completions will work for both \"bktide\" and \"bin/bktide\" automatically');\n        break;\n        \n      case 'bash':\n        console.error('  Option 1 (User-specific - add to ~/.bashrc):');\n        console.error('    source <(bktide completions bash)');\n        console.error('');\n        console.error('  Option 2 (System-wide - requires sudo):');\n        console.error('    bktide completions bash | sudo tee /etc/bash_completion.d/bktide');\n        console.error('');\n        console.error('  For macOS with Homebrew bash-completion:');\n        console.error('    bktide completions bash > $(brew --prefix)/etc/bash_completion.d/bktide');\n        break;\n        \n      case 'zsh':\n        console.error('  Option 1 (User-specific - add to ~/.zshrc):');\n        console.error('    source <(bktide completions zsh)');\n        console.error('');\n        console.error('  Option 2 (Add to fpath - add to ~/.zshrc):');\n        console.error('    mkdir -p ~/.zsh/completions');\n        console.error('    bktide completions zsh > ~/.zsh/completions/_bktide');\n        console.error('    echo \"fpath=(~/.zsh/completions $fpath)\" >> ~/.zshrc');\n        console.error('    echo \"autoload -U compinit && compinit\" >> ~/.zshrc');\n        break;\n    }\n    \n    console.error('');\n    console.error('After installation, restart your shell or run:');\n    switch (shell) {\n      case 'fish':\n        console.error('    source ~/.config/fish/config.fish');\n        break;\n      case 'bash':\n        console.error('    source ~/.bashrc');\n        break;\n      case 'zsh':\n        console.error('    source ~/.zshrc');\n        break;\n    }\n  }\n}\n"]}

package/dist/commands/ListAnnotations.js

@@ -2,6 +2,7 @@ import { BaseCommand } from './BaseCommand.js';
 import { logger } from '../services/logger.js';
 import { parseBuildRef } from '../utils/parseBuildRef.js';
 import { FormatterFactory, FormatterType } from '../formatters/index.js';
+import { Progress } from '../ui/progress.js';
 export class ListAnnotations extends BaseCommand {
     static requiresToken = true;
     async execute(options) {
@@ -12,6 +13,9 @@ export class ListAnnotations extends BaseCommand {
             logger.error('Build reference is required');
             return 1;
         }
+        // Initialize reporter and spinner early
+        const format = options.format || 'plain';
+        const spinner = Progress.spinner('Fetching annotations…', { format });
         try {
             // Ensure the command is initialized
             await this.ensureInitialized();
@@ -22,6 +26,7 @@ export class ListAnnotations extends BaseCommand {
             // Fetch annotations from the GraphQL API
             const buildSlug = `${buildRef.org}/${buildRef.pipeline}/${buildRef.number}`;
             const result = await this.client.getBuildAnnotations(buildSlug);
+            spinner.stop();
             // Extract annotations from the GraphQL response
             let annotations = result.build?.annotations?.edges?.map((edge) => edge.node) || [];
             // Filter by context if specified
@@ -40,9 +45,11 @@ export class ListAnnotations extends BaseCommand {
                 contextFilter: options.context
             });
             logger.console(output);
+            // Success is implicit - data display confirms retrieval
             return 0;
         }
         catch (error) {
+            spinner.stop();
             logger.error('Failed to fetch annotations:', error);
             // Handle the error with the formatter
             const formatter = FormatterFactory.getFormatter(FormatterType.ANNOTATION, options.format || 'plain'); // Cast to any since FormatterFactory returns BaseFormatter

package/dist/commands/ListAnnotations.js.map

@@ -1 +1 @@
-{"version":3,"file":"ListAnnotations.js","sourceRoot":"/","sources":["commands/ListAnnotations.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseCommand } from './BaseCommand.js';\nimport { logger } from '../services/logger.js';\nimport { parseBuildRef } from '../utils/parseBuildRef.js';\nimport { FormatterFactory, FormatterType } from '../formatters/index.js';\nimport { Annotation } from '../types/index.js';\n\nexport class ListAnnotations extends BaseCommand {\n  static requiresToken = true;\n\n  async execute(options: any): Promise<number> {\n    if (options.debug) {\n      logger.debug('Starting ListAnnotations command execution');\n    }\n    \n    \n    if (!options.buildArg) {\n      logger.error('Build reference is required');\n      return 1;\n    }\n    \n    try {\n      // Ensure the command is initialized\n      await this.ensureInitialized();\n      \n      const buildRef = parseBuildRef(options.buildArg);\n      if (options.debug) {\n        logger.debug('Parsed build reference:', buildRef);\n      }\n      \n      // Fetch annotations from the GraphQL API\n      const buildSlug = `${buildRef.org}/${buildRef.pipeline}/${buildRef.number}`;\n      const result = await this.client.getBuildAnnotations(buildSlug);\n      \n      // Extract annotations from the GraphQL response\n      let annotations: Annotation[] = result.build?.annotations?.edges?.map((edge: any) => edge.node) || [];\n      \n      // Filter by context if specified\n      if (options.context) {\n        const contextFilter = options.context.toLowerCase();\n        annotations = annotations.filter(annotation => \n          annotation.context.toLowerCase() === contextFilter\n        );\n        \n        if (options.debug) {\n          logger.debug(`Filtered annotations by context '${options.context}': ${annotations.length} found`);\n        }\n      }\n      \n      // Get the appropriate formatter\n      const formatter = FormatterFactory.getFormatter(\n        FormatterType.ANNOTATION,\n        options.format || 'plain'\n      ) as any; // Cast to any since FormatterFactory returns BaseFormatter\n      \n      // Format and output the results\n      const output = formatter.formatAnnotations(annotations, {\n        debug: options.debug,\n        contextFilter: options.context\n      });\n      \n      logger.console(output);\n      \n      return 0;\n    } catch (error) {\n      logger.error('Failed to fetch annotations:', error);\n      \n      // Handle the error with the formatter\n      const formatter = FormatterFactory.getFormatter(\n        FormatterType.ANNOTATION,\n        options.format || 'plain'\n      ) as any; // Cast to any since FormatterFactory returns BaseFormatter\n      \n      const errorOutput = formatter.formatAnnotations([], {\n        hasError: true,\n        errorMessage: error instanceof Error ? error.message : 'Unknown error occurred',\n        errorType: 'api',\n        debug: options.debug\n      });\n      \n      logger.console(errorOutput);\n      return 1;\n    }\n  }\n}\n"]}
+{"version":3,"file":"ListAnnotations.js","sourceRoot":"/","sources":["commands/ListAnnotations.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseCommand } from './BaseCommand.js';\nimport { logger } from '../services/logger.js';\nimport { parseBuildRef } from '../utils/parseBuildRef.js';\nimport { FormatterFactory, FormatterType } from '../formatters/index.js';\nimport { Annotation } from '../types/index.js';\n\nimport { Progress } from '../ui/progress.js';\n\nexport class ListAnnotations extends BaseCommand {\n  static requiresToken = true;\n\n  async execute(options: any): Promise<number> {\n    if (options.debug) {\n      logger.debug('Starting ListAnnotations command execution');\n    }\n    \n    \n    if (!options.buildArg) {\n      logger.error('Build reference is required');\n      return 1;\n    }\n    \n    // Initialize reporter and spinner early\n    const format = options.format || 'plain';\n    const spinner = Progress.spinner('Fetching annotations…', { format });\n    \n    try {\n      // Ensure the command is initialized\n      await this.ensureInitialized();\n      \n      const buildRef = parseBuildRef(options.buildArg);\n      if (options.debug) {\n        logger.debug('Parsed build reference:', buildRef);\n      }\n      \n      // Fetch annotations from the GraphQL API\n      const buildSlug = `${buildRef.org}/${buildRef.pipeline}/${buildRef.number}`;\n      const result = await this.client.getBuildAnnotations(buildSlug);\n      spinner.stop();\n      \n      // Extract annotations from the GraphQL response\n      let annotations: Annotation[] = result.build?.annotations?.edges?.map((edge: any) => edge.node) || [];\n      \n      // Filter by context if specified\n      if (options.context) {\n        const contextFilter = options.context.toLowerCase();\n        annotations = annotations.filter(annotation => \n          annotation.context.toLowerCase() === contextFilter\n        );\n        \n        if (options.debug) {\n          logger.debug(`Filtered annotations by context '${options.context}': ${annotations.length} found`);\n        }\n      }\n      \n      // Get the appropriate formatter\n      const formatter = FormatterFactory.getFormatter(\n        FormatterType.ANNOTATION,\n        options.format || 'plain'\n      ) as any; // Cast to any since FormatterFactory returns BaseFormatter\n      \n      // Format and output the results\n      const output = formatter.formatAnnotations(annotations, {\n        debug: options.debug,\n        contextFilter: options.context\n      });\n      \n      logger.console(output);\n      // Success is implicit - data display confirms retrieval\n      \n      return 0;\n    } catch (error) {\n      spinner.stop();\n      logger.error('Failed to fetch annotations:', error);\n      \n      // Handle the error with the formatter\n      const formatter = FormatterFactory.getFormatter(\n        FormatterType.ANNOTATION,\n        options.format || 'plain'\n      ) as any; // Cast to any since FormatterFactory returns BaseFormatter\n      \n      const errorOutput = formatter.formatAnnotations([], {\n        hasError: true,\n        errorMessage: error instanceof Error ? error.message : 'Unknown error occurred',\n        errorType: 'api',\n        debug: options.debug\n      });\n      \n      logger.console(errorOutput);\n      return 1;\n    }\n  }\n}\n"]}