specweave 0.29.2 → 0.30.1

package/dist/src/living-docs/epic-id-allocator.js

@@ -0,0 +1,363 @@
+/**
+ * Epic ID Allocator - Intelligent Epic ID allocation with chronological placement
+ *
+ * Allocates EP-XXX IDs for external work items (ADO Capabilities, Strategic Themes)
+ * based on creation date, attempting chronological insertion while preventing collisions.
+ *
+ * Features:
+ * - Chronological ID allocation based on work item creation date
+ * - Gap filling (insert EP-011E between EP-010 and EP-020)
+ * - Append mode fallback (max ID + 1)
+ * - Collision detection (checks both EP-XXX and EP-XXXE)
+ * - Archive-aware (scans both active and archived epics)
+ *
+ * @module living-docs/epic-id-allocator
+ * @version 0.29.3
+ */
+import * as fs from '../utils/fs-native.js';
+import path from 'path';
+import matter from 'gray-matter';
+import { formatOrigin } from '../core/types/origin-metadata.js';
+import { consoleLogger } from '../utils/logger.js';
+/**
+ * Epic ID Allocator
+ *
+ * Intelligently allocates Epic IDs with chronological placement.
+ * Epics are stored in _epics/ folder at the specs root level.
+ *
+ * CRITICAL: In umbrella/multi-repo setups, enable globalCollisionDetection
+ * to prevent ID collisions like EP-001 in one repo and EP-001E in another.
+ */
+export class EpicIdAllocator {
+    constructor(projectRoot, options) {
+        this.existingEpics = new Map();
+        this.scanned = false;
+        this.projectRoot = projectRoot;
+        this.specsPath = path.join(projectRoot, '.specweave/docs/internal/specs');
+        // Epics are at the root level: _epics/ (NOT inside project folders)
+        this.epicsPath = path.join(this.specsPath, '_epics');
+        this.globalCollisionDetection = options?.globalCollisionDetection ?? false;
+        this.externalContainer = options?.externalContainer;
+        this.logger = options?.logger ?? consoleLogger;
+    }
+    /**
+     * Scan existing EP-IDs (both active and archived)
+     *
+     * CRITICAL: Archives are scanned to prevent ID reuse
+     *
+     * Structure:
+     * - _epics/EP-XXX/
+     * - _epics/_archive/EP-XXX/
+     */
+    async scanExistingIds() {
+        this.existingEpics.clear();
+        // Scan active epics
+        if (await fs.pathExists(this.epicsPath)) {
+            await this.scanDirectory(this.epicsPath, 'active');
+        }
+        // Scan archived epics
+        const archivePath = path.join(this.epicsPath, '_archive');
+        if (await fs.pathExists(archivePath)) {
+            await this.scanDirectory(archivePath, 'archived');
+        }
+        this.scanned = true;
+        this.logger.log(`📊 Scanned ${this.existingEpics.size} existing Epic IDs`);
+    }
+    /**
+     * Scan directory for EP-XXX folders
+     */
+    async scanDirectory(dirPath, source) {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            // Match EP-XXX or EP-XXXE pattern (3+ digits)
+            const match = entry.name.match(/^(EP-\d{3,}E?)$/);
+            if (!match)
+                continue;
+            const epId = match[1];
+            const epicPath = path.join(dirPath, entry.name);
+            // Try to parse epic metadata from EPIC.md
+            const metadata = await this.parseEpicMetadata(epicPath, epId);
+            if (metadata) {
+                this.existingEpics.set(epId, metadata);
+            }
+        }
+    }
+    /**
+     * Parse epic metadata from EPIC.md frontmatter
+     */
+    async parseEpicMetadata(epicPath, epId) {
+        // Try EPIC.md first, then README.md
+        const possibleFiles = ['EPIC.md', 'README.md', 'epic.md', 'readme.md'];
+        for (const filename of possibleFiles) {
+            const filePath = path.join(epicPath, filename);
+            if (await fs.pathExists(filePath)) {
+                try {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const parsed = matter(content);
+                    const frontmatter = parsed.data;
+                    // Normalize timestamp
+                    const rawTimestamp = frontmatter.created || frontmatter.createdAt || new Date(0);
+                    const timestamp = rawTimestamp instanceof Date ? rawTimestamp.toISOString() : rawTimestamp;
+                    const normalizedTimestamp = timestamp.replace(/\.\d{3}Z$/, 'Z');
+                    return {
+                        id: epId,
+                        createdAt: normalizedTimestamp,
+                        origin: epId.endsWith('E') ? 'external' : 'internal',
+                        externalId: frontmatter.external_id || frontmatter.externalId,
+                        path: epicPath
+                    };
+                }
+                catch (error) {
+                    // Continue to next file
+                    continue;
+                }
+            }
+        }
+        // Fallback: create minimal metadata if no file found
+        return {
+            id: epId,
+            createdAt: new Date(0).toISOString(), // Epoch (will sort to beginning)
+            origin: epId.endsWith('E') ? 'external' : 'internal',
+            path: epicPath
+        };
+    }
+    /**
+     * Allocate EP-ID for external work item with chronological placement
+     *
+     * Algorithm:
+     * 1. Sort existing IDs by creation date
+     * 2. Find chronological insertion point based on work item creation date
+     * 3. Check for ID gaps between consecutive epics
+     * 4. If gap exists, allocate next ID in gap (e.g., EP-011E between EP-010 and EP-020)
+     * 5. If no gap, append to end (max ID + 1 with E suffix)
+     *
+     * CRITICAL: Unified numeric sequence - EP-XXX and EP-XXXE never share same index
+     *
+     * @param workItem - External epic item to allocate ID for
+     * @returns Allocation result with ID and strategy
+     */
+    async allocateId(workItem) {
+        if (!this.scanned) {
+            await this.scanExistingIds();
+        }
+        // Handle empty case (first epic)
+        if (this.existingEpics.size === 0) {
+            const result = {
+                id: 'EP-001E',
+                strategy: 'first',
+                reason: 'First external epic in project',
+                number: 1
+            };
+            // Track allocated IDs to prevent duplicates in same session
+            this.trackAllocatedId(result.id, workItem.createdAt);
+            return result;
+        }
+        // Sort epics by creation date
+        const sortedEpics = Array.from(this.existingEpics.values()).sort((a, b) => {
+            return new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime();
+        });
+        // Find chronological insertion point
+        const workItemDate = new Date(workItem.createdAt).getTime();
+        let insertionIndex = sortedEpics.findIndex(e => new Date(e.createdAt).getTime() > workItemDate);
+        // If work item is after all existing epics, append
+        if (insertionIndex === -1) {
+            const maxId = this.getMaxId();
+            const nextNumber = maxId + 1;
+            const nextId = `EP-${String(nextNumber).padStart(3, '0')}E`;
+            // Check for collision
+            if (this.hasCollision(nextId)) {
+                throw new Error(`ID collision: ${nextId} already exists`);
+            }
+            const result = {
+                id: nextId,
+                strategy: 'append',
+                reason: `Work item created after all existing epics (${new Date(workItem.createdAt).toISOString()})`,
+                number: nextNumber
+            };
+            this.trackAllocatedId(result.id, workItem.createdAt);
+            return result;
+        }
+        // Try chronological insertion into gap
+        const beforeEpic = insertionIndex > 0 ? sortedEpics[insertionIndex - 1] : null;
+        const afterEpic = sortedEpics[insertionIndex];
+        if (beforeEpic && afterEpic) {
+            const beforeNumber = this.extractNumber(beforeEpic.id);
+            const afterNumber = this.extractNumber(afterEpic.id);
+            // Check if there's a gap (at least 2 numbers apart)
+            if (afterNumber - beforeNumber > 1) {
+                // Allocate next ID after beforeEpic
+                const nextNumber = beforeNumber + 1;
+                const nextId = `EP-${String(nextNumber).padStart(3, '0')}E`;
+                // Check for collision
+                if (!this.hasCollision(nextId)) {
+                    const result = {
+                        id: nextId,
+                        strategy: 'chronological-insert',
+                        reason: `Inserted chronologically between ${beforeEpic.id} and ${afterEpic.id}`,
+                        number: nextNumber
+                    };
+                    this.trackAllocatedId(result.id, workItem.createdAt);
+                    return result;
+                }
+                else {
+                    const collidingId = this.findCollidingId(nextNumber);
+                    this.logger.warn(`⚠️ Numeric collision prevented: ${collidingId} exists, skipping index ${nextNumber}`);
+                }
+            }
+        }
+        // Fallback: append to end if gap insertion failed
+        const maxId = this.getMaxId();
+        const nextNumber = maxId + 1;
+        const nextId = `EP-${String(nextNumber).padStart(3, '0')}E`;
+        // Check for collision
+        if (this.hasCollision(nextId)) {
+            throw new Error(`ID collision: ${nextId} already exists`);
+        }
+        const result = {
+            id: nextId,
+            strategy: 'append',
+            reason: 'Gap insertion not possible, appended to end',
+            number: nextNumber
+        };
+        this.trackAllocatedId(result.id, workItem.createdAt);
+        return result;
+    }
+    /**
+     * Track a newly allocated ID to prevent duplicates in the same session
+     */
+    trackAllocatedId(id, createdAt) {
+        this.existingEpics.set(id, {
+            id,
+            createdAt,
+            origin: 'external',
+            path: ''
+        });
+    }
+    /**
+     * Check if ID has collision (exact match or variant)
+     */
+    hasCollision(id) {
+        // Exact match
+        if (this.existingEpics.has(id)) {
+            return true;
+        }
+        // Variant match (check both EP-XXX and EP-XXXE)
+        const number = this.extractNumber(id);
+        const internalId = `EP-${String(number).padStart(3, '0')}`;
+        const externalId = `EP-${String(number).padStart(3, '0')}E`;
+        return this.existingEpics.has(internalId) || this.existingEpics.has(externalId);
+    }
+    /**
+     * Get maximum numeric ID value (ignoring E suffix)
+     */
+    getMaxId() {
+        if (this.existingEpics.size === 0) {
+            return 0;
+        }
+        const numbers = Array.from(this.existingEpics.keys()).map(id => this.extractNumber(id));
+        return Math.max(...numbers);
+    }
+    /**
+     * Extract numeric part from EP-ID
+     */
+    extractNumber(id) {
+        const match = id.match(/^EP-(\d{3,})E?$/);
+        if (!match) {
+            throw new Error(`Invalid EP-ID format: ${id}`);
+        }
+        return parseInt(match[1], 10);
+    }
+    /**
+     * Find which epic ID is using a numeric index
+     */
+    findCollidingId(index) {
+        const internalId = `EP-${String(index).padStart(3, '0')}`;
+        const externalId = `EP-${String(index).padStart(3, '0')}E`;
+        if (this.existingEpics.has(internalId)) {
+            return internalId;
+        }
+        if (this.existingEpics.has(externalId)) {
+            return externalId;
+        }
+        return `index ${index}`;
+    }
+    /**
+     * Get all existing epic IDs (sorted by creation date)
+     */
+    getExistingEpics() {
+        return Array.from(this.existingEpics.values()).sort((a, b) => {
+            return new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime();
+        });
+    }
+    /**
+     * Get allocation statistics
+     */
+    getStats() {
+        const epics = Array.from(this.existingEpics.values());
+        return {
+            total: epics.length,
+            active: epics.filter(e => !e.path.includes('/_archive/')).length,
+            archived: epics.filter(e => e.path.includes('/_archive/')).length,
+            internal: epics.filter(e => e.origin === 'internal').length,
+            external: epics.filter(e => e.origin === 'external').length,
+            maxId: this.getMaxId()
+        };
+    }
+    /**
+     * Create epic folder with EPIC.md and metadata
+     *
+     * Structure:
+     * - _epics/EP-XXX/EPIC.md
+     *
+     * @param epId - Epic ID (e.g., "EP-042E")
+     * @param workItem - External epic item metadata
+     * @param metadata - External item metadata for origin tracking
+     * @returns Path to created epic folder
+     */
+    async createEpicFolder(epId, workItem, metadata) {
+        // Epics are at root level: _epics/EP-XXX/
+        const epicPath = path.join(this.epicsPath, epId);
+        await fs.ensureDir(epicPath);
+        // Generate EPIC.md with frontmatter
+        const originBadge = formatOrigin(metadata);
+        const workItemTypeLabel = workItem.workItemType || 'Capability';
+        const epicContent = `---
+id: ${epId}
+title: "${workItem.title}"
+type: epic
+origin: external
+source: ${metadata.source}
+external_id: ${metadata.external_id}
+external_url: ${metadata.external_url}
+work_item_type: ${workItemTypeLabel}
+created: ${workItem.createdAt}
+imported_at: ${metadata.imported_at}
+---
+
+# ${workItemTypeLabel}: ${workItem.title}
+
+**Origin**: ${originBadge}
+
+## Description
+
+This ${workItemTypeLabel.toLowerCase()} was imported from an external tool.
+
+## Features in This Epic
+
+Features belonging to this ${workItemTypeLabel.toLowerCase()} will be listed here.
+
+## Status
+
+- **Created**: ${workItem.createdAt}
+- **Imported**: ${metadata.imported_at}
+- **External ID**: ${metadata.external_id}
+`;
+        const epicFilePath = path.join(epicPath, 'EPIC.md');
+        await fs.writeFile(epicFilePath, epicContent);
+        this.logger.log(`📁 Created Epic folder: ${epId}`);
+        return epicPath;
+    }
+}
+//# sourceMappingURL=epic-id-allocator.js.map

