specweave 0.6.8 → 0.7.1

package/dist/cli/commands/status.js

@@ -0,0 +1,23 @@
+import { showStatus } from '../../core/increment/status-commands.js';
+/**
+ * CLI command to show increment status overview
+ *
+ * @param options - Command options (verbose, type filter)
+ */
+export async function statusCommand(options = {}) {
+    const statusOptions = {
+        verbose: options.verbose
+    };
+    // Validate and convert type if provided
+    if (options.type) {
+        const validTypes = ['feature', 'hotfix', 'bug', 'change-request', 'refactor', 'experiment'];
+        if (!validTypes.includes(options.type)) {
+            console.error(`Invalid type: ${options.type}`);
+            console.error(`Valid types: ${validTypes.join(', ')}`);
+            process.exit(1);
+        }
+        statusOptions.type = options.type;
+    }
+    await showStatus(statusOptions);
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,yCAAyC,CAAC;AAQpF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,aAAa,GAAkB;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IAEF,wCAAwC;IACxC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,UAAU,GAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QACtG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,iBAAiB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,gBAAgB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,aAAa,CAAC,IAAI,GAAG,OAAO,CAAC,IAAqB,CAAC;IACrD,CAAC;IAED,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,CAAC"}

package/dist/cli/helpers/issue-tracker/ado.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Azure DevOps Integration for Issue Tracker Setup
+ *
+ * Handles Azure DevOps authentication and connection validation
+ *
+ * @module cli/helpers/issue-tracker/ado
+ */
+import type { AzureDevOpsCredentials, ExistingCredentials, ValidationResult } from './types.js';
+import type { SupportedLanguage } from '../../../core/i18n/types.js';
+/**
+ * Check for existing Azure DevOps credentials
+ *
+ * @param projectPath - Path to project root
+ * @returns Existing credentials or null
+ */
+export declare function checkExistingAzureDevOpsCredentials(projectPath: string): Promise<ExistingCredentials | null>;
+/**
+ * Prompt user for Azure DevOps credentials
+ *
+ * @param language - User's language
+ * @returns Credentials or null if skipped
+ */
+export declare function promptAzureDevOpsCredentials(language: SupportedLanguage): Promise<AzureDevOpsCredentials | null>;
+/**
+ * Validate Azure DevOps connection
+ *
+ * Tests authentication and returns project information
+ * Handles rate limiting with retry logic
+ *
+ * @param credentials - Azure DevOps credentials
+ * @param maxRetries - Maximum retry attempts (default: 3)
+ * @returns Validation result
+ */
+export declare function validateAzureDevOpsConnection(credentials: AzureDevOpsCredentials, maxRetries?: number): Promise<ValidationResult>;
+/**
+ * Get Azure DevOps environment variables for .env file
+ *
+ * @param credentials - Azure DevOps credentials
+ * @returns Array of key-value pairs for .env
+ */
+export declare function getAzureDevOpsEnvVars(credentials: AzureDevOpsCredentials): Array<{
+    key: string;
+    value: string;
+}>;
+/**
+ * Show Azure DevOps setup complete message
+ *
+ * @param language - User's language
+ */
+export declare function showAzureDevOpsSetupComplete(language: SupportedLanguage): void;
+/**
+ * Show Azure DevOps setup skipped message
+ *
+ * @param language - User's language
+ */
+export declare function showAzureDevOpsSetupSkipped(language: SupportedLanguage): void;
+//# sourceMappingURL=ado.d.ts.map

package/dist/cli/helpers/issue-tracker/ado.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/issue-tracker/ado.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE;;;;;GAKG;AACH,wBAAsB,mCAAmC,CACvD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA2BrC;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAyExC;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,sBAAsB,EACnC,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA+D3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,sBAAsB,GAClC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAMvC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAO7E"}

package/dist/cli/helpers/issue-tracker/ado.js

@@ -0,0 +1,223 @@
+/**
+ * Azure DevOps Integration for Issue Tracker Setup
+ *
+ * Handles Azure DevOps authentication and connection validation
+ *
+ * @module cli/helpers/issue-tracker/ado
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { getAzureDevOpsAuth } from '../../../utils/auth-helpers.js';
+import { parseEnvFile, readEnvFile } from '../../../utils/env-file.js';
+import { retryWithBackoff, checkRateLimit } from './utils.js';
+import { getLocaleManager } from '../../../core/i18n/locale-manager.js';
+import { RateLimitError } from './types.js';
+/**
+ * Check for existing Azure DevOps credentials
+ *
+ * @param projectPath - Path to project root
+ * @returns Existing credentials or null
+ */
+export async function checkExistingAzureDevOpsCredentials(projectPath) {
+    // 1. Check project .env file
+    const envContent = readEnvFile(projectPath);
+    if (envContent) {
+        const parsed = parseEnvFile(envContent);
+        if (parsed.AZURE_DEVOPS_PAT && parsed.AZURE_DEVOPS_ORG && parsed.AZURE_DEVOPS_PROJECT) {
+            return {
+                source: '.env',
+                credentials: {
+                    pat: parsed.AZURE_DEVOPS_PAT,
+                    org: parsed.AZURE_DEVOPS_ORG,
+                    project: parsed.AZURE_DEVOPS_PROJECT
+                }
+            };
+        }
+    }
+    // 2. Check environment variables
+    const auth = getAzureDevOpsAuth();
+    if (auth) {
+        return {
+            source: 'env-vars',
+            credentials: auth
+        };
+    }
+    return null;
+}
+/**
+ * Prompt user for Azure DevOps credentials
+ *
+ * @param language - User's language
+ * @returns Credentials or null if skipped
+ */
+export async function promptAzureDevOpsCredentials(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.white('\n📋 Azure DevOps Integration Setup\n'));
+    console.log(chalk.gray('SpecWeave will sync increments with Azure DevOps Work Items.\n'));
+    // Show setup instructions
+    console.log(chalk.cyan('📋 Quick Setup:'));
+    console.log(chalk.gray('   1. Go to: https://dev.azure.com/{org}/_usersSettings/tokens'));
+    console.log(chalk.gray('   2. Click "New Token"'));
+    console.log(chalk.gray('   3. Scopes: Work Items (Read, Write, Manage), Code (Read), Project (Read)'));
+    console.log(chalk.gray('   4. Copy the token\n'));
+    const { continueSetup } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'continueSetup',
+            message: 'Continue with Azure DevOps setup?',
+            default: true
+        }]);
+    if (!continueSetup) {
+        return null;
+    }
+    // Collect credentials
+    const questions = [
+        {
+            type: 'input',
+            name: 'org',
+            message: 'Azure DevOps organization name:',
+            validate: (input) => {
+                if (!input || input.trim() === '') {
+                    return 'Organization cannot be empty';
+                }
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'project',
+            message: 'Project name:',
+            validate: (input) => {
+                if (!input || input.trim() === '') {
+                    return 'Project cannot be empty';
+                }
+                return true;
+            }
+        },
+        {
+            type: 'password',
+            name: 'pat',
+            message: 'Paste your Personal Access Token:',
+            mask: '*',
+            validate: (input) => {
+                if (!input || input.length === 0) {
+                    return 'Token cannot be empty';
+                }
+                // ADO PATs are typically 52 characters, but fine-grained tokens can be >= 40
+                if (input.length < 40) {
+                    return 'Azure DevOps tokens should be at least 40 characters';
+                }
+                return true;
+            }
+        }
+    ];
+    const answers = await inquirer.prompt(questions);
+    return {
+        pat: answers.pat,
+        org: answers.org,
+        project: answers.project
+    };
+}
+/**
+ * Validate Azure DevOps connection
+ *
+ * Tests authentication and returns project information
+ * Handles rate limiting with retry logic
+ *
+ * @param credentials - Azure DevOps credentials
+ * @param maxRetries - Maximum retry attempts (default: 3)
+ * @returns Validation result
+ */
+export async function validateAzureDevOpsConnection(credentials, maxRetries = 3) {
+    const spinner = ora('Testing connection...').start();
+    try {
+        const result = await retryWithBackoff(async () => {
+            // Test connection by fetching project details
+            const projectEndpoint = `https://dev.azure.com/${credentials.org}/_apis/projects/${credentials.project}?api-version=7.0`;
+            // Basic auth with PAT (username can be empty)
+            const auth = Buffer.from(`:${credentials.pat}`).toString('base64');
+            const response = await fetch(projectEndpoint, {
+                headers: {
+                    'Authorization': `Basic ${auth}`,
+                    'Accept': 'application/json'
+                }
+            });
+            // Check for rate limiting
+            const rateLimitInfo = checkRateLimit(response);
+            if (rateLimitInfo) {
+                throw new RateLimitError('Azure DevOps API rate limit exceeded', rateLimitInfo);
+            }
+            if (!response.ok) {
+                const errorText = await response.text();
+                let errorMessage = 'Authentication failed';
+                if (response.status === 401) {
+                    errorMessage = 'Invalid Personal Access Token';
+                }
+                else if (response.status === 403) {
+                    errorMessage = 'Access forbidden (check token scopes)';
+                }
+                else if (response.status === 404) {
+                    errorMessage = 'Project not found (check organization and project name)';
+                }
+                else {
+                    errorMessage = `HTTP ${response.status}: ${errorText}`;
+                }
+                throw new Error(errorMessage);
+            }
+            const project = await response.json();
+            return project;
+        }, maxRetries);
+        spinner.succeed(`Connected to Azure DevOps project: ${result.name}`);
+        return {
+            success: true,
+            username: result.name
+        };
+    }
+    catch (error) {
+        spinner.fail('Azure DevOps authentication failed');
+        return {
+            success: false,
+            error: error.message || 'Unknown error'
+        };
+    }
+}
+/**
+ * Get Azure DevOps environment variables for .env file
+ *
+ * @param credentials - Azure DevOps credentials
+ * @returns Array of key-value pairs for .env
+ */
+export function getAzureDevOpsEnvVars(credentials) {
+    return [
+        { key: 'AZURE_DEVOPS_PAT', value: credentials.pat },
+        { key: 'AZURE_DEVOPS_ORG', value: credentials.org },
+        { key: 'AZURE_DEVOPS_PROJECT', value: credentials.project }
+    ];
+}
+/**
+ * Show Azure DevOps setup complete message
+ *
+ * @param language - User's language
+ */
+export function showAzureDevOpsSetupComplete(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.green.bold('\n✅ Azure DevOps integration complete!\n'));
+    console.log(chalk.white('Available commands:'));
+    console.log(chalk.gray('  /specweave-ado:sync'));
+    console.log(chalk.gray('  /specweave-ado:status\n'));
+    console.log(chalk.cyan('💡 Tip: Use /specweave:inc "feature" to create an increment'));
+    console.log(chalk.gray('   It will automatically sync to Azure DevOps Work Items!\n'));
+}
+/**
+ * Show Azure DevOps setup skipped message
+ *
+ * @param language - User's language
+ */
+export function showAzureDevOpsSetupSkipped(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.yellow('\n⏭️  Skipped Azure DevOps setup\n'));
+    console.log(chalk.white('You can configure later:'));
+    console.log(chalk.gray('  1. Add AZURE_DEVOPS_PAT, AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT to .env'));
+    console.log(chalk.gray('  2. Install plugin: /plugin install specweave-ado@specweave\n'));
+}
+//# sourceMappingURL=ado.js.map

