bktide 0.0.1

package/README.md

@@ -0,0 +1,145 @@
+# bktide
+
+A command-line tool for interacting with Buildkite's GraphQL API.
+
+## Installation
+
+```bash
+npm install -g bktide
+```
+
+## Documentation
+
+- [Development Guide](docs/development.md) - Information about running and developing the CLI
+- [Authentication](docs/authentication.md) - How to authenticate with Buildkite
+- [Caching](docs/caching.md) - Information about the CLI's caching system
+- [Alfred Integration (Overview)](docs/alfred.md) - What the Alfred integration does and quick usage
+- [Alfred Installation](docs/alfred-installation.md) - End-user install, configuration, and troubleshooting
+- [Alfred Development](docs/alfred-development.md) - Packaging, wrapper behavior, metadata, and workflow wiring
+
+## Usage
+
+### Show Your Login Information
+
+```bash
+npm run dev -- viewer
+```
+
+### List Your Organizations
+
+```bash
+npm run dev -- orgs
+```
+
+### List Pipelines in an Organization
+
+```bash
+npm run dev -- pipelines
+```
+
+Additional options:
+```bash
+# Filter by organization
+npm run dev -- pipelines --org your-org-slug
+
+# Limit the number of results
+npm run dev -- pipelines --count 20
+```
+
+### List Your Builds
+
+```bash
+npm run dev -- builds
+```
+
+Additional options:
+```bash
+# Filter by organization
+npm run dev -- builds --org your-org-slug
+
+# Filter by pipeline
+npm run dev -- builds --pipeline pipeline-slug
+
+# Filter by branch
+npm run dev -- builds --branch main
+
+# Filter by state
+npm run dev -- builds --state passed
+
+# Pagination
+npm run dev -- builds --count 20 --page 2
+
+# Output in JSON format
+npm run dev -- builds --json
+
+# Output in Alfred-compatible JSON format
+npm run dev -- builds --alfred
+```
+
+### Show Build Annotations
+
+```bash
+npm run dev -- annotations <build>
+```
+
+The build reference can be specified in two formats:
+- **Slug format**: `org/pipeline/number` (e.g., `gusto/zenpayroll/1287418`)
+- **URL format**: `@https://buildkite.com/org/pipeline/builds/number` or `https://buildkite.com/org/pipeline/builds/number`
+
+Additional options:
+```bash
+# Filter by context
+npm run dev -- annotations gusto/zenpayroll/1287418 --context rspec
+
+# Output in JSON format
+npm run dev -- annotations gusto/zenpayroll/1287418 --format json
+
+# Output in plain text format (default)
+npm run dev -- annotations https://buildkite.com/gusto/zenpayroll/builds/1287418 --format plain
+
+# Combine filtering and formatting
+npm run dev -- annotations gusto/zenpayroll/1287418 --context build-resources --format json
+```
+
+## API Token
+
+You'll need a Buildkite API token with GraphQL scopes. Create one at:
+https://buildkite.com/user/api-access-tokens
+
+# Logging System
+
+The CLI uses a structured logging system based on Pino. This provides several benefits:
+
+- Different log levels (trace, debug, info, warn, error, fatal)
+- JSON logs saved to disk (in `log/cli.log`)
+- Pretty-printed logs to the console
+- Performance measurements
+
+## Log Level Configuration
+
+You can configure the log level with the `--log-level` option:
+
+```bash
+bktide orgs --log-level=debug  # Show debug messages
+bktide builds --log-level=trace # Show all messages including trace
+```
+
+Available log levels (from most to least verbose):
+- trace: Very detailed tracing for debugging
+- debug: Detailed information for developers
+- info: General information (default)
+- warn: Warning conditions
+- error: Error conditions
+- fatal: Severe errors causing termination
+
+## Log Files
+
+All logs are written to `log/cli.log` in JSON format, which can be processed with tools like jq:
+
+```bash
+# View recent errors
+cat log/cli.log | grep -v '"level":30' | jq
+
+# Analyze performance 
+cat log/cli.log | jq 'select(.duration != null) | {msg, duration}'
+``` 

package/WORKFLOW_README.md