package/dist/src/living-docs/epic-id-allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-id-allocator.js","sourceRoot":"","sources":["../../../src/living-docs/epic-id-allocator.ts"],"names":[],"mappings":"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"}

package/dist/src/sync/external-change-puller.d.ts

@@ -0,0 +1,94 @@
+/**
+ * External Change Puller
+ *
+ * Pulls changes from external tools (ADO, JIRA, GitHub) back to SpecWeave.
+ * Implements the pull direction of bidirectional sync.
+ *
+ * Features:
+ * - Fetch recent changes from all configured platforms
+ * - Map external changes to living docs format
+ * - Support for timestamp-based filtering
+ *
+ * @module sync/external-change-puller
+ */
+import { Logger } from '../utils/logger.js';
+/**
+ * Generic external change interface
+ * Unifies changes from ADO, JIRA, and GitHub
+ */
+export interface ExternalChange {
+    platform: 'ado' | 'jira' | 'github';
+    externalId: string;
+    changedAt: string;
+    changedBy: string;
+    changedFields: Array<{
+        field: string;
+        oldValue: unknown;
+        newValue: unknown;
+    }>;
+    currentState: {
+        status: string;
+        priority: string | number | null;
+        assignee: string | null;
+    };
+}
+/**
+ * External change puller options
+ */
+export interface ExternalChangePullerOptions {
+    /**
+     * Project root directory
+     */
+    projectRoot: string;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Platforms to pull from
+     */
+    platforms?: Array<'ado' | 'jira' | 'github'>;
+}
+/**
+ * ExternalChangePuller - Fetches changes from external tools
+ *
+ * Aggregates changes from all configured external tools and
+ * transforms them into a unified format for processing.
+ */
+export declare class ExternalChangePuller {
+    private readonly projectRoot;
+    private readonly logger;
+    private readonly platforms;
+    constructor(options: ExternalChangePullerOptions);
+    /**
+     * Fetch recent changes from all configured platforms
+     *
+     * @param since - Timestamp to query changes from
+     * @param linkedItems - Optional map of platform -> item IDs to filter
+     * @returns Array of external changes from all platforms
+     */
+    fetchRecentChanges(since: Date, linkedItems?: {
+        ado?: number[];
+        jira?: string[];
+        github?: number[];
+    }): Promise<ExternalChange[]>;
+    /**
+     * Fetch changes from Azure DevOps
+     */
+    private fetchAdoChanges;
+    /**
+     * Fetch changes from JIRA
+     */
+    private fetchJiraChanges;
+    /**
+     * Fetch changes from GitHub
+     */
+    private fetchGitHubChanges;
+    /**
+     * Map external status to SpecWeave status
+     *
+     * Converts platform-specific status values to SpecWeave's status taxonomy.
+     */
+    mapToSpecWeaveStatus(platform: 'ado' | 'jira' | 'github', externalStatus: string): string;
+}
+//# sourceMappingURL=external-change-puller.d.ts.map

