bktide 0.0.1

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// Buildkite GraphQL API response types
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["types/index.ts"],"names":[],"mappings":"AAAA,uCAAuC","sourcesContent":["// Buildkite GraphQL API response types\n\n// Viewer types\nexport interface ViewerUser {\n  id: string;\n  uuid: string;\n  name: string;\n  email: string;\n}\n\nexport interface Viewer {\n  id: string;\n  user?: ViewerUser;\n}\n\nexport interface ViewerData {\n  viewer: Viewer;\n}\n\n// Organization types\nexport interface Organization {\n  id: string;\n  name: string;\n  slug: string;\n}\n\n// Pipeline types\nexport interface Repository {\n  url: string;\n}\n\nexport interface Pipeline {\n  uuid: string;\n  id: string;\n  name: string;\n  slug: string;\n  description?: string;\n  url?: string;\n  organization?: string;\n  repository?: Repository;\n}\n\n// Build types\nexport interface BuildPipeline {\n  name: string;\n  slug: string;\n}\n\nexport interface BuildOrganization {\n  name: string;\n  slug: string;\n}\n\nexport interface Build {\n  id: string;\n  number: number;\n  url?: string;\n  web_url?: string;\n  state?: string;\n  message?: string;\n  commit?: string;\n  branch?: string;\n  createdAt?: string;\n  created_at?: string;\n  startedAt?: string;\n  started_at?: string;\n  finishedAt?: string;\n  finished_at?: string;\n  pipeline?: BuildPipeline;\n  organization?: BuildOrganization;\n}\n\n// Annotation types\nexport interface Annotation {\n  context: string;\n  style: string;\n  body: {\n    html: string;\n  };\n}\n\n// GraphQL API response structure types\nexport interface GraphQLEdge<T> {\n  node: T;\n}\n\nexport interface GraphQLConnection<T> {\n  edges: GraphQLEdge<T>[];\n  pageInfo?: {\n    hasNextPage: boolean;\n    endCursor?: string;\n  };\n}\n\nexport interface ViewerOrganizationsData {\n  viewer: {\n    organizations: GraphQLConnection<Organization>;\n  };\n}\n\nexport interface PipelineQueryResponse {\n  organization: {\n    pipelines: GraphQLConnection<Pipeline>;\n  };\n}\n\nexport interface ViewerBuildsQueryResponse {\n  viewer: {\n    builds: GraphQLConnection<Build>;\n  };\n}\n\nexport interface OrganizationsQueryResponse {\n  viewer: {\n    organizations: GraphQLConnection<Organization>;\n  };\n} "]}

package/dist/utils/cli-error-handler.js

