specweave 0.22.13 → 0.22.14

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

@@ -0,0 +1,161 @@
+/**
+ * GitHub Importer
+ *
+ * Imports GitHub issues as External Items with pagination support.
+ * Handles rate limiting and converts GitHub-specific data to platform-agnostic format.
+ */
+import { Octokit } from '@octokit/rest';
+/**
+ * GitHub Importer Implementation
+ */
+export class GitHubImporter {
+    constructor(owner, repo, token) {
+        this.platform = 'github';
+        this.owner = owner;
+        this.repo = repo;
+        this.octokit = new Octokit({
+            auth: token || process.env.GITHUB_TOKEN,
+        });
+    }
+    /**
+     * 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 (100 per page)
+     */
+    async *paginate(config = {}) {
+        const { timeRangeMonths = 3, includeClosed = false, labels = [], milestone, maxItems = Infinity, } = config;
+        // Calculate since date
+        const since = new Date();
+        since.setMonth(since.getMonth() - timeRangeMonths);
+        let page = 1;
+        let totalFetched = 0;
+        while (totalFetched < maxItems) {
+            try {
+                // Fetch page from GitHub API
+                const response = await this.octokit.issues.listForRepo({
+                    owner: this.owner,
+                    repo: this.repo,
+                    state: includeClosed ? 'all' : 'open',
+                    since: since.toISOString(),
+                    labels: labels.join(','),
+                    milestone: milestone,
+                    per_page: 100,
+                    page,
+                });
+                // Check rate limiting
+                const remaining = parseInt(response.headers['x-ratelimit-remaining'] || '0', 10);
+                if (remaining < 10) {
+                    const resetTime = parseInt(response.headers['x-ratelimit-reset'] || '0', 10);
+                    const resetDate = new Date(resetTime * 1000);
+                    throw new Error(`GitHub rate limit approaching (${remaining} requests remaining). Resets at ${resetDate.toLocaleString()}`);
+                }
+                // Convert GitHub issues to ExternalItems
+                const items = response.data
+                    .filter((issue) => !issue.pull_request) // Exclude pull requests
+                    .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 (response.data.length < 100) {
+                    break;
+                }
+                page++;
+            }
+            catch (error) {
+                if (error.status === 403 && error.message.includes('rate limit')) {
+                    throw new Error(`GitHub rate limit exceeded: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+    }
+    /**
+     * Convert GitHub issue to ExternalItem
+     */
+    convertToExternalItem(issue) {
+        // Extract type from labels
+        let type = 'task';
+        const labelNames = issue.labels.map((l) => l.name.toLowerCase());
+        if (labelNames.includes('user-story') || labelNames.includes('story')) {
+            type = 'user-story';
+        }
+        else if (labelNames.includes('epic')) {
+            type = 'epic';
+        }
+        else if (labelNames.includes('bug')) {
+            type = 'bug';
+        }
+        else if (labelNames.includes('feature')) {
+            type = 'feature';
+        }
+        // Extract priority from labels (P0, P1, P2, P3, P4)
+        const priorityLabel = labelNames.find((l) => /^p[0-4]$/i.test(l));
+        const priority = priorityLabel ? priorityLabel.toUpperCase() : undefined;
+        // Extract acceptance criteria from body
+        const acceptanceCriteria = this.extractAcceptanceCriteria(issue.body || '');
+        // Map GitHub state to ExternalItem status
+        let status = 'open';
+        if (issue.state === 'closed') {
+            status = 'completed';
+        }
+        else if (labelNames.includes('in-progress') || labelNames.includes('in progress')) {
+            status = 'in-progress';
+        }
+        return {
+            id: `github#${issue.number}`,
+            type,
+            title: issue.title,
+            description: issue.body || '',
+            status,
+            priority,
+            createdAt: new Date(issue.created_at),
+            updatedAt: new Date(issue.updated_at),
+            url: issue.html_url,
+            labels: issue.labels.map((l) => l.name),
+            acceptanceCriteria: acceptanceCriteria.length > 0 ? acceptanceCriteria : undefined,
+            platform: 'github',
+        };
+    }
+    /**
+     * Extract acceptance criteria from issue body
+     * Looks for patterns like:
+     * - [ ] AC-001: ...
+     * - Acceptance Criteria: ...
+     */
+    extractAcceptanceCriteria(body) {
+        const criteria = [];
+        // Pattern 1: Checkbox list items starting with "AC"
+        const acPattern = /^[\s-]*\[[ x]\]\s+(AC[-:]?\s*\d+:?\s*.+)$/gim;
+        const acMatches = body.matchAll(acPattern);
+        for (const match of acMatches) {
+            criteria.push(match[1].trim());
+        }
+        // Pattern 2: "Acceptance Criteria" section
+        const sectionPattern = /(?:^|\n)##?\s*Acceptance Criteria\s*\n([\s\S]*?)(?=\n##|\n---|\z)/i;
+        const sectionMatch = body.match(sectionPattern);
+        if (sectionMatch) {
+            const section = sectionMatch[1];
+            const itemPattern = /^[\s-]*[•*-]\s*(.+)$/gm;
+            const itemMatches = section.matchAll(itemPattern);
+            for (const match of itemMatches) {
+                const item = match[1].trim();
+                if (!criteria.some((c) => c.includes(item))) {
+                    criteria.push(item);
+                }
+            }
+        }
+        return criteria;
+    }
+}
+//# sourceMappingURL=github-importer.js.map

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

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

package/dist/src/importers/import-coordinator.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Import Coordinator
+ *
+ * Orchestrates multi-platform imports from GitHub, JIRA, and Azure DevOps.
+ * Handles parallel execution, progress tracking, and result aggregation.
+ */
+import type { ExternalItem, ImportConfig, ImportResult } from './external-importer.js';
+export interface CoordinatorConfig {
+    /** Import from GitHub */
+    github?: {
+        owner: string;
+        repo: string;
+        token?: string;
+    };
+    /** Import from JIRA */
+    jira?: {
+        host: string;
+        email?: string;
+        apiToken?: string;
+    };
+    /** Import from Azure DevOps */
+    ado?: {
+        orgUrl: string;
+        project: string;
+        pat?: string;
+    };
+    /** Common import configuration */
+    importConfig?: ImportConfig;
+    /** Run imports in parallel (default: true) */
+    parallel?: boolean;
+    /** Progress callback */
+    onProgress?: (platform: string, count: number, total?: number) => void;
+}
+export interface CoordinatorResult {
+    /** Combined results from all platforms */
+    results: ImportResult[];
+    /** Total items imported across all platforms */
+    totalCount: number;
+    /** All imported items */
+    allItems: ExternalItem[];
+    /** Errors by platform */
+    errors: Record<string, string[]>;
+    /** Platforms that were imported from */
+    platforms: Array<'github' | 'jira' | 'ado'>;
+}
+/**
+ * Import Coordinator
+ */
+export declare class ImportCoordinator {
+    private importers;
+    private config;
+    constructor(config: CoordinatorConfig);
+    /**
+     * Initialize importers based on configuration
+     */
+    private initializeImporters;
+    /**
+     * Import from all configured platforms
+     */
+    importAll(): Promise<CoordinatorResult>;
+    /**
+     * Import from platforms in parallel
+     */
+    private importParallel;
+    /**
+     * Import from platforms sequentially
+     */
+    private importSequential;
+    /**
+     * Import from a single platform with progress tracking
+     */
+    private importFromPlatform;
+    /**
+     * Aggregate results from all platforms
+     */
+    private aggregateResults;
+    /**
+     * Import from a specific platform only
+     */
+    importFrom(platform: 'github' | 'jira' | 'ado'): Promise<ImportResult>;
+    /**
+     * Get list of configured platforms
+     */
+    getConfiguredPlatforms(): Array<'github' | 'jira' | 'ado'>;
+    /**
+     * Check if a platform is configured
+     */
+    isPlatformConfigured(platform: 'github' | 'jira' | 'ado'): boolean;
+}
+//# sourceMappingURL=import-coordinator.d.ts.map

package/dist/src/importers/import-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-coordinator.d.ts","sourceRoot":"","sources":["../../../src/importers/import-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAY,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKjG,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,uBAAuB;IACvB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,+BAA+B;IAC/B,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,kCAAkC;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjC,wCAAwC;IACxC,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAKrC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgD3B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAU7C;;OAEG;YACW,cAAc;IAU5B;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,kBAAkB;IA0BhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyCxB;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAU5E;;OAEG;IACH,sBAAsB,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IAI1D;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO;CAGnE"}

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

@@ -0,0 +1,182 @@
+/**
+ * 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 Coordinator
+ */
+export class ImportCoordinator {
+    constructor(config) {
+        this.importers = new Map();
+        this.config = config;
+        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);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(error.message || String(error));
+        }
+        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":"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"}

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

@@ -0,0 +1,91 @@
+/**
+ * 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;
+}
+/**
+ * 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;
+    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;AAO3D,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;CACnC;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,EAAE,oBAAoB;IAIzC;;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;IAsBxE;;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"}