specweave 1.0.506 → 1.0.508

package/dist/plugins/specweave/lib/integrations/github/duplicate-detector.js

@@ -0,0 +1,423 @@
+/**
+ * Global Duplicate Detection System for GitHub Issues
+ *
+ * CRITICAL ARCHITECTURE:
+ * ALL GitHub issue creation in SpecWeave MUST use this module.
+ * This is the SINGLE SOURCE OF TRUTH for duplicate prevention.
+ *
+ * THREE-PHASE PROTECTION:
+ * 1. Detection (Before Create): Search GitHub for existing issues
+ * 2. Verification (After Create): Count check to detect duplicates
+ * 3. Reflection (Auto-Correct): Close duplicate issues automatically
+ *
+ * USAGE:
+ * ```typescript
+ * // Simple: Create with full protection
+ * const result = await DuplicateDetector.createWithProtection({
+ *   title: '[FS-031] Feature Title',
+ *   body: 'Description...',
+ *   titlePattern: '[FS-031]',
+ *   labels: ['specweave', 'feature']
+ * });
+ *
+ * // Manual: Check before creating
+ * const existing = await DuplicateDetector.checkBeforeCreate('[FS-031]');
+ * if (!existing) {
+ *   // Create issue...
+ * }
+ * ```
+ *
+ * @module duplicate-detector
+ */
+import { execFileSync } from 'child_process';
+import { getGitHubAuthFromProject } from '../../../../../src/utils/auth-helpers.js';
+/**
+ * Get environment object with GH_TOKEN for gh CLI commands.
+ * This ensures the token from .env is passed to all gh operations,
+ * regardless of `gh auth` status.
+ */
+function getGhEnv() {
+    const { token } = getGitHubAuthFromProject(process.cwd());
+    return token
+        ? { ...process.env, GH_TOKEN: token }
+        : process.env;
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+export class DuplicateDetector {
+    /**
+     * PHASE 1: Detection (Before Creating Issue)
+     *
+     * Searches GitHub for existing issues matching the title pattern.
+     * This is the PRIMARY defense against duplicates.
+     *
+     * @param titlePattern - Pattern to search (e.g., "[FS-031]" current, "[INC-0031]" deprecated)
+     * @param incrementId - Optional increment ID for more precise matching
+     * @param repo - Optional repo (format: "owner/repo")
+     * @returns Existing issue if found, null otherwise
+     */
+    static async checkBeforeCreate(titlePattern, incrementId, repo) {
+        console.log(`🔍 DETECTION: Checking for existing issue with pattern: ${titlePattern}`);
+        try {
+            const args = [
+                'issue',
+                'list',
+                '--search', `"${titlePattern}" in:title`,
+                '--json', 'number,title,url,body,createdAt',
+                '--limit', '20',
+                '--state', 'all' // Check both open and closed
+            ];
+            if (repo) {
+                args.push('--repo', repo);
+            }
+            const output = execFileSync('gh', args, { encoding: 'utf-8', env: getGhEnv() });
+            const issues = JSON.parse(output);
+            if (issues.length === 0) {
+                console.log('   ✅ No existing issues found (safe to create)');
+                return null;
+            }
+            console.log(`   📋 Found ${issues.length} issue(s) matching pattern`);
+            // Strategy 1: Exact title match
+            const exactMatch = issues.find(issue => issue.title.includes(titlePattern));
+            if (exactMatch) {
+                console.log(`   ⚠️  DUPLICATE DETECTED: Issue #${exactMatch.number}`);
+                console.log(`   📎 URL: ${exactMatch.url}`);
+                return exactMatch;
+            }
+            // Strategy 2: Body match (if incrementId provided)
+            if (incrementId) {
+                const bodyMatch = issues.find(issue => issue.body && (issue.body.includes(`**Increment**: ${incrementId}`) ||
+                    issue.body.includes(incrementId)));
+                if (bodyMatch) {
+                    console.log(`   ⚠️  DUPLICATE DETECTED (body match): Issue #${bodyMatch.number}`);
+                    console.log(`   📎 URL: ${bodyMatch.url}`);
+                    return bodyMatch;
+                }
+            }
+            console.log('   ✅ No exact match found (safe to create)');
+            return null;
+        }
+        catch (error) {
+            console.warn(`   ⚠️  Detection failed (continuing anyway): ${error.message}`);
+            return null; // Fail gracefully - allow creation to proceed
+        }
+    }
+    /**
+     * PHASE 2: Verification (After Creating Issue)
+     *
+     * Counts issues matching the pattern and identifies duplicates.
+     * This is the SECONDARY defense - catches duplicates that slipped through.
+     *
+     * @param titlePattern - Pattern to search (e.g., "[FS-031]")
+     * @param expectedCount - Expected number of issues (usually 1)
+     * @param repo - Optional repo (format: "owner/repo")
+     * @returns Verification result with duplicate list
+     */
+    static async verifyAfterCreate(titlePattern, expectedCount = 1, repo) {
+        console.log(`\n🔍 VERIFICATION: Checking issue count for pattern: ${titlePattern}`);
+        // ✅ GitHub API indexing delay: Wait 2 seconds for issue to be indexed
+        await new Promise(resolve => setTimeout(resolve, 2000));
+        try {
+            const args = [
+                'issue',
+                'list',
+                '--search', `"${titlePattern}" in:title`,
+                '--json', 'number,title,url,createdAt',
+                '--limit', '50',
+                '--state', 'all'
+            ];
+            if (repo) {
+                args.push('--repo', repo);
+            }
+            const output = execFileSync('gh', args, { encoding: 'utf-8', env: getGhEnv() });
+            const issues = JSON.parse(output);
+            // Filter exact matches only
+            const exactMatches = issues.filter(issue => issue.title.includes(titlePattern));
+            const actualCount = exactMatches.length;
+            console.log(`   Expected: ${expectedCount} issue(s)`);
+            console.log(`   Actual: ${actualCount} issue(s)`);
+            if (actualCount === expectedCount) {
+                console.log(`   ✅ VERIFICATION PASSED: Count matches!`);
+                return {
+                    success: true,
+                    expectedCount,
+                    actualCount,
+                    duplicates: [],
+                    message: 'Verification passed'
+                };
+            }
+            else if (actualCount > expectedCount) {
+                // DUPLICATES DETECTED!
+                console.warn(`   ⚠️  VERIFICATION FAILED: ${actualCount - expectedCount} duplicate(s) detected!`);
+                // Sort by creation date (oldest first)
+                const sorted = exactMatches.sort((a, b) => {
+                    const dateA = new Date(a.createdAt || 0).getTime();
+                    const dateB = new Date(b.createdAt || 0).getTime();
+                    return dateA - dateB;
+                });
+                // Keep first (oldest), mark rest as duplicates
+                const duplicates = sorted.slice(1);
+                console.warn(`   📋 Duplicate issues:`);
+                duplicates.forEach(dup => {
+                    console.warn(`      - #${dup.number}: ${dup.title}`);
+                });
+                return {
+                    success: false,
+                    expectedCount,
+                    actualCount,
+                    duplicates,
+                    message: `${duplicates.length} duplicate(s) found`
+                };
+            }
+            else {
+                console.warn(`   ⚠️  VERIFICATION WARNING: Expected ${expectedCount} but found ${actualCount}`);
+                return {
+                    success: false,
+                    expectedCount,
+                    actualCount,
+                    duplicates: [],
+                    message: 'Count mismatch (fewer than expected)'
+                };
+            }
+        }
+        catch (error) {
+            console.error(`   ❌ Verification failed: ${error.message}`);
+            return {
+                success: false,
+                expectedCount,
+                actualCount: -1,
+                duplicates: [],
+                message: `Verification error: ${error.message}`
+            };
+        }
+    }
+    /**
+     * PHASE 3: Reflection (Auto-Correct Duplicates)
+     *
+     * Automatically closes duplicate issues and keeps the oldest one.
+     * This is the CLEANUP phase - fixes problems that occurred.
+     *
+     * @param duplicates - List of duplicate issues to close
+     * @param keepIssueNumber - Issue number to keep (usually the oldest)
+     * @param repo - Optional repo (format: "owner/repo")
+     * @returns Correction result with count of closed issues
+     */
+    static async correctDuplicates(duplicates, keepIssueNumber, repo) {
+        if (duplicates.length === 0) {
+            return {
+                success: true,
+                duplicatesClosed: 0,
+                keptIssue: keepIssueNumber,
+                errors: []
+            };
+        }
+        console.log(`\n🔧 REFLECTION: Auto-correcting ${duplicates.length} duplicate(s)...`);
+        const errors = [];
+        let closed = 0;
+        for (const duplicate of duplicates) {
+            try {
+                console.log(`   🗑️  Closing duplicate #${duplicate.number}...`);
+                const comment = `Duplicate of #${keepIssueNumber}
+
+This issue was automatically closed by SpecWeave's Global Duplicate Detection System.
+
+The original issue (#${keepIssueNumber}) should be used for tracking instead.
+
+🤖 Auto-closed by SpecWeave`;
+                const commentArgs = [
+                    'issue',
+                    'comment',
+                    duplicate.number.toString(),
+                    '--body', comment
+                ];
+                if (repo) {
+                    commentArgs.push('--repo', repo);
+                }
+                // Add comment explaining closure
+                execFileSync('gh', commentArgs, { encoding: 'utf-8', env: getGhEnv() });
+                const closeArgs = [
+                    'issue',
+                    'close',
+                    duplicate.number.toString()
+                ];
+                if (repo) {
+                    closeArgs.push('--repo', repo);
+                }
+                // Close the issue
+                execFileSync('gh', closeArgs, { encoding: 'utf-8', env: getGhEnv() });
+                console.log(`      ✅ Closed #${duplicate.number}`);
+                closed++;
+            }
+            catch (error) {
+                const errorMsg = `Failed to close #${duplicate.number}: ${error.message}`;
+                console.error(`      ❌ ${errorMsg}`);
+                errors.push(errorMsg);
+            }
+        }
+        console.log(`\n   ✅ REFLECTION COMPLETE: Kept #${keepIssueNumber}, closed ${closed}/${duplicates.length} duplicate(s)`);
+        return {
+            success: errors.length === 0,
+            duplicatesClosed: closed,
+            keptIssue: keepIssueNumber,
+            errors
+        };
+    }
+    /**
+     * ALL-IN-ONE: Create Issue with Full Protection
+     *
+     * This is the RECOMMENDED way to create GitHub issues in SpecWeave.
+     * Combines all 3 phases: Detection → Creation → Verification → Reflection
+     *
+     * GUARANTEES:
+     * - No duplicates will be created
+     * - Existing duplicates will be detected and closed
+     * - Idempotent: can run multiple times safely
+     *
+     * @param options - Create options (title, body, labels, etc.)
+     * @returns Create result with issue details and duplicate stats
+     */
+    static async createWithProtection(options) {
+        const { title, body, titlePattern, incrementId, labels = ['specweave'], milestone, assignees = [], repo } = options;
+        console.log(`\n🛡️  Creating GitHub issue with FULL PROTECTION...`);
+        console.log(`   Title: ${title}`);
+        console.log(`   Pattern: ${titlePattern}`);
+        // PHASE 1: Detection (Check if issue already exists)
+        console.log(`\n━━━ PHASE 1: DETECTION ━━━`);
+        const existing = await this.checkBeforeCreate(titlePattern, incrementId, repo);
+        let issueNumber;
+        let issueUrl;
+        let wasReused = false;
+        if (existing) {
+            // Reuse existing issue instead of creating duplicate
+            console.log(`\n♻️  Using existing issue #${existing.number} (skipping creation)`);
+            issueNumber = existing.number;
+            issueUrl = existing.url;
+            wasReused = true;
+        }
+        else {
+            // PHASE 2: Creation (No duplicate found, safe to create)
+            console.log(`\n━━━ PHASE 2: CREATION ━━━`);
+            console.log(`   Creating new GitHub issue...`);
+            try {
+                // Ensure all labels exist in target repo before creating issue
+                // Sanitize labels: only allow alphanumeric, hyphens, colons, spaces
+                const safeLabels = labels.filter(l => /^[a-zA-Z0-9:_\- ]+$/.test(l));
+                if (repo) {
+                    for (const label of safeLabels) {
+                        try {
+                            execFileSync('gh', [
+                                'label', 'create', label, '--repo', repo,
+                                '--color', 'ededed', '--description', 'SpecWeave auto-label', '--force'
+                            ], { encoding: 'utf-8', env: getGhEnv() });
+                        }
+                        catch {
+                            // Label creation failure is non-fatal
+                        }
+                    }
+                }
+                const args = [
+                    'issue',
+                    'create',
+                    '--title', title,
+                    '--body', body
+                ];
+                if (repo) {
+                    args.push('--repo', repo);
+                }
+                // Add sanitized labels
+                safeLabels.forEach(label => {
+                    args.push('--label', label);
+                });
+                // Add milestone if provided
+                if (milestone) {
+                    args.push('--milestone', milestone);
+                }
+                // Add assignees if provided
+                assignees.forEach(assignee => {
+                    args.push('--assignee', assignee);
+                });
+                const output = execFileSync('gh', args, { encoding: 'utf-8', env: getGhEnv() });
+                // Extract issue number from output (format: "https://github.com/owner/repo/issues/123")
+                const match = output.match(/\/issues\/(\d+)/);
+                if (!match) {
+                    throw new Error('Could not extract issue number from gh CLI output');
+                }
+                issueNumber = parseInt(match[1], 10);
+                issueUrl = output.trim();
+                console.log(`   ✅ Created issue #${issueNumber}`);
+                console.log(`   📎 ${issueUrl}`);
+            }
+            catch (error) {
+                throw new Error(`Failed to create GitHub issue: ${error.message}`);
+            }
+        }
+        // PHASE 3: Verification — SKIPPED BY DEFAULT to reduce API calls (FS-529)
+        // Phase 1 already searched for duplicates. Phase 3 only adds value if there's a
+        // race condition from parallel sync sessions, which is rare. Enable with
+        // SPECWEAVE_VERIFY_DUPLICATES=1 env var if needed.
+        let duplicatesClosed = 0;
+        if (process.env.SPECWEAVE_VERIFY_DUPLICATES === '1') {
+            console.log(`\n━━━ PHASE 3: VERIFICATION ━━━`);
+            const verification = await this.verifyAfterCreate(titlePattern, 1, repo);
+            if (!verification.success && verification.duplicates.length > 0) {
+                // PHASE 4: Reflection (Auto-correct duplicates)
+                console.log(`\n━━━ PHASE 4: REFLECTION ━━━`);
+                console.warn(`   ⚠️  ${verification.duplicates.length} duplicate(s) detected!`);
+                const correction = await this.correctDuplicates(verification.duplicates, issueNumber, repo);
+                duplicatesClosed = correction.duplicatesClosed;
+                if (correction.errors.length > 0) {
+                    console.warn(`   ⚠️  Some duplicates could not be closed:`);
+                    correction.errors.forEach(err => console.warn(`      - ${err}`));
+                }
+            }
+            else if (verification.success) {
+                console.log(`   ✅ No duplicates detected!`);
+            }
+        } // end SPECWEAVE_VERIFY_DUPLICATES guard
+        // Final Summary
+        console.log(`\n✅ Issue creation complete!`);
+        console.log(`   Issue: #${issueNumber}`);
+        console.log(`   Duplicates closed: ${duplicatesClosed}`);
+        console.log(`   Reused existing: ${wasReused ? 'Yes' : 'No'}`);
+        return {
+            issue: {
+                number: issueNumber,
+                title,
+                url: issueUrl
+            },
+            duplicatesFound: duplicatesClosed,
+            duplicatesClosed,
+            wasReused
+        };
+    }
+    /**
+     * Utility: Extract title pattern from full title
+     *
+     * Examples:
+     * - "[FS-031] Feature Title" → "[FS-031]" (current format)
+     * - "[INC-0031] Increment Title" → "[INC-0031]" (deprecated, legacy support only)
+     *
+     * @param title - Full issue title
+     * @returns Extracted pattern or null
+     */
+    static extractTitlePattern(title) {
+        const match = title.match(/^(\[[^\]]+\])/);
+        return match ? match[1] : null;
+    }
+    /**
+     * Utility: Check if GitHub CLI is available and authenticated
+     *
+     * @returns true if gh CLI is ready, false otherwise
+     */
+    static checkGitHubCLI() {
+        try {
+            execFileSync('gh', ['auth', 'status'], { encoding: 'utf-8', env: getGhEnv() });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=duplicate-detector.js.map

package/dist/plugins/specweave/lib/integrations/github/duplicate-detector.js.map

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

package/dist/plugins/specweave/lib/integrations/github/github-ac-checkbox-sync.d.ts

@@ -0,0 +1,54 @@
+/**
+ * GitHub AC Checkbox Sync
+ *
+ * Extracted from SyncCoordinator (0348) — efficient regex-based AC checkbox
+ * updates on existing GitHub issues without full body regeneration.
+ *
+ * Uses the same approach as the original SyncCoordinator.syncACCheckboxesToGitHub()
+ * but lives in the GitHub plugin where GitHub-specific code belongs.
+ */
+import { Logger } from '../../vendor/utils/logger.js';
+import type { SpecWeaveConfig } from '../../../../../src/core/config/types.js';
+export interface ACCheckboxSyncResult {
+    success: boolean;
+    updated: number;
+    issues: number[];
+}
+export declare class GitHubACCheckboxSync {
+    private projectRoot;
+    private incrementId;
+    private logger;
+    private providerRouter;
+    constructor(options: {
+        projectRoot: string;
+        incrementId: string;
+        logger?: Logger;
+    });
+    /**
+     * Sync AC checkbox state from spec.md to GitHub issue bodies.
+     *
+     * Uses efficient regex replacement to flip checkboxes without rebuilding
+     * the entire issue body.
+     */
+    syncACCheckboxesToGitHub(config: SpecWeaveConfig, options?: {
+        addComment?: boolean;
+    }): Promise<ACCheckboxSyncResult>;
+    /**
+     * Parse AC checkbox status from spec.md content
+     *
+     * Handles both formats:
+     * - `- [x] **AC-US5-01**: Description` (SpecWeave standard)
+     * - `- [x] AC-US5-01: Description` (legacy)
+     */
+    static parseACStatusFromSpec(specContent: string): Map<string, boolean>;
+    /**
+     * Build the AC ID prefix for a given US ID.
+     * US-001 → "AC-US1-", US-SPE-001 → "AC-SPE-US1-"
+     */
+    static buildACPrefix(usId: string): string;
+    /**
+     * Load user stories from living docs for the increment
+     */
+    private loadUserStoriesForIncrement;
+}
+//# sourceMappingURL=github-ac-checkbox-sync.d.ts.map

package/dist/plugins/specweave/lib/integrations/github/github-ac-checkbox-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-ac-checkbox-sync.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/github/github-ac-checkbox-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,MAAM,EAAiB,MAAM,8BAA8B,CAAC;AAUrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG/E,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAOD;;;;;OAKG;IACG,wBAAwB,CAC5B,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAiLhC;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAwBvE;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAe1C;;OAEG;YACW,2BAA2B;CAqG1C"}