specweave 0.22.13 → 0.23.0

package/dist/src/importers/import-coordinator.js

@@ -0,0 +1,224 @@
+/**
+ * Import Coordinator
+ *
+ * Orchestrates multi-platform imports from GitHub, JIRA, and Azure DevOps.
+ * Handles parallel execution, progress tracking, and result aggregation.
+ */
+import { GitHubImporter } from './github-importer.js';
+import { JiraImporter } from './jira-importer.js';
+import { ADOImporter } from './ado-importer.js';
+import { updateSyncMetadata } from '../sync/sync-metadata.js';
+import { RateLimiter } from './rate-limiter.js';
+/**
+ * Import Coordinator
+ */
+export class ImportCoordinator {
+    constructor(config) {
+        this.importers = new Map();
+        this.rateLimiter = null;
+        this.config = {
+            enableSyncMetadata: true,
+            enableRateLimiting: true,
+            projectRoot: process.cwd(),
+            ...config,
+        };
+        this.projectRoot = this.config.projectRoot;
+        // Initialize rate limiter if enabled
+        if (this.config.enableRateLimiting) {
+            this.rateLimiter = new RateLimiter();
+        }
+        this.initializeImporters();
+    }
+    /**
+     * Initialize importers based on configuration
+     */
+    initializeImporters() {
+        // GitHub importer
+        if (this.config.github) {
+            try {
+                const importer = new GitHubImporter(this.config.github.owner, this.config.github.repo, this.config.github.token);
+                this.importers.set('github', importer);
+            }
+            catch (error) {
+                console.warn(`Failed to initialize GitHub importer: ${error.message}`);
+            }
+        }
+        // JIRA importer
+        if (this.config.jira) {
+            try {
+                const importer = new JiraImporter(this.config.jira.host, this.config.jira.email, this.config.jira.apiToken);
+                this.importers.set('jira', importer);
+            }
+            catch (error) {
+                console.warn(`Failed to initialize JIRA importer: ${error.message}`);
+            }
+        }
+        // Azure DevOps importer
+        if (this.config.ado) {
+            try {
+                const importer = new ADOImporter(this.config.ado.orgUrl, this.config.ado.project, this.config.ado.pat);
+                this.importers.set('ado', importer);
+            }
+            catch (error) {
+                console.warn(`Failed to initialize ADO importer: ${error.message}`);
+            }
+        }
+        if (this.importers.size === 0) {
+            throw new Error('No importers configured. Provide at least one platform configuration.');
+        }
+    }
+    /**
+     * Import from all configured platforms
+     */
+    async importAll() {
+        const parallel = this.config.parallel !== false; // Default to true
+        if (parallel) {
+            return this.importParallel();
+        }
+        else {
+            return this.importSequential();
+        }
+    }
+    /**
+     * Import from platforms in parallel
+     */
+    async importParallel() {
+        const promises = Array.from(this.importers.entries()).map(([platform, importer]) => this.importFromPlatform(platform, importer));
+        const results = await Promise.allSettled(promises);
+        return this.aggregateResults(results);
+    }
+    /**
+     * Import from platforms sequentially
+     */
+    async importSequential() {
+        const results = [];
+        for (const [platform, importer] of this.importers.entries()) {
+            try {
+                const result = await this.importFromPlatform(platform, importer);
+                results.push({ status: 'fulfilled', value: result });
+            }
+            catch (error) {
+                results.push({
+                    status: 'rejected',
+                    reason: error,
+                });
+            }
+        }
+        return this.aggregateResults(results);
+    }
+    /**
+     * Import from a single platform with progress tracking
+     */
+    async importFromPlatform(platform, importer) {
+        const errors = [];
+        const items = [];
+        try {
+            // Use pagination for progress tracking
+            for await (const page of importer.paginate(this.config.importConfig)) {
+                items.push(...page);
+                // Report progress
+                if (this.config.onProgress) {
+                    this.config.onProgress(platform, items.length);
+                }
+            }
+            // Update sync metadata if enabled
+            if (this.config.enableSyncMetadata && items.length > 0) {
+                const metadata = {
+                    lastImport: new Date().toISOString(),
+                    lastImportCount: items.length,
+                    lastSyncResult: errors.length > 0 ? 'partial' : 'success',
+                };
+                try {
+                    updateSyncMetadata(this.projectRoot, platform, metadata);
+                }
+                catch (error) {
+                    // Log metadata update error but don't fail the import
+                    errors.push(`Failed to update sync metadata: ${error.message}`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(error.message || String(error));
+            // Update sync metadata with failed status
+            if (this.config.enableSyncMetadata) {
+                const metadata = {
+                    lastImport: new Date().toISOString(),
+                    lastImportCount: 0,
+                    lastSyncResult: 'failed',
+                };
+                try {
+                    updateSyncMetadata(this.projectRoot, platform, metadata);
+                }
+                catch {
+                    // Ignore metadata update errors on failed imports
+                }
+            }
+        }
+        return {
+            count: items.length,
+            items,
+            errors,
+            platform: importer.platform,
+        };
+    }
+    /**
+     * Aggregate results from all platforms
+     */
+    aggregateResults(results) {
+        const allResults = [];
+        const allItems = [];
+        const errors = {};
+        const platforms = [];
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                const importResult = result.value;
+                allResults.push(importResult);
+                allItems.push(...importResult.items);
+                platforms.push(importResult.platform);
+                if (importResult.errors.length > 0) {
+                    errors[importResult.platform] = importResult.errors;
+                }
+            }
+            else {
+                // Rejected promise
+                const error = result.reason;
+                const errorMsg = error?.message || String(error);
+                // Try to determine which platform failed
+                const platformMatch = errorMsg.match(/(GitHub|JIRA|ADO)/i);
+                const platform = platformMatch ? platformMatch[1].toLowerCase() : 'unknown';
+                errors[platform] = errors[platform] || [];
+                errors[platform].push(errorMsg);
+            }
+        }
+        return {
+            results: allResults,
+            totalCount: allItems.length,
+            allItems,
+            errors,
+            platforms,
+        };
+    }
+    /**
+     * Import from a specific platform only
+     */
+    async importFrom(platform) {
+        const importer = this.importers.get(platform);
+        if (!importer) {
+            throw new Error(`${platform} importer not configured`);
+        }
+        return this.importFromPlatform(platform, importer);
+    }
+    /**
+     * Get list of configured platforms
+     */
+    getConfiguredPlatforms() {
+        return Array.from(this.importers.keys());
+    }
+    /**
+     * Check if a platform is configured
+     */
+    isPlatformConfigured(platform) {
+        return this.importers.has(platform);
+    }
+}
+//# sourceMappingURL=import-coordinator.js.map

package/dist/src/importers/import-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-coordinator.js","sourceRoot":"","sources":["../../../src/importers/import-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAA6B,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AAqEpE;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAM5B,YAAY,MAAyB;QAL7B,cAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;QAE7C,gBAAW,GAAuB,IAAI,CAAC;QAI7C,IAAI,CAAC,MAAM,GAAG;YACZ,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;YAC1B,GAAG,MAAM;SACV,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAY,CAAC;QAE5C,qCAAqC;QACrC,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,kBAAkB;QAClB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,cAAc,CACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CACzB,CAAC;gBACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,yCAAyC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,YAAY,CAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAC1B,CAAC;gBACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,uCAAuC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,WAAW,CAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CACpB,CAAC;gBACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,sCAAsC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,kBAAkB;QAEnE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CACjF,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAC5C,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEnD,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,OAAO,GAA8C,EAAE,CAAC;QAE9D,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACvD,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,UAAU;oBAClB,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE,QAAkB;QACnE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAmB,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,uCAAuC;YACvC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBAEpB,kBAAkB;gBAClB,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;oBAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAED,kCAAkC;YAClC,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAyB;oBACrC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACpC,eAAe,EAAE,KAAK,CAAC,MAAM;oBAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;iBAC1D,CAAC;gBAEF,IAAI,CAAC;oBACH,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,QAAqC,EAAE,QAAQ,CAAC,CAAC;gBACxF,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,sDAAsD;oBACtD,MAAM,CAAC,IAAI,CAAC,mCAAmC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAE5C,0CAA0C;YAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACnC,MAAM,QAAQ,GAAyB;oBACrC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACpC,eAAe,EAAE,CAAC;oBAClB,cAAc,EAAE,QAAQ;iBACzB,CAAC;gBAEF,IAAI,CAAC;oBACH,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,QAAqC,EAAE,QAAQ,CAAC,CAAC;gBACxF,CAAC;gBAAC,MAAM,CAAC;oBACP,kDAAkD;gBACpD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,OAAkD;QAElD,MAAM,UAAU,GAAmB,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,MAAM,MAAM,GAA6B,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAqC,EAAE,CAAC;QAEvD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;gBAClC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;gBACrC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBAEtC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;gBACtD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC5B,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;gBAEjD,yCAAyC;gBACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBAC3D,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAE5E,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,QAAQ;YACR,MAAM;YACN,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,QAAmC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,0BAA0B,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAqC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,QAAmC;QACtD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/src/importers/item-converter.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Item Converter
+ *
+ * Converts external items (GitHub/JIRA/ADO) to SpecWeave living docs User Stories.
+ * CRITICAL: Does NOT create increments - only creates living docs.
+ */
+import type { ExternalItem } from './external-importer.js';
+export interface ConvertedUserStory {
+    /** User Story ID with E suffix (e.g., US-001E) */
+    id: string;
+    /** User Story title */
+    title: string;
+    /** User Story description */
+    description: string;
+    /** Acceptance criteria */
+    acceptanceCriteria: string[];
+    /** Priority (P0-P4) */
+    priority?: string;
+    /** Status (open, in-progress, completed) */
+    status: string;
+    /** External metadata */
+    metadata: {
+        externalId: string;
+        externalUrl: string;
+        externalPlatform: 'github' | 'jira' | 'ado';
+        importedAt: string;
+        createdAt: string;
+        updatedAt: string;
+        labels: string[];
+    };
+    /** Living docs file path */
+    filePath: string;
+    /** Living docs markdown content */
+    markdown: string;
+}
+export interface ItemConverterOptions {
+    /** Base directory for living docs (e.g., .specweave/docs/internal/specs) */
+    specsDir: string;
+    /** Starting US-ID number for imported items (default: 1) */
+    startingId?: number;
+    /** Project root for FS-ID allocator and ID registry */
+    projectRoot?: string;
+    /** Enable feature-level organization with FS-ID allocation */
+    enableFeatureAllocation?: boolean;
+    /** Enable duplicate detection (default: true) */
+    enableDuplicateDetection?: boolean;
+    /** Callback for skipped duplicates */
+    onDuplicateSkipped?: (externalId: string, existingUsId: string) => void;
+}
+/**
+ * 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 declare class ItemConverter {
+    private options;
+    private duplicateDetector;
+    constructor(options: ItemConverterOptions);
+    /**
+     * Convert a single external item to a User Story with E suffix
+     */
+    convertItem(item: ExternalItem, usId: number): ConvertedUserStory;
+    /**
+     * Convert multiple external items to User Stories
+     *
+     * CRITICAL: This method ONLY creates living docs files.
+     * It does NOT create increments.
+     */
+    convertItems(items: ExternalItem[]): Promise<ConvertedUserStory[]>;
+    /**
+     * Map external status to SpecWeave status
+     */
+    private mapStatus;
+    /**
+     * Generate origin badge for living docs
+     */
+    private generateOriginBadge;
+    /**
+     * Generate markdown content for living docs User Story
+     */
+    private generateMarkdown;
+    /**
+     * Generate file name for living docs User Story
+     *
+     * Format: us-001e-title-here.md
+     */
+    private generateFileName;
+    /**
+     * Validate that no increments were created
+     *
+     * CRITICAL: This validation ensures we're not auto-creating increments.
+     */
+    static validateNoIncrementsCreated(projectRoot: string): void;
+}
+//# sourceMappingURL=item-converter.d.ts.map

