specweave 0.6.8 → 0.7.0

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Issue Tracker Integration - Main Coordinator
+ *
+ * Guides users through issue tracker setup during `specweave init`
+ * Supports GitHub, Jira, and Azure DevOps
+ *
+ * @module cli/helpers/issue-tracker
+ */
+import type { SetupOptions } from './types.js';
+/**
+ * Setup issue tracker integration during init
+ *
+ * Main entry point called from init.ts
+ * Guides user through tracker selection and setup
+ *
+ * @param options - Setup options
+ * @returns True if setup completed successfully
+ */
+export declare function setupIssueTracker(options: SetupOptions): Promise<boolean>;
+export * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/issue-tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAoC,YAAY,EAAE,MAAM,YAAY,CAAC;AAyCjF;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CA+H/E;AAmKD,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,270 @@
+/**
+ * Issue Tracker Integration - Main Coordinator
+ *
+ * Guides users through issue tracker setup during `specweave init`
+ * Supports GitHub, Jira, and Azure DevOps
+ *
+ * @module cli/helpers/issue-tracker
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { detectDefaultTracker, getTrackerDisplayName, installTrackerPlugin, isClaudeCliAvailable } from './utils.js';
+import { readEnvFile, writeEnvFile, createEnvFromTemplate, updateEnvVars, ensureEnvGitignored } from '../../../utils/env-file.js';
+import { getLocaleManager } from '../../../core/i18n/locale-manager.js';
+// GitHub
+import { checkExistingGitHubCredentials, promptGitHubCredentials, validateGitHubConnection, getGitHubEnvVars, showGitHubSetupComplete, showGitHubSetupSkipped } from './github.js';
+// Jira
+import { checkExistingJiraCredentials, promptJiraCredentials, validateJiraConnection, getJiraEnvVars, showJiraSetupComplete, showJiraSetupSkipped } from './jira.js';
+// Azure DevOps
+import { checkExistingAzureDevOpsCredentials, promptAzureDevOpsCredentials, validateAzureDevOpsConnection, getAzureDevOpsEnvVars, showAzureDevOpsSetupComplete, showAzureDevOpsSetupSkipped } from './ado.js';
+/**
+ * Setup issue tracker integration during init
+ *
+ * Main entry point called from init.ts
+ * Guides user through tracker selection and setup
+ *
+ * @param options - Setup options
+ * @returns True if setup completed successfully
+ */
+export async function setupIssueTracker(options) {
+    const { projectPath, language, maxRetries = 3 } = options;
+    const locale = getLocaleManager(language);
+    // Check if running in CI/non-interactive environment
+    const isCI = process.env.CI === 'true' ||
+        process.env.GITHUB_ACTIONS === 'true' ||
+        process.env.GITLAB_CI === 'true' ||
+        process.env.CIRCLECI === 'true' ||
+        !process.stdin.isTTY;
+    if (isCI) {
+        // In CI, skip issue tracker setup (non-interactive)
+        console.log('');
+        console.log(chalk.gray('⏭️  CI environment detected - skipping issue tracker setup'));
+        console.log(chalk.gray('   You can configure later via /plugin install\n'));
+        return true;
+    }
+    console.log('');
+    console.log(chalk.cyan.bold('🎯 Issue Tracker Integration'));
+    console.log('');
+    // Step 1: Ask which tracker to use
+    const defaultTracker = detectDefaultTracker(projectPath);
+    const { tracker } = await inquirer.prompt([{
+            type: 'list',
+            name: 'tracker',
+            message: 'Which issue tracker do you use?',
+            choices: [
+                {
+                    name: `🐙 GitHub Issues ${defaultTracker === 'github' ? '(detected)' : ''}`,
+                    value: 'github'
+                },
+                {
+                    name: `📋 Jira`,
+                    value: 'jira'
+                },
+                {
+                    name: `🔷 Azure DevOps ${defaultTracker === 'ado' ? '(detected)' : ''}`,
+                    value: 'ado'
+                },
+                {
+                    name: '⏭️  None (skip)',
+                    value: 'none'
+                }
+            ],
+            default: defaultTracker
+        }]);
+    if (tracker === 'none') {
+        console.log(chalk.gray('\n⏭️  Skipping issue tracker setup'));
+        console.log(chalk.gray('   You can configure later via /plugin install\n'));
+        return true;
+    }
+    // Step 2: Check for existing credentials
+    const existing = await checkExistingCredentials(tracker, projectPath);
+    if (existing) {
+        console.log(chalk.green(`\n✓ Found existing credentials (${existing.source})`));
+        const { useExisting } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'useExisting',
+                message: `Use existing ${getTrackerDisplayName(tracker)} credentials?`,
+                default: true
+            }]);
+        if (useExisting) {
+            // Validate existing credentials
+            const validationResult = await validateConnection(tracker, existing.credentials, maxRetries);
+            if (validationResult.success) {
+                // Install plugin
+                await installPlugin(tracker, language);
+                showSetupComplete(tracker, language);
+                return true;
+            }
+            else {
+                console.log(chalk.red(`\n❌ Validation failed: ${validationResult.error}`));
+                console.log(chalk.yellow('   Let\'s configure new credentials\n'));
+                // Fall through to prompt for new credentials
+            }
+        }
+    }
+    // Step 3: Prompt for credentials
+    const credentials = await promptCredentials(tracker, language);
+    if (!credentials) {
+        showSetupSkipped(tracker, language);
+        return false;
+    }
+    // Step 4: Validate connection
+    const validationResult = await validateConnection(tracker, credentials, maxRetries);
+    if (!validationResult.success) {
+        console.log(chalk.red(`\n❌ Connection failed: ${validationResult.error}\n`));
+        const { retry } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'retry',
+                message: 'Try again?',
+                default: true
+            }]);
+        if (retry) {
+            // Recursive retry (will respect maxRetries in validation)
+            return setupIssueTracker(options);
+        }
+        showSetupSkipped(tracker, language);
+        return false;
+    }
+    // Step 5: Save credentials to .env
+    await saveCredentials(projectPath, tracker, credentials);
+    // Step 6: Install plugin
+    await installPlugin(tracker, language);
+    // Step 7: Show success message
+    showSetupComplete(tracker, language);
+    return true;
+}
+/**
+ * Check for existing credentials
+ */
+async function checkExistingCredentials(tracker, projectPath) {
+    switch (tracker) {
+        case 'github':
+            return checkExistingGitHubCredentials(projectPath);
+        case 'jira':
+            return checkExistingJiraCredentials(projectPath);
+        case 'ado':
+            return checkExistingAzureDevOpsCredentials(projectPath);
+        default:
+            return null;
+    }
+}
+/**
+ * Prompt for credentials
+ */
+async function promptCredentials(tracker, language) {
+    switch (tracker) {
+        case 'github':
+            return promptGitHubCredentials(language);
+        case 'jira':
+            return promptJiraCredentials(language);
+        case 'ado':
+            return promptAzureDevOpsCredentials(language);
+        default:
+            return null;
+    }
+}
+/**
+ * Validate connection
+ */
+async function validateConnection(tracker, credentials, maxRetries) {
+    switch (tracker) {
+        case 'github':
+            return validateGitHubConnection(credentials, maxRetries);
+        case 'jira':
+            return validateJiraConnection(credentials, maxRetries);
+        case 'ado':
+            return validateAzureDevOpsConnection(credentials, maxRetries);
+        default:
+            return { success: false, error: 'Unknown tracker' };
+    }
+}
+/**
+ * Save credentials to .env file
+ */
+async function saveCredentials(projectPath, tracker, credentials) {
+    // Read existing .env or create from template
+    let envContent = readEnvFile(projectPath);
+    if (!envContent) {
+        envContent = createEnvFromTemplate(projectPath);
+    }
+    // Get tracker-specific env vars
+    let envVars = [];
+    switch (tracker) {
+        case 'github':
+            envVars = getGitHubEnvVars(credentials);
+            break;
+        case 'jira':
+            envVars = getJiraEnvVars(credentials);
+            break;
+        case 'ado':
+            envVars = getAzureDevOpsEnvVars(credentials);
+            break;
+    }
+    // Update .env content
+    const updatedContent = updateEnvVars(envContent, envVars);
+    // Write .env file
+    writeEnvFile(projectPath, updatedContent);
+    // Ensure .env is gitignored
+    ensureEnvGitignored(projectPath);
+    console.log(chalk.green('✓ Credentials saved to .env (gitignored)'));
+}
+/**
+ * Install tracker plugin
+ */
+async function installPlugin(tracker, language) {
+    const spinner = ora(`Installing ${getTrackerDisplayName(tracker)} plugin...`).start();
+    // Check if Claude CLI is available
+    if (!isClaudeCliAvailable()) {
+        spinner.warn('Claude CLI not found');
+        console.log(chalk.yellow('\n📦 Manual plugin installation required:'));
+        console.log(chalk.white(`   /plugin install specweave-${tracker}@specweave\n`));
+        return;
+    }
+    // Install plugin
+    const success = installTrackerPlugin(tracker);
+    if (success) {
+        spinner.succeed(`${getTrackerDisplayName(tracker)} plugin installed`);
+    }
+    else {
+        spinner.fail(`Could not auto-install plugin`);
+        console.log(chalk.yellow('\n📦 Manual plugin installation:'));
+        console.log(chalk.white(`   /plugin install specweave-${tracker}@specweave\n`));
+    }
+}
+/**
+ * Show setup complete message
+ */
+function showSetupComplete(tracker, language) {
+    switch (tracker) {
+        case 'github':
+            showGitHubSetupComplete(language);
+            break;
+        case 'jira':
+            showJiraSetupComplete(language);
+            break;
+        case 'ado':
+            showAzureDevOpsSetupComplete(language);
+            break;
+    }
+}
+/**
+ * Show setup skipped message
+ */
+function showSetupSkipped(tracker, language) {
+    switch (tracker) {
+        case 'github':
+            showGitHubSetupSkipped(language);
+            break;
+        case 'jira':
+            showJiraSetupSkipped(language);
+            break;
+        case 'ado':
+            showAzureDevOpsSetupSkipped(language);
+            break;
+    }
+}
+// Export all types and utilities for external use
+export * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * Jira Integration for Issue Tracker Setup
+ *
+ * Handles Jira Cloud and Jira Server/Data Center authentication
+ *
+ * @module cli/helpers/issue-tracker/jira
+ */
+import type { JiraCredentials, ExistingCredentials, ValidationResult } from './types.js';
+import type { SupportedLanguage } from '../../../core/i18n/types.js';
+/**
+ * Check for existing Jira credentials
+ *
+ * @param projectPath - Path to project root
+ * @returns Existing credentials or null
+ */
+export declare function checkExistingJiraCredentials(projectPath: string): Promise<ExistingCredentials | null>;
+/**
+ * Prompt user for Jira credentials
+ *
+ * Supports:
+ * - Jira Cloud (atlassian.net)
+ * - Jira Server/Data Center (self-hosted)
+ *
+ * @param language - User's language
+ * @returns Credentials or null if skipped
+ */
+export declare function promptJiraCredentials(language: SupportedLanguage): Promise<JiraCredentials | null>;
+/**
+ * Validate Jira connection
+ *
+ * Tests authentication and returns user information
+ * Handles rate limiting with retry logic
+ *
+ * @param credentials - Jira credentials
+ * @param maxRetries - Maximum retry attempts (default: 3)
+ * @returns Validation result
+ */
+export declare function validateJiraConnection(credentials: JiraCredentials, maxRetries?: number): Promise<ValidationResult>;
+/**
+ * Get Jira environment variables for .env file
+ *
+ * @param credentials - Jira credentials
+ * @returns Array of key-value pairs for .env
+ */
+export declare function getJiraEnvVars(credentials: JiraCredentials): Array<{
+    key: string;
+    value: string;
+}>;
+/**
+ * Show Jira setup complete message
+ *
+ * @param language - User's language
+ */
+export declare function showJiraSetupComplete(language: SupportedLanguage): void;
+/**
+ * Show Jira setup skipped message
+ *
+ * @param language - User's language
+ */
+export declare function showJiraSetupSkipped(language: SupportedLanguage): void;
+//# sourceMappingURL=jira.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jira.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/issue-tracker/jira.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA+BrC;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsGjC;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,eAAe,EAC5B,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAkE3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAalG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CASvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAOtE"}

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

