specweave 0.22.13 → 0.22.14

package/dist/src/importers/item-converter.js

@@ -0,0 +1,221 @@
+/**
+ * Item Converter
+ *
+ * Converts external items (GitHub/JIRA/ADO) to SpecWeave living docs User Stories.
+ * CRITICAL: Does NOT create increments - only creates living docs.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Convert external items to living docs User Stories
+ *
+ * CRITICAL: This function ONLY creates living docs files.
+ * It does NOT create increments or populate .specweave/increments/.
+ */
+export class ItemConverter {
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Convert a single external item to a User Story with E suffix
+     */
+    convertItem(item, usId) {
+        // Generate US-ID with E suffix
+        const id = `US-${String(usId).padStart(3, '0')}E`;
+        // Map external status to SpecWeave status
+        const status = this.mapStatus(item.status);
+        // Extract acceptance criteria
+        const acceptanceCriteria = item.acceptanceCriteria || [];
+        // Generate origin badge
+        const originBadge = this.generateOriginBadge(item);
+        // Generate markdown content for living docs
+        const markdown = this.generateMarkdown({
+            id,
+            title: item.title,
+            description: item.description,
+            acceptanceCriteria,
+            priority: item.priority,
+            status,
+            originBadge,
+            metadata: {
+                externalId: item.id,
+                externalUrl: item.url,
+                externalPlatform: item.platform,
+                importedAt: new Date().toISOString(),
+                createdAt: item.createdAt.toISOString(),
+                updatedAt: item.updatedAt.toISOString(),
+                labels: item.labels
+            }
+        });
+        // Generate file path
+        const fileName = this.generateFileName(id, item.title);
+        const filePath = path.join(this.options.specsDir, fileName);
+        return {
+            id,
+            title: item.title,
+            description: item.description,
+            acceptanceCriteria,
+            priority: item.priority,
+            status,
+            metadata: {
+                externalId: item.id,
+                externalUrl: item.url,
+                externalPlatform: item.platform,
+                importedAt: new Date().toISOString(),
+                createdAt: item.createdAt.toISOString(),
+                updatedAt: item.updatedAt.toISOString(),
+                labels: item.labels
+            },
+            filePath,
+            markdown
+        };
+    }
+    /**
+     * Convert multiple external items to User Stories
+     *
+     * CRITICAL: This method ONLY creates living docs files.
+     * It does NOT create increments.
+     */
+    async convertItems(items) {
+        const startingId = this.options.startingId || 1;
+        const converted = [];
+        // Ensure specs directory exists
+        fs.mkdirSync(this.options.specsDir, { recursive: true });
+        // Convert each item
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const usId = startingId + i;
+            const userStory = this.convertItem(item, usId);
+            converted.push(userStory);
+            // Write living docs file
+            fs.writeFileSync(userStory.filePath, userStory.markdown, 'utf-8');
+        }
+        return converted;
+    }
+    /**
+     * Map external status to SpecWeave status
+     */
+    mapStatus(externalStatus) {
+        const statusMap = {
+            'open': 'Open',
+            'in-progress': 'In Progress',
+            'completed': 'Completed',
+            'closed': 'Completed'
+        };
+        return statusMap[externalStatus] || 'Open';
+    }
+    /**
+     * Generate origin badge for living docs
+     */
+    generateOriginBadge(item) {
+        const platformEmoji = {
+            'github': '🔗',
+            'jira': '🔗',
+            'ado': '🔗'
+        };
+        const platformName = {
+            'github': 'GitHub',
+            'jira': 'JIRA',
+            'ado': 'Azure DevOps'
+        };
+        const emoji = platformEmoji[item.platform] || '🔗';
+        const name = platformName[item.platform] || item.platform;
+        // Extract issue/ticket number from external ID
+        const issueNumber = item.id.replace(/^(GITHUB|JIRA|ADO)-/, '');
+        return `${emoji} [${name} #${issueNumber}](${item.url})`;
+    }
+    /**
+     * Generate markdown content for living docs User Story
+     */
+    generateMarkdown(data) {
+        const parts = [];
+        // Title
+        parts.push(`# ${data.id}: ${data.title}`);
+        parts.push('');
+        // Origin badge
+        parts.push(`**Origin**: ${data.originBadge}`);
+        parts.push('');
+        // Status and Priority
+        parts.push(`**Status**: ${data.status}`);
+        if (data.priority) {
+            parts.push(`**Priority**: ${data.priority}`);
+        }
+        parts.push('');
+        // Description
+        parts.push('## Description');
+        parts.push('');
+        parts.push(data.description || 'No description provided.');
+        parts.push('');
+        // Acceptance Criteria
+        if (data.acceptanceCriteria.length > 0) {
+            parts.push('## Acceptance Criteria');
+            parts.push('');
+            data.acceptanceCriteria.forEach((ac, index) => {
+                const acId = `AC-${data.id.replace('E', '')}-${String(index + 1).padStart(2, '0')}`;
+                parts.push(`- [ ] **${acId}**: ${ac}`);
+            });
+            parts.push('');
+        }
+        // Tasks
+        parts.push('## Tasks');
+        parts.push('');
+        parts.push('> **Note**: This User Story was imported from an external tool.');
+        parts.push('> Create tasks manually when ready to implement.');
+        parts.push('');
+        // Metadata (frontmatter-style at bottom)
+        parts.push('---');
+        parts.push('');
+        parts.push('## External Metadata');
+        parts.push('');
+        parts.push(`- **External ID**: ${data.metadata.externalId}`);
+        parts.push(`- **External URL**: ${data.metadata.externalUrl}`);
+        parts.push(`- **Platform**: ${data.metadata.externalPlatform}`);
+        parts.push(`- **Imported At**: ${data.metadata.importedAt}`);
+        parts.push(`- **Created At**: ${data.metadata.createdAt}`);
+        parts.push(`- **Updated At**: ${data.metadata.updatedAt}`);
+        if (data.metadata.labels.length > 0) {
+            parts.push(`- **Labels**: ${data.metadata.labels.join(', ')}`);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Generate file name for living docs User Story
+     *
+     * Format: us-001e-title-here.md
+     */
+    generateFileName(usId, title) {
+        // Convert US-001E to us-001e
+        const idPart = usId.toLowerCase();
+        // Convert title to kebab-case
+        const titlePart = title
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '') // Remove special chars
+            .replace(/\s+/g, '-') // Replace spaces with hyphens
+            .replace(/-+/g, '-') // Remove duplicate hyphens
+            .slice(0, 50); // Limit to 50 chars
+        return `${idPart}-${titlePart}.md`;
+    }
+    /**
+     * Validate that no increments were created
+     *
+     * CRITICAL: This validation ensures we're not auto-creating increments.
+     */
+    static validateNoIncrementsCreated(projectRoot) {
+        const incrementsDir = path.join(projectRoot, '.specweave', 'increments');
+        if (!fs.existsSync(incrementsDir)) {
+            return; // No increments directory - that's fine
+        }
+        // Check for any numbered increment directories
+        const items = fs.readdirSync(incrementsDir);
+        const incrementDirs = items.filter(item => {
+            const fullPath = path.join(incrementsDir, item);
+            return fs.statSync(fullPath).isDirectory() && /^\d{4}-/.test(item);
+        });
+        if (incrementDirs.length > 0) {
+            throw new Error(`VALIDATION FAILED: Increments were auto-created during import. ` +
+                `Found: ${incrementDirs.join(', ')}. ` +
+                `Import should ONLY create living docs, not increments.`);
+        }
+    }
+}
+//# sourceMappingURL=item-converter.js.map