package/dist/cli/helpers/issue-tracker/ado.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado.js","sourceRoot":"","sources":["../../../../src/cli/helpers/issue-tracker/ado.ts"],"names":[],"mappings":"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"}

package/dist/cli/helpers/issue-tracker/github.d.ts

@@ -0,0 +1,65 @@
+/**
+ * GitHub Integration for Issue Tracker Setup
+ *
+ * Handles GitHub.com and GitHub Enterprise authentication
+ * Supports manual token entry and gh CLI auto-detection
+ *
+ * @module cli/helpers/issue-tracker/github
+ */
+import type { GitHubCredentials, ExistingCredentials, ValidationResult } from './types.js';
+import type { SupportedLanguage } from '../../../core/i18n/types.js';
+/**
+ * Check for existing GitHub credentials
+ *
+ * Priority: .env > GH_TOKEN > GITHUB_TOKEN > gh CLI config
+ *
+ * @param projectPath - Path to project root
+ * @returns Existing credentials or null
+ */
+export declare function checkExistingGitHubCredentials(projectPath: string): Promise<ExistingCredentials | null>;
+/**
+ * Prompt user for GitHub credentials
+ *
+ * Supports:
+ * - Manual token entry
+ * - gh CLI auto-detection
+ * - GitHub.com vs GitHub Enterprise selection
+ *
+ * @param language - User's language
+ * @returns Credentials or null if skipped
+ */
+export declare function promptGitHubCredentials(language: SupportedLanguage): Promise<GitHubCredentials | null>;
+/**
+ * Validate GitHub connection
+ *
+ * Tests authentication and returns user information
+ * Handles rate limiting with retry logic
+ *
+ * @param credentials - GitHub credentials
+ * @param maxRetries - Maximum retry attempts (default: 3)
+ * @returns Validation result
+ */
+export declare function validateGitHubConnection(credentials: GitHubCredentials, maxRetries?: number): Promise<ValidationResult>;
+/**
+ * Get GitHub environment variables for .env file
+ *
+ * @param credentials - GitHub credentials
+ * @returns Array of key-value pairs for .env
+ */
+export declare function getGitHubEnvVars(credentials: GitHubCredentials): Array<{
+    key: string;
+    value: string;
+}>;
+/**
+ * Show GitHub setup complete message
+ *
+ * @param language - User's language
+ */
+export declare function showGitHubSetupComplete(language: SupportedLanguage): void;
+/**
+ * Show GitHub setup skipped message
+ *
+ * @param language - User's language
+ */
+export declare function showGitHubSetupSkipped(language: SupportedLanguage): void;
+//# sourceMappingURL=github.d.ts.map

