specweave 0.12.7 → 0.13.0

package/plugins/specweave-jira/lib/setup-wizard.js

@@ -0,0 +1,219 @@
+/**
+ * Smart Jira Setup Wizard
+ *
+ * Intelligent credential detection and setup flow:
+ * 1. Check .env for credentials (uses credentialsManager)
+ * 2. Interactive prompt only if missing
+ * 3. Never ask twice for same credentials
+ */
+import inquirer from 'inquirer';
+import { credentialsManager } from '../../../src/core/credentials-manager.js';
+// ============================================================================
+// Credential Detection
+// ============================================================================
+/**
+ * Smart credential detection - uses existing credentialsManager
+ */
+export async function detectJiraCredentials() {
+    if (credentialsManager.hasJiraCredentials()) {
+        try {
+            const credentials = credentialsManager.getJiraCredentials();
+            console.log('✅ Found Jira credentials in .env');
+            return {
+                found: true,
+                credentials,
+                source: 'env',
+            };
+        }
+        catch (error) {
+            // Credentials exist but invalid format
+            return { found: false };
+        }
+    }
+    return { found: false };
+}
+// ============================================================================
+// Interactive Setup
+// ============================================================================
+/**
+ * Interactive Jira credential setup
+ * Only runs if credentials not found
+ */
+export async function setupJiraCredentials() {
+    console.log('\n🔧 Jira Setup Wizard\n');
+    // Check for existing credentials first
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        // Ask user if they want to use existing or re-enter
+        const { useExisting } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useExisting',
+                message: `Found credentials in ${detected.source}. Use these credentials?`,
+                default: true,
+            },
+        ]);
+        if (useExisting) {
+            return detected.credentials;
+        }
+        console.log('\n📝 Enter new credentials:\n');
+    }
+    else {
+        console.log('⚠️  No Jira credentials found\n');
+        console.log('📝 Let\'s set up your Jira connection:\n');
+    }
+    // Interactive credential entry
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'setupType',
+            message: 'How would you like to connect to Jira?',
+            choices: [
+                {
+                    name: 'Cloud (*.atlassian.net)',
+                    value: 'cloud',
+                },
+                {
+                    name: 'Server/Data Center (self-hosted)',
+                    value: 'server',
+                },
+            ],
+        },
+        {
+            type: 'input',
+            name: 'domain',
+            message: (answers) => answers.setupType === 'cloud'
+                ? 'Jira domain (e.g., mycompany.atlassian.net):'
+                : 'Jira server URL (e.g., jira.mycompany.com):',
+            validate: (value) => {
+                if (!value)
+                    return 'Domain is required';
+                if (answers.setupType === 'cloud' && !value.includes('.atlassian.net')) {
+                    return 'Cloud domain must end with .atlassian.net';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Email address:',
+            validate: (value) => {
+                if (!value)
+                    return 'Email is required';
+                if (!value.includes('@'))
+                    return 'Must be a valid email';
+                return true;
+            },
+        },
+        {
+            type: 'password',
+            name: 'apiToken',
+            message: 'API token:',
+            mask: '*',
+            validate: (value) => {
+                if (!value)
+                    return 'API token is required';
+                if (value.length < 10)
+                    return 'API token seems too short';
+                return true;
+            },
+        },
+    ]);
+    const credentials = {
+        domain: answers.domain,
+        email: answers.email,
+        apiToken: answers.apiToken,
+    };
+    // Test connection
+    console.log('\n🔍 Testing connection...');
+    const isValid = await testJiraConnection(credentials);
+    if (!isValid) {
+        console.log('❌ Failed to connect to Jira');
+        console.log('💡 Please check your credentials and try again\n');
+        const { retry } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'retry',
+                message: 'Would you like to try again?',
+                default: true,
+            },
+        ]);
+        if (retry) {
+            return setupJiraCredentials();
+        }
+        throw new Error('Jira connection failed');
+    }
+    console.log('✅ Connection successful!\n');
+    // Save to .env using credentialsManager
+    await saveCredentialsToEnv(credentials);
+    return credentials;
+}
+/**
+ * Test Jira connection with credentials
+ */
+async function testJiraConnection(credentials) {
+    try {
+        const https = await import('https');
+        const auth = Buffer.from(`${credentials.email}:${credentials.apiToken}`).toString('base64');
+        return new Promise((resolve) => {
+            const req = https.request({
+                hostname: credentials.domain,
+                path: '/rest/api/3/myself',
+                method: 'GET',
+                headers: {
+                    Authorization: `Basic ${auth}`,
+                    'Content-Type': 'application/json',
+                },
+            }, (res) => {
+                resolve(res.statusCode === 200);
+            });
+            req.on('error', () => resolve(false));
+            req.setTimeout(5000, () => {
+                req.destroy();
+                resolve(false);
+            });
+            req.end();
+        });
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Save credentials to .env using credentialsManager
+ */
+async function saveCredentialsToEnv(credentials) {
+    console.log('💡 Save credentials to .env for future use\n');
+    const { saveToEnv } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'saveToEnv',
+            message: 'Save credentials to .env file?',
+            default: true,
+        },
+    ]);
+    if (saveToEnv) {
+        credentialsManager.saveToEnvFile({ jira: credentials });
+        console.log('✅ Credentials saved to .env');
+        console.log('✅ .env added to .gitignore');
+    }
+    else {
+        console.log('⚠️  Credentials not saved. You\'ll need to enter them again next time.');
+    }
+}
+// ============================================================================
+// Export Helpers
+// ============================================================================
+/**
+ * Get Jira credentials - smart detection with fallback to interactive setup
+ */
+export async function getJiraCredentials() {
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        return detected.credentials;
+    }
+    // Not found - run interactive setup
+    return setupJiraCredentials();
+}
+//# sourceMappingURL=setup-wizard.js.map