@@ -0,0 +1,65 @@
+# bktide Alfred Workflow
+
+A powerful Alfred workflow for interacting with Buildkite builds, pipelines, and organizations.
+
+## Quick Start
+
+1. **Install Node.js 18+** (required)
+   - Download from [nodejs.org](https://nodejs.org/) or install via Homebrew: `brew install node`
+
+2. **Set up your Buildkite token**
+   - Open Alfred: `bktide token store`
+   - Enter your Buildkite API token
+
+3. **Start using the workflow**
+   - `bktide viewer` - Show your user info
+   - `bktide orgs` - List organizations
+   - `bktide pipelines` - List pipelines
+   - `bktide builds` - List recent builds
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `bktide viewer` | Show your Buildkite user information |
+| `bktide orgs` | List your accessible organizations |
+| `bktide pipelines [org]` | List pipelines, optionally filtered by org |
+| `bktide builds [filter]` | List recent builds with optional filtering |
+| `bktide annotations <build-ref>` | Show annotations for a specific build |
+
+## Configuration
+
+If Node.js is not in your PATH, create `~/.config/bktide/env`:
+
+```bash
+# For Homebrew on Apple Silicon
+export PATH="/opt/homebrew/bin:$PATH"
+NODE_BIN=/opt/homebrew/bin/node
+
+# For Homebrew on Intel
+export PATH="/usr/local/bin:$PATH"
+NODE_BIN=/usr/local/bin/node
+
+# For nvm
+NODE_BIN=/Users/username/.nvm/versions/node/v18.17.0/bin/node
+```
+
+See `env.example` in this workflow for more configuration options.
+
+## Troubleshooting
+
+**"node: command not found"**
+- Install Node.js or configure the path in `~/.config/bktide/env`
+
+**"Authentication failed"**
+- Run `bktide token store` to set up your Buildkite API token
+
+**Workflow is slow**
+- Clear cache: `rm -rf ~/.cache/bktide`
+- Check logs: `~/.local/state/bktide/logs/alfred.log`
+
+## Support
+
+- Full documentation: See included `docs/alfred-installation.md`
+- Issues: [GitHub Issues](https://github.com/yourusername/bktide/issues)
+- Logs: `~/.local/state/bktide/logs/alfred.log`

package/bin/alfred-entrypoint

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+set -e
+set -x
+
+workflow_dir="$(dirname "$0")/.."
+cd "$workflow_dir"
+
+# Prefer Alfred's cache directory for logs; fall back to XDG if unavailable
+if [[ -n "$alfred_workflow_cache" ]]; then
+  log_file="$alfred_workflow_cache/alfred.log"
+else
+  log_file="$HOME/.local/state/bktide/logs/alfred.log"
+fi
+mkdir -p "$(dirname "$log_file")"
+
+# Optionally source user-provided environment to customize PATH, NODE_BIN, etc.
+xdg_config_home="${XDG_CONFIG_HOME:-$HOME/.config}"
+user_env_file="$xdg_config_home/bktide/env"
+workflow_env_file="$workflow_dir/.env"
+
+if [[ -f "$user_env_file" ]]; then
+  # Export variables defined in the file
+  set -a
+  # shellcheck disable=SC1090
+  source "$user_env_file" 
+  set +a
+elif [[ -f "$workflow_env_file" ]]; then
+  set -a
+  # shellcheck disable=SC1090
+  source "$workflow_env_file"
+  set +a
+fi
+
+command="$1"
+shift
+
+if [[ -z "$command" ]]; then
+  echo "Usage: $0 <command> [filter]"
+  exit 1
+fi
+
+if [[ -z "$NODE_BIN" ]]; then
+  export NODE_BIN=node
+fi
+
+# Enable CLI debug mode if user config sets DEBUG=true/1 (compatible with macOS bash 3.2)
+extra_flags=()
+if [[ "$DEBUG" == "true" || "$DEBUG" == "TRUE" || "$DEBUG" == "True" || "$DEBUG" == "1" ]]; then
+  extra_flags+=("--debug")
+fi
+
+echo "Running command: $NODE_BIN $workflow_dir/dist/index.js $command" "$@" >> "$log_file"
+"$NODE_BIN" "$workflow_dir/dist/index.js" "$command" --format alfred "${extra_flags[@]}" "$@" 2>&1 | tee -a "$log_file"

package/dist/commands/BaseCommand.js

@@ -0,0 +1,159 @@
+import { BuildkiteClient } from '../services/BuildkiteClient.js';
+import { BuildkiteRestClient } from '../services/BuildkiteRestClient.js';
+import { FormatterFactory } from '../formatters/index.js';
+import { logger } from '../services/logger.js';
+import { CredentialManager } from '../services/CredentialManager.js';
+export class BaseCommand {
+    token;
+    requiresToken = true;
+    _client;
+    _restClient;
+    _restClientOptions;
+    options;
+    initialized = false;
+    static credentialManager = new CredentialManager();
+    constructor(options) {
+        this.options = options || {};
+        this.token = this.options.token;
+        if (this.options.debug) {
+            // Include token length (not the actual token) for debugging auth issues
+            // Debug mode is already handled here by logger.debug use
+            logger.debug('BaseCommandHandler options:', {
+                ...options,
+                token: this.token ? `${this.token.substring(0, 4)}...${this.token.substring(this.token.length - 4)} (${this.token.length} chars)` : 'Not provided'
+            });
+        }
+    }
+    get client() {
+        if (this._client) {
+            return this._client;
+        }
+        else {
+            if (this.token) {
+                this._client = new BuildkiteClient(this.token, this.options);
+                return this._client;
+            }
+            else {
+                throw new Error('No token provided');
+            }
+        }
+    }
+    get restClient() {
+        if (this._restClient) {
+            return this._restClient;
+        }
+        else {
+            if (this.token) {
+                this._restClient = new BuildkiteRestClient(this.token, this.options);
+                return this._restClient;
+            }
+            else {
+                throw new Error('No token provided');
+            }
+        }
+    }
+    get restClientOptions() {
+        if (this._restClientOptions) {
+            return this._restClientOptions;
+        }
+        else {
+            // Configure REST client with the same caching options
+            const restClientOptions = {
+                debug: this.options?.debug,
+                caching: !this.options?.noCache,
+            };
+            // If a specific cache TTL is provided, apply it to REST client
+            if (this.options?.cacheTTL) {
+                restClientOptions.cacheTTLs = {
+                    default: this.options.cacheTTL,
+                    builds: this.options.cacheTTL,
+                };
+            }
+            return restClientOptions;
+        }
+    }
+    static get requiresToken() {
+        return true;
+    }
+    async ensureInitialized() {
+        // No additional initialization needed
+        return Promise.resolve();
+    }
+    handleError(error, debug = false) {
+        // Only log the error message and stack trace
+        if (error instanceof Error) {
+            logger.error(error, 'Error occurred');
+            // If it's a GraphQL error or API error, show more details
+            const apiError = error;
+            if (apiError.response?.errors) {
+                apiError.response.errors.forEach((gqlError, index) => {
+                    logger.error({ path: gqlError.path }, `GraphQL Error ${index + 1}: ${gqlError.message}`);
+                });
+            }
+            // Show request details if available and in debug mode
+            if (debug && apiError.request) {
+                logger.debug({
+                    url: apiError.request.url,
+                    method: apiError.request.method
+                }, 'Request Details');
+            }
+        }
+        else if (typeof error === 'object') {
+            logger.error({ error }, 'Unknown error occurred');
+        }
+        else {
+            logger.error({ error }, 'Unknown error occurred');
+        }
+        if (debug) {
+            logger.debug({
+                timestamp: new Date().toISOString(),
+                nodeVersion: process.version,
+                platform: `${process.platform} (${process.arch})`
+            }, 'Debug Information');
+        }
+    }
+    // Static helper to get token from options, keyring, or environment
+    static async getToken(options) {
+        // First check if token is provided directly in options
+        if (options.token) {
+            return options.token;
+        }
+        // Next try to get token from keyring
+        try {
+            const storedToken = await this.credentialManager.getToken();
+            if (storedToken) {
+                logger.debug('Using token from system keychain');
+                return storedToken;
+            }
+        }
+        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.');
+        }
+        else {
+            return;
+        }
+    }
+    /**
+     * Get the appropriate formatter based on command-specific type and format option
+     * @param type The formatter type ('pipeline', 'build', 'viewer')
+     * @param options Command options that may include a format
+     * @returns The appropriate formatter
+     */
+    getFormatter(type, options) {
+        // Format precedence: command line option > constructor option > default
+        const format = options.format || this.options.format || 'plain';
+        if (options.debug) {
+            logger.debug(`Using ${format} formatter for ${type}`);
+        }
+        return FormatterFactory.getFormatter(type, format);
+    }
+}
+//# sourceMappingURL=BaseCommand.js.map

package/dist/commands/BaseCommand.js.map

@@ -0,0 +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}"]}

