specweave 0.32.2 → 0.32.5

package/dist/src/core/living-docs/cross-project-sync.js

@@ -0,0 +1,135 @@
+/**
+ * Cross-Project Sync Orchestrator
+ *
+ * Handles syncing increments that span multiple projects.
+ * Groups user stories by their target project and syncs each group
+ * to the appropriate project folder in living docs.
+ *
+ * @module core/living-docs/cross-project-sync
+ * @since v0.33.0
+ */
+import * as path from 'node:path';
+import { consoleLogger } from '../../utils/logger.js';
+import { ensureDir } from '../../utils/fs-native.js';
+/**
+ * Cross-Project Sync Orchestrator
+ */
+export class CrossProjectSync {
+    constructor(projectRoot, options = {}) {
+        this.projectRoot = projectRoot;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Group user stories by their target project
+     *
+     * @param userStories - User stories to group
+     * @param defaultProject - Default project for USs without explicit project
+     * @returns Map of project ID to user stories
+     */
+    groupByProject(userStories, defaultProject) {
+        const groups = new Map();
+        for (const us of userStories) {
+            const project = us.project || defaultProject;
+            if (!groups.has(project)) {
+                groups.set(project, []);
+            }
+            groups.get(project).push(us);
+        }
+        return groups;
+    }
+    /**
+     * Check if an increment is cross-project (spans multiple projects)
+     */
+    isCrossProject(userStories, defaultProject) {
+        const groups = this.groupByProject(userStories, defaultProject);
+        return groups.size > 1;
+    }
+    /**
+     * Get the specs folder path for a project
+     */
+    getProjectSpecsPath(projectId) {
+        return path.join(this.projectRoot, '.specweave/docs/internal/specs', projectId);
+    }
+    /**
+     * Get the feature folder path for a project and feature
+     */
+    getFeaturePath(projectId, featureId) {
+        return path.join(this.getProjectSpecsPath(projectId), featureId);
+    }
+    /**
+     * Ensure project specs folder exists
+     */
+    async ensureProjectFolder(projectId) {
+        const folderPath = this.getProjectSpecsPath(projectId);
+        await ensureDir(folderPath);
+        return folderPath;
+    }
+    /**
+     * Ensure feature folder exists within a project
+     */
+    async ensureFeatureFolder(projectId, featureId) {
+        const folderPath = this.getFeaturePath(projectId, featureId);
+        await ensureDir(folderPath);
+        return folderPath;
+    }
+    /**
+     * Generate cross-references section for FEATURE.md
+     *
+     * @param featureId - The feature ID (e.g., "FS-125")
+     * @param allProjects - All projects this feature spans
+     * @param currentProject - The current project being generated
+     * @returns Markdown content for "Related Projects" section
+     */
+    generateCrossReferences(featureId, allProjects, currentProject) {
+        const otherProjects = allProjects.filter(p => p !== currentProject);
+        if (otherProjects.length === 0) {
+            return '';
+        }
+        const lines = [
+            '',
+            '## Related Projects',
+            '',
+            'This feature spans multiple projects:',
+            ''
+        ];
+        for (const projectId of otherProjects) {
+            // Relative path from current project to other project
+            const relativePath = `../../${projectId}/${featureId}/`;
+            lines.push(`- [${projectId}](${relativePath})`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate cross-reference frontmatter for US files
+     */
+    generateRelatedProjectsFrontmatter(allProjects, currentProject) {
+        const otherProjects = allProjects.filter(p => p !== currentProject);
+        if (otherProjects.length === 0) {
+            return '';
+        }
+        return `related_projects: [${otherProjects.join(', ')}]`;
+    }
+    /**
+     * Log cross-project sync summary
+     */
+    logSyncSummary(result) {
+        this.logger.log('');
+        this.logger.log('📦 Cross-Project Sync Summary:');
+        this.logger.log(`   Projects: ${result.projectCount}`);
+        this.logger.log(`   User Stories: ${result.totalUserStories}`);
+        for (const project of result.projects) {
+            const status = project.success ? '✅' : '❌';
+            this.logger.log(`   ${status} ${project.projectId}: ${project.userStories.length} USs`);
+            if (project.errors.length > 0) {
+                for (const error of project.errors) {
+                    this.logger.warn(`      ⚠️ ${error}`);
+                }
+            }
+        }
+        if (result.crossReferences.length > 0) {
+            this.logger.log(`   🔗 Cross-references: ${result.crossReferences.length} links created`);
+        }
+    }
+}
+//# sourceMappingURL=cross-project-sync.js.map

package/dist/src/core/living-docs/cross-project-sync.js.map

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

package/dist/src/core/living-docs/external-sync-orchestrator.d.ts

@@ -0,0 +1,106 @@
+/**
+ * External Sync Orchestrator
+ *
+ * Coordinates syncing user stories to multiple external tools based on
+ * per-US project targeting. Groups USs by their target project and
+ * syncs each group to the appropriate external system.
+ *
+ * @module core/living-docs/external-sync-orchestrator
+ * @since v0.33.0
+ */
+import type { UserStoryData } from './types.js';
+import type { USExternalRefsMap } from '../types/increment-metadata.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Project mapping configuration
+ */
+export interface ProjectMapping {
+    github?: {
+        owner: string;
+        repo: string;
+    };
+    jira?: {
+        project: string;
+        board?: string;
+    };
+    ado?: {
+        project: string;
+        areaPath?: string;
+    };
+}
+/**
+ * Result of syncing a single US to an external tool
+ */
+export interface USSyncResult {
+    usId: string;
+    provider: 'github' | 'jira' | 'ado';
+    success: boolean;
+    issueNumber?: number | string;
+    url?: string;
+    error?: string;
+}
+/**
+ * Result of syncing all USs in a project group
+ */
+export interface ProjectSyncResult {
+    projectId: string;
+    provider: 'github' | 'jira' | 'ado';
+    success: boolean;
+    synced: USSyncResult[];
+    errors: string[];
+}
+/**
+ * Result of complete cross-project sync
+ */
+export interface CrossProjectExternalSyncResult {
+    success: boolean;
+    projects: ProjectSyncResult[];
+    externalRefs: USExternalRefsMap;
+    summary: {
+        totalUSs: number;
+        syncedUSs: number;
+        failedUSs: number;
+        projectCount: number;
+    };
+}
+/**
+ * External Sync Orchestrator
+ */
+export declare class ExternalSyncOrchestrator {
+    private projectRoot;
+    private logger;
+    private projectMappings;
+    constructor(projectRoot: string, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Load project mappings from config
+     */
+    loadProjectMappings(): Promise<void>;
+    /**
+     * Get project mapping for a project ID
+     */
+    getProjectMapping(projectId: string): ProjectMapping | undefined;
+    /**
+     * Group user stories by their target project
+     */
+    groupUSsByProject(userStories: UserStoryData[], defaultProject: string): Map<string, UserStoryData[]>;
+    /**
+     * Get preferred provider for a US
+     * Priority: US.externalProvider > first available in mapping
+     */
+    getPreferredProvider(us: UserStoryData, mapping: ProjectMapping): 'github' | 'jira' | 'ado' | null;
+    /**
+     * Build external refs map from sync results
+     */
+    buildExternalRefsMap(results: ProjectSyncResult[]): USExternalRefsMap;
+    /**
+     * Log sync summary
+     */
+    logSyncSummary(result: CrossProjectExternalSyncResult): void;
+    /**
+     * Create placeholder sync result for dry-run or when sync is skipped
+     */
+    createPlaceholderResult(userStories: UserStoryData[], defaultProject: string): CrossProjectExternalSyncResult;
+}
+//# sourceMappingURL=external-sync-orchestrator.d.ts.map

package/dist/src/core/living-docs/external-sync-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-sync-orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/external-sync-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAsC;gBAEjD,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAKlE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAa1C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIhE;;OAEG;IACH,iBAAiB,CACf,WAAW,EAAE,aAAa,EAAE,EAC5B,cAAc,EAAE,MAAM,GACrB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAe/B;;;OAGG;IACH,oBAAoB,CAClB,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,cAAc,GACtB,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAcnC;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,iBAAiB;IAwBrE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,8BAA8B,GAAG,IAAI;IAkB5D;;OAEG;IACH,uBAAuB,CACrB,WAAW,EAAE,aAAa,EAAE,EAC5B,cAAc,EAAE,MAAM,GACrB,8BAA8B;CA0BlC"}

package/dist/src/core/living-docs/external-sync-orchestrator.js

@@ -0,0 +1,146 @@
+/**
+ * External Sync Orchestrator
+ *
+ * Coordinates syncing user stories to multiple external tools based on
+ * per-US project targeting. Groups USs by their target project and
+ * syncs each group to the appropriate external system.
+ *
+ * @module core/living-docs/external-sync-orchestrator
+ * @since v0.33.0
+ */
+import * as path from 'node:path';
+import { consoleLogger } from '../../utils/logger.js';
+import { pathExists, readJson } from './sync-helpers/file-utils.js';
+/**
+ * External Sync Orchestrator
+ */
+export class ExternalSyncOrchestrator {
+    constructor(projectRoot, options = {}) {
+        this.projectMappings = {};
+        this.projectRoot = projectRoot;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Load project mappings from config
+     */
+    async loadProjectMappings() {
+        const configPath = path.join(this.projectRoot, '.specweave/config.json');
+        if (await pathExists(configPath)) {
+            try {
+                const config = await readJson(configPath);
+                this.projectMappings = config.projectMappings || {};
+            }
+            catch (error) {
+                this.logger.warn('Failed to load projectMappings from config');
+            }
+        }
+    }
+    /**
+     * Get project mapping for a project ID
+     */
+    getProjectMapping(projectId) {
+        return this.projectMappings[projectId];
+    }
+    /**
+     * Group user stories by their target project
+     */
+    groupUSsByProject(userStories, defaultProject) {
+        const groups = new Map();
+        for (const us of userStories) {
+            const project = us.project || defaultProject;
+            if (!groups.has(project)) {
+                groups.set(project, []);
+            }
+            groups.get(project).push(us);
+        }
+        return groups;
+    }
+    /**
+     * Get preferred provider for a US
+     * Priority: US.externalProvider > first available in mapping
+     */
+    getPreferredProvider(us, mapping) {
+        // Explicit preference in US
+        if (us.externalProvider && mapping[us.externalProvider]) {
+            return us.externalProvider;
+        }
+        // Fall back to first available in mapping
+        if (mapping.github)
+            return 'github';
+        if (mapping.jira)
+            return 'jira';
+        if (mapping.ado)
+            return 'ado';
+        return null;
+    }
+    /**
+     * Build external refs map from sync results
+     */
+    buildExternalRefsMap(results) {
+        const refsMap = {};
+        for (const projectResult of results) {
+            for (const usResult of projectResult.synced) {
+                if (!usResult.success)
+                    continue;
+                if (!refsMap[usResult.usId]) {
+                    refsMap[usResult.usId] = {};
+                }
+                refsMap[usResult.usId][usResult.provider] = {
+                    provider: usResult.provider,
+                    issueNumber: usResult.issueNumber,
+                    url: usResult.url,
+                    targetProject: projectResult.projectId,
+                    lastSynced: new Date().toISOString()
+                };
+            }
+        }
+        return refsMap;
+    }
+    /**
+     * Log sync summary
+     */
+    logSyncSummary(result) {
+        this.logger.log('');
+        this.logger.log('🔗 Cross-Project External Sync Summary:');
+        this.logger.log(`   Projects: ${result.summary.projectCount}`);
+        this.logger.log(`   User Stories: ${result.summary.syncedUSs}/${result.summary.totalUSs} synced`);
+        for (const project of result.projects) {
+            const status = project.success ? '✅' : '❌';
+            this.logger.log(`   ${status} ${project.projectId} (${project.provider}): ${project.synced.length} USs`);
+            if (project.errors.length > 0) {
+                for (const error of project.errors) {
+                    this.logger.warn(`      ⚠️ ${error}`);
+                }
+            }
+        }
+    }
+    /**
+     * Create placeholder sync result for dry-run or when sync is skipped
+     */
+    createPlaceholderResult(userStories, defaultProject) {
+        const groups = this.groupUSsByProject(userStories, defaultProject);
+        return {
+            success: true,
+            projects: [...groups.entries()].map(([projectId, stories]) => ({
+                projectId,
+                provider: 'github',
+                success: true,
+                synced: stories.map(us => ({
+                    usId: us.id,
+                    provider: 'github',
+                    success: false,
+                    error: 'Sync skipped (dry-run or SKIP_EXTERNAL_SYNC)'
+                })),
+                errors: []
+            })),
+            externalRefs: {},
+            summary: {
+                totalUSs: userStories.length,
+                syncedUSs: 0,
+                failedUSs: 0,
+                projectCount: groups.size
+            }
+        };
+    }
+}
+//# sourceMappingURL=external-sync-orchestrator.js.map

package/dist/src/core/living-docs/external-sync-orchestrator.js.map

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

package/dist/src/core/living-docs/feature-archiver.d.ts

@@ -106,7 +106,11 @@ export declare class FeatureArchiver {
      * Examples:
      * - "0041-living-docs-test-fixes" → "FS-041"
      * - "0123-my-feature" → "FS-123"
+     * - "0111E-external-issue" → "FS-111E" (external increment → external feature)
      * - "temp-experiment" → null (no number)
+     *
+     * CRITICAL (v0.33.0): External increments (with E suffix like 0111E-...)
+     * MUST map to external features (FS-111E), not internal ones (FS-111).
      */
     private inferFeatureIdFromIncrement;
     /**

package/dist/src/core/living-docs/feature-archiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-archiver.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/feature-archiver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"feature-archiver.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/feature-archiver.ts"],"names":[],"mappings":"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"}

package/dist/src/core/living-docs/feature-archiver.js

@@ -100,6 +100,14 @@ export class FeatureArchiver {
             // Empty array .every() returns true, so we must explicitly check length
             // Archive orphaned features ONLY if option is set
             const isOrphaned = linkedIncrements.length === 0 && options.archiveOrphanedFeatures;
+            // v0.33.0: External features (FS-XXXE) are NOT orphaned - they're imported from
+            // external tools and should be handled by archiveExternalFeatures() separately!
+            // Skip external features in the normal archiving flow.
+            const isExternalFeature = featureId.endsWith('E');
+            if (isExternalFeature && linkedIncrements.length === 0) {
+                console.log(`⏭️  Skipping ${featureId}: external feature (use --external flag to archive)`);
+                continue;
+            }
             // Check if all linked increments are archived (EXACT MATCH, not partial)
             // CRITICAL: Use exact match (===) not .includes() to avoid false positives
             // SAFETY: If no linked increments and archiveOrphanedFeatures is false, skip
@@ -557,17 +565,24 @@ export class FeatureArchiver {
      * Examples:
      * - "0041-living-docs-test-fixes" → "FS-041"
      * - "0123-my-feature" → "FS-123"
+     * - "0111E-external-issue" → "FS-111E" (external increment → external feature)
      * - "temp-experiment" → null (no number)
+     *
+     * CRITICAL (v0.33.0): External increments (with E suffix like 0111E-...)
+     * MUST map to external features (FS-111E), not internal ones (FS-111).
      */
     inferFeatureIdFromIncrement(increment) {
-        // Extract 4-digit number prefix
-        const match = increment.match(/^(\d{4})/);
+        // Extract 4-digit number prefix and optional E suffix
+        // Pattern: NNNN or NNNNE (e.g., 0041, 0111E)
+        const match = increment.match(/^(\d{4})(E)?/);
         if (!match) {
             return null; // Can't infer (no number prefix)
         }
         const number = parseInt(match[1], 10);
-        // Convert to feature ID format: 41 → "FS-041"
-        return `FS-${number.toString().padStart(3, '0')}`;
+        const isExternal = match[2] === 'E';
+        // Convert to feature ID format: 41 → "FS-041", 111E → "FS-111E"
+        const featureId = `FS-${number.toString().padStart(3, '0')}`;
+        return isExternal ? `${featureId}E` : featureId;
     }
     /**
      * Get features linked to an epic
@@ -687,16 +702,23 @@ export class FeatureArchiver {
             }
             try {
                 const content = await fs.readFile(featureMdPath, 'utf-8');
-                // Extract increment number from Implementation History
-                const match = content.match(/\[(\d{4})-[^\]]+\]\([^)]*increments/);
+                // Extract increment number and optional E suffix from Implementation History
+                // CRITICAL (v0.33.0): Handle external increments like [0111E-name](...)
+                const match = content.match(/\[(\d{4})(E)?-[^\]]+\]\([^)]*increments/);
                 if (!match) {
                     continue; // No increment reference found
                 }
                 const referencedIncrementNum = parseInt(match[1]);
-                const currentFeatureNum = parseInt(featureId.slice(3));
-                // Check if feature ID matches referenced increment
-                if (referencedIncrementNum !== currentFeatureNum) {
-                    const expectedFeatureId = `FS-${referencedIncrementNum.toString().padStart(3, '0')}`;
+                const isExternalIncrement = match[2] === 'E';
+                // Parse current feature ID - handle both FS-111 and FS-111E
+                const currentFeatureNum = parseInt(featureId.replace('FS-', '').replace('E', ''));
+                const isCurrentExternal = featureId.endsWith('E');
+                // Check if feature ID matches referenced increment (both number AND external status)
+                const numberMismatch = referencedIncrementNum !== currentFeatureNum;
+                const externalMismatch = isExternalIncrement !== isCurrentExternal;
+                if (numberMismatch || externalMismatch) {
+                    const baseId = `FS-${referencedIncrementNum.toString().padStart(3, '0')}`;
+                    const expectedFeatureId = isExternalIncrement ? `${baseId}E` : baseId;
                     console.log(`   ⚠️  Mismatch: ${featureId} references increment ${match[1]}`);
                     console.log(`      Renaming ${featureId} → ${expectedFeatureId}`);
                     // Rename the feature folder