package/dist/src/importers/item-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-converter.d.ts","sourceRoot":"","sources":["../../../src/importers/item-converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQ3D,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IAEX,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;QAC5C,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAEF,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IAEjB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8DAA8D;IAC9D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,iDAAiD;IACjD,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,iBAAiB,CAAkC;gBAE/C,OAAO,EAAE,oBAAoB;IAczC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB;IA0DjE;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAwCxE;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6ExB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAsB9D"}

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

@@ -0,0 +1,246 @@
+/**
+ * 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';
+import { DuplicateDetector } from './duplicate-detector.js';
+/**
+ * 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.duplicateDetector = null;
+        this.options = {
+            enableDuplicateDetection: true,
+            ...options,
+        };
+        // Initialize duplicate detector if enabled
+        if (this.options.enableDuplicateDetection) {
+            this.duplicateDetector = new DuplicateDetector({
+                specsDir: this.options.specsDir,
+            });
+        }
+    }
+    /**
+     * 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 = [];
+        let skippedCount = 0;
+        // 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];
+            // Check for duplicates if duplicate detection is enabled
+            if (this.duplicateDetector) {
+                const existingReference = await this.duplicateDetector.findExternalIdReference(item.id);
+                if (existingReference) {
+                    skippedCount++;
+                    // Notify callback if provided
+                    if (this.options.onDuplicateSkipped) {
+                        this.options.onDuplicateSkipped(item.id, existingReference.usId);
+                    }
+                    // Skip this item (duplicate)
+                    continue;
+                }
+            }
+            const usId = startingId + (i - skippedCount);
+            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":"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"}

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"}