@@ -0,0 +1,172 @@
+/**
+ * CLI Error Handler - Provides error display for CLI applications
+ */
+import { logger } from '../services/logger.js';
+import { FormatterFactory, FormatterType } from '../formatters/FormatterFactory.js';
+// Default format to use for error output
+let globalErrorFormat = 'plain';
+/**
+ * Set the global error output format
+ * @param format The format to use ('plain', 'json', 'alfred')
+ */
+export function setErrorFormat(format) {
+    const normalizedFormat = format.toLowerCase().trim();
+    if (['plain', 'json', 'alfred'].includes(normalizedFormat)) {
+        globalErrorFormat = normalizedFormat;
+        logger.debug(`Error output format set to ${normalizedFormat}`);
+    }
+    else {
+        logger.warn(`Unknown format '${format}', error output format remains as ${globalErrorFormat}`);
+    }
+}
+/**
+ * Display a formatted error message
+ *
+ * @param error The error to display
+ * @param debug Whether to include debug information
+ * @param format Output format (plain, json, alfred), defaults to global setting
+ */
+export function displayCLIError(error, debug = false, format) {
+    // Use provided format or fall back to global format
+    const outputFormat = format || globalErrorFormat;
+    // Get the appropriate formatter based on format
+    const formatter = FormatterFactory.getFormatter(FormatterType.ERROR, outputFormat);
+    // Format the error using the selected formatter
+    const formattedError = formatter.formatError(error, { debug });
+    // Print the formatted output
+    if (outputFormat === 'plain') {
+        logger.error(formattedError);
+    }
+    else {
+        logger.console(formattedError);
+    }
+    process.exit(1);
+}
+/**
+ * Get the current global error output format
+ * @returns The current format
+ */
+export function getErrorFormat() {
+    return globalErrorFormat;
+}
+/**
+ * Format an error object for display in the CLI
+ * Extracts as much useful information as possible, including stack traces
+ *
+ * @param error The error object to format
+ * @param debug Whether to include debug information
+ * @returns Formatted error message
+ */
+export function formatErrorForCLI(error, debug = false) {
+    let output = '';
+    // Add a separator and heading
+    output += '\n\x1b[31m════════════════════════ ERROR ════════════════════════\x1b[0m\n\n';
+    if (error instanceof Error) {
+        // Handle standard Error objects
+        output += `\x1b[31m${error.name}: ${error.message}\x1b[0m\n\n`;
+        if (error.stack) {
+            const stackLines = error.stack.split('\n');
+            // First line usually contains the error message, which we've already displayed
+            const stackTrace = stackLines.slice(1).join('\n');
+            output += `\x1b[33mStack Trace:\x1b[0m\n${stackTrace}\n\n`;
+        }
+        // Handle additional properties that might be present in API errors
+        const apiError = error;
+        if (apiError.response?.errors) {
+            output += '\x1b[33mAPI Errors:\x1b[0m\n';
+            apiError.response.errors.forEach((e, i) => {
+                output += `  Error ${i + 1}: ${e.message || 'Unknown error'}\n`;
+                if (e.path)
+                    output += `  Path: ${e.path.join('.')}\n`;
+                if (e.locations)
+                    output += `  Locations: ${JSON.stringify(e.locations)}\n`;
+                output += '\n';
+            });
+        }
+        if (debug && apiError.request) {
+            output += '\x1b[36mRequest Details:\x1b[0m\n';
+            output += `  URL: ${apiError.request.url || 'N/A'}\n`;
+            output += `  Method: ${apiError.request.method || 'N/A'}\n\n`;
+        }
+        // If error has a cause, include it
+        if (apiError.cause) {
+            output += '\x1b[33mCaused by:\x1b[0m\n';
+            output += formatErrorForCLI(apiError.cause, debug);
+        }
+    }
+    else if (error && typeof error === 'object') {
+        // Handle non-Error objects
+        try {
+            output += '\x1b[31mError Object:\x1b[0m\n';
+            output += JSON.stringify(error, null, 2) + '\n\n';
+            // Try to extract more detailed information
+            const errorObj = error;
+            if (errorObj.message) {
+                output += `Message: ${errorObj.message}\n`;
+            }
+            if (debug) {
+                output += '\x1b[36mProperties:\x1b[0m\n';
+                for (const key in errorObj) {
+                    try {
+                        if (key !== 'stack' && key !== 'message') {
+                            const value = errorObj[key];
+                            output += `  ${key}: ${typeof value === 'object' ? JSON.stringify(value) : value}\n`;
+                        }
+                    }
+                    catch {
+                        output += `  ${key}: [Cannot stringify]\n`;
+                    }
+                }
+                output += '\n';
+            }
+        }
+        catch {
+            output += '\x1b[31mUnable to stringify error object\x1b[0m\n\n';
+        }
+    }
+    else {
+        // Handle primitive values
+        output += `\x1b[31m${String(error)}\x1b[0m\n\n`;
+    }
+    if (debug) {
+        // Add debug information
+        output += '\x1b[36mDebug Information:\x1b[0m\n';
+        output += `  Timestamp: ${new Date().toISOString()}\n`;
+        output += `  Node Version: ${process.version}\n`;
+        output += `  Platform: ${process.platform} (${process.arch})\n`;
+        try {
+            // Get the current call stack
+            const stack = new Error().stack;
+            if (stack) {
+                const stackLines = stack.split('\n').slice(2); // Skip the Error creation line and this function
+                output += '\n\x1b[36mCurrent Stack:\x1b[0m\n';
+                output += stackLines.join('\n') + '\n';
+            }
+        }
+        catch {
+            // Ignore stack trace errors
+        }
+    }
+    // Add a closing separator
+    output += '\n\x1b[31m═══════════════════════════════════════════════════════\x1b[0m\n';
+    return output;
+}
+/**
+ * Wraps a function with CLI error handling
+ *
+ * @param fn The function to wrap
+ * @param options Error handling options
+ * @returns A wrapped function with error handling
+ */
+export function withCLIErrorHandling(fn, options = {}) {
+    return async function (...args) {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            displayCLIError(error, options.debugMode || false, options.format);
+            process.exit(1);
+        }
+    };
+}
+//# sourceMappingURL=cli-error-handler.js.map

