specweave 2.3.0 → 3.0.0

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

@@ -1,449 +0,0 @@
-/**
- * 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';
-import * as fs from 'fs/promises';
-import * as path from 'path';
-
-// ============================================================================
-// 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 {
-  /** Track known parent keys for reparent detection */
-  private previousParents = new Map<string, string>();
-
-  constructor(private client: JiraClient) {}
-
-  /**
-   * Set known parent keys from previous sync metadata.
-   * Call before detectReorganization() to enable accurate reparent detection.
-   */
-  setKnownParents(parents: Record<string, string>): void {
-    for (const [key, parent] of Object.entries(parents)) {
-      this.previousParents.set(key, parent);
-    }
-  }
-
-  /**
-   * 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.
-   *
-   * Requires previousParents map to track known parent keys.
-   * Only fires REPARENTED when the parent actually changed.
-   */
-  private detectReparent(
-    originalKey: string,
-    issue: JiraIssue,
-    lastSyncTimestamp?: string
-  ): ReorganizationEvent | null {
-    const currentParent = issue.fields.parent?.key || null;
-    const previousParent = this.previousParents.get(originalKey) || null;
-
-    // Only fire REPARENTED if we know the previous parent AND it differs
-    if (previousParent !== null && currentParent !== previousParent) {
-      return {
-        type: 'REPARENTED',
-        timestamp: issue.fields.updated,
-        description: `Issue ${originalKey} reparented from ${previousParent} to ${currentParent || 'none'}`,
-        originalKeys: [originalKey],
-        fromEpic: previousParent,
-        toEpic: currentParent || undefined,
-      };
-    }
-
-    // Update tracked parent for future comparisons
-    if (currentParent) {
-      this.previousParents.set(originalKey, 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 metadata.
- *
- * For each event type, updates local metadata.json to reflect
- * the reorganization that happened in JIRA.
- */
-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`);
-
-  const metadataPath = path.join(
-    projectRoot,
-    '.specweave',
-    'increments',
-    incrementId,
-    'metadata.json'
-  );
-
-  let metadata: any = {};
-  try {
-    metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
-  } catch {
-    console.warn(`   ⚠️  Could not read metadata.json for ${incrementId}`);
-  }
-
-  // Ensure reorganization log exists
-  if (!metadata.reorganization) {
-    metadata.reorganization = { events: [], lastHandled: null };
-  }
-
-  for (const event of events) {
-    switch (event.type) {
-      case 'MOVED_PROJECT': {
-        // Update tracked project key in metadata
-        if (event.newKeys?.[0]) {
-          if (!metadata.external_sync) metadata.external_sync = {};
-          if (!metadata.external_sync.jira) metadata.external_sync.jira = {};
-          metadata.external_sync.jira.issueKey = event.newKeys[0];
-          metadata.external_sync.jira.project = event.toProject;
-        }
-        console.log(`   ✓ Updated project mapping: ${event.fromProject} → ${event.toProject}`);
-        break;
-      }
-
-      case 'SPLIT': {
-        // Record split — new keys added as related issues
-        if (!metadata.external_sync?.jira?.relatedKeys) {
-          if (!metadata.external_sync) metadata.external_sync = {};
-          if (!metadata.external_sync.jira) metadata.external_sync.jira = {};
-          metadata.external_sync.jira.relatedKeys = [];
-        }
-        if (event.newKeys) {
-          metadata.external_sync.jira.relatedKeys.push(...event.newKeys);
-        }
-        console.log(`   ✓ Recorded split: ${event.newKeys?.join(', ')}`);
-        break;
-      }
-
-      case 'MERGED': {
-        // Update issue key to the merge target
-        if (event.newKeys?.[0]) {
-          if (!metadata.external_sync) metadata.external_sync = {};
-          if (!metadata.external_sync.jira) metadata.external_sync.jira = {};
-          metadata.external_sync.jira.issueKey = event.newKeys[0];
-          metadata.external_sync.jira.mergedFrom = event.originalKeys[0];
-        }
-        console.log(`   ✓ Updated merged issue: ${event.originalKeys[0]} → ${event.newKeys?.[0]}`);
-        break;
-      }
-
-      case 'REPARENTED': {
-        // Update parent epic key in metadata
-        if (!metadata.external_sync) metadata.external_sync = {};
-        if (!metadata.external_sync.jira) metadata.external_sync.jira = {};
-        metadata.external_sync.jira.epicKey = event.toEpic || null;
-        metadata.external_sync.jira.previousEpicKey = event.fromEpic || null;
-        console.log(`   ✓ Updated epic link: ${event.fromEpic || 'none'} → ${event.toEpic || 'none'}`);
-        break;
-      }
-
-      case 'DELETED': {
-        // Mark issue as deleted (don't remove metadata, just flag)
-        if (!metadata.external_sync) metadata.external_sync = {};
-        if (!metadata.external_sync.jira) metadata.external_sync.jira = {};
-        metadata.external_sync.jira.deleted = true;
-        metadata.external_sync.jira.deletedAt = event.timestamp;
-        console.log(`   ⚠️  Marked as deleted: ${event.originalKeys[0]}`);
-        break;
-      }
-    }
-
-    // Log event for audit trail
-    metadata.reorganization.events.push({
-      type: event.type,
-      timestamp: event.timestamp,
-      description: event.description,
-    });
-  }
-
-  metadata.reorganization.lastHandled = new Date().toISOString();
-
-  // Write updated metadata
-  try {
-    await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2));
-    console.log(`   📄 Updated metadata.json for ${incrementId}`);
-  } catch (err) {
-    console.warn(`   ⚠️  Failed to write metadata: ${(err as Error).message}`);
-  }
-
-  console.log('\n✅ Reorganization handled\n');
-}

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

@@ -1,156 +0,0 @@
-import { confirm, select, input, password } from "@inquirer/prompts";
-import { credentialsManager } from "../../../../../src/core/credentials/credentials-manager.js";
-import { JiraCredentials as JiraCredentials2 } from "../../../../../src/core/credentials/credentials-manager.js";
-async function detectJiraCredentials() {
-  if (credentialsManager.hasJiraCredentials()) {
-    try {
-      const credentials = credentialsManager.getJiraCredentials();
-      console.log("\u2705 Found Jira credentials in .env");
-      return {
-        found: true,
-        credentials,
-        source: "env"
-      };
-    } catch (error) {
-      return { found: false };
-    }
-  }
-  return { found: false };
-}
-async function setupJiraCredentials() {
-  console.log("\n\u{1F527} Jira Setup Wizard\n");
-  const detected = await detectJiraCredentials();
-  if (detected.found) {
-    const useExisting = await confirm({
-      message: `Found credentials in ${detected.source}. Use these credentials?`,
-      default: true
-    });
-    if (useExisting) {
-      return detected.credentials;
-    }
-    console.log("\n\u{1F4DD} Enter new credentials:\n");
-  } else {
-    console.log("\u26A0\uFE0F  No Jira credentials found\n");
-    console.log("\u{1F4DD} Let's set up your Jira connection:\n");
-  }
-  const setupType = await select({
-    message: "How would you like to connect to Jira?",
-    choices: [
-      {
-        name: "Cloud (*.atlassian.net)",
-        value: "cloud"
-      },
-      {
-        name: "Server/Data Center (self-hosted)",
-        value: "server"
-      }
-    ]
-  });
-  const domain = await input({
-    message: 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 (setupType === "cloud" && !value.includes(".atlassian.net")) {
-        return "Cloud domain must end with .atlassian.net";
-      }
-      return true;
-    }
-  });
-  const email = await input({
-    message: "Email address:",
-    validate: (value) => {
-      if (!value) return "Email is required";
-      if (!value.includes("@")) return "Must be a valid email";
-      return true;
-    }
-  });
-  const apiToken = await password({
-    message: "API token:",
-    mask: true,
-    validate: (value) => {
-      if (!value) return "API token is required";
-      if (value.length < 10) return "API token seems too short";
-      return true;
-    }
-  });
-  const answers = { setupType, domain, email, apiToken };
-  const credentials = {
-    domain: answers.domain,
-    email: answers.email,
-    apiToken: answers.apiToken
-  };
-  console.log("\n\u{1F50D} Testing connection...");
-  const isValid = await testJiraConnection(credentials);
-  if (!isValid) {
-    console.log("\u274C Failed to connect to Jira");
-    console.log("\u{1F4A1} Please check your credentials and try again\n");
-    const retry = await confirm({
-      message: "Would you like to try again?",
-      default: true
-    });
-    if (retry) {
-      return setupJiraCredentials();
-    }
-    throw new Error("Jira connection failed");
-  }
-  console.log("\u2705 Connection successful!\n");
-  await saveCredentialsToEnv(credentials);
-  return 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(5e3, () => {
-        req.destroy();
-        resolve(false);
-      });
-      req.end();
-    });
-  } catch (error) {
-    return false;
-  }
-}
-async function saveCredentialsToEnv(credentials) {
-  console.log("\u{1F4A1} Save credentials to .env for future use\n");
-  const saveToEnv = await confirm({
-    message: "Save credentials to .env file?",
-    default: true
-  });
-  if (saveToEnv) {
-    credentialsManager.saveToEnvFile({ jira: credentials });
-    console.log("\u2705 Credentials saved to .env");
-    console.log("\u2705 .env added to .gitignore");
-  } else {
-    console.log("\u26A0\uFE0F  Credentials not saved. You'll need to enter them again next time.");
-  }
-}
-async function getJiraCredentials() {
-  const detected = await detectJiraCredentials();
-  if (detected.found) {
-    return detected.credentials;
-  }
-  return setupJiraCredentials();
-}
-export {
-  JiraCredentials2 as JiraCredentials,
-  detectJiraCredentials,
-  getJiraCredentials,
-  setupJiraCredentials
-};