@@ -0,0 +1,265 @@
+/**
+ * Jira Integration for Issue Tracker Setup
+ *
+ * Handles Jira Cloud and Jira Server/Data Center authentication
+ *
+ * @module cli/helpers/issue-tracker/jira
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { getJiraAuth } from '../../../utils/auth-helpers.js';
+import { parseEnvFile, readEnvFile } from '../../../utils/env-file.js';
+import { isValidEmail, retryWithBackoff, checkRateLimit } from './utils.js';
+import { getLocaleManager } from '../../../core/i18n/locale-manager.js';
+import { RateLimitError } from './types.js';
+/**
+ * Check for existing Jira credentials
+ *
+ * @param projectPath - Path to project root
+ * @returns Existing credentials or null
+ */
+export async function checkExistingJiraCredentials(projectPath) {
+    // 1. Check project .env file
+    const envContent = readEnvFile(projectPath);
+    if (envContent) {
+        const parsed = parseEnvFile(envContent);
+        if (parsed.JIRA_API_TOKEN && parsed.JIRA_EMAIL && parsed.JIRA_DOMAIN) {
+            return {
+                source: '.env',
+                credentials: {
+                    token: parsed.JIRA_API_TOKEN,
+                    email: parsed.JIRA_EMAIL,
+                    domain: parsed.JIRA_DOMAIN,
+                    instanceType: 'cloud' // Assume cloud unless specified
+                }
+            };
+        }
+    }
+    // 2. Check environment variables
+    const auth = getJiraAuth();
+    if (auth) {
+        return {
+            source: 'env-vars',
+            credentials: {
+                ...auth,
+                instanceType: 'cloud'
+            }
+        };
+    }
+    return null;
+}
+/**
+ * Prompt user for Jira credentials
+ *
+ * Supports:
+ * - Jira Cloud (atlassian.net)
+ * - Jira Server/Data Center (self-hosted)
+ *
+ * @param language - User's language
+ * @returns Credentials or null if skipped
+ */
+export async function promptJiraCredentials(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.white('\n📋 Jira Integration Setup\n'));
+    console.log(chalk.gray('SpecWeave will sync increments with Jira Issues.\n'));
+    // Step 1: Ask about instance type (Cloud vs Server)
+    const { instanceType } = await inquirer.prompt([{
+            type: 'list',
+            name: 'instanceType',
+            message: 'Which Jira instance are you using?',
+            choices: [
+                { name: 'Jira Cloud (*.atlassian.net)', value: 'cloud' },
+                { name: 'Jira Server/Data Center (self-hosted)', value: 'server' }
+            ],
+            default: 'cloud'
+        }]);
+    // Step 2: Show setup instructions
+    console.log(chalk.cyan('\n📋 Quick Setup:'));
+    if (instanceType === 'cloud') {
+        console.log(chalk.gray('   1. Go to: https://id.atlassian.com/manage-profile/security/api-tokens'));
+        console.log(chalk.gray('   2. Click "Create API token"'));
+        console.log(chalk.gray('   3. Label: "SpecWeave - [your-project]"'));
+        console.log(chalk.gray('   4. Copy the token\n'));
+    }
+    else {
+        console.log(chalk.gray('   1. Go to your Jira settings → Personal Access Tokens'));
+        console.log(chalk.gray('   2. Create new token with "Read/Write" permissions'));
+        console.log(chalk.gray('   3. Label: "SpecWeave - [your-project]"'));
+        console.log(chalk.gray('   4. Copy the token\n'));
+    }
+    const { continueSetup } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'continueSetup',
+            message: 'Continue with Jira setup?',
+            default: true
+        }]);
+    if (!continueSetup) {
+        return null;
+    }
+    // Step 3: Collect credentials
+    const questions = [
+        {
+            type: 'input',
+            name: 'domain',
+            message: instanceType === 'cloud'
+                ? 'Jira domain (e.g., your-company.atlassian.net):'
+                : 'Jira Server URL (e.g., jira.company.com):',
+            validate: (input) => {
+                if (!input || input.trim() === '') {
+                    return 'Domain cannot be empty';
+                }
+                // Prevent SSRF attacks - block localhost and internal IP addresses
+                if (/localhost|127\.0\.0\.1|192\.168\.|10\.|172\.(1[6-9]|2[0-9]|3[01])\./i.test(input)) {
+                    return 'Internal IP addresses and localhost are not allowed';
+                }
+                // For cloud, suggest .atlassian.net but don't enforce (user might have custom domain)
+                if (instanceType === 'cloud' && !input.includes('.')) {
+                    return 'Please enter a valid domain (e.g., your-company.atlassian.net)';
+                }
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Your Jira email:',
+            validate: (input) => {
+                if (!isValidEmail(input)) {
+                    return 'Please enter a valid email address';
+                }
+                return true;
+            }
+        },
+        {
+            type: 'password',
+            name: 'token',
+            message: 'Paste your Jira API token:',
+            mask: '*',
+            validate: (input) => {
+                if (!input || input.length === 0) {
+                    return 'Token cannot be empty';
+                }
+                return true;
+            }
+        }
+    ];
+    const answers = await inquirer.prompt(questions);
+    return {
+        token: answers.token,
+        email: answers.email,
+        domain: answers.domain,
+        instanceType: instanceType
+    };
+}
+/**
+ * Validate Jira connection
+ *
+ * Tests authentication and returns user information
+ * Handles rate limiting with retry logic
+ *
+ * @param credentials - Jira credentials
+ * @param maxRetries - Maximum retry attempts (default: 3)
+ * @returns Validation result
+ */
+export async function validateJiraConnection(credentials, maxRetries = 3) {
+    const spinner = ora('Testing connection...').start();
+    try {
+        const result = await retryWithBackoff(async () => {
+            // Determine API endpoint based on instance type
+            const apiBase = credentials.instanceType === 'cloud'
+                ? `https://${credentials.domain}/rest/api/3`
+                : `https://${credentials.domain}/rest/api/2`;
+            const userEndpoint = `${apiBase}/myself`;
+            // Basic auth header
+            const auth = Buffer.from(`${credentials.email}:${credentials.token}`).toString('base64');
+            const response = await fetch(userEndpoint, {
+                headers: {
+                    'Authorization': `Basic ${auth}`,
+                    'Accept': 'application/json'
+                }
+            });
+            // Check for rate limiting
+            const rateLimitInfo = checkRateLimit(response);
+            if (rateLimitInfo) {
+                throw new RateLimitError('Jira API rate limit exceeded', rateLimitInfo);
+            }
+            if (!response.ok) {
+                const errorText = await response.text();
+                let errorMessage = 'Authentication failed';
+                if (response.status === 401) {
+                    errorMessage = 'Invalid credentials (check email and token)';
+                }
+                else if (response.status === 403) {
+                    errorMessage = 'Access forbidden (check token permissions)';
+                }
+                else if (response.status === 404) {
+                    errorMessage = 'Jira instance not found (check domain)';
+                }
+                else {
+                    errorMessage = `HTTP ${response.status}: ${errorText}`;
+                }
+                throw new Error(errorMessage);
+            }
+            const user = await response.json();
+            return user;
+        }, maxRetries);
+        spinner.succeed(`Connected to Jira as ${result.displayName || result.name}`);
+        return {
+            success: true,
+            username: result.displayName || result.name
+        };
+    }
+    catch (error) {
+        spinner.fail('Jira authentication failed');
+        return {
+            success: false,
+            error: error.message || 'Unknown error'
+        };
+    }
+}
+/**
+ * Get Jira environment variables for .env file
+ *
+ * @param credentials - Jira credentials
+ * @returns Array of key-value pairs for .env
+ */
+export function getJiraEnvVars(credentials) {
+    const vars = [
+        { key: 'JIRA_API_TOKEN', value: credentials.token },
+        { key: 'JIRA_EMAIL', value: credentials.email },
+        { key: 'JIRA_DOMAIN', value: credentials.domain }
+    ];
+    // Add Server-specific variables if needed
+    if (credentials.instanceType === 'server') {
+        vars.push({ key: 'JIRA_INSTANCE_TYPE', value: 'server' });
+    }
+    return vars;
+}
+/**
+ * Show Jira setup complete message
+ *
+ * @param language - User's language
+ */
+export function showJiraSetupComplete(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.green.bold('\n✅ Jira integration complete!\n'));
+    console.log(chalk.white('Available commands:'));
+    console.log(chalk.gray('  /specweave-jira:sync'));
+    console.log(chalk.gray('  /specweave-jira:status\n'));
+    console.log(chalk.cyan('💡 Tip: Use /specweave:inc "feature" to create an increment'));
+    console.log(chalk.gray('   It will automatically sync to Jira Issues!\n'));
+}
+/**
+ * Show Jira setup skipped message
+ *
+ * @param language - User's language
+ */
+export function showJiraSetupSkipped(language) {
+    const locale = getLocaleManager(language);
+    console.log(chalk.yellow('\n⏭️  Skipped Jira setup\n'));
+    console.log(chalk.white('You can configure later:'));
+    console.log(chalk.gray('  1. Add JIRA_API_TOKEN, JIRA_EMAIL, JIRA_DOMAIN to .env'));
+    console.log(chalk.gray('  2. Install plugin: /plugin install specweave-jira@specweave\n'));
+}
+//# sourceMappingURL=jira.js.map