bktide 1.0.1755266193 → 1.0.1755547716

package/dist/services/CredentialManager.js

@@ -1,7 +1,8 @@
-import { Entry } from '@napi-rs/keyring';
 import { logger } from './logger.js';
 import { BuildkiteClient } from './BuildkiteClient.js';
 import { BuildkiteRestClient } from './BuildkiteRestClient.js';
+import { isRunningInAlfred } from '../utils/alfred.js';
+import { Progress } from '../ui/progress.js';
 const SERVICE_NAME = 'bktide';
 const ACCOUNT_KEY = 'default';
 /**
@@ -10,7 +11,28 @@ const ACCOUNT_KEY = 'default';
 export class CredentialManager {
     entry;
     constructor(serviceName = SERVICE_NAME, accountName = ACCOUNT_KEY) {
-        this.entry = new Entry(serviceName, accountName);
+        // Do not load keyring when running under Alfred
+        if (!isRunningInAlfred()) {
+            // Lazy init via dynamic import to avoid resolving native module in Alfred context
+            // Note: constructor remains sync; actual instantiation is deferred in ensureEntry
+            void this.ensureEntry(serviceName, accountName);
+        }
+    }
+    async ensureEntry(serviceName = SERVICE_NAME, accountName = ACCOUNT_KEY) {
+        if (this.entry)
+            return this.entry;
+        if (isRunningInAlfred())
+            return undefined;
+        try {
+            const keyring = await import('@napi-rs/keyring');
+            this.entry = new keyring.Entry(serviceName, accountName);
+            return this.entry;
+        }
+        catch (error) {
+            logger.debug('Failed to initialize keyring Entry, continuing without keychain', error);
+            this.entry = undefined;
+            return undefined;
+        }
     }
     /**
      * Stores a token in the system keychain
@@ -18,8 +40,15 @@ export class CredentialManager {
      * @returns true if token was successfully stored
      */
     async saveToken(token) {
+        if (isRunningInAlfred()) {
+            // In Alfred path, we do not persist tokens programmatically
+            throw new Error('In Alfred, set token via Workflow Configuration (User Configuration).');
+        }
         try {
-            await this.entry.setPassword(token);
+            const entry = await this.ensureEntry();
+            if (!entry)
+                throw new Error('Keyring unavailable');
+            await entry.setPassword(token);
             logger.debug('Token saved to system keychain');
             return true;
         }
@@ -33,11 +62,18 @@ export class CredentialManager {
      * @returns The stored token or undefined if not found
      */
     async getToken() {
+        // Alfred: use env var only
+        if (isRunningInAlfred()) {
+            return process.env.BUILDKITE_API_TOKEN || process.env.BK_TOKEN || undefined;
+        }
         try {
-            const token = this.entry.getPassword();
+            const entry = await this.ensureEntry();
+            if (!entry)
+                return undefined;
+            const token = entry.getPassword();
             return token || undefined;
         }
-        catch (error) {
+        catch {
             return undefined;
         }
     }
@@ -46,8 +82,15 @@ export class CredentialManager {
      * @returns true if token was successfully deleted
      */
     async deleteToken() {
+        if (isRunningInAlfred()) {
+            // Nothing to delete in keyring under Alfred
+            return true;
+        }
         try {
-            await this.entry.deletePassword();
+            const entry = await this.ensureEntry();
+            if (!entry)
+                return false;
+            await entry.deletePassword();
             logger.debug('Token deleted from system keychain');
             return true;
         }
@@ -67,9 +110,10 @@ export class CredentialManager {
     /**
      * Validates if a token is valid by making test API calls to both GraphQL and REST APIs
      * @param token Optional token to validate. If not provided, will use the stored token.
+     * @param options Optional configuration for progress display
      * @returns Object containing validation status for both GraphQL and REST APIs
      */
-    async validateToken(token) {
+    async validateToken(token, options) {
         try {
             // If no token provided, try to get the stored one
             const tokenToValidate = token || await this.getToken();
@@ -103,6 +147,16 @@ export class CredentialManager {
             }
             const organizations = {};
             let allValid = true;
+            // Determine if we should show progress
+            const showProgress = options?.showProgress !== false &&
+                !isRunningInAlfred() &&
+                orgSlugs.length > 0;
+            const progress = showProgress ? Progress.bar({
+                total: orgSlugs.length * 3,
+                label: 'Validating token access',
+                format: options?.format
+            }) : null;
+            let checkCount = 0;
             // Validate each organization
             for (const orgSlug of orgSlugs) {
                 const orgStatus = {
@@ -110,8 +164,11 @@ export class CredentialManager {
                     builds: false,
                     organizations: false
                 };
+                // Check GraphQL access
+                if (progress) {
+                    progress.update(checkCount++, `Checking GraphQL access for ${orgSlug}`);
+                }
                 try {
-                    // Check GraphQL access
                     await graphqlClient.getViewer();
                     orgStatus.graphql = true;
                 }
@@ -119,8 +176,11 @@ export class CredentialManager {
                     logger.debug(`GraphQL validation failed for organization ${orgSlug}`, error);
                     allValid = false;
                 }
+                // Check build access
+                if (progress) {
+                    progress.update(checkCount++, `Checking build access for ${orgSlug}`);
+                }
                 try {
-                    // Check build access
                     await restClient.hasBuildAccess(orgSlug);
                     orgStatus.builds = true;
                 }
@@ -128,8 +188,11 @@ export class CredentialManager {
                     logger.debug(`Build access validation failed for organization ${orgSlug}`, error);
                     allValid = false;
                 }
+                // Check organization access
+                if (progress) {
+                    progress.update(checkCount++, `Checking organization access for ${orgSlug}`);
+                }
                 try {
-                    // Check organization access
                     await restClient.hasOrganizationAccess(orgSlug);
                     orgStatus.organizations = true;
                 }
@@ -139,6 +202,13 @@ export class CredentialManager {
                 }
                 organizations[orgSlug] = orgStatus;
             }
+            // Complete the progress bar
+            if (progress) {
+                const successCount = Object.values(organizations)
+                    .filter(org => org.graphql && org.builds && org.organizations)
+                    .length;
+                progress.complete(`✓ Validated ${orgSlugs.length} organizations (${successCount} fully accessible)`);
+            }
             return {
                 valid: allValid,
                 canListOrganizations: true,

package/dist/services/CredentialManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"CredentialManager.js","sourceRoot":"/","sources":["services/CredentialManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { Entry } from '@napi-rs/keyring';\nimport { logger } from './logger.js';\nimport { BuildkiteClient } from './BuildkiteClient.js';\nimport { BuildkiteRestClient } from './BuildkiteRestClient.js';\nimport { TokenValidationStatus, OrganizationValidationStatus } from '../types/credentials.js';\n\nconst SERVICE_NAME = 'bktide';\nconst ACCOUNT_KEY = 'default';\n\n/**\n * Manages secure storage of credentials using the system's keychain\n */\nexport class CredentialManager {\n  private entry: Entry;\n\n  constructor(serviceName = SERVICE_NAME, accountName = ACCOUNT_KEY) {\n    this.entry = new Entry(serviceName, accountName);\n  }\n\n  /**\n   * Stores a token in the system keychain\n   * @param token The Buildkite API token to store\n   * @returns true if token was successfully stored\n   */\n  async saveToken(token: string): Promise<boolean> {\n    try {\n      await this.entry.setPassword(token);\n      logger.debug('Token saved to system keychain');\n      return true;\n    } catch (error) {\n      logger.error('Failed to save token to system keychain', error);\n      return false;\n    }\n  }\n\n  /**\n   * Retrieves the stored token from the system keychain\n   * @returns The stored token or undefined if not found\n   */\n  async getToken(): Promise<string | undefined> {\n    try {\n      const token = this.entry.getPassword();\n      return token || undefined;\n    } catch (error) {\n      return undefined;\n    }\n  }\n\n  /**\n   * Deletes the stored token from the system keychain\n   * @returns true if token was successfully deleted\n   */\n  async deleteToken(): Promise<boolean> {\n    try {\n      await this.entry.deletePassword();\n      logger.debug('Token deleted from system keychain');\n      return true;\n    } catch (error) {\n      logger.error('Failed to delete token from system keychain', error);\n      return false;\n    }\n  }\n\n  /**\n   * Checks if a token exists in the system keychain\n   * @returns true if a token exists\n   */\n  async hasToken(): Promise<boolean> {\n    const token = await this.getToken();\n    return !!token;\n  }\n\n  /**\n   * Validates if a token is valid by making test API calls to both GraphQL and REST APIs\n   * @param token Optional token to validate. If not provided, will use the stored token.\n   * @returns Object containing validation status for both GraphQL and REST APIs\n   */\n  async validateToken(token?: string): Promise<TokenValidationStatus> {\n    try {\n      // If no token provided, try to get the stored one\n      const tokenToValidate = token || await this.getToken();\n      if (!tokenToValidate) {\n        logger.debug('No token provided for validation');\n        return { \n          valid: false, \n          canListOrganizations: false,\n          organizations: {} \n        };\n      }\n\n      // Create clients with the token\n      const graphqlClient = new BuildkiteClient(tokenToValidate, { debug: false, caching: false });\n      const restClient = new BuildkiteRestClient(tokenToValidate, { debug: false });\n      \n      // First check if we can list organizations\n      let orgSlugs: string[] = [];\n      try {\n        orgSlugs = await graphqlClient.getOrganizations().then(orgs => orgs.map(org => org.slug));\n        logger.debug('Successfully retrieved organization slugs');\n      } catch (error) {\n        logger.debug('Failed to retrieve organization slugs', {\n          error: error instanceof Error ? error.message : String(error),\n          cause: error instanceof Error && error.cause ? error.cause : undefined\n        });\n        return { \n          valid: false, \n          canListOrganizations: false,\n          organizations: {} \n        };\n      }\n\n      const organizations: Record<string, OrganizationValidationStatus> = {};\n      let allValid = true;\n\n      // Validate each organization\n      for (const orgSlug of orgSlugs) {\n        const orgStatus: OrganizationValidationStatus = {\n          graphql: false,\n          builds: false,\n          organizations: false\n        };\n\n        try {\n          // Check GraphQL access\n          await graphqlClient.getViewer();\n          orgStatus.graphql = true;\n        } catch (error) {\n          logger.debug(`GraphQL validation failed for organization ${orgSlug}`, error);\n          allValid = false;\n        }\n\n        try {\n          // Check build access\n          await restClient.hasBuildAccess(orgSlug);\n          orgStatus.builds = true;\n        } catch (error) {\n          logger.debug(`Build access validation failed for organization ${orgSlug}`, error);\n          allValid = false;\n        }\n\n        try {\n          // Check organization access\n          await restClient.hasOrganizationAccess(orgSlug);\n          orgStatus.organizations = true;\n        } catch (error) {\n          logger.debug(`Organization access validation failed for organization ${orgSlug}`, error);\n          allValid = false;\n        }\n\n        organizations[orgSlug] = orgStatus;\n      }\n\n      return {\n        valid: allValid,\n        canListOrganizations: true,\n        organizations\n      };\n    } catch (error) {\n      logger.debug('Token validation failed', error);\n      return { \n        valid: false, \n        canListOrganizations: false,\n        organizations: {} \n      };\n    }\n  }\n}"]}
+{"version":3,"file":"CredentialManager.js","sourceRoot":"/","sources":["services/CredentialManager.ts"],"names":[],"mappings":"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","sourcesContent":["// Avoid importing native module eagerly; import lazily when needed\nimport type { Entry } from '@napi-rs/keyring';\nimport { logger } from './logger.js';\nimport { BuildkiteClient } from './BuildkiteClient.js';\nimport { BuildkiteRestClient } from './BuildkiteRestClient.js';\nimport { TokenValidationStatus, OrganizationValidationStatus } from '../types/credentials.js';\nimport { isRunningInAlfred } from '../utils/alfred.js';\nimport { Progress } from '../ui/progress.js';\n\nconst SERVICE_NAME = 'bktide';\nconst ACCOUNT_KEY = 'default';\n\n/**\n * Manages secure storage of credentials using the system's keychain\n */\nexport class CredentialManager {\n  private entry: Entry | undefined;\n\n  constructor(serviceName = SERVICE_NAME, accountName = ACCOUNT_KEY) {\n    // Do not load keyring when running under Alfred\n    if (!isRunningInAlfred()) {\n      // Lazy init via dynamic import to avoid resolving native module in Alfred context\n      // Note: constructor remains sync; actual instantiation is deferred in ensureEntry\n      void this.ensureEntry(serviceName, accountName);\n    }\n  }\n\n  private async ensureEntry(serviceName = SERVICE_NAME, accountName = ACCOUNT_KEY): Promise<Entry | undefined> {\n    if (this.entry) return this.entry;\n    if (isRunningInAlfred()) return undefined;\n    try {\n      const keyring = await import('@napi-rs/keyring');\n      this.entry = new keyring.Entry(serviceName, accountName) as Entry;\n      return this.entry;\n    } catch (error) {\n      logger.debug('Failed to initialize keyring Entry, continuing without keychain', error);\n      this.entry = undefined;\n      return undefined;\n    }\n  }\n\n  /**\n   * Stores a token in the system keychain\n   * @param token The Buildkite API token to store\n   * @returns true if token was successfully stored\n   */\n  async saveToken(token: string): Promise<boolean> {\n    if (isRunningInAlfred()) {\n      // In Alfred path, we do not persist tokens programmatically\n      throw new Error('In Alfred, set token via Workflow Configuration (User Configuration).');\n    }\n    try {\n      const entry = await this.ensureEntry();\n      if (!entry) throw new Error('Keyring unavailable');\n      await entry.setPassword(token);\n      logger.debug('Token saved to system keychain');\n      return true;\n    } catch (error) {\n      logger.error('Failed to save token to system keychain', error);\n      return false;\n    }\n  }\n\n  /**\n   * Retrieves the stored token from the system keychain\n   * @returns The stored token or undefined if not found\n   */\n  async getToken(): Promise<string | undefined> {\n    // Alfred: use env var only\n    if (isRunningInAlfred()) {\n      return process.env.BUILDKITE_API_TOKEN || process.env.BK_TOKEN || undefined;\n    }\n    try {\n      const entry = await this.ensureEntry();\n      if (!entry) return undefined;\n      const token = entry.getPassword();\n      return token || undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Deletes the stored token from the system keychain\n   * @returns true if token was successfully deleted\n   */\n  async deleteToken(): Promise<boolean> {\n    if (isRunningInAlfred()) {\n      // Nothing to delete in keyring under Alfred\n      return true;\n    }\n    try {\n      const entry = await this.ensureEntry();\n      if (!entry) return false;\n      await entry.deletePassword();\n      logger.debug('Token deleted from system keychain');\n      return true;\n    } catch (error) {\n      logger.error('Failed to delete token from system keychain', error);\n      return false;\n    }\n  }\n\n  /**\n   * Checks if a token exists in the system keychain\n   * @returns true if a token exists\n   */\n  async hasToken(): Promise<boolean> {\n    const token = await this.getToken();\n    return !!token;\n  }\n\n  /**\n   * Validates if a token is valid by making test API calls to both GraphQL and REST APIs\n   * @param token Optional token to validate. If not provided, will use the stored token.\n   * @param options Optional configuration for progress display\n   * @returns Object containing validation status for both GraphQL and REST APIs\n   */\n  async validateToken(token?: string, options?: { format?: string; showProgress?: boolean }): Promise<TokenValidationStatus> {\n    try {\n      // If no token provided, try to get the stored one\n      const tokenToValidate = token || await this.getToken();\n      if (!tokenToValidate) {\n        logger.debug('No token provided for validation');\n        return { \n          valid: false, \n          canListOrganizations: false,\n          organizations: {} \n        };\n      }\n\n      // Create clients with the token\n      const graphqlClient = new BuildkiteClient(tokenToValidate, { debug: false, caching: false });\n      const restClient = new BuildkiteRestClient(tokenToValidate, { debug: false });\n      \n      // First check if we can list organizations\n      let orgSlugs: string[] = [];\n      try {\n        orgSlugs = await graphqlClient.getOrganizations().then(orgs => orgs.map(org => org.slug));\n        logger.debug('Successfully retrieved organization slugs');\n      } catch (error) {\n        logger.debug('Failed to retrieve organization slugs', {\n          error: error instanceof Error ? error.message : String(error),\n          cause: error instanceof Error && error.cause ? error.cause : undefined\n        });\n        return { \n          valid: false, \n          canListOrganizations: false,\n          organizations: {} \n        };\n      }\n\n      const organizations: Record<string, OrganizationValidationStatus> = {};\n      let allValid = true;\n\n      // Determine if we should show progress\n      const showProgress = options?.showProgress !== false && \n                          !isRunningInAlfred() && \n                          orgSlugs.length > 0;\n      \n      const progress = showProgress ? Progress.bar({\n        total: orgSlugs.length * 3,\n        label: 'Validating token access',\n        format: options?.format\n      }) : null;\n\n      let checkCount = 0;\n\n      // Validate each organization\n      for (const orgSlug of orgSlugs) {\n        const orgStatus: OrganizationValidationStatus = {\n          graphql: false,\n          builds: false,\n          organizations: false\n        };\n\n        // Check GraphQL access\n        if (progress) {\n          progress.update(checkCount++, `Checking GraphQL access for ${orgSlug}`);\n        }\n        try {\n          await graphqlClient.getViewer();\n          orgStatus.graphql = true;\n        } catch (error) {\n          logger.debug(`GraphQL validation failed for organization ${orgSlug}`, error);\n          allValid = false;\n        }\n\n        // Check build access\n        if (progress) {\n          progress.update(checkCount++, `Checking build access for ${orgSlug}`);\n        }\n        try {\n          await restClient.hasBuildAccess(orgSlug);\n          orgStatus.builds = true;\n        } catch (error) {\n          logger.debug(`Build access validation failed for organization ${orgSlug}`, error);\n          allValid = false;\n        }\n\n        // Check organization access\n        if (progress) {\n          progress.update(checkCount++, `Checking organization access for ${orgSlug}`);\n        }\n        try {\n          await restClient.hasOrganizationAccess(orgSlug);\n          orgStatus.organizations = true;\n        } catch (error) {\n          logger.debug(`Organization access validation failed for organization ${orgSlug}`, error);\n          allValid = false;\n        }\n\n        organizations[orgSlug] = orgStatus;\n      }\n\n      // Complete the progress bar\n      if (progress) {\n        const successCount = Object.values(organizations)\n          .filter(org => org.graphql && org.builds && org.organizations)\n          .length;\n        progress.complete(`✓ Validated ${orgSlugs.length} organizations (${successCount} fully accessible)`);\n      }\n\n      return {\n        valid: allValid,\n        canListOrganizations: true,\n        organizations\n      };\n    } catch (error) {\n      logger.debug('Token validation failed', error);\n      return { \n        valid: false, \n        canListOrganizations: false,\n        organizations: {} \n      };\n    }\n  }\n}"]}

package/dist/ui/help.js

@@ -0,0 +1,69 @@
+/**
+ * Custom Help formatter for Commander with width-aware text wrapping
+ */
+import { Help } from 'commander';
+import { termWidth, wrapText } from './width.js';
+export class WidthAwareHelp extends Help {
+    /**
+     * Get the terminal width with a max limit for readability
+     */
+    getHelpWidth() {
+        // Cap at 100 chars for readability, even on ultra-wide terminals
+        return Math.min(termWidth(), 100);
+    }
+    /**
+     * Wrap text to fit terminal width
+     */
+    wrapLine(text, indent = 0) {
+        const width = this.getHelpWidth();
+        const effectiveWidth = Math.max(40, width - indent);
+        const lines = wrapText(text, effectiveWidth);
+        const indentStr = ' '.repeat(indent);
+        return lines.map((line, i) => i === 0 ? line : indentStr + line).join('\n');
+    }
+    /**
+     * Override formatHelp to apply width-aware formatting
+     */
+    formatHelp(cmd, helper) {
+        const width = this.getHelpWidth();
+        // Get the default help text
+        let helpText = super.formatHelp(cmd, helper);
+        // Process each line to apply wrapping
+        const lines = helpText.split('\n');
+        const processedLines = [];
+        for (const line of lines) {
+            // Skip empty lines
+            if (line.trim() === '') {
+                processedLines.push(line);
+                continue;
+            }
+            // Detect option/command lines (they start with spaces and contain two or more spaces for alignment)
+            const optionMatch = line.match(/^(\s+)(\S+)\s{2,}(.*)$/);
+            if (optionMatch) {
+                const [, indent, option, description] = optionMatch;
+                const optionIndent = indent.length;
+                const descIndent = optionIndent + option.length + 2;
+                // If the line is too long, wrap the description
+                if (line.length > width) {
+                    const wrappedDesc = this.wrapLine(description, descIndent);
+                    processedLines.push(`${indent}${option}  ${wrappedDesc}`);
+                }
+                else {
+                    processedLines.push(line);
+                }
+            }
+            else if (line.length > width) {
+                // For other long lines (like descriptions), wrap them
+                const leadingSpaces = line.match(/^(\s*)/)?.[1] || '';
+                const content = line.trim();
+                const wrapped = this.wrapLine(content, leadingSpaces.length);
+                processedLines.push(leadingSpaces + wrapped);
+            }
+            else {
+                processedLines.push(line);
+            }
+        }
+        return processedLines.join('\n');
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/ui/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"/","sources":["ui/help.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom Help formatter for Commander with width-aware text wrapping\n */\n\nimport { Help } from 'commander';\nimport { termWidth, wrapText } from './width.js';\n\nexport class WidthAwareHelp extends Help {\n  /**\n   * Get the terminal width with a max limit for readability\n   */\n  private getHelpWidth(): number {\n    // Cap at 100 chars for readability, even on ultra-wide terminals\n    return Math.min(termWidth(), 100);\n  }\n\n  /**\n   * Wrap text to fit terminal width\n   */\n  private wrapLine(text: string, indent = 0): string {\n    const width = this.getHelpWidth();\n    const effectiveWidth = Math.max(40, width - indent);\n    const lines = wrapText(text, effectiveWidth);\n    const indentStr = ' '.repeat(indent);\n    return lines.map((line, i) => i === 0 ? line : indentStr + line).join('\\n');\n  }\n\n  /**\n   * Override formatHelp to apply width-aware formatting\n   */\n  formatHelp(cmd: any, helper: Help): string {\n    const width = this.getHelpWidth();\n    \n    // Get the default help text\n    let helpText = super.formatHelp(cmd, helper);\n    \n    // Process each line to apply wrapping\n    const lines = helpText.split('\\n');\n    const processedLines: string[] = [];\n    \n    for (const line of lines) {\n      // Skip empty lines\n      if (line.trim() === '') {\n        processedLines.push(line);\n        continue;\n      }\n      \n      // Detect option/command lines (they start with spaces and contain two or more spaces for alignment)\n      const optionMatch = line.match(/^(\\s+)(\\S+)\\s{2,}(.*)$/);\n      if (optionMatch) {\n        const [, indent, option, description] = optionMatch;\n        const optionIndent = indent.length;\n        const descIndent = optionIndent + option.length + 2;\n        \n        // If the line is too long, wrap the description\n        if (line.length > width) {\n          const wrappedDesc = this.wrapLine(description, descIndent);\n          processedLines.push(`${indent}${option}  ${wrappedDesc}`);\n        } else {\n          processedLines.push(line);\n        }\n      } else if (line.length > width) {\n        // For other long lines (like descriptions), wrap them\n        const leadingSpaces = line.match(/^(\\s*)/)?.[1] || '';\n        const content = line.trim();\n        const wrapped = this.wrapLine(content, leadingSpaces.length);\n        processedLines.push(leadingSpaces + wrapped);\n      } else {\n        processedLines.push(line);\n      }\n    }\n    \n    return processedLines.join('\\n');\n  }\n\n\n}\n"]}

package/dist/ui/progress.js

@@ -0,0 +1,356 @@
+/**
+ * Unified progress indicator system
+ * Provides both determinate (bar) and indeterminate (spinner) progress indicators
+ */
+import { COLORS, SYMBOLS } from './theme.js';
+import { termWidth, truncate } from './width.js';
+/**
+ * Check if output format is machine-readable
+ */
+function isMachineFormat(format) {
+    const f = (format || '').toLowerCase();
+    return f === 'json' || f === 'alfred';
+}
+/**
+ * Check if we should show progress indicators
+ */
+function shouldShowProgress(format) {
+    // Don't show in non-TTY environments
+    if (!process.stderr.isTTY)
+        return false;
+    // Don't show for machine formats
+    if (format && isMachineFormat(format))
+        return false;
+    // Don't show in CI environments
+    if (process.env.CI)
+        return false;
+    // Don't show if NO_COLOR is set (indicates non-interactive)
+    if (process.env.NO_COLOR)
+        return false;
+    return true;
+}
+/**
+ * Spinner for indeterminate progress
+ * Shows animated spinner with updating label
+ */
+class Spinner {
+    format;
+    interval;
+    frame = 0;
+    frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    label = '';
+    lastLineLength = 0;
+    isActive = false;
+    stream = process.stderr;
+    constructor(label, format) {
+        this.format = format;
+        if (label)
+            this.label = label;
+    }
+    shouldShow() {
+        return shouldShowProgress(this.format);
+    }
+    start() {
+        if (!this.shouldShow() || this.isActive)
+            return;
+        this.isActive = true;
+        this.interval = setInterval(() => {
+            this.render();
+            this.frame = (this.frame + 1) % this.frames.length;
+        }, 80);
+    }
+    update(_value, label) {
+        // For spinner, we only care about label updates
+        if (label !== undefined) {
+            this.label = label;
+        }
+        if (!this.isActive) {
+            this.start();
+        }
+    }
+    stop() {
+        if (!this.isActive)
+            return;
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+        this.clear();
+        this.isActive = false;
+    }
+    complete(message) {
+        this.stop();
+        if (message && this.shouldShow()) {
+            this.stream.write(COLORS.success(`${SYMBOLS.success} ${message}\n`));
+        }
+    }
+    fail(message) {
+        this.stop();
+        if (message && this.shouldShow()) {
+            this.stream.write(COLORS.error(`${SYMBOLS.error} ${message}\n`));
+        }
+    }
+    clear() {
+        if (!this.stream.isTTY)
+            return;
+        this.stream.write('\r' + ' '.repeat(this.lastLineLength) + '\r');
+    }
+    render() {
+        if (!this.shouldShow() || !this.isActive)
+            return;
+        const spinner = COLORS.info(this.frames[this.frame]);
+        const line = this.label ? `${spinner} ${this.label}` : spinner;
+        this.clear();
+        this.stream.write(line);
+        this.lastLineLength = line.length;
+    }
+}
+/**
+ * Progress bar for determinate progress
+ * Shows percentage and optional counts
+ */
+class Bar {
+    current = 0;
+    total;
+    barWidth = 30;
+    label;
+    lastLineLength = 0;
+    isActive = false;
+    stream = process.stderr;
+    format;
+    constructor(options) {
+        this.total = options.total || 100;
+        this.label = options.label;
+        this.barWidth = options.barWidth || 30;
+        this.format = options.format;
+    }
+    shouldShow() {
+        return shouldShowProgress(this.format);
+    }
+    start() {
+        if (!this.shouldShow() || this.isActive)
+            return;
+        this.isActive = true;
+        this.render();
+    }
+    update(value, label) {
+        if (!this.isActive) {
+            this.start();
+        }
+        // For bar, value should be a number
+        if (typeof value === 'number') {
+            this.current = Math.min(value, this.total);
+        }
+        if (label !== undefined) {
+            this.label = label;
+        }
+        if (this.shouldShow() && this.isActive) {
+            this.render();
+        }
+    }
+    stop() {
+        if (!this.isActive)
+            return;
+        this.clear();
+        this.isActive = false;
+    }
+    complete(message) {
+        if (!this.shouldShow())
+            return;
+        this.current = this.total;
+        this.render();
+        this.clear();
+        if (message) {
+            this.stream.write(COLORS.success(`${SYMBOLS.success} ${message}\n`));
+        }
+        this.isActive = false;
+    }
+    fail(message) {
+        this.stop();
+        if (message && this.shouldShow()) {
+            this.stream.write(COLORS.error(`${SYMBOLS.error} ${message}\n`));
+        }
+    }
+    clear() {
+        if (!this.stream.isTTY)
+            return;
+        this.stream.write('\r' + ' '.repeat(this.lastLineLength) + '\r');
+    }
+    render() {
+        if (!this.shouldShow() || !this.isActive)
+            return;
+        const percentage = Math.round((this.current / this.total) * 100);
+        const filledLength = Math.round((this.current / this.total) * this.barWidth);
+        const emptyLength = this.barWidth - filledLength;
+        const filled = '█'.repeat(filledLength);
+        const empty = '░'.repeat(emptyLength);
+        const bar = `[${filled}${empty}]`;
+        const parts = [];
+        if (this.label) {
+            const maxLabelWidth = Math.max(20, termWidth() - this.barWidth - 20);
+            parts.push(truncate(this.label, maxLabelWidth));
+        }
+        parts.push(bar);
+        parts.push(`${percentage}%`);
+        parts.push(`(${this.current}/${this.total})`);
+        const line = parts.join(' ');
+        this.clear();
+        this.stream.write(line);
+        this.lastLineLength = line.length;
+    }
+}
+/**
+ * No-op progress for non-interactive environments
+ */
+class NoOpProgress {
+    update() { }
+    stop() { }
+    complete() { }
+    fail() { }
+}
+/**
+ * Main Progress API - factory methods for creating progress indicators
+ */
+export class Progress {
+    /**
+     * Create a spinner (indeterminate progress)
+     * Use for operations of unknown duration
+     */
+    static spinner(label, options) {
+        if (!shouldShowProgress(options?.format)) {
+            return new NoOpProgress();
+        }
+        const spinner = new Spinner(label, options?.format);
+        if (label) {
+            spinner.start();
+        }
+        return spinner;
+    }
+    /**
+     * Create a progress bar (determinate progress)
+     * Use when you know the total number of items
+     */
+    static bar(options) {
+        if (!shouldShowProgress(options.format)) {
+            return new NoOpProgress();
+        }
+        const bar = new Bar(options);
+        bar.start();
+        return bar;
+    }
+    /**
+     * Smart factory that creates appropriate progress type
+     * Creates bar if total is provided, spinner otherwise
+     */
+    static create(options) {
+        if (!options) {
+            return Progress.spinner();
+        }
+        if (options.total !== undefined && options.total > 0) {
+            return Progress.bar(options);
+        }
+        return Progress.spinner(options.label, options);
+    }
+}
+/**
+ * Helper for async operations with progress tracking
+ */
+export async function withProgress(operation, options) {
+    const progress = Progress.create(options);
+    try {
+        const result = await operation(progress);
+        progress.complete(options?.successMessage);
+        return result;
+    }
+    catch (error) {
+        progress.fail(error instanceof Error ? error.message : 'Operation failed');
+        throw error;
+    }
+}
+// ============================================================================
+// Legacy API - for backward compatibility during migration
+// ============================================================================
+/**
+ * @deprecated Use Progress.bar() instead
+ */
+export class ProgressBar {
+    progress;
+    constructor(options) {
+        this.progress = Progress.bar({
+            total: options.total,
+            label: options.label,
+            format: options.format
+        });
+    }
+    start() {
+        // Already started in constructor
+    }
+    update(value, label) {
+        this.progress.update(value, label);
+    }
+    stop() {
+        this.progress.stop();
+    }
+    complete(message) {
+        this.progress.complete(message);
+    }
+}
+/**
+ * @deprecated Use Progress.spinner() instead
+ */
+export class IndeterminateProgress {
+    progress;
+    constructor(label, format) {
+        this.progress = Progress.spinner(label, { format });
+    }
+    start() {
+        // Already started if label provided
+    }
+    updateLabel(label) {
+        this.progress.update(label, label);
+    }
+    stop() {
+        this.progress.stop();
+    }
+    complete(message) {
+        this.progress.complete(message);
+    }
+}
+/**
+ * @deprecated Use withProgress() instead
+ */
+export async function withCountedProgress(items, operation, options = {}) {
+    if (!items || items.length === 0) {
+        return;
+    }
+    const progress = Progress.bar({
+        total: items.length,
+        label: options.label || 'Processing',
+        format: options.format
+    });
+    try {
+        for (let i = 0; i < items.length; i++) {
+            const label = options.itemLabel ?
+                options.itemLabel(items[i], i) :
+                `Processing item ${i + 1}/${items.length}`;
+            progress.update(i, label);
+            await operation(items[i], i);
+        }
+        progress.update(items.length, 'Complete');
+        const completeMessage = options.onComplete ?
+            options.onComplete(items.length) :
+            `Processed ${items.length} items`;
+        progress.complete(completeMessage);
+    }
+    catch (error) {
+        progress.stop();
+        throw error;
+    }
+}
+/**
+ * @deprecated Use withProgress() instead
+ */
+export async function withIndeterminateProgress(operation, label, format, successMessage) {
+    return withProgress(operation, { label, format, successMessage });
+}
+//# sourceMappingURL=progress.js.map