package/dist/cli/helpers/issue-tracker/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/issue-tracker/github.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAOpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA6BrC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAoInC;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,iBAAiB,EAC9B,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA2D3B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAWzE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAOxE"}

package/dist/cli/helpers/issue-tracker/github.js

@@ -0,0 +1,284 @@
+/**
+ * GitHub Integration for Issue Tracker Setup
+ *
+ * Handles GitHub.com and GitHub Enterprise authentication
+ * Supports manual token entry and gh CLI auto-detection
+ *
+ * @module cli/helpers/issue-tracker/github
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { getGitHubAuth } from '../../../utils/auth-helpers.js';
+import { parseEnvFile, readEnvFile } from '../../../utils/env-file.js';
+import { isGhCliAvailable, retryWithBackoff, checkRateLimit } from './utils.js';
+import { getLocaleManager } from '../../../core/i18n/locale-manager.js';
+import { RateLimitError } from './types.js';
+/**
+ * Check for existing GitHub credentials
+ *
+ * Priority: .env > GH_TOKEN > GITHUB_TOKEN > gh CLI config
+ *
+ * @param projectPath - Path to project root
+ * @returns Existing credentials or null
+ */
+export async function checkExistingGitHubCredentials(projectPath) {
+    // 1. Check project .env file
+    const envContent = readEnvFile(projectPath);
+    if (envContent) {
+        const parsed = parseEnvFile(envContent);
+        if (parsed.GH_TOKEN) {
+            return {
+                source: '.env',
+                credentials: {
+                    token: parsed.GH_TOKEN,
+                    instanceType: 'cloud' // Assume cloud unless specified
+                }
+            };
+        }
+    }
+    // 2. Check environment variables and gh CLI
+    const auth = getGitHubAuth();
+    if (auth.source !== 'none') {
+        return {
+            source: auth.source,
+            credentials: {
+                token: auth.token,
+                instanceType: 'cloud'
+            }
+        };
+    }
+    return null;
+}
+/**
+ * Prompt user for GitHub credentials
+ *
+ * Supports:
+ * - Manual token entry
+ * - gh CLI auto-detection
+ * - GitHub.com vs GitHub Enterprise selection
+ *
+ * @param language - User's language
+ * @returns Credentials or null if skipped
+ */
+export async function promptGitHubCredentials(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.white('\n📋 GitHub Integration Setup\n'));
+    console.log(chalk.gray('SpecWeave will sync increments with GitHub Issues.\n'));
+    // Step 1: Ask about instance type (Cloud vs Enterprise)
+    const { instanceType } = await inquirer.prompt([{
+            type: 'list',
+            name: 'instanceType',
+            message: 'Which GitHub instance are you using?',
+            choices: [
+                { name: 'GitHub.com (cloud)', value: 'cloud' },
+                { name: 'GitHub Enterprise (self-hosted)', value: 'enterprise' }
+            ],
+            default: 'cloud'
+        }]);
+    let apiEndpoint;
+    // Step 2: If Enterprise, ask for API endpoint
+    if (instanceType === 'enterprise') {
+        console.log(chalk.gray('\nGitHub Enterprise requires a custom API endpoint.\n'));
+        const { endpoint } = await inquirer.prompt([{
+                type: 'input',
+                name: 'endpoint',
+                message: 'GitHub Enterprise API endpoint:',
+                default: 'https://github.company.com/api/v3',
+                validate: (input) => {
+                    if (!input.startsWith('https://')) {
+                        return 'API endpoint must use HTTPS (http:// is not secure)';
+                    }
+                    return true;
+                }
+            }]);
+        apiEndpoint = endpoint;
+    }
+    // Step 3: Show setup instructions
+    console.log(chalk.cyan('\n📋 Quick Setup:'));
+    if (instanceType === 'cloud') {
+        console.log(chalk.gray('   1. Go to: https://github.com/settings/tokens/new'));
+    }
+    else {
+        console.log(chalk.gray(`   1. Go to: ${apiEndpoint}/settings/tokens/new`));
+    }
+    console.log(chalk.gray('   2. Token name: "SpecWeave - [your-project]"'));
+    console.log(chalk.gray('   3. Scopes needed: ☑ repo, ☑ workflow'));
+    console.log(chalk.gray('   4. Click "Generate token"'));
+    console.log(chalk.gray('   5. Copy the token (ghp_...)\n'));
+    // Step 4: Check if gh CLI is available (only for GitHub.com)
+    const ghCliAvailable = instanceType === 'cloud' && await isGhCliAvailable();
+    const choices = [
+        { name: 'Enter token manually', value: 'manual' },
+        ...(ghCliAvailable ? [{ name: 'Use gh CLI (auto-detect)', value: 'gh-cli' }] : []),
+        { name: 'Skip for now', value: 'skip' }
+    ];
+    const { method } = await inquirer.prompt([{
+            type: 'list',
+            name: 'method',
+            message: 'How would you like to authenticate?',
+            choices
+        }]);
+    if (method === 'skip') {
+        return null;
+    }
+    // Step 5: Get token based on method
+    let token;
+    if (method === 'gh-cli') {
+        const auth = getGitHubAuth();
+        if (auth.source === 'gh-cli') {
+            console.log(chalk.green('✓ Found gh CLI token'));
+            token = auth.token;
+        }
+        else {
+            console.log(chalk.red('❌ Could not detect gh CLI token'));
+            console.log(chalk.yellow('   Make sure you\'re logged in: gh auth login\n'));
+            // Fallback to manual entry
+            const { retryMethod } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'retryMethod',
+                    message: 'What would you like to do?',
+                    choices: [
+                        { name: 'Enter token manually', value: 'manual' },
+                        { name: 'Skip for now', value: 'skip' }
+                    ]
+                }]);
+            if (retryMethod === 'skip') {
+                return null;
+            }
+            // Fall through to manual entry
+        }
+    }
+    // Manual token entry
+    if (method === 'manual' || !token) {
+        const { manualToken } = await inquirer.prompt([{
+                type: 'password',
+                name: 'manualToken',
+                message: 'Paste your GitHub token:',
+                mask: '*',
+                validate: (input) => {
+                    if (!input || input.length < 20) {
+                        return 'Invalid token format (should be at least 20 characters)';
+                    }
+                    // GitHub tokens start with ghp_ (classic) or github_pat_ (fine-grained)
+                    if (instanceType === 'cloud') {
+                        if (!input.startsWith('ghp_') && !input.startsWith('github_pat_')) {
+                            return 'GitHub tokens typically start with "ghp_" or "github_pat_"';
+                        }
+                    }
+                    return true;
+                }
+            }]);
+        token = manualToken;
+    }
+    return {
+        token,
+        instanceType: instanceType,
+        apiEndpoint
+    };
+}
+/**
+ * Validate GitHub connection
+ *
+ * Tests authentication and returns user information
+ * Handles rate limiting with retry logic
+ *
+ * @param credentials - GitHub credentials
+ * @param maxRetries - Maximum retry attempts (default: 3)
+ * @returns Validation result
+ */
+export async function validateGitHubConnection(credentials, maxRetries = 3) {
+    const spinner = ora('Testing connection...').start();
+    try {
+        const result = await retryWithBackoff(async () => {
+            // Determine API endpoint
+            const apiBase = credentials.apiEndpoint || 'https://api.github.com';
+            const userEndpoint = `${apiBase}/user`;
+            const response = await fetch(userEndpoint, {
+                headers: {
+                    'Authorization': `Bearer ${credentials.token}`,
+                    'Accept': 'application/vnd.github+json',
+                    'X-GitHub-Api-Version': '2022-11-28'
+                }
+            });
+            // Check for rate limiting
+            const rateLimitInfo = checkRateLimit(response);
+            if (rateLimitInfo) {
+                throw new RateLimitError('GitHub API rate limit exceeded', rateLimitInfo);
+            }
+            if (!response.ok) {
+                const errorText = await response.text();
+                let errorMessage = 'Authentication failed';
+                if (response.status === 401) {
+                    errorMessage = 'Invalid authentication credentials';
+                }
+                else if (response.status === 403) {
+                    errorMessage = 'Access forbidden (check token scopes)';
+                }
+                else {
+                    errorMessage = `HTTP ${response.status}: ${errorText}`;
+                }
+                throw new Error(errorMessage);
+            }
+            const user = await response.json();
+            return user;
+        }, maxRetries);
+        spinner.succeed(`Connected to GitHub as @${result.login}`);
+        return {
+            success: true,
+            username: result.login
+        };
+    }
+    catch (error) {
+        spinner.fail('GitHub authentication failed');
+        return {
+            success: false,
+            error: error.message || 'Unknown error'
+        };
+    }
+}
+/**
+ * Get GitHub environment variables for .env file
+ *
+ * @param credentials - GitHub credentials
+ * @returns Array of key-value pairs for .env
+ */
+export function getGitHubEnvVars(credentials) {
+    const vars = [
+        { key: 'GH_TOKEN', value: credentials.token }
+    ];
+    // Add Enterprise-specific variables
+    if (credentials.instanceType === 'enterprise' && credentials.apiEndpoint) {
+        vars.push({ key: 'GITHUB_API_URL', value: credentials.apiEndpoint });
+    }
+    return vars;
+}
+/**
+ * Show GitHub setup complete message
+ *
+ * @param language - User's language
+ */
+export function showGitHubSetupComplete(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.green.bold('\n✅ GitHub integration complete!\n'));
+    console.log(chalk.white('Available commands:'));
+    console.log(chalk.gray('  /specweave-github:create-issue'));
+    console.log(chalk.gray('  /specweave-github:sync'));
+    console.log(chalk.gray('  /specweave-github:close-issue'));
+    console.log(chalk.gray('  /specweave-github:status\n'));
+    console.log(chalk.cyan('💡 Tip: Use /specweave:inc "feature" to create an increment'));
+    console.log(chalk.gray('   It will automatically sync to GitHub Issues!\n'));
+}
+/**
+ * Show GitHub setup skipped message
+ *
+ * @param language - User's language
+ */
+export function showGitHubSetupSkipped(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.yellow('\n⏭️  Skipped GitHub setup\n'));
+    console.log(chalk.white('You can configure later:'));
+    console.log(chalk.gray('  1. Add GH_TOKEN to .env file'));
+    console.log(chalk.gray('  2. Install plugin: /plugin install specweave-github@specweave\n'));
+}
+//# sourceMappingURL=github.js.map