package/dist/src/importers/item-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-converter.js","sourceRoot":"","sources":["../../../src/importers/item-converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAwDxB;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAGxB,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAkB,EAAE,IAAY;QAC1C,+BAA+B;QAC/B,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;QAElD,0CAA0C;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3C,8BAA8B;QAC9B,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC;QAEzD,wBAAwB;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAEnD,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACrC,EAAE;YACF,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,kBAAkB;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,WAAW;YACX,QAAQ,EAAE;gBACR,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,WAAW,EAAE,IAAI,CAAC,GAAG;gBACrB,gBAAgB,EAAE,IAAI,CAAC,QAAQ;gBAC/B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;gBACvC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB;SACF,CAAC,CAAC;QAEH,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE5D,OAAO;YACL,EAAE;YACF,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,kBAAkB;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,QAAQ,EAAE;gBACR,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,WAAW,EAAE,IAAI,CAAC,GAAG;gBACrB,gBAAgB,EAAE,IAAI,CAAC,QAAQ;gBAC/B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;gBACvC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB;YACD,QAAQ;YACR,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,KAAqB;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QAChD,MAAM,SAAS,GAAyB,EAAE,CAAC;QAE3C,gCAAgC;QAChC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzD,oBAAoB;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC,CAAC;YAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/C,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAE1B,yBAAyB;YACzB,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,cAAsC;QACtD,MAAM,SAAS,GAA2B;YACxC,MAAM,EAAE,MAAM;YACd,aAAa,EAAE,aAAa;YAC5B,WAAW,EAAE,WAAW;YACxB,QAAQ,EAAE,WAAW;SACtB,CAAC;QAEF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,IAAkB;QAC5C,MAAM,aAAa,GAA2B;YAC5C,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;SACZ,CAAC;QAEF,MAAM,YAAY,GAA2B;YAC3C,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,cAAc;SACtB,CAAC;QAEF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;QACnD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC;QAE1D,+CAA+C;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QAE/D,OAAO,GAAG,KAAK,KAAK,IAAI,KAAK,WAAW,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC;IAC3D,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAiBxB;QACC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,QAAQ;QACR,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,eAAe;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,sBAAsB;QACtB,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,cAAc;QACd,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,0BAA0B,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,sBAAsB;QACtB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;gBAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBACpF,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,QAAQ;QACR,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,yCAAyC;QACzC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACK,gBAAgB,CAAC,IAAY,EAAE,KAAa;QAClD,6BAA6B;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAElC,8BAA8B;QAC9B,MAAM,SAAS,GAAG,KAAK;aACpB,WAAW,EAAE;aACb,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,uBAAuB;aACpD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAU,8BAA8B;aAC5D,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAW,2BAA2B;aACzD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAiB,oBAAoB;QAErD,OAAO,GAAG,MAAM,IAAI,SAAS,KAAK,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,WAAmB;QACpD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAEzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,wCAAwC;QAClD,CAAC;QAED,+CAA+C;QAC/C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,iEAAiE;gBACjE,UAAU,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACtC,wDAAwD,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/src/importers/jira-importer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JIRA Importer
+ *
+ * Imports JIRA issues/epics as External Items with JQL support and pagination.
+ * Handles authentication and converts JIRA-specific data to platform-agnostic format.
+ */
+import type { Importer, ExternalItem, ImportConfig } from './external-importer.js';
+/**
+ * JIRA Importer Implementation
+ */
+export declare class JiraImporter implements Importer {
+    readonly platform: "jira";
+    private host;
+    private email;
+    private apiToken;
+    constructor(host: string, email?: string, apiToken?: string);
+    /**
+     * Import all issues matching config
+     */
+    import(config?: ImportConfig): Promise<ExternalItem[]>;
+    /**
+     * Paginate through issues using JQL (50 per page)
+     */
+    paginate(config?: ImportConfig): AsyncGenerator<ExternalItem[], void, unknown>;
+    /**
+     * Make authenticated JIRA API request
+     */
+    private makeJiraRequest;
+    /**
+     * Convert JIRA issue to ExternalItem
+     */
+    private convertToExternalItem;
+    /**
+     * Extract acceptance criteria from description
+     * Looks for patterns like:
+     * - AC1: ...
+     * - Acceptance Criteria:
+     * - Given/When/Then
+     */
+    private extractAcceptanceCriteria;
+}
+//# sourceMappingURL=jira-importer.d.ts.map