package/dist/commands/BaseCommandHandler.js

@@ -0,0 +1,80 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { BuildkiteClient } from '../services/BuildkiteClient.js';
+export class BaseCommandHandler {
+    constructor(token, options) {
+        this.initialized = false;
+        this.token = token;
+        this.options = options || {};
+        if (options === null || options === void 0 ? void 0 : options.debug) {
+            console.log('Debug: BaseCommandHandler options:', JSON.stringify(options));
+        }
+        this.client = new BuildkiteClient(token);
+        this.initialized = true; // Client is initialized in constructor
+    }
+    ensureInitialized() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // No additional initialization needed
+            return Promise.resolve();
+        });
+    }
+    handleError(error, debug = false) {
+        var _a;
+        console.error('\x1b[31m%s\x1b[0m', '🔥 Error Details:');
+        if (error instanceof Error) {
+            console.error('\x1b[31m%s\x1b[0m', `Message: ${error.message}`);
+            // Always print the stack trace for proper debugging
+            if (error.stack) {
+                console.error('\x1b[33m%s\x1b[0m', 'Stack Trace:');
+                console.error('\x1b[33m%s\x1b[0m', error.stack);
+            }
+            // If it's a GraphQL error or API error, show more details
+            const apiError = error;
+            if ((_a = apiError.response) === null || _a === void 0 ? void 0 : _a.errors) {
+                console.error('\x1b[33m%s\x1b[0m', 'GraphQL Errors:');
+                apiError.response.errors.forEach((gqlError, index) => {
+                    console.error(`  Error ${index + 1}: ${gqlError.message}`);
+                    if (gqlError.path)
+                        console.error(`  Path: ${gqlError.path.join('.')}`);
+                    if (gqlError.locations)
+                        console.error(`  Locations: ${JSON.stringify(gqlError.locations)}`);
+                    console.error('');
+                });
+            }
+            // Show request details if available and in debug mode
+            if (debug && apiError.request) {
+                console.error('\x1b[36m%s\x1b[0m', 'Request Details:');
+                console.error(`  URL: ${apiError.request.url || 'N/A'}`);
+                console.error(`  Method: ${apiError.request.method || 'N/A'}`);
+            }
+        }
+        else if (typeof error === 'object') {
+            console.error('\x1b[31m%s\x1b[0m', JSON.stringify(error, null, 2));
+        }
+        else {
+            console.error('\x1b[31m%s\x1b[0m', 'An unknown error occurred:', error);
+        }
+        if (debug) {
+            console.error('\x1b[36m%s\x1b[0m', '\nDebug Information:');
+            console.error('\x1b[36m%s\x1b[0m', `⏰ Timestamp: ${new Date().toISOString()}`);
+            console.error('\x1b[36m%s\x1b[0m', `🔧 Node Version: ${process.version}`);
+            console.error('\x1b[36m%s\x1b[0m', `💻 Platform: ${process.platform} (${process.arch})`);
+        }
+    }
+    // Static helper to get token from options or environment
+    static getToken(options) {
+        const token = options.token || process.env.BK_TOKEN;
+        if (!token) {
+            throw new Error('API token required. Set via --token or BK_TOKEN environment variable.');
+        }
+        return token;
+    }
+}
+//# sourceMappingURL=BaseCommandHandler.js.map