package/plugins/specweave-jira/lib/setup-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.js","sourceRoot":"","sources":["setup-wizard.ts"],"names":[],"mappings":"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"}

package/src/templates/CLAUDE.md.template

@@ -87,6 +87,47 @@ This project uses **SpecWeave** - a specification-first AI development framework
 
 ---
 
+## 🔗 Automatic Syncing (Living Docs + External Tools)
+
+**SpecWeave automatically syncs your work** after EVERY task completion via hooks:
+
+### What Gets Synced Automatically
+
+1. **Living Docs** → `.specweave/docs/internal/specs/`
+   - Increment specs sync to permanent knowledge base
+   - Ensures complete project history
+   - **Configurable**: Set `sync_living_docs: true` in `.specweave/config.json`
+
+2. **External Trackers** (if configured):
+   - GitHub Issues - Task checkboxes update automatically
+   - Jira - Issue status updates automatically
+   - Azure DevOps - Work item updates automatically
+   - **Configurable**: Set `external_tracker_sync: true` in `.specweave/config.json`
+
+3. **Sound Notifications**:
+   - Plays sound when tasks complete (helps you know when to review)
+   - Platform-specific: Glass.aiff (macOS), system sounds (Linux/Windows)
+
+### Configuration (`.specweave/config.json`)
+
+Created automatically during `specweave init`, but you can customize:
+
+```json
+{
+  "hooks": {
+    "post_task_completion": {
+      "sync_living_docs": true,        // Sync specs to living docs
+      "sync_tasks_md": true,           // Update tasks.md
+      "external_tracker_sync": true    // Sync to GitHub/Jira/ADO
+    }
+  }
+}
+```
+
+**Just works!** No manual syncing needed - focus on implementation, SpecWeave handles the rest.
+
+---
+
 ## 🧠 Automatic Intent Detection (NEW in v0.3.8+)
 
 **SpecWeave now detects when you're describing a product/project and automatically helps you plan it!**