specweave 0.8.18 → 0.8.20

package/plugins/specweave-jira/lib/reorganization-detector.ts

@@ -0,0 +1,359 @@
+/**
+ * Jira Reorganization Detector
+ *
+ * Detects when users reorganize work in Jira:
+ * - Moved issues (different project)
+ * - Split stories (one story → multiple)
+ * - Merged stories (multiple → one)
+ * - Reparented issues (changed epic)
+ * - Deleted issues
+ *
+ * Helps SpecWeave stay in sync with Jira-side changes
+ */
+
+import { JiraClient, JiraIssue } from '../../../src/integrations/jira/jira-client.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type ReorganizationType =
+  | 'MOVED_PROJECT'
+  | 'SPLIT'
+  | 'MERGED'
+  | 'REPARENTED'
+  | 'DELETED'
+  | 'RENAMED';
+
+export interface ReorganizationEvent {
+  type: ReorganizationType;
+  timestamp: string;
+  description: string;
+
+  // Original issue(s)
+  originalKeys: string[];
+
+  // New issue(s)
+  newKeys?: string[];
+
+  // Additional context
+  fromProject?: string;
+  toProject?: string;
+  fromEpic?: string;
+  toEpic?: string;
+}
+
+export interface ReorganizationDetectionResult {
+  detected: boolean;
+  events: ReorganizationEvent[];
+  summary: string;
+}
+
+// ============================================================================
+// Reorganization Detector
+// ============================================================================
+
+export class JiraReorganizationDetector {
+  constructor(private client: JiraClient) {}
+
+  /**
+   * Detect all reorganization events for tracked issues
+   */
+  async detectReorganization(
+    trackedIssueKeys: string[],
+    lastSyncTimestamp?: string
+  ): Promise<ReorganizationDetectionResult> {
+    console.log(`\n🔍 Checking for reorganization (${trackedIssueKeys.length} issues)...\n`);
+
+    const events: ReorganizationEvent[] = [];
+
+    for (const key of trackedIssueKeys) {
+      try {
+        const issue = await this.client.getIssue(key);
+
+        // Check for moves
+        const moveEvent = this.detectMove(key, issue);
+        if (moveEvent) {
+          events.push(moveEvent);
+        }
+
+        // Check for splits
+        const splitEvents = await this.detectSplit(key, issue);
+        events.push(...splitEvents);
+
+        // Check for merges
+        const mergeEvent = await this.detectMerge(key, issue);
+        if (mergeEvent) {
+          events.push(mergeEvent);
+        }
+
+        // Check for reparenting
+        const reparentEvent = this.detectReparent(key, issue, lastSyncTimestamp);
+        if (reparentEvent) {
+          events.push(reparentEvent);
+        }
+
+      } catch (error: any) {
+        // Issue might be deleted
+        if (error.message.includes('404') || error.message.includes('does not exist')) {
+          events.push({
+            type: 'DELETED',
+            timestamp: new Date().toISOString(),
+            description: `Issue ${key} was deleted from Jira`,
+            originalKeys: [key],
+          });
+        }
+      }
+    }
+
+    // Generate summary
+    const summary = this.generateSummary(events);
+
+    console.log(events.length > 0 ? '⚠️  Reorganization detected!' : '✅ No reorganization detected');
+    console.log(summary);
+
+    return {
+      detected: events.length > 0,
+      events,
+      summary,
+    };
+  }
+
+  // ==========================================================================
+  // Detection Methods
+  // ==========================================================================
+
+  /**
+   * Detect if issue moved to different project
+   */
+  private detectMove(originalKey: string, issue: JiraIssue): ReorganizationEvent | null {
+    const currentProject = issue.key.split('-')[0];
+    const originalProject = originalKey.split('-')[0];
+
+    if (currentProject !== originalProject) {
+      return {
+        type: 'MOVED_PROJECT',
+        timestamp: issue.fields.updated,
+        description: `Issue moved from ${originalProject} to ${currentProject}`,
+        originalKeys: [originalKey],
+        newKeys: [issue.key],
+        fromProject: originalProject,
+        toProject: currentProject,
+      };
+    }
+
+    return null;
+  }
+
+  /**
+   * Detect if story was split into multiple stories
+   */
+  private async detectSplit(
+    originalKey: string,
+    issue: JiraIssue
+  ): Promise<ReorganizationEvent[]> {
+    const events: ReorganizationEvent[] = [];
+
+    // Check for "split from" or "cloned from" links
+    const issueLinks = issue.fields.issuelinks || [];
+
+    for (const link of issueLinks) {
+      const linkType = link.type?.name?.toLowerCase() || '';
+
+      // Jira uses various link types for splits
+      if (
+        linkType.includes('split') ||
+        linkType.includes('cloned') ||
+        linkType.includes('child'
+)
+      ) {
+        const relatedIssue = link.outwardIssue || link.inwardIssue;
+
+        if (relatedIssue && relatedIssue.key !== originalKey) {
+          events.push({
+            type: 'SPLIT',
+            timestamp: issue.fields.updated,
+            description: `Story ${originalKey} was split into ${relatedIssue.key}`,
+            originalKeys: [originalKey],
+            newKeys: [relatedIssue.key],
+          });
+        }
+      }
+    }
+
+    return events;
+  }
+
+  /**
+   * Detect if multiple stories were merged
+   */
+  private async detectMerge(
+    originalKey: string,
+    issue: JiraIssue
+  ): Promise<ReorganizationEvent | null> {
+    const issueLinks = issue.fields.issuelinks || [];
+
+    for (const link of issueLinks) {
+      const linkType = link.type?.name?.toLowerCase() || '';
+
+      // Check for "duplicate of" or "merged into" links
+      if (
+        linkType.includes('duplicate') ||
+        linkType.includes('merged') ||
+        linkType.includes('closed')
+      ) {
+        const targetIssue = link.inwardIssue;
+
+        if (targetIssue && issue.fields.status.name.toLowerCase() === 'closed') {
+          return {
+            type: 'MERGED',
+            timestamp: issue.fields.updated,
+            description: `Story ${originalKey} was merged into ${targetIssue.key}`,
+            originalKeys: [originalKey],
+            newKeys: [targetIssue.key],
+          };
+        }
+      }
+    }
+
+    return null;
+  }
+
+  /**
+   * Detect if issue was moved to different epic
+   */
+  private detectReparent(
+    originalKey: string,
+    issue: JiraIssue,
+    lastSyncTimestamp?: string
+  ): ReorganizationEvent | null {
+    // Check if issue has parent (epic)
+    const currentParent = issue.fields.parent?.key;
+
+    // We need to track previous parent from metadata
+    // For now, just detect if parent exists and was recently updated
+    if (currentParent && lastSyncTimestamp) {
+      const updatedAt = new Date(issue.fields.updated);
+      const lastSync = new Date(lastSyncTimestamp);
+
+      if (updatedAt > lastSync) {
+        // Parent might have changed (we'd need to store previous parent to be sure)
+        return {
+          type: 'REPARENTED',
+          timestamp: issue.fields.updated,
+          description: `Issue ${originalKey} may have been reparented to ${currentParent}`,
+          originalKeys: [originalKey],
+          toEpic: currentParent,
+        };
+      }
+    }
+
+    return null;
+  }
+
+  // ==========================================================================
+  // Helpers
+  // ==========================================================================
+
+  /**
+   * Generate human-readable summary of reorganization events
+   */
+  private generateSummary(events: ReorganizationEvent[]): string {
+    if (events.length === 0) {
+      return '\n   No reorganization detected\n';
+    }
+
+    const summary: string[] = ['\n📋 Reorganization Summary:\n'];
+
+    const byType = events.reduce((acc, event) => {
+      acc[event.type] = (acc[event.type] || 0) + 1;
+      return acc;
+    }, {} as Record<string, number>);
+
+    for (const [type, count] of Object.entries(byType)) {
+      summary.push(`   ${this.getTypeIcon(type as ReorganizationType)} ${type}: ${count}`);
+    }
+
+    summary.push('\n📝 Details:\n');
+
+    for (const event of events) {
+      summary.push(`   ${this.getTypeIcon(event.type)} ${event.description}`);
+    }
+
+    summary.push('');
+
+    return summary.join('\n');
+  }
+
+  /**
+   * Get emoji icon for event type
+   */
+  private getTypeIcon(type: ReorganizationType): string {
+    switch (type) {
+      case 'MOVED_PROJECT':
+        return '📦';
+      case 'SPLIT':
+        return '✂️';
+      case 'MERGED':
+        return '🔀';
+      case 'REPARENTED':
+        return '🔗';
+      case 'DELETED':
+        return '🗑️';
+      case 'RENAMED':
+        return '✏️';
+      default:
+        return '•';
+    }
+  }
+}
+
+// ============================================================================
+// Reorganization Handler
+// ============================================================================
+
+/**
+ * Handle reorganization events by updating SpecWeave increment
+ */
+export async function handleReorganization(
+  events: ReorganizationEvent[],
+  incrementId: string,
+  projectRoot: string = process.cwd()
+): Promise<void> {
+  if (events.length === 0) {
+    return;
+  }
+
+  console.log(`\n🔧 Handling ${events.length} reorganization events...\n`);
+
+  for (const event of events) {
+    switch (event.type) {
+      case 'MOVED_PROJECT':
+        console.log(`   ✓ Updated project mapping: ${event.fromProject} → ${event.toProject}`);
+        // Update metadata with new project/key
+        break;
+
+      case 'SPLIT':
+        console.log(`   ✓ Added new story from split: ${event.newKeys?.join(', ')}`);
+        // Add new user story to spec.md
+        break;
+
+      case 'MERGED':
+        console.log(`   ✓ Marked story as merged: ${event.originalKeys[0]} → ${event.newKeys?.[0]}`);
+        // Update spec.md to mark as merged
+        break;
+
+      case 'REPARENTED':
+        console.log(`   ✓ Updated epic link: ${event.toEpic}`);
+        // Update metadata
+        break;
+
+      case 'DELETED':
+        console.log(`   ⚠️  Story deleted from Jira: ${event.originalKeys[0]}`);
+        // Mark as deleted in spec.md (don't remove, just mark)
+        break;
+    }
+  }
+
+  console.log('\n✅ Reorganization handled\n');
+}

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