package/dist/commands/BaseCommandHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCommandHandler.js","sourceRoot":"/","sources":["commands/BaseCommandHandler.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AA2BjE,MAAM,OAAgB,kBAAkB;IAMtC,YAAY,KAAa,EAAE,OAAqC;QAFtD,gBAAW,GAAY,KAAK,CAAC;QAGrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,uCAAuC;IAClE,CAAC;IAEe,iBAAiB;;YAC/B,sCAAsC;YACtC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;KAAA;IAES,WAAW,CAAC,KAAU,EAAE,QAAiB,KAAK;;QACtD,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;QAExD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAEhE,oDAAoD;YACpD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;gBACnD,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;YAED,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,KAAiB,CAAC;YACnC,IAAI,MAAA,QAAQ,CAAC,QAAQ,0CAAE,MAAM,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;gBACtD,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;oBACnD,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC3D,IAAI,QAAQ,CAAC,IAAI;wBAAE,OAAO,CAAC,KAAK,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACvE,IAAI,QAAQ,CAAC,SAAS;wBAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC5F,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACpB,CAAC,CAAC,CAAC;YACL,CAAC;YAED,sDAAsD;YACtD,IAAI,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;gBACvD,OAAO,CAAC,KAAK,CAAC,UAAU,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;gBACzD,OAAO,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,4BAA4B,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;YAC3D,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,gBAAgB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/E,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,oBAAoB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1E,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,gBAAgB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,MAAM,CAAC,QAAQ,CAAC,OAAY;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF","sourcesContent":["import { BuildkiteClient } from '../services/BuildkiteClient.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 BaseCommandHandler {\n  protected token: string;\n  protected client: BuildkiteClient;\n  protected options: Partial<BaseCommandOptions>;\n  protected initialized: boolean = false;\n\n  constructor(token: string, options?: Partial<BaseCommandOptions>) {\n    this.token = token;\n    this.options = options || {};\n    if (options?.debug) {\n      console.log('Debug: BaseCommandHandler options:', JSON.stringify(options));\n    }\n    this.client = new BuildkiteClient(token);\n    this.initialized = true; // Client is initialized in constructor\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    console.error('\\x1b[31m%s\\x1b[0m', '🔥 Error Details:');\n    \n    if (error instanceof Error) {\n      console.error('\\x1b[31m%s\\x1b[0m', `Message: ${error.message}`);\n      \n      // Always print the stack trace for proper debugging\n      if (error.stack) {\n        console.error('\\x1b[33m%s\\x1b[0m', 'Stack Trace:');\n        console.error('\\x1b[33m%s\\x1b[0m', error.stack);\n      }\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        console.error('\\x1b[33m%s\\x1b[0m', 'GraphQL Errors:');\n        apiError.response.errors.forEach((gqlError, index) => {\n          console.error(`  Error ${index + 1}: ${gqlError.message}`);\n          if (gqlError.path) console.error(`  Path: ${gqlError.path.join('.')}`);\n          if (gqlError.locations) console.error(`  Locations: ${JSON.stringify(gqlError.locations)}`);\n          console.error('');\n        });\n      }\n      \n      // Show request details if available and in debug mode\n      if (debug && apiError.request) {\n        console.error('\\x1b[36m%s\\x1b[0m', 'Request Details:');\n        console.error(`  URL: ${apiError.request.url || 'N/A'}`);\n        console.error(`  Method: ${apiError.request.method || 'N/A'}`);\n      }\n    } else if (typeof error === 'object') {\n      console.error('\\x1b[31m%s\\x1b[0m', JSON.stringify(error, null, 2));\n    } else {\n      console.error('\\x1b[31m%s\\x1b[0m', 'An unknown error occurred:', error);\n    }\n    \n    if (debug) {\n      console.error('\\x1b[36m%s\\x1b[0m', '\\nDebug Information:');\n      console.error('\\x1b[36m%s\\x1b[0m', `⏰ Timestamp: ${new Date().toISOString()}`);\n      console.error('\\x1b[36m%s\\x1b[0m', `🔧 Node Version: ${process.version}`);\n      console.error('\\x1b[36m%s\\x1b[0m', `💻 Platform: ${process.platform} (${process.arch})`);\n    }\n  }\n\n  // Static helper to get token from options or environment\n  static getToken(options: any): string {\n    const token = options.token || process.env.BK_TOKEN;\n    if (!token) {\n      throw new Error('API token required. Set via --token or BK_TOKEN environment variable.');\n    }\n    return token;\n  }\n} "]}

package/dist/commands/BuildCommandHandler.js

@@ -0,0 +1,28 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { BaseCommandHandler } from './BaseCommandHandler.js';
+export class BuildCommandHandler extends BaseCommandHandler {
+    triggerBuild(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                // Currently just logging, but would implement the actual API call
+                console.log('Triggering build with options:', options);
+                // Implementation would go here
+                // TODO: Implement build triggering logic using the Buildkite API
+            }
+            catch (error) {
+                console.error('Error triggering build:');
+                this.handleError(error, options.debug);
+                process.exit(1);
+            }
+        });
+    }
+}
+//# sourceMappingURL=BuildCommandHandler.js.map

package/dist/commands/BuildCommandHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildCommandHandler.js","sourceRoot":"","sources":["../../src/commands/BuildCommandHandler.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAW7D,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IACnD,YAAY,CAAC,OAAqB;;YACtC,IAAI,CAAC;gBACH,kEAAkE;gBAClE,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;gBAEvD,+BAA+B;gBAC/B,iEAAiE;YAEnE,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBACzC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;KAAA;CACF"}

package/dist/commands/HelloCommandHandler.js

@@ -0,0 +1,6 @@
+export class HelloCommandHandler {
+    execute() {
+        console.log('Hello from bk-cli!');
+    }
+}
+//# sourceMappingURL=HelloCommandHandler.js.map

package/dist/commands/HelloCommandHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelloCommandHandler.js","sourceRoot":"","sources":["../../src/commands/HelloCommandHandler.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAmB;IAC9B,OAAO;QACL,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/commands/ListAnnotations.js

@@ -0,0 +1,60 @@
+import { BaseCommand } from './BaseCommand.js';
+import { logger } from '../services/logger.js';
+import { parseBuildRef } from '../utils/parseBuildRef.js';
+import { FormatterFactory, FormatterType } from '../formatters/index.js';
+export class ListAnnotations extends BaseCommand {
+    static requiresToken = true;
+    async execute(options) {
+        if (options.debug) {
+            logger.debug('Starting ListAnnotations command execution');
+        }
+        if (!options.buildArg) {
+            logger.error('Build reference is required');
+            return 1;
+        }
+        try {
+            // Ensure the command is initialized
+            await this.ensureInitialized();
+            const buildRef = parseBuildRef(options.buildArg);
+            if (options.debug) {
+                logger.debug('Parsed build reference:', buildRef);
+            }
+            // Fetch annotations from the GraphQL API
+            const buildSlug = `${buildRef.org}/${buildRef.pipeline}/${buildRef.number}`;
+            const result = await this.client.getBuildAnnotations(buildSlug);
+            // Extract annotations from the GraphQL response
+            let annotations = result.build?.annotations?.edges?.map((edge) => edge.node) || [];
+            // Filter by context if specified
+            if (options.context) {
+                const contextFilter = options.context.toLowerCase();
+                annotations = annotations.filter(annotation => annotation.context.toLowerCase() === contextFilter);
+                if (options.debug) {
+                    logger.debug(`Filtered annotations by context '${options.context}': ${annotations.length} found`);
+                }
+            }
+            // Get the appropriate formatter
+            const formatter = FormatterFactory.getFormatter(FormatterType.ANNOTATION, options.format || 'plain'); // Cast to any since FormatterFactory returns BaseFormatter
+            // Format and output the results
+            const output = formatter.formatAnnotations(annotations, {
+                debug: options.debug,
+                contextFilter: options.context
+            });
+            logger.console(output);
+            return 0;
+        }
+        catch (error) {
+            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
+            const errorOutput = formatter.formatAnnotations([], {
+                hasError: true,
+                errorMessage: error instanceof Error ? error.message : 'Unknown error occurred',
+                errorType: 'api',
+                debug: options.debug
+            });
+            logger.console(errorOutput);
+            return 1;
+        }
+    }
+}
+//# sourceMappingURL=ListAnnotations.js.map

package/dist/commands/ListAnnotations.js.map

@@ -0,0 +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"]}