package/dist/src/importers/jira-importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-importer.d.ts","sourceRoot":"","sources":["../../../src/importers/jira-importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA0CnF;;GAEG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,QAAQ,EAAG,MAAM,CAAU;IACpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAY3D;;OAEG;IACG,MAAM,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUhE;;OAEG;IACI,QAAQ,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC;IA0FzF;;OAEG;YACW,eAAe;IAgC7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;CA2BlC"}

package/dist/src/importers/jira-importer.js

@@ -0,0 +1,221 @@
+/**
+ * JIRA Importer
+ *
+ * Imports JIRA issues/epics as External Items with JQL support and pagination.
+ * Handles authentication and converts JIRA-specific data to platform-agnostic format.
+ */
+/**
+ * JIRA Importer Implementation
+ */
+export class JiraImporter {
+    constructor(host, email, apiToken) {
+        this.platform = 'jira';
+        this.host = host.replace(/\/+$/, ''); // Remove trailing slashes
+        this.email = email || process.env.JIRA_EMAIL || '';
+        this.apiToken = apiToken || process.env.JIRA_API_TOKEN || '';
+        if (!this.email || !this.apiToken) {
+            throw new Error('JIRA authentication required: Set JIRA_EMAIL and JIRA_API_TOKEN environment variables');
+        }
+    }
+    /**
+     * Import all issues matching config
+     */
+    async import(config = {}) {
+        const items = [];
+        for await (const page of this.paginate(config)) {
+            items.push(...page);
+        }
+        return items;
+    }
+    /**
+     * Paginate through issues using JQL (50 per page)
+     */
+    async *paginate(config = {}) {
+        const { timeRangeMonths = 3, includeClosed = false, labels = [], milestone, // JIRA uses "fixVersion" or "epic"
+        maxItems = Infinity, } = config;
+        // Build JQL query
+        const jqlParts = [];
+        // Time range
+        const since = new Date();
+        since.setMonth(since.getMonth() - timeRangeMonths);
+        jqlParts.push(`created >= "${since.toISOString().split('T')[0]}"`);
+        // Status filter
+        if (!includeClosed) {
+            jqlParts.push('statusCategory != Done');
+        }
+        // Labels filter
+        if (labels.length > 0) {
+            const labelsCondition = labels.map((l) => `labels = "${l}"`).join(' OR ');
+            jqlParts.push(`(${labelsCondition})`);
+        }
+        // Epic/Milestone filter (assuming epic link custom field)
+        if (milestone) {
+            jqlParts.push(`"Epic Link" = "${milestone}"`);
+        }
+        const jql = jqlParts.join(' AND ');
+        let startAt = 0;
+        const maxResults = 50; // JIRA pagination size
+        let totalFetched = 0;
+        while (totalFetched < maxItems) {
+            try {
+                // Fetch page from JIRA API
+                const response = await this.makeJiraRequest('/rest/api/3/search', {
+                    jql,
+                    startAt,
+                    maxResults,
+                    fields: [
+                        'summary',
+                        'description',
+                        'status',
+                        'priority',
+                        'issuetype',
+                        'created',
+                        'updated',
+                        'labels',
+                        'customfield_10016', // Story points
+                        'subtasks',
+                        'parent',
+                    ],
+                });
+                // Convert JIRA issues to ExternalItems
+                const items = response.issues.map((issue) => this.convertToExternalItem(issue));
+                // Yield page
+                if (items.length > 0) {
+                    yield items.slice(0, maxItems - totalFetched);
+                    totalFetched += items.length;
+                }
+                // Check if we've reached the end
+                if (startAt + maxResults >= response.total) {
+                    break;
+                }
+                startAt += maxResults;
+            }
+            catch (error) {
+                if (error.status === 401) {
+                    throw new Error(`JIRA authentication failed: ${error.message}`);
+                }
+                else if (error.status === 403) {
+                    throw new Error(`JIRA access forbidden: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+    }
+    /**
+     * Make authenticated JIRA API request
+     */
+    async makeJiraRequest(endpoint, params = {}) {
+        const url = new URL(endpoint, this.host);
+        // Add query params
+        Object.entries(params).forEach(([key, value]) => {
+            if (value !== undefined && value !== null) {
+                url.searchParams.append(key, typeof value === 'object' ? JSON.stringify(value) : String(value));
+            }
+        });
+        // Create Basic Auth header
+        const auth = Buffer.from(`${this.email}:${this.apiToken}`).toString('base64');
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Basic ${auth}`,
+                'Accept': 'application/json',
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            const error = new Error(`JIRA API error: ${response.statusText} - ${errorText}`);
+            error.status = response.status;
+            throw error;
+        }
+        return response.json();
+    }
+    /**
+     * Convert JIRA issue to ExternalItem
+     */
+    convertToExternalItem(issue) {
+        // Map JIRA issue type to ExternalItem type
+        let type = 'task';
+        const issueTypeName = issue.fields.issuetype.name.toLowerCase();
+        if (issueTypeName.includes('story') || issueTypeName === 'user story') {
+            type = 'user-story';
+        }
+        else if (issueTypeName === 'epic') {
+            type = 'epic';
+        }
+        else if (issueTypeName === 'bug') {
+            type = 'bug';
+        }
+        else if (issueTypeName === 'feature') {
+            type = 'feature';
+        }
+        // Map JIRA priority to ExternalItem priority
+        const priorityMap = {
+            'highest': 'P0',
+            'high': 'P1',
+            'medium': 'P2',
+            'low': 'P3',
+            'lowest': 'P4',
+        };
+        const priority = issue.fields.priority
+            ? priorityMap[issue.fields.priority.name.toLowerCase()]
+            : undefined;
+        // Extract acceptance criteria from description
+        const acceptanceCriteria = this.extractAcceptanceCriteria(issue.fields.description || '');
+        // Map JIRA status category to ExternalItem status
+        let status = 'open';
+        const statusCategory = issue.fields.status.statusCategory.key;
+        if (statusCategory === 'indeterminate') {
+            status = 'in-progress';
+        }
+        else if (statusCategory === 'done') {
+            status = 'completed';
+        }
+        return {
+            id: `JIRA-${issue.key}`,
+            type,
+            title: issue.fields.summary,
+            description: issue.fields.description || '',
+            status,
+            priority,
+            createdAt: new Date(issue.fields.created),
+            updatedAt: new Date(issue.fields.updated),
+            url: `${this.host}/browse/${issue.key}`,
+            labels: issue.fields.labels,
+            acceptanceCriteria,
+            parentId: issue.fields.parent ? `JIRA-${issue.fields.parent.key}` : undefined,
+            platform: 'jira',
+        };
+    }
+    /**
+     * Extract acceptance criteria from description
+     * Looks for patterns like:
+     * - AC1: ...
+     * - Acceptance Criteria:
+     * - Given/When/Then
+     */
+    extractAcceptanceCriteria(description) {
+        const criteria = [];
+        // Pattern 1: AC1:, AC2:, etc.
+        const acPattern = /AC\d+:\s*(.+)/gi;
+        let match;
+        while ((match = acPattern.exec(description)) !== null) {
+            criteria.push(match[1].trim());
+        }
+        // Pattern 2: Bullet points under "Acceptance Criteria:" heading
+        const acSectionMatch = description.match(/Acceptance Criteria:?\s*\n([\s\S]*?)(?:\n\n|\n#|$)/i);
+        if (acSectionMatch) {
+            const bullets = acSectionMatch[1].match(/^[\s*-]\s*(.+)/gm);
+            if (bullets) {
+                criteria.push(...bullets.map((b) => b.replace(/^[\s*-]\s*/, '').trim()));
+            }
+        }
+        // Pattern 3: Given/When/Then format
+        const gwtPattern = /Given\s+(.+?)\s+When\s+(.+?)\s+Then\s+(.+)/gi;
+        while ((match = gwtPattern.exec(description)) !== null) {
+            criteria.push(`Given ${match[1]} When ${match[2]} Then ${match[3]}`);
+        }
+        return criteria.length > 0 ? criteria : undefined;
+    }
+}
+//# sourceMappingURL=jira-importer.js.map

package/dist/src/importers/jira-importer.js.map

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

package/dist/src/init/repo/types.d.ts

@@ -77,9 +77,9 @@ export declare const RepositoryMetadataSchema: z.ZodObject<{
     language?: string;
     owner?: string;
     url?: string;
+    lastUpdated?: Date;
     private?: boolean;
     stars?: number;
-    lastUpdated?: Date;
     defaultBranch?: string;
 }, {
     name?: string;
@@ -87,9 +87,9 @@ export declare const RepositoryMetadataSchema: z.ZodObject<{
     language?: string;
     owner?: string;
     url?: string;
+    lastUpdated?: Date;
     private?: boolean;
     stars?: number;
-    lastUpdated?: Date;
     defaultBranch?: string;
 }>;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/integrations/jira/jira-mapper.d.ts

@@ -81,7 +81,7 @@ export declare class JiraMapper {
      */
     exportIncrementAsEpic(incrementId: string, projectKey: string): Promise<SyncResult>;
     /**
-     * Bidirectional sync between SpecWeave Increment and Jira Epic
+     * Three-permission sync between SpecWeave Increment and Jira Epic
      */
     syncIncrement(incrementId: string): Promise<SyncResult>;
     private getNextIncrementId;

package/dist/src/integrations/jira/jira-mapper.js

@@ -188,7 +188,7 @@ export class JiraMapper {
         }
     }
     /**
-     * Bidirectional sync between SpecWeave Increment and Jira Epic
+     * Three-permission sync between SpecWeave Increment and Jira Epic
      */
     async syncIncrement(incrementId) {
         console.log(`\n🔄 Syncing Increment ${incrementId} with Jira...`);