specweave 0.16.5 → 0.16.11

package/dist/plugins/specweave-github/lib/github-multi-project-sync.js

@@ -0,0 +1,420 @@
+/**
+ * GitHub Multi-Project Sync
+ *
+ * Supports two patterns:
+ * 1. **Multiple Repos**: Separate repos for each project (FE, BE, MOBILE)
+ * 2. **Master + Nested**: Master repo (epics) + nested repos (detailed tasks)
+ *
+ * @module github-multi-project-sync
+ */
+import { Octokit } from '@octokit/rest';
+import { getPrimaryProject } from '../../../src/utils/project-mapper.js';
+import { parseSpecFile } from '../../../src/utils/spec-splitter.js';
+/**
+ * GitHub Multi-Project Sync Client
+ */
+export class GitHubMultiProjectSync {
+    constructor(config) {
+        this.config = config;
+        this.octokit = new Octokit({ auth: config.token });
+    }
+    /**
+     * Pre-flight validation: Verify all repos exist
+     *
+     * @throws Error if any repos are missing
+     */
+    async validateRepos() {
+        const reposToValidate = [];
+        // Collect all repos to validate
+        if (this.config.repos) {
+            reposToValidate.push(...this.config.repos);
+        }
+        if (this.config.masterRepo) {
+            reposToValidate.push(this.config.masterRepo);
+        }
+        if (this.config.nestedRepos) {
+            reposToValidate.push(...this.config.nestedRepos);
+        }
+        if (reposToValidate.length === 0) {
+            throw new Error('No repositories configured for validation');
+        }
+        // Validate repos exist
+        const missing = await validateGitHubRepos(this.config, reposToValidate);
+        if (missing.length > 0) {
+            throw new Error(`❌ Pre-flight check failed: Missing GitHub repositories:\n` +
+                missing.map(r => `  - ${this.config.owner}/${r}`).join('\n') +
+                `\n\nPlease verify repository names and access permissions.`);
+        }
+    }
+    /**
+     * Sync spec to appropriate GitHub repos based on project mapping
+     *
+     * @param specPath Path to spec file
+     * @returns Array of sync results
+     */
+    async syncSpec(specPath) {
+        const results = [];
+        // Pre-flight validation: Verify all repos exist
+        await this.validateRepos();
+        // Parse spec
+        const parsedSpec = await parseSpecFile(specPath);
+        // Determine sync pattern
+        const isMasterNested = !!this.config.masterRepo && !!this.config.nestedRepos;
+        if (isMasterNested) {
+            // Pattern 2: Master + Nested
+            results.push(...await this.syncMasterNested(parsedSpec));
+        }
+        else if (this.config.repos) {
+            // Pattern 1: Multiple Repos
+            results.push(...await this.syncMultipleRepos(parsedSpec));
+        }
+        else {
+            throw new Error('Invalid config: Must specify repos[] or masterRepo+nestedRepos[]');
+        }
+        return results;
+    }
+    /**
+     * Pattern 1: Sync to multiple repos (simple)
+     *
+     * Each project → separate repo
+     * - FE user stories → company/frontend-web
+     * - BE user stories → company/backend-api
+     * - MOBILE user stories → company/mobile-app
+     */
+    async syncMultipleRepos(parsedSpec) {
+        const results = [];
+        // Classify user stories by project
+        const projectStories = new Map();
+        const mapperConfig = {
+            confidenceThreshold: this.config.confidenceThreshold
+        };
+        for (const userStory of parsedSpec.userStories) {
+            const primaryProject = getPrimaryProject(userStory, undefined, mapperConfig);
+            if (primaryProject) {
+                const existing = projectStories.get(primaryProject.projectId) || [];
+                existing.push(userStory);
+                projectStories.set(primaryProject.projectId, existing);
+            }
+            else {
+                // No confident match - skip or assign to default repo
+                const threshold = this.config.confidenceThreshold ?? 0.3;
+                console.warn(`⚠️  No confident project match for ${userStory.id} (< ${threshold * 100}% threshold) - skipping`);
+            }
+        }
+        // Sync each project to its repo
+        for (const [projectId, stories] of projectStories.entries()) {
+            const repo = this.findRepoForProject(projectId);
+            if (!repo) {
+                console.warn(`⚠️  No GitHub repo configured for project ${projectId} - skipping`);
+                continue;
+            }
+            // Create or update issue for each story
+            for (const story of stories) {
+                const result = await this.createOrUpdateIssue(repo, story, projectId);
+                results.push(result);
+            }
+        }
+        return results;
+    }
+    /**
+     * Pattern 2: Sync to master + nested repos (advanced)
+     *
+     * - Master repo (epic-level): High-level overview
+     * - Nested repos (task-level): Detailed implementation
+     *
+     * Example:
+     * Master (company/master-project):
+     *   Epic #10: User Authentication
+     *     → Links to: frontend-web#42, backend-api#15, mobile-app#8
+     *
+     * Nested (company/frontend-web):
+     *   Issue #42: Implement Login UI
+     *     Task 1: Create login component
+     *     Task 2: Add form validation
+     */
+    async syncMasterNested(parsedSpec) {
+        const results = [];
+        if (!this.config.masterRepo || !this.config.nestedRepos) {
+            throw new Error('Master+nested mode requires masterRepo and nestedRepos');
+        }
+        // Step 1: Create epic in master repo
+        const epicResult = await this.createEpicInMasterRepo(parsedSpec);
+        results.push(epicResult);
+        // Step 2: Classify user stories by project
+        const projectStories = new Map();
+        const mapperConfig = {
+            confidenceThreshold: this.config.confidenceThreshold
+        };
+        for (const userStory of parsedSpec.userStories) {
+            const primaryProject = getPrimaryProject(userStory, undefined, mapperConfig);
+            if (primaryProject) {
+                const existing = projectStories.get(primaryProject.projectId) || [];
+                existing.push(userStory);
+                projectStories.set(primaryProject.projectId, existing);
+            }
+        }
+        // Step 3: Create issues in nested repos + link to epic
+        for (const [projectId, stories] of projectStories.entries()) {
+            const repo = this.findNestedRepoForProject(projectId);
+            if (!repo) {
+                console.warn(`⚠️  No nested repo for project ${projectId} - skipping`);
+                continue;
+            }
+            for (const story of stories) {
+                const result = await this.createIssueInNestedRepo(repo, story, projectId, epicResult.issueNumber);
+                results.push(result);
+            }
+        }
+        // Step 4: Update epic with links to nested issues
+        if (this.config.crossLinking) {
+            await this.updateEpicWithLinks(epicResult.issueNumber, results.filter(r => r.repo !== this.config.masterRepo));
+        }
+        return results;
+    }
+    /**
+     * Create epic issue in master repo
+     */
+    async createEpicInMasterRepo(parsedSpec) {
+        const title = `Epic: ${parsedSpec.metadata.title}`;
+        const body = `# ${parsedSpec.metadata.title}
+
+**Status**: ${parsedSpec.metadata.status}
+**Priority**: ${parsedSpec.metadata.priority}
+**Estimated Effort**: ${parsedSpec.metadata.estimatedEffort || 'TBD'}
+
+## Executive Summary
+
+${parsedSpec.executiveSummary}
+
+## User Stories (${parsedSpec.userStories.length} total)
+
+${parsedSpec.userStories.map((s, i) => `${i + 1}. ${s.id}: ${s.title}`).join('\n')}
+
+---
+
+📊 **This is a high-level epic** - detailed implementation tracked in nested repos
+🔗 **Links to implementation issues** (will be added automatically)
+
+🤖 Auto-generated by SpecWeave
+`;
+        const response = await this.octokit.issues.create({
+            owner: this.config.owner,
+            repo: this.config.masterRepo,
+            title,
+            body,
+            labels: ['epic', 'specweave']
+        });
+        return {
+            project: 'MASTER',
+            repo: this.config.masterRepo,
+            issueNumber: response.data.number,
+            url: response.data.html_url,
+            action: 'created'
+        };
+    }
+    /**
+     * Create issue in nested repo + link to epic
+     */
+    async createIssueInNestedRepo(repo, userStory, projectId, epicNumber) {
+        const title = `${userStory.id}: ${userStory.title}`;
+        let body = `# ${userStory.title}
+
+${userStory.description}
+
+## Acceptance Criteria
+
+${userStory.acceptanceCriteria.map((ac, i) => `- [ ] ${ac}`).join('\n')}
+`;
+        // Add technical context if present
+        if (userStory.technicalContext) {
+            body += `\n## Technical Context\n\n${userStory.technicalContext}\n`;
+        }
+        // Add link to epic if cross-linking enabled
+        if (this.config.crossLinking && epicNumber) {
+            body += `\n---\n\n📊 Part of Epic: ${this.config.owner}/${this.config.masterRepo}#${epicNumber}\n`;
+        }
+        body += `\n🤖 Auto-generated by SpecWeave\n`;
+        const response = await this.octokit.issues.create({
+            owner: this.config.owner,
+            repo,
+            title,
+            body,
+            labels: ['story', 'specweave', projectId.toLowerCase()]
+        });
+        return {
+            project: projectId,
+            repo,
+            issueNumber: response.data.number,
+            url: response.data.html_url,
+            action: 'created'
+        };
+    }
+    /**
+     * Create or update issue (for simple multi-repo pattern)
+     */
+    async createOrUpdateIssue(repo, userStory, projectId) {
+        const title = `${userStory.id}: ${userStory.title}`;
+        const body = `# ${userStory.title}
+
+${userStory.description}
+
+## Acceptance Criteria
+
+${userStory.acceptanceCriteria.map((ac, i) => `- [ ] ${ac}`).join('\n')}
+
+${userStory.technicalContext ? `\n## Technical Context\n\n${userStory.technicalContext}\n` : ''}
+
+🤖 Auto-generated by SpecWeave
+`;
+        // Check if issue already exists (search by title)
+        const existingIssues = await this.octokit.issues.listForRepo({
+            owner: this.config.owner,
+            repo,
+            labels: 'specweave',
+            state: 'all'
+        });
+        const existing = existingIssues.data.find(issue => issue.title === title);
+        if (existing) {
+            // Update existing issue
+            const response = await this.octokit.issues.update({
+                owner: this.config.owner,
+                repo,
+                issue_number: existing.number,
+                body
+            });
+            return {
+                project: projectId,
+                repo,
+                issueNumber: response.data.number,
+                url: response.data.html_url,
+                action: 'updated'
+            };
+        }
+        else {
+            // Create new issue
+            const response = await this.octokit.issues.create({
+                owner: this.config.owner,
+                repo,
+                title,
+                body,
+                labels: ['specweave', projectId.toLowerCase()]
+            });
+            return {
+                project: projectId,
+                repo,
+                issueNumber: response.data.number,
+                url: response.data.html_url,
+                action: 'created'
+            };
+        }
+    }
+    /**
+     * Update epic with links to nested issues
+     */
+    async updateEpicWithLinks(epicNumber, nestedResults) {
+        if (!this.config.masterRepo)
+            return;
+        const linksSection = `\n\n## Implementation Issues\n\n${nestedResults
+            .map(r => `- ${r.project}: ${this.config.owner}/${r.repo}#${r.issueNumber} - ${r.url}`)
+            .join('\n')}\n`;
+        // Get current epic body
+        const epic = await this.octokit.issues.get({
+            owner: this.config.owner,
+            repo: this.config.masterRepo,
+            issue_number: epicNumber
+        });
+        // Append links section
+        const updatedBody = epic.data.body + linksSection;
+        // Update epic
+        await this.octokit.issues.update({
+            owner: this.config.owner,
+            repo: this.config.masterRepo,
+            issue_number: epicNumber,
+            body: updatedBody
+        });
+    }
+    /**
+     * Find GitHub repo for project ID
+     *
+     * Maps project IDs to repo names:
+     * - FE → frontend-web
+     * - BE → backend-api
+     * - MOBILE → mobile-app
+     */
+    findRepoForProject(projectId) {
+        if (!this.config.repos)
+            return undefined;
+        // Try exact match first
+        let match = this.config.repos.find(repo => repo.toLowerCase().includes(projectId.toLowerCase()));
+        if (!match) {
+            // Try fuzzy match (FE → frontend, BE → backend, MOBILE → mobile)
+            const fuzzyMap = {
+                FE: ['frontend', 'web', 'ui', 'client'],
+                BE: ['backend', 'api', 'server'],
+                MOBILE: ['mobile', 'app', 'ios', 'android'],
+                INFRA: ['infra', 'infrastructure', 'devops', 'platform']
+            };
+            const keywords = fuzzyMap[projectId] || [];
+            match = this.config.repos.find(repo => keywords.some(keyword => repo.toLowerCase().includes(keyword)));
+        }
+        return match;
+    }
+    /**
+     * Find nested repo for project ID (same logic as findRepoForProject)
+     */
+    findNestedRepoForProject(projectId) {
+        if (!this.config.nestedRepos)
+            return undefined;
+        // Reuse same logic
+        const tempConfig = { ...this.config, repos: this.config.nestedRepos };
+        const tempSync = new GitHubMultiProjectSync(tempConfig);
+        return tempSync.findRepoForProject(projectId);
+    }
+}
+/**
+ * Format sync results for display
+ */
+export function formatSyncResults(results) {
+    const lines = [];
+    lines.push('📊 GitHub Multi-Project Sync Results:\n');
+    const byProject = new Map();
+    for (const result of results) {
+        const existing = byProject.get(result.project) || [];
+        existing.push(result);
+        byProject.set(result.project, existing);
+    }
+    for (const [project, projectResults] of byProject.entries()) {
+        lines.push(`\n**${project}**:`);
+        for (const result of projectResults) {
+            const icon = result.action === 'created' ? '✅' : result.action === 'updated' ? '🔄' : '⏭️';
+            lines.push(`  ${icon} ${result.repo}#${result.issueNumber} (${result.action})`);
+            lines.push(`     ${result.url}`);
+        }
+    }
+    lines.push(`\n✅ Total: ${results.length} issues synced\n`);
+    return lines.join('\n');
+}
+/**
+ * Validate GitHub repositories exist
+ *
+ * @param config GitHub configuration
+ * @param repoNames Array of repo names to validate
+ * @returns Validation results (missing repos)
+ */
+export async function validateGitHubRepos(config, repoNames) {
+    const missing = [];
+    const octokit = new Octokit({ auth: config.token });
+    for (const repo of repoNames) {
+        try {
+            await octokit.repos.get({
+                owner: config.owner,
+                repo
+            });
+        }
+        catch (error) {
+            missing.push(repo);
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=github-multi-project-sync.js.map

package/dist/plugins/specweave-github/lib/github-multi-project-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-multi-project-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-multi-project-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-spec-commit-sync.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitHub Spec Commit Sync
+ *
+ * Posts commit/PR comments to GitHub issues linked to living docs specs.
+ * This enables traceability from spec user stories to actual code changes.
+ */
+import { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
+import { UserStory } from '../../../src/core/spec-task-mapper.js';
+export interface SyncOptions {
+    incrementPath: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    commentsPosted: number;
+    errors: string[];
+    commits: GitCommit[];
+    userStories: UserStory[];
+}
+/**
+ * Sync commits for completed user stories to GitHub issue
+ */
+export declare function syncSpecCommitsToGitHub(options: SyncOptions): Promise<SyncResult>;
+/**
+ * Post batch commit update to GitHub issue (for multiple commits)
+ */
+export declare function postCommitBatchUpdate(incrementPath: string, commits: GitCommit[], issueNumber: number, repo: GitRepository, dryRun?: boolean): Promise<boolean>;
+/**
+ * Check if spec commit sync is enabled in config
+ */
+export declare function isSpecCommitSyncEnabled(projectRoot: string): Promise<boolean>;
+/**
+ * Get GitHub issue number from spec metadata
+ */
+export declare function getGitHubIssueForSpec(specPath: string): Promise<number | null>;
+//# sourceMappingURL=github-spec-commit-sync.d.ts.map

package/dist/plugins/specweave-github/lib/github-spec-commit-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-spec-commit-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-spec-commit-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,SAAS,EACT,aAAa,EAEd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,SAAS,EACV,MAAM,uCAAuC,CAAC;AAW/C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAmKrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}