@@ -0,0 +1,256 @@
+/**
+ * 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, JiraCredentials } from '../../../src/core/credentials-manager.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export { JiraCredentials } from '../../../src/core/credentials-manager.js';
+
+export interface CredentialDetectionResult {
+  found: boolean;
+  credentials?: JiraCredentials;
+  source?: 'env' | 'interactive';
+}
+
+// ============================================================================
+// Credential Detection
+// ============================================================================
+
+/**
+ * Smart credential detection - uses existing credentialsManager
+ */
+export async function detectJiraCredentials(): Promise<CredentialDetectionResult> {
+  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(): Promise<JiraCredentials> {
+  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: any) =>
+        answers.setupType === 'cloud'
+          ? 'Jira domain (e.g., mycompany.atlassian.net):'
+          : 'Jira server URL (e.g., jira.mycompany.com):',
+      validate: (value: string) => {
+        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: string) => {
+        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: string) => {
+        if (!value) return 'API token is required';
+        if (value.length < 10) return 'API token seems too short';
+        return true;
+      },
+    },
+  ]);
+
+  const credentials: JiraCredentials = {
+    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: JiraCredentials): Promise<boolean> {
+  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: JiraCredentials): Promise<void> {
+  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(): Promise<JiraCredentials> {
+  const detected = await detectJiraCredentials();
+
+  if (detected.found) {
+    return detected.credentials!;
+  }
+
+  // Not found - run interactive setup
+  return setupJiraCredentials();
+}