specweave 1.0.506 → 1.0.508

package/dist/plugins/specweave/lib/integrations/jira/jira-spec-content-sync.js

@@ -0,0 +1,294 @@
+/**
+ * JIRA Spec Content Sync
+ *
+ * Syncs spec CONTENT (title, description, user stories) to JIRA Epics.
+ * Does NOT sync STATUS - that's managed in JIRA.
+ *
+ * Sync Direction:
+ * - Title/Description: SpecWeave → JIRA (we update)
+ * - Status (To Do/In Progress/Done): JIRA → SpecWeave (we read)
+ */
+import axios from 'axios';
+import { parseSpecContent, detectContentChanges, hasExternalLink, updateSpecWithExternalLink, } from '../../../../../src/core/specs/spec-content-sync.js';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Sync spec content to JIRA epic
+ * Creates epic if it doesn't exist, updates if it does
+ */
+export async function syncSpecContentToJira(options) {
+    const { specPath, config, dryRun = false, verbose = false } = options;
+    try {
+        // 1. Parse spec content
+        const spec = await parseSpecContent(specPath);
+        if (!spec) {
+            return {
+                success: false,
+                action: 'error',
+                error: 'Failed to parse spec content',
+            };
+        }
+        if (verbose) {
+            console.log(`📄 Parsed spec: ${spec.id}`);
+            console.log(`   Title: ${spec.title}`);
+            console.log(`   User Stories: ${spec.userStories.length}`);
+        }
+        // 2. Create JIRA client
+        const client = axios.create({
+            baseURL: `https://${config.domain}/rest/api/3`,
+            auth: {
+                username: config.email,
+                password: config.apiToken,
+            },
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+            },
+        });
+        // 3. Check if epic already exists
+        const existingEpicKey = await hasExternalLink(specPath, 'jira');
+        if (existingEpicKey) {
+            // UPDATE existing epic
+            return await updateJiraEpic(client, spec, existingEpicKey, options);
+        }
+        else {
+            // CREATE new epic
+            return await createJiraEpic(client, spec, options);
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: error.message,
+        };
+    }
+}
+/**
+ * Create new JIRA epic from spec
+ */
+async function createJiraEpic(client, spec, options) {
+    const { specPath, config, dryRun, verbose } = options;
+    try {
+        // Build epic summary and description
+        const summary = `[${spec.id.toUpperCase()}] ${spec.title}`;
+        const description = buildJiraDescription(spec);
+        if (verbose) {
+            console.log(`\n📝 Creating JIRA epic:`);
+            console.log(`   Summary: ${summary}`);
+            console.log(`   Description length: ${description.length} chars`);
+        }
+        if (dryRun) {
+            console.log('\n🔍 Dry run - would create epic:');
+            console.log(`   Summary: ${summary}`);
+            console.log(`   Description:\n${description}`);
+            return {
+                success: true,
+                action: 'created',
+                externalId: 'DRY-RUN',
+                externalUrl: `https://${options.config.domain}/browse/DRY-RUN`,
+            };
+        }
+        // Create epic
+        const response = await client.post('/issue', {
+            fields: {
+                project: { key: config.projectKey },
+                summary,
+                description: {
+                    type: 'doc',
+                    version: 1,
+                    content: [
+                        {
+                            type: 'paragraph',
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: description,
+                                },
+                            ],
+                        },
+                    ],
+                },
+                issuetype: { name: 'Epic' },
+                labels: ['specweave', 'spec', spec.metadata.priority || 'P2'],
+            },
+        });
+        const epicKey = response.data.key;
+        const epicUrl = `https://${config.domain}/browse/${epicKey}`;
+        if (verbose) {
+            console.log(`✅ Created epic ${epicKey}`);
+            console.log(`   URL: ${epicUrl}`);
+        }
+        // Update spec with JIRA link
+        await updateSpecWithExternalLink(specPath, 'jira', epicKey, epicUrl);
+        return {
+            success: true,
+            action: 'created',
+            externalId: epicKey,
+            externalUrl: epicUrl,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: `Failed to create JIRA epic: ${error.message}`,
+        };
+    }
+}
+/**
+ * Update existing JIRA epic with spec content
+ */
+async function updateJiraEpic(client, spec, epicKey, options) {
+    const { specPath, config, dryRun, verbose } = options;
+    try {
+        // Get current epic
+        const response = await client.get(`/issue/${epicKey}`);
+        const epic = response.data;
+        if (verbose) {
+            console.log(`\n🔄 Checking for changes in epic ${epicKey}`);
+        }
+        // Detect changes
+        const changes = detectContentChanges(spec, {
+            title: epic.fields.summary.replace(/^\[SPEC-\d+\]\s*/, ''),
+            description: extractTextFromJiraADF(epic.fields.description),
+            userStoryCount: 0, // TODO: Parse from description
+        });
+        if (!changes.hasChanges) {
+            if (verbose) {
+                console.log('   ℹ️  No changes detected');
+            }
+            return {
+                success: true,
+                action: 'no-change',
+                externalId: epicKey,
+                externalUrl: `https://${config.domain}/browse/${epicKey}`,
+            };
+        }
+        if (verbose) {
+            console.log('   📝 Changes detected:');
+            for (const change of changes.changes) {
+                console.log(`      - ${change}`);
+            }
+        }
+        // Build updated content
+        const newSummary = `[${spec.id.toUpperCase()}] ${spec.title}`;
+        const newDescription = buildJiraDescription(spec);
+        if (dryRun) {
+            console.log('\n🔍 Dry run - would update epic:');
+            console.log(`   Summary: ${newSummary}`);
+            console.log(`   Description:\n${newDescription}`);
+            return {
+                success: true,
+                action: 'updated',
+                externalId: epicKey,
+                externalUrl: `https://${config.domain}/browse/${epicKey}`,
+            };
+        }
+        // Update epic (ONLY summary and description, NOT status!)
+        await client.put(`/issue/${epicKey}`, {
+            fields: {
+                summary: newSummary,
+                description: {
+                    type: 'doc',
+                    version: 1,
+                    content: [
+                        {
+                            type: 'paragraph',
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: newDescription,
+                                },
+                            ],
+                        },
+                    ],
+                },
+            },
+        });
+        // Note: We do NOT update status - that's managed in JIRA
+        // We do NOT transition issues (To Do → In Progress → Done)
+        if (verbose) {
+            console.log(`✅ Updated epic ${epicKey}`);
+        }
+        return {
+            success: true,
+            action: 'updated',
+            externalId: epicKey,
+            externalUrl: `https://${config.domain}/browse/${epicKey}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: `Failed to update JIRA epic: ${error.message}`,
+        };
+    }
+}
+/**
+ * Build JIRA description from spec content
+ * Converts markdown to JIRA markup
+ */
+function buildJiraDescription(spec) {
+    let description = '';
+    // Add spec description
+    if (spec.description) {
+        description += spec.description + '\n\n';
+    }
+    // Add user stories
+    if (spec.userStories.length > 0) {
+        description += 'h2. User Stories\n\n';
+        for (const us of spec.userStories) {
+            description += `h3. ${us.id}: ${us.title}\n\n`;
+            if (us.acceptanceCriteria.length > 0) {
+                description += '*Acceptance Criteria:*\n';
+                for (const ac of us.acceptanceCriteria) {
+                    const checkbox = ac.completed ? '(/)' : '(x)';
+                    description += `* ${checkbox} ${ac.id}: ${ac.description}\n`;
+                }
+                description += '\n';
+            }
+        }
+    }
+    // Add metadata
+    if (spec.metadata.priority) {
+        description += `\n*Priority:* ${spec.metadata.priority}\n`;
+    }
+    return description;
+}
+/**
+ * Extract plain text from JIRA ADF (Atlassian Document Format)
+ */
+function extractTextFromJiraADF(adf) {
+    if (!adf || !adf.content) {
+        return '';
+    }
+    let text = '';
+    function traverse(node) {
+        if (node.type === 'text') {
+            text += node.text;
+        }
+        if (node.content) {
+            for (const child of node.content) {
+                traverse(child);
+            }
+        }
+    }
+    traverse(adf);
+    return text.trim();
+}
+/**
+ * Check if spec content sync is enabled
+ */
+export async function isContentSyncEnabled(projectRoot) {
+    try {
+        const configPath = path.join(projectRoot, '.specweave', 'config.json');
+        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        return config.sync?.settings?.syncSpecContent !== false;
+    }
+    catch {
+        return true; // Default: enabled
+    }
+}
+//# sourceMappingURL=jira-spec-content-sync.js.map

package/dist/plugins/specweave/lib/integrations/jira/jira-spec-content-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-spec-content-sync.js","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/jira/jira-spec-content-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave/lib/integrations/jira/jira-spec-sync.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Jira Spec Sync
+ *
+ * CORRECT ARCHITECTURE:
+ * - Syncs .specweave/docs/internal/specs/spec-*.md ↔ Jira Epics
+ * - NOT increments ↔ Jira Issues (that was wrong!)
+ *
+ * Mapping:
+ * - Spec → Jira Epic
+ * - User Story → Jira Story (subtask of epic)
+ * - Acceptance Criteria → Checklist in Story description
+ *
+ * @module jira-spec-sync
+ */
+import { UserStory, SpecSyncResult } from '../../../../../src/core/types/spec-metadata.js';
+import { AdfDocument } from './content-format-adapter.js';
+import { CircuitBreakerRegistry } from '../../../../../src/core/sync/circuit-breaker-registry.js';
+import { SyncRetryQueue } from '../../../../../src/core/sync/sync-retry-queue.js';
+/**
+ * Build a JIRA story description from a UserStory.
+ * ACs are rendered as [ ]/[x] which content-format-adapter converts to native ADF taskList/taskItem checkboxes.
+ */
+export declare function buildStoryDescription(us: UserStory): string;
+export interface JiraEpic {
+    id: string;
+    key: string;
+    summary: string;
+    description: string | AdfDocument;
+    status: {
+        name: string;
+    };
+    url: string;
+}
+export interface JiraStory {
+    id: string;
+    key: string;
+    summary: string;
+    description: string;
+    status: {
+        name: string;
+    };
+    epicLink?: string;
+    labels: string[];
+}
+export interface JiraConfig {
+    domain: string;
+    email: string;
+    apiToken: string;
+    projectKey: string;
+}
+export interface JiraSpecSyncOptions {
+    circuitBreakerRegistry?: CircuitBreakerRegistry;
+    retryQueue?: SyncRetryQueue;
+    lockDir?: string;
+    incrementId?: string;
+    featureId?: string;
+}
+export declare class JiraSpecSync {
+    private specManager;
+    private client;
+    private config;
+    private projectRoot;
+    private circuitBreakerRegistry?;
+    private retryQueue?;
+    private lockManager?;
+    private incrementId;
+    private featureId;
+    constructor(config: JiraConfig, projectRoot?: string, projectId?: string, options?: JiraSpecSyncOptions);
+    /**
+     * Execute fn under file lock (if lockManager configured).
+     */
+    private withLock;
+    /**
+     * Check circuit breaker before making API calls.
+     */
+    private checkCircuitBreaker;
+    /**
+     * Record success on circuit breaker.
+     */
+    private recordApiSuccess;
+    /**
+     * Record failure on circuit breaker and optionally enqueue retry.
+     */
+    private recordApiFailure;
+    /**
+     * Initialize: detect deployment type and update client baseURL
+     */
+    init(): Promise<void>;
+    /**
+     * Sync spec to Jira Epic (CREATE or UPDATE)
+     */
+    syncSpecToJira(specId: string): Promise<SpecSyncResult>;
+    /**
+     * Sync FROM Jira Epic to spec (bidirectional)
+     */
+    syncFromJira(specId: string): Promise<SpecSyncResult>;
+    /**
+     * Create new Jira Epic for spec
+     */
+    private createJiraEpic;
+    /**
+     * Update existing Jira Epic
+     */
+    private updateJiraEpic;
+    /**
+     * Sync user stories as Jira Stories
+     */
+    private syncUserStories;
+    /**
+     * Write JIRA story key back to living doc US file frontmatter.
+     * Searches all project subdirs for the matching US file and adds external_tools.jira.key.
+     */
+    private writeJiraKeyToUSFile;
+    /**
+     * Generate epic description from spec
+     */
+    private generateEpicDescription;
+    /**
+     * Generate story description from user story
+     */
+    private generateStoryDescription;
+    /**
+     * Detect conflicts between spec and Jira
+     */
+    private detectConflicts;
+    /**
+     * Resolve conflicts based on configurable strategy.
+     *
+     * Strategies:
+     * - 'manual' (default): Halt sync, report conflicts to user, no auto-resolve
+     * - 'remote-wins': Auto-resolve in favor of JIRA (remote)
+     * - 'local-wins': Auto-resolve in favor of spec (local)
+     * - 'report-only': Log conflicts, continue without resolving
+     */
+    private resolveConflicts;
+    /**
+     * Write conflict report JSON file for detected conflicts.
+     */
+    private writeConflictReport;
+    /**
+     * Fetch Jira Epic details
+     */
+    private fetchJiraEpic;
+    /**
+     * Find story by title pattern scoped to a specific spec (via label).
+     * US IDs like "US-001" are reused across features, so we must scope to
+     * the spec label (e.g. "spec:FS-526") to avoid false matches.
+     */
+    private findStoryByTitle;
+    /**
+     * Create Jira Story
+     */
+    private createStory;
+    /**
+     * Update Jira Story
+     */
+    private updateStory;
+    /**
+     * Transition issue to new status
+     */
+    private transitionIssue;
+    /**
+     * Resolve the actual issue type name available in this project.
+     * Falls back through preferred → alternatives if the preferred type doesn't exist.
+     */
+    private resolveIssueType;
+    /**
+     * Map SpecWeave priority to JIRA priority name
+     *
+     * JIRA standard priority names: Highest, High, Medium, Low, Lowest
+     */
+    private mapPriorityToJira;
+    /**
+     * Map SpecWeave type to JIRA issue type
+     *
+     * Supports: Epic, Story, Bug, Task
+     */
+    private mapTypeToJira;
+}
+//# sourceMappingURL=jira-spec-sync.d.ts.map

package/dist/plugins/specweave/lib/integrations/jira/jira-spec-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-spec-sync.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/jira/jira-spec-sync.ts"],"names":[],"mappings":"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"}