package/dist/utils/cli-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error-handler.js","sourceRoot":"/","sources":["utils/cli-error-handler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CLI Error Handler - Provides error display for CLI applications\n */\n\nimport { logger } from '../services/logger.js';\nimport { FormatterFactory, FormatterType } from '../formatters/FormatterFactory.js';\nimport { ErrorFormatter } from '../formatters/errors/index.js';\n\n// Default format to use for error output\nlet globalErrorFormat = 'plain';\n\n/**\n * Set the global error output format\n * @param format The format to use ('plain', 'json', 'alfred')\n */\nexport function setErrorFormat(format: string): void {\n  const normalizedFormat = format.toLowerCase().trim();\n  if (['plain', 'json', 'alfred'].includes(normalizedFormat)) {\n    globalErrorFormat = normalizedFormat;\n    logger.debug(`Error output format set to ${normalizedFormat}`);\n  } else {\n    logger.warn(`Unknown format '${format}', error output format remains as ${globalErrorFormat}`);\n  }\n}\n\n/**\n * Display a formatted error message\n * \n * @param error The error to display\n * @param debug Whether to include debug information\n * @param format Output format (plain, json, alfred), defaults to global setting\n */\nexport function displayCLIError(\n  error: unknown, \n  debug = false, \n  format?: string\n): void {\n  // Use provided format or fall back to global format\n  const outputFormat = format || globalErrorFormat;\n  \n  // Get the appropriate formatter based on format\n  const formatter = FormatterFactory.getFormatter(FormatterType.ERROR, outputFormat) as ErrorFormatter;\n  \n  // Format the error using the selected formatter\n  const formattedError = formatter.formatError(error, { debug });\n  \n  // Print the formatted output\n  if (outputFormat === 'plain') {\n    logger.error(formattedError);\n  } else {\n    logger.console(formattedError);\n  }\n  \n  process.exit(1);\n}\n\n/**\n * Get the current global error output format\n * @returns The current format\n */\nexport function getErrorFormat(): string {\n  return globalErrorFormat;\n}\n\n/**\n * Format an error object for display in the CLI\n * Extracts as much useful information as possible, including stack traces\n * \n * @param error The error object to format\n * @param debug Whether to include debug information\n * @returns Formatted error message\n */\nexport function formatErrorForCLI(error: unknown, debug = false): string {\n  let output = '';\n  \n  // Add a separator and heading\n  output += '\\n\\x1b[31m════════════════════════ ERROR ════════════════════════\\x1b[0m\\n\\n';\n  \n  if (error instanceof Error) {\n    // Handle standard Error objects\n    output += `\\x1b[31m${error.name}: ${error.message}\\x1b[0m\\n\\n`;\n    \n    if (error.stack) {\n      const stackLines = error.stack.split('\\n');\n      // First line usually contains the error message, which we've already displayed\n      const stackTrace = stackLines.slice(1).join('\\n');\n      output += `\\x1b[33mStack Trace:\\x1b[0m\\n${stackTrace}\\n\\n`;\n    }\n    \n    // Handle additional properties that might be present in API errors\n    const apiError = error as any;\n    if (apiError.response?.errors) {\n      output += '\\x1b[33mAPI Errors:\\x1b[0m\\n';\n      apiError.response.errors.forEach((e: any, i: number) => {\n        output += `  Error ${i + 1}: ${e.message || 'Unknown error'}\\n`;\n        if (e.path) output += `  Path: ${e.path.join('.')}\\n`;\n        if (e.locations) output += `  Locations: ${JSON.stringify(e.locations)}\\n`;\n        output += '\\n';\n      });\n    }\n    \n    if (debug && apiError.request) {\n      output += '\\x1b[36mRequest Details:\\x1b[0m\\n';\n      output += `  URL: ${apiError.request.url || 'N/A'}\\n`;\n      output += `  Method: ${apiError.request.method || 'N/A'}\\n\\n`;\n    }\n    \n    // If error has a cause, include it\n    if (apiError.cause) {\n      output += '\\x1b[33mCaused by:\\x1b[0m\\n';\n      output += formatErrorForCLI(apiError.cause, debug);\n    }\n  } else if (error && typeof error === 'object') {\n    // Handle non-Error objects\n    try {\n      output += '\\x1b[31mError Object:\\x1b[0m\\n';\n      output += JSON.stringify(error, null, 2) + '\\n\\n';\n      \n      // Try to extract more detailed information\n      const errorObj = error as Record<string, any>;\n      if (errorObj.message) {\n        output += `Message: ${errorObj.message}\\n`;\n      }\n      \n      if (debug) {\n        output += '\\x1b[36mProperties:\\x1b[0m\\n';\n        for (const key in errorObj) {\n          try {\n            if (key !== 'stack' && key !== 'message') {\n              const value = errorObj[key];\n              output += `  ${key}: ${typeof value === 'object' ? JSON.stringify(value) : value}\\n`;\n            }\n          } catch {\n            output += `  ${key}: [Cannot stringify]\\n`;\n          }\n        }\n        output += '\\n';\n      }\n    } catch {\n      output += '\\x1b[31mUnable to stringify error object\\x1b[0m\\n\\n';\n    }\n  } else {\n    // Handle primitive values\n    output += `\\x1b[31m${String(error)}\\x1b[0m\\n\\n`;\n  }\n  \n  if (debug) {\n    // Add debug information\n    output += '\\x1b[36mDebug Information:\\x1b[0m\\n';\n    output += `  Timestamp: ${new Date().toISOString()}\\n`;\n    output += `  Node Version: ${process.version}\\n`;\n    output += `  Platform: ${process.platform} (${process.arch})\\n`;\n    \n    try {\n      // Get the current call stack\n      const stack = new Error().stack;\n      if (stack) {\n        const stackLines = stack.split('\\n').slice(2); // Skip the Error creation line and this function\n        output += '\\n\\x1b[36mCurrent Stack:\\x1b[0m\\n';\n        output += stackLines.join('\\n') + '\\n';\n      }\n    } catch {\n      // Ignore stack trace errors\n    }\n  }\n  \n  // Add a closing separator\n  output += '\\n\\x1b[31m═══════════════════════════════════════════════════════\\x1b[0m\\n';\n  \n  return output;\n}\n\n/**\n * Wraps a function with CLI error handling\n * \n * @param fn The function to wrap\n * @param options Error handling options\n * @returns A wrapped function with error handling\n */\nexport function withCLIErrorHandling<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  options: {\n    debugMode?: boolean;\n    format?: string;\n  } = {}\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async function(...args: Parameters<T>): Promise<ReturnType<T>> {\n    try {\n      return await fn(...args);\n    } catch (error) {\n      displayCLIError(\n        error, \n        options.debugMode || false, \n        options.format\n      );\n      process.exit(1);\n    }\n  };\n} "]}