package/dist/src/sync/external-change-puller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-change-puller.d.ts","sourceRoot":"","sources":["../../../src/sync/external-change-puller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAI3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,KAAK,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;QACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;gBAEjD,OAAO,EAAE,2BAA2B;IAMhD;;;;;;OAMG;IACG,kBAAkB,CACtB,KAAK,EAAE,IAAI,EACX,WAAW,CAAC,EAAE;QACZ,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,GACA,OAAO,CAAC,cAAc,EAAE,CAAC;IA4C5B;;OAEG;YACW,eAAe;IA8B7B;;OAEG;YACW,gBAAgB;IA8B9B;;OAEG;YACW,kBAAkB;IAqChC;;;;OAIG;IACH,oBAAoB,CAClB,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,EACnC,cAAc,EAAE,MAAM,GACrB,MAAM;CA0BV"}

package/dist/src/sync/external-change-puller.js

@@ -0,0 +1,181 @@
+/**
+ * External Change Puller
+ *
+ * Pulls changes from external tools (ADO, JIRA, GitHub) back to SpecWeave.
+ * Implements the pull direction of bidirectional sync.
+ *
+ * Features:
+ * - Fetch recent changes from all configured platforms
+ * - Map external changes to living docs format
+ * - Support for timestamp-based filtering
+ *
+ * @module sync/external-change-puller
+ */
+import { consoleLogger } from '../utils/logger.js';
+/**
+ * ExternalChangePuller - Fetches changes from external tools
+ *
+ * Aggregates changes from all configured external tools and
+ * transforms them into a unified format for processing.
+ */
+export class ExternalChangePuller {
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.logger = options.logger ?? consoleLogger;
+        this.platforms = options.platforms ?? ['ado', 'jira', 'github'];
+    }
+    /**
+     * Fetch recent changes from all configured platforms
+     *
+     * @param since - Timestamp to query changes from
+     * @param linkedItems - Optional map of platform -> item IDs to filter
+     * @returns Array of external changes from all platforms
+     */
+    async fetchRecentChanges(since, linkedItems) {
+        const allChanges = [];
+        this.logger.log(`⬇️  Fetching changes since ${since.toISOString()}`);
+        // Fetch from each platform in parallel
+        const fetchPromises = [];
+        if (this.platforms.includes('ado')) {
+            fetchPromises.push(this.fetchAdoChanges(since, linkedItems?.ado)
+                .then(changes => { allChanges.push(...changes); })
+                .catch(err => { this.logger.warn(`ADO fetch failed: ${err.message}`); }));
+        }
+        if (this.platforms.includes('jira')) {
+            fetchPromises.push(this.fetchJiraChanges(since, linkedItems?.jira)
+                .then(changes => { allChanges.push(...changes); })
+                .catch(err => { this.logger.warn(`JIRA fetch failed: ${err.message}`); }));
+        }
+        if (this.platforms.includes('github')) {
+            fetchPromises.push(this.fetchGitHubChanges(since, linkedItems?.github)
+                .then(changes => { allChanges.push(...changes); })
+                .catch(err => { this.logger.warn(`GitHub fetch failed: ${err.message}`); }));
+        }
+        await Promise.all(fetchPromises);
+        // Sort by changedAt (most recent first)
+        allChanges.sort((a, b) => new Date(b.changedAt).getTime() - new Date(a.changedAt).getTime());
+        this.logger.log(`📥 Fetched ${allChanges.length} changes from external tools`);
+        return allChanges;
+    }
+    /**
+     * Fetch changes from Azure DevOps
+     */
+    async fetchAdoChanges(since, linkedItemIds) {
+        try {
+            // Dynamic import to avoid initialization errors when ADO is not configured
+            const { AdoClient } = await import('../integrations/ado/ado-client.js');
+            const client = new AdoClient();
+            const adoChanges = await client.fetchRecentChanges(since, linkedItemIds);
+            // Map to unified format
+            return adoChanges.map(change => ({
+                platform: 'ado',
+                externalId: change.externalId,
+                changedAt: change.changedAt,
+                changedBy: change.changedBy,
+                changedFields: change.changedFields,
+                currentState: {
+                    status: change.currentState.status,
+                    priority: change.currentState.priority,
+                    assignee: change.currentState.assignee,
+                },
+            }));
+        }
+        catch (err) {
+            this.logger.debug(`ADO not configured or error: ${err.message}`);
+            return [];
+        }
+    }
+    /**
+     * Fetch changes from JIRA
+     */
+    async fetchJiraChanges(since, linkedIssueKeys) {
+        try {
+            // Dynamic import to avoid initialization errors when JIRA is not configured
+            const { JiraClient } = await import('../integrations/jira/jira-client.js');
+            const client = new JiraClient();
+            const jiraChanges = await client.fetchRecentChanges(since, linkedIssueKeys);
+            // Map to unified format
+            return jiraChanges.map(change => ({
+                platform: 'jira',
+                externalId: change.externalId,
+                changedAt: change.changedAt,
+                changedBy: change.changedBy,
+                changedFields: change.changedFields,
+                currentState: {
+                    status: change.currentState.status,
+                    priority: change.currentState.priority,
+                    assignee: change.currentState.assignee,
+                },
+            }));
+        }
+        catch (err) {
+            this.logger.debug(`JIRA not configured or error: ${err.message}`);
+            return [];
+        }
+    }
+    /**
+     * Fetch changes from GitHub
+     */
+    async fetchGitHubChanges(since, linkedIssueNumbers) {
+        try {
+            // Dynamic import to avoid initialization errors when GitHub is not configured
+            const { GitHubClientV2 } = await import('../../plugins/specweave-github/lib/github-client-v2.js');
+            // Detect repo from git remote
+            const detected = await GitHubClientV2.detectRepo(this.projectRoot);
+            if (!detected) {
+                this.logger.debug('GitHub: No git remote detected');
+                return [];
+            }
+            const client = GitHubClientV2.fromRepo(detected.owner, detected.repo);
+            const githubChanges = await client.fetchRecentChanges(since, linkedIssueNumbers);
+            // Map to unified format (GitHub returns slightly different format)
+            return githubChanges.map(change => ({
+                platform: 'github',
+                externalId: change.externalId,
+                changedAt: change.changedAt,
+                changedBy: change.changedBy,
+                changedFields: change.changedFields,
+                currentState: {
+                    status: change.currentState.status,
+                    priority: null, // GitHub doesn't have priority
+                    assignee: change.currentState.assignee,
+                },
+            }));
+        }
+        catch (err) {
+            this.logger.debug(`GitHub not configured or error: ${err.message}`);
+            return [];
+        }
+    }
+    /**
+     * Map external status to SpecWeave status
+     *
+     * Converts platform-specific status values to SpecWeave's status taxonomy.
+     */
+    mapToSpecWeaveStatus(platform, externalStatus) {
+        // Status mapping by platform
+        const statusMaps = {
+            ado: {
+                'New': 'pending',
+                'Active': 'in_progress',
+                'Resolved': 'completed',
+                'Closed': 'completed',
+                'Removed': 'cancelled',
+            },
+            jira: {
+                'To Do': 'pending',
+                'In Progress': 'in_progress',
+                'Done': 'completed',
+                'Closed': 'completed',
+                'Won\'t Do': 'cancelled',
+            },
+            github: {
+                'open': 'in_progress',
+                'closed': 'completed',
+            },
+        };
+        const map = statusMaps[platform] || {};
+        return map[externalStatus] || externalStatus.toLowerCase().replace(/\s+/g, '_');
+    }
+}
+//# sourceMappingURL=external-change-puller.js.map

package/dist/src/sync/external-change-puller.js.map

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