package/dist/utils/errorUtils.js

@@ -0,0 +1,59 @@
+/**
+ * Error handling utilities
+ */
+import * as sourceMap from 'source-map-support';
+import { logger } from '../services/logger.js';
+import { displayCLIError } from './cli-error-handler.js';
+/**
+ * Initialize error handling for the application
+ */
+export function initializeErrorHandling() {
+    // Install source map support for better stack traces
+    sourceMap.install({
+        handleUncaughtExceptions: false,
+        hookRequire: true
+    });
+    // Set up handlers for uncaught exceptions and unhandled rejections
+    process.on('uncaughtException', (err) => {
+        displayCLIError(err, false);
+    });
+    process.on('unhandledRejection', (reason) => {
+        displayCLIError(reason, false);
+    });
+    logger.debug('Error handling system initialized');
+}
+/**
+ * Log an error with proper formatting
+ * @param error The error to log
+ */
+export function logError(error) {
+    if (error instanceof Error) {
+        logger.error(error, 'Error occurred');
+    }
+    else {
+        logger.error({ error }, 'Unknown error occurred');
+    }
+}
+/**
+ * Wrap an async function with better error handling
+ *
+ * @param fn Function to wrap
+ * @returns Wrapped function with better error handling
+ */
+export function withErrorHandling(fn) {
+    return async function (...args) {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                logger.error(error, 'Error occurred');
+            }
+            else {
+                logger.error({ error }, 'Unknown error occurred');
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=errorUtils.js.map

package/dist/utils/errorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.js","sourceRoot":"/","sources":["utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,qDAAqD;IACrD,SAAS,CAAC,OAAO,CAAC;QAChB,wBAAwB,EAAE,KAAK;QAC/B,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAK;IAEL,OAAO,KAAK,WAAU,GAAG,IAAmB;QAC1C,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Error handling utilities\n */\nimport * as sourceMap from 'source-map-support';\nimport { logger } from '../services/logger.js';\nimport { displayCLIError } from './cli-error-handler.js';\n\n/**\n * Initialize error handling for the application\n */\nexport function initializeErrorHandling(): void {\n  // Install source map support for better stack traces\n  sourceMap.install({\n    handleUncaughtExceptions: false,\n    hookRequire: true\n  });\n  \n  // Set up handlers for uncaught exceptions and unhandled rejections\n  process.on('uncaughtException', (err) => {\n    displayCLIError(err, false);\n  });\n\n  process.on('unhandledRejection', (reason) => {\n    displayCLIError(reason, false);\n  });\n\n  logger.debug('Error handling system initialized');\n}\n\n/**\n * Log an error with proper formatting\n * @param error The error to log\n */\nexport function logError(error: unknown): void {\n  if (error instanceof Error) {\n    logger.error(error, 'Error occurred');\n  } else {\n    logger.error({ error }, 'Unknown error occurred');\n  }\n}\n\n/**\n * Wrap an async function with better error handling\n * \n * @param fn Function to wrap\n * @returns Wrapped function with better error handling\n */\nexport function withErrorHandling<T extends (...args: any[]) => Promise<any>>(\n  fn: T\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async function(...args: Parameters<T>): Promise<ReturnType<T>> {\n    try {\n      return await fn(...args);\n    } catch (error) {\n      if (error instanceof Error) {\n        logger.error(error, 'Error occurred');\n      } else {\n        logger.error({ error }, 'Unknown error occurred');\n      }\n      throw error;\n    }\n  };\n} "]}

package/dist/utils/parseBuildRef.js

@@ -0,0 +1,31 @@
+export function parseBuildRef(input) {
+    if (!input) {
+        throw new Error('Build reference is required');
+    }
+    // Remove optional leading @
+    const cleanInput = input.startsWith('@') ? input.slice(1) : input;
+    // Try URL format first: https://buildkite.com/org/pipeline/builds/number
+    const urlRegex = /^https?:\/\/buildkite\.com\/([^\/]+)\/([^\/]+)\/builds\/(\d+)$/;
+    const urlMatch = cleanInput.match(urlRegex);
+    if (urlMatch) {
+        const [, org, pipeline, numberStr] = urlMatch;
+        const number = parseInt(numberStr, 10);
+        if (isNaN(number)) {
+            throw new Error(`Invalid build number: ${numberStr}`);
+        }
+        return { org, pipeline, number };
+    }
+    // Try slug format: org/pipeline/number
+    const slugRegex = /^([^\/]+)\/([^\/]+)\/(\d+)$/;
+    const slugMatch = cleanInput.match(slugRegex);
+    if (slugMatch) {
+        const [, org, pipeline, numberStr] = slugMatch;
+        const number = parseInt(numberStr, 10);
+        if (isNaN(number)) {
+            throw new Error(`Invalid build number: ${numberStr}`);
+        }
+        return { org, pipeline, number };
+    }
+    throw new Error(`Invalid build reference format: ${input}. Expected org/pipeline/number or @https://buildkite.com/org/pipeline/builds/number`);
+}
+//# sourceMappingURL=parseBuildRef.js.map

package/dist/utils/parseBuildRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBuildRef.js","sourceRoot":"/","sources":["utils/parseBuildRef.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAElE,yEAAyE;IACzE,MAAM,QAAQ,GAAG,gEAAgE,CAAC;IAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;QAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEvC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,uCAAuC;IACvC,MAAM,SAAS,GAAG,6BAA6B,CAAC;IAChD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE9C,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;QAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEvC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,qFAAqF,CAAC,CAAC;AACjJ,CAAC","sourcesContent":["export interface BuildRef {\n  org: string;\n  pipeline: string;\n  number: number;\n}\n\nexport function parseBuildRef(input: string): BuildRef {\n  if (!input) {\n    throw new Error('Build reference is required');\n  }\n\n  // Remove optional leading @\n  const cleanInput = input.startsWith('@') ? input.slice(1) : input;\n\n  // Try URL format first: https://buildkite.com/org/pipeline/builds/number\n  const urlRegex = /^https?:\\/\\/buildkite\\.com\\/([^\\/]+)\\/([^\\/]+)\\/builds\\/(\\d+)$/;\n  const urlMatch = cleanInput.match(urlRegex);\n  \n  if (urlMatch) {\n    const [, org, pipeline, numberStr] = urlMatch;\n    const number = parseInt(numberStr, 10);\n    \n    if (isNaN(number)) {\n      throw new Error(`Invalid build number: ${numberStr}`);\n    }\n    \n    return { org, pipeline, number };\n  }\n\n  // Try slug format: org/pipeline/number\n  const slugRegex = /^([^\\/]+)\\/([^\\/]+)\\/(\\d+)$/;\n  const slugMatch = cleanInput.match(slugRegex);\n  \n  if (slugMatch) {\n    const [, org, pipeline, numberStr] = slugMatch;\n    const number = parseInt(numberStr, 10);\n    \n    if (isNaN(number)) {\n      throw new Error(`Invalid build number: ${numberStr}`);\n    }\n    \n    return { org, pipeline, number };\n  }\n\n  throw new Error(`Invalid build reference format: ${input}. Expected org/pipeline/number or @https://buildkite.com/org/pipeline/builds/number`);\n}\n"]}

package/dist/utils/textFormatter.js

@@ -0,0 +1,53 @@
+import { htmlToText } from 'html-to-text';
+/**
+ * Formats HTML text for terminal display
+ */
+export function formatTextForTerminal(text, options = {}) {
+    const { maxWidth = 80, preserveLinks = true } = options;
+    if (!text || typeof text !== 'string') {
+        return '';
+    }
+    // Convert HTML to text with better structure preservation
+    const htmlToTextOptions = {
+        wordwrap: maxWidth,
+        preserveNewlines: true,
+        selectors: [
+            { selector: 'a', format: 'anchor' }
+        ],
+        formatters: {
+            anchor: (elem, _walk, builder) => {
+                const href = elem.attribs?.href;
+                const text = elem.children?.[0]?.data || href;
+                if (preserveLinks && href) {
+                    builder.addInline(`${text} (${href})`);
+                }
+                else {
+                    builder.addInline(text);
+                }
+            }
+        }
+    };
+    try {
+        const formattedText = htmlToText(text, htmlToTextOptions);
+        // Clean up any excessive whitespace while preserving structure
+        return formattedText
+            .replace(/\n{3,}/g, '\n\n') // Replace 3+ newlines with 2
+            .trim();
+    }
+    catch (error) {
+        // If HTML parsing fails, fall back to original text
+        console.warn('Failed to parse HTML, using original text:', error);
+        return text.trim();
+    }
+}
+/**
+ * Formats annotation body text specifically for terminal display
+ */
+export function formatAnnotationBody(bodyText, options = {}) {
+    return formatTextForTerminal(bodyText, {
+        maxWidth: 100,
+        preserveLinks: true,
+        ...options
+    });
+}
+//# sourceMappingURL=textFormatter.js.map

package/dist/utils/textFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textFormatter.js","sourceRoot":"/","sources":["utils/textFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,UAAiC,EAAE;IACrF,MAAM,EACJ,QAAQ,GAAG,EAAE,EACb,aAAa,GAAG,IAAI,EACrB,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,0DAA0D;IAC1D,MAAM,iBAAiB,GAAG;QACxB,QAAQ,EAAE,QAAQ;QAClB,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE;YACT,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE;SACpC;QACD,UAAU,EAAE;YACV,MAAM,EAAE,CAAC,IAAS,EAAE,KAAU,EAAE,OAAY,EAAE,EAAE;gBAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;gBAC9C,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;oBAC1B,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;SACF;KACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAE1D,+DAA+D;QAC/D,OAAO,aAAa;aACjB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,6BAA6B;aACxD,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oDAAoD;QACpD,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,UAAiC,EAAE;IACxF,OAAO,qBAAqB,CAAC,QAAQ,EAAE;QACrC,QAAQ,EAAE,GAAG;QACb,aAAa,EAAE,IAAI;QACnB,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { htmlToText } from 'html-to-text';\n\nexport interface TextFormattingOptions {\n  maxWidth?: number;\n  preserveLinks?: boolean;\n}\n\n/**\n * Formats HTML text for terminal display\n */\nexport function formatTextForTerminal(text: string, options: TextFormattingOptions = {}): string {\n  const {\n    maxWidth = 80,\n    preserveLinks = true\n  } = options;\n\n  if (!text || typeof text !== 'string') {\n    return '';\n  }\n\n  // Convert HTML to text with better structure preservation\n  const htmlToTextOptions = {\n    wordwrap: maxWidth,\n    preserveNewlines: true,\n    selectors: [\n      { selector: 'a', format: 'anchor' }\n    ],\n    formatters: {\n      anchor: (elem: any, _walk: any, builder: any) => {\n        const href = elem.attribs?.href;\n        const text = elem.children?.[0]?.data || href;\n        if (preserveLinks && href) {\n          builder.addInline(`${text} (${href})`);\n        } else {\n          builder.addInline(text);\n        }\n      }\n    }\n  };\n\n  try {\n    const formattedText = htmlToText(text, htmlToTextOptions);\n    \n    // Clean up any excessive whitespace while preserving structure\n    return formattedText\n      .replace(/\\n{3,}/g, '\\n\\n') // Replace 3+ newlines with 2\n      .trim();\n  } catch (error) {\n    // If HTML parsing fails, fall back to original text\n    console.warn('Failed to parse HTML, using original text:', error);\n    return text.trim();\n  }\n}\n\n/**\n * Formats annotation body text specifically for terminal display\n */\nexport function formatAnnotationBody(bodyText: string, options: TextFormattingOptions = {}): string {\n  return formatTextForTerminal(bodyText, {\n    maxWidth: 100,\n    preserveLinks: true,\n    ...options\n  });\n}\n"]}

package/dist/utils/xdgPaths.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+/**
+ * XDG Base Directory Specification utility
+ * https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
+ */
+export class XDGPaths {
+    /**
+     * Get XDG_CONFIG_HOME directory path
+     * Defaults to $HOME/.config
+     */
+    static getConfigHome() {
+        return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
+    }
+    /**
+     * Get XDG_DATA_HOME directory path
+     * Defaults to $HOME/.local/share
+     */
+    static getDataHome() {
+        return process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
+    }
+    /**
+     * Get XDG_CACHE_HOME directory path
+     * Defaults to $HOME/.cache
+     */
+    static getCacheHome() {
+        return process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache');
+    }
+    /**
+     * Get XDG_STATE_HOME directory path
+     * Defaults to $HOME/.local/state
+     */
+    static getStateHome() {
+        return process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state');
+    }
+    /**
+     * Get the appropriate application directory within an XDG directory
+     * @param base XDG base directory
+     * @param appName Application name
+     * @param create Whether to create the directory if it doesn't exist
+     */
+    static getAppDir(base, appName, create = true) {
+        const dir = path.join(base, appName);
+        if (create) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        return dir;
+    }
+    /**
+     * Get application's cache directory
+     * @param appName Application name
+     * @param create Whether to create the directory if it doesn't exist
+     */
+    static getAppCacheDir(appName, create = true) {
+        return this.getAppDir(this.getCacheHome(), appName, create);
+    }
+    /**
+     * Get application's config directory
+     * @param appName Application name
+     * @param create Whether to create the directory if it doesn't exist
+     */
+    static getAppConfigDir(appName, create = true) {
+        return this.getAppDir(this.getConfigHome(), appName, create);
+    }
+    /**
+     * Get application's data directory
+     * @param appName Application name
+     * @param create Whether to create the directory if it doesn't exist
+     */
+    static getAppDataDir(appName, create = true) {
+        return this.getAppDir(this.getDataHome(), appName, create);
+    }
+    /**
+     * Get application's state directory (for logs, etc.)
+     * @param appName Application name
+     * @param create Whether to create the directory if it doesn't exist
+     */
+    static getAppStateDir(appName, create = true) {
+        return this.getAppDir(this.getStateHome(), appName, create);
+    }
+    /**
+     * Get application's log directory (typically in state home)
+     * @param appName Application name
+     * @param create Whether to create the directory if it doesn't exist
+     */
+    static getAppLogDir(appName, create = true) {
+        const logDir = path.join(this.getAppStateDir(appName, create), 'logs');
+        if (create) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+        return logDir;
+    }
+}
+//# sourceMappingURL=xdgPaths.js.map

package/dist/utils/xdgPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xdgPaths.js","sourceRoot":"/","sources":["utils/xdgPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACnB;;;OAGG;IACH,MAAM,CAAC,aAAa;QAClB,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW;QAChB,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,MAAM,GAAG,IAAI;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,MAAM,GAAG,IAAI;QAClD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,OAAe,EAAE,MAAM,GAAG,IAAI;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,MAAM,GAAG,IAAI;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,MAAM,GAAG,IAAI;QAClD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,OAAe,EAAE,MAAM,GAAG,IAAI;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,MAAM,EAAE,CAAC;YACX,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF","sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\n\n/**\n * XDG Base Directory Specification utility\n * https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n */\nexport class XDGPaths {\n  /**\n   * Get XDG_CONFIG_HOME directory path\n   * Defaults to $HOME/.config\n   */\n  static getConfigHome(): string {\n    return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');\n  }\n\n  /**\n   * Get XDG_DATA_HOME directory path\n   * Defaults to $HOME/.local/share\n   */\n  static getDataHome(): string {\n    return process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n  }\n\n  /**\n   * Get XDG_CACHE_HOME directory path\n   * Defaults to $HOME/.cache\n   */\n  static getCacheHome(): string {\n    return process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache');\n  }\n\n  /**\n   * Get XDG_STATE_HOME directory path\n   * Defaults to $HOME/.local/state\n   */\n  static getStateHome(): string {\n    return process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state');\n  }\n\n  /**\n   * Get the appropriate application directory within an XDG directory\n   * @param base XDG base directory\n   * @param appName Application name\n   * @param create Whether to create the directory if it doesn't exist\n   */\n  static getAppDir(base: string, appName: string, create = true): string {\n    const dir = path.join(base, appName);\n    if (create) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n    return dir;\n  }\n\n  /**\n   * Get application's cache directory\n   * @param appName Application name\n   * @param create Whether to create the directory if it doesn't exist\n   */\n  static getAppCacheDir(appName: string, create = true): string {\n    return this.getAppDir(this.getCacheHome(), appName, create);\n  }\n\n  /**\n   * Get application's config directory\n   * @param appName Application name\n   * @param create Whether to create the directory if it doesn't exist\n   */\n  static getAppConfigDir(appName: string, create = true): string {\n    return this.getAppDir(this.getConfigHome(), appName, create);\n  }\n\n  /**\n   * Get application's data directory\n   * @param appName Application name\n   * @param create Whether to create the directory if it doesn't exist\n   */\n  static getAppDataDir(appName: string, create = true): string {\n    return this.getAppDir(this.getDataHome(), appName, create);\n  }\n\n  /**\n   * Get application's state directory (for logs, etc.)\n   * @param appName Application name\n   * @param create Whether to create the directory if it doesn't exist\n   */\n  static getAppStateDir(appName: string, create = true): string {\n    return this.getAppDir(this.getStateHome(), appName, create);\n  }\n\n  /**\n   * Get application's log directory (typically in state home)\n   * @param appName Application name\n   * @param create Whether to create the directory if it doesn't exist\n   */\n  static getAppLogDir(appName: string, create = true): string {\n    const logDir = path.join(this.getAppStateDir(appName, create), 'logs');\n    if (create) {\n      fs.mkdirSync(logDir, { recursive: true });\n    }\n    return logDir;\n  }\n} "]}

package/env.example

@@ -0,0 +1,66 @@
+# bktide Environment Configuration
+# Copy this file to ~/.config/bktide/env or to the workflow directory as .env
+
+# Node.js Configuration
+# ===================
+
+# Path to the Node.js binary
+# If Node.js is not in your PATH or you want to use a specific version,
+# set this to the full path of the node binary
+# Examples:
+#   NODE_BIN=node                           # Use node from PATH (default)
+#   NODE_BIN=/opt/homebrew/bin/node         # Homebrew on Apple Silicon
+#   NODE_BIN=/usr/local/bin/node           # Homebrew on Intel Mac
+#   NODE_BIN=/Users/username/.nvm/versions/node/v18.17.0/bin/node  # nvm
+#NODE_BIN=node
+
+# PATH Configuration
+# =================
+
+# You can extend the PATH to include additional directories where Node.js might be located
+# This is useful if your Node.js installation is not in the default system PATH
+# Examples:
+#   export PATH="/opt/homebrew/bin:$PATH"              # Add Homebrew (Apple Silicon)
+#   export PATH="/usr/local/bin:$PATH"                 # Add Homebrew (Intel)
+#   export PATH="/Users/username/.nvm/versions/node/v18.17.0/bin:$PATH"  # Add nvm
+
+# Buildkite API Configuration
+# ==========================
+
+# Buildkite API token
+# This can also be stored securely using: bktide token --store
+# Or passed as a command line argument: --token your_token_here
+#BUILDKITE_API_TOKEN=your_buildkite_api_token_here
+
+# Debugging and Development
+# ========================
+
+# Enable debug logging (equivalent to --debug flag)
+#DEBUG=true
+
+# Disable caching (equivalent to --no-cache flag)
+#NO_CACHE=true
+
+# Custom cache directory (defaults to ~/.cache/bktide)
+#CACHE_DIR=/custom/path/to/cache
+
+# Custom log directory (defaults to ~/.local/state/bktide/logs)
+#LOG_DIR=/custom/path/to/logs
+
+# Example configurations for common setups:
+# ========================================
+
+# For Homebrew on Apple Silicon Macs:
+# export PATH="/opt/homebrew/bin:$PATH"
+# NODE_BIN=/opt/homebrew/bin/node
+
+# For Homebrew on Intel Macs:
+# export PATH="/usr/local/bin:$PATH"
+# NODE_BIN=/usr/local/bin/node
+
+# For nvm users (replace with your Node version):
+# export PATH="/Users/$(whoami)/.nvm/versions/node/v18.17.0/bin:$PATH"
+# NODE_BIN="/Users/$(whoami)/.nvm/versions/node/v18.17.0/bin/node"
+
+# For system Node.js installation:
+# NODE_BIN=node

package/icons/README.md

@@ -0,0 +1,68 @@
+[Possible States](https://buildkite.com/user/graphql/documentation/type/BuildStates)
+
+SKIPPED
+The build was skipped
+
+CREATING
+The build is currently being created
+
+SCHEDULED
+The build has yet to start running jobs
+
+RUNNING
+The build is currently running jobs
+
+PASSED
+The build passed
+
+FAILED
+The build failed
+
+FAILING
+The build is failing
+
+CANCELING
+The build is currently being canceled
+
+CANCELED
+The build was canceled
+
+BLOCKED
+The build is blocked
+
+NOT_RUN
+The build wasn't run
+
+Material Icons
+Size: 256x256
+
+* icons/pass.png
+  * [Check Circle](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:check_circle:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=check&icon.size=256&icon.color=%2375FB4C)
+* icons/fail.png
+  * [Error](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:error:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=error&icon.size=256&icon.color=%23BB271A)
+* icons/running.png
+  * [Sync](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:sync:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=sync&icon.size=256&icon.color=%23F19E39)
+* icons/cancelled.png
+  * [Cancel](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:cancel:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=cancel&icon.size=256&icon.color=%23EA3323)
+  * Red
+* icons/cancelling.png
+  * [Sync Problem](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:sync_problem:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=sync&icon.size=256&icon.color=%23EA3323)
+  * Red
+* icons/failing.png
+  * [Sync Problem](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:sync_problem:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=sync&icon.size=256&icon.color=%23EA3323)
+  * Red
+* icons/skipped.png
+  * [Next Plan](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:next_plan:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=skip&icon.size=256&icon.color=%23999999)
+  * Gray
+* icons/blocked.png
+  * [Pause](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:pause:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=pause&icon.size=256&icon.color=%238C1AF6)
+  * purple
+* icons/scheduled.png
+  * [Schedule](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:schedule:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=schedule&icon.size=256&icon.color=%23999999)
+  * gray
+* icons/unknown.png
+  * [Question Mark](https://fonts.google.com/icons?selected=Material+Symbols+Outlined:question_mark:FILL@0;wght@400;GRAD@0;opsz@48&icon.query=unknown&icon.size=256&icon.color=%23999999)
+  * gray
+* icons/building.png
+  * https://buildkite.com/about/brand-assets/
+  * secondary logo, mark