specweave 0.17.16 → 0.17.19

package/dist/plugins/specweave-github/lib/enhanced-github-sync.js

@@ -0,0 +1,249 @@
+/**
+ * Enhanced GitHub Spec Content Sync
+ *
+ * Uses EnhancedContentBuilder and SpecIncrementMapper for rich external descriptions.
+ * NEW (v0.21.0): Supports task checkboxes and automatic labeling.
+ */
+import { GitHubClientV2 } from './github-client-v2.js';
+import { EnhancedContentBuilder } from '../../../src/core/sync/enhanced-content-builder.js';
+import { SpecIncrementMapper } from '../../../src/core/sync/spec-increment-mapper.js';
+import { parseSpecContent } from '../../../src/core/spec-content-sync.js';
+import { LabelDetector } from '../../../src/core/sync/label-detector.js';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Enhanced sync with rich content including task mappings
+ */
+export async function syncSpecWithEnhancedContent(options) {
+    const { specPath, owner, repo, dryRun = false, verbose = false } = options;
+    try {
+        // 1. Parse spec content
+        const baseSpec = await parseSpecContent(specPath);
+        if (!baseSpec) {
+            return {
+                success: false,
+                action: 'error',
+                error: 'Failed to parse spec content',
+            };
+        }
+        if (verbose) {
+            console.log(`📄 Parsed spec: ${baseSpec.identifier.compact}`);
+        }
+        // 2. Build enhanced spec with task mappings
+        const specId = baseSpec.identifier.full || baseSpec.identifier.compact;
+        const rootDir = await findSpecWeaveRoot(specPath);
+        const mapper = new SpecIncrementMapper(rootDir);
+        const mapping = await mapper.mapSpecToIncrements(specId);
+        if (verbose) {
+            console.log(`🔗 Found ${mapping.increments.length} related increments`);
+            console.log(`📋 Mapped ${Object.keys(mapping.userStoryMappings).length} user stories to tasks`);
+        }
+        // 3. Build task mapping for EnhancedSpecContent
+        const taskMapping = buildTaskMapping(mapping.increments, owner, repo);
+        // 4. Build architecture docs references
+        const architectureDocs = await findArchitectureDocs(rootDir, specId);
+        // 5. Build source links
+        const sourceLinks = buildSourceLinks(mapping.increments[0]?.id, owner, repo);
+        // 6. Create enhanced spec content
+        const enhancedSpec = {
+            ...baseSpec,
+            summary: baseSpec.description,
+            taskMapping,
+            architectureDocs,
+            sourceLinks
+        };
+        // 7. Build external description with task checkboxes
+        const builder = new EnhancedContentBuilder();
+        // NEW: Override buildTasksSection call to include checkboxes
+        const originalBuildExternal = builder.buildExternalDescription.bind(builder);
+        const description = (() => {
+            const sections = [];
+            // Summary
+            sections.push(builder.buildSummarySection(enhancedSpec));
+            // User stories
+            if (enhancedSpec.userStories && enhancedSpec.userStories.length > 0) {
+                sections.push(builder.buildUserStoriesSection(enhancedSpec.userStories));
+            }
+            // Tasks with checkboxes (NEW!)
+            if (enhancedSpec.taskMapping) {
+                sections.push(builder.buildTasksSection(enhancedSpec.taskMapping, {
+                    showCheckboxes: true,
+                    showProgressBar: true,
+                    showCompletionStatus: true,
+                    provider: 'github'
+                }));
+            }
+            // Architecture
+            if (enhancedSpec.architectureDocs && enhancedSpec.architectureDocs.length > 0) {
+                sections.push(builder.buildArchitectureSection(enhancedSpec.architectureDocs));
+            }
+            // Source links
+            if (enhancedSpec.sourceLinks) {
+                sections.push(builder.buildSourceLinksSection(enhancedSpec.sourceLinks));
+            }
+            return sections.filter(s => s.length > 0).join('\n\n---\n\n');
+        })();
+        if (verbose) {
+            console.log(`📝 Generated description: ${description.length} characters`);
+        }
+        if (dryRun) {
+            console.log('🔍 DRY RUN - Would create/update issue with:');
+            console.log(`   Title: ${baseSpec.title}`);
+            console.log(`   Description length: ${description.length}`);
+            console.log(`   Tasks linked: ${taskMapping?.tasks.length || 0}`);
+            return {
+                success: true,
+                action: 'no-change',
+                tasksLinked: taskMapping?.tasks.length || 0
+            };
+        }
+        // 8. Create or update GitHub issue
+        if (!owner || !repo) {
+            return {
+                success: false,
+                action: 'error',
+                error: 'GitHub owner/repo not specified',
+            };
+        }
+        const client = GitHubClientV2.fromRepo(owner, repo);
+        // NEW: Detect increment type and apply labels
+        const labelDetector = new LabelDetector(undefined, false); // Use GitHub format
+        const detection = labelDetector.detectType(await fs.readFile(specPath, 'utf-8'), mapping.increments[0]?.id);
+        const githubLabels = labelDetector.getGitHubLabels(detection.type);
+        const allLabels = ['spec', ...githubLabels]; // Include both 'spec' and type labels
+        if (verbose) {
+            console.log(`🏷️  Detected type: ${detection.type} (${detection.confidence}% confidence)`);
+            console.log(`   Labels: ${allLabels.join(', ')}`);
+        }
+        // Check if issue already exists
+        const existingIssue = await findExistingIssue(client, baseSpec.identifier.compact);
+        let result;
+        if (existingIssue) {
+            // Update existing issue (body + labels)
+            await client.updateIssueBody(existingIssue.number, description);
+            // Update labels if autoApplyLabels is enabled
+            // TODO: Read from config, for now always apply
+            await client.addLabels(existingIssue.number, allLabels);
+            result = {
+                success: true,
+                action: 'updated',
+                issueNumber: existingIssue.number,
+                issueUrl: existingIssue.html_url,
+                tasksLinked: taskMapping?.tasks.length || 0
+            };
+        }
+        else {
+            // Create new issue with labels
+            const issue = await client.createEpicIssue(`[${baseSpec.identifier.compact}] ${baseSpec.title}`, description, undefined, allLabels // Apply labels at creation
+            );
+            result = {
+                success: true,
+                action: 'created',
+                issueNumber: issue.number,
+                issueUrl: issue.html_url,
+                tasksLinked: taskMapping?.tasks.length || 0
+            };
+            // Update spec with GitHub link
+            await mapper.updateSpecWithIncrementLinks(specId, mapping.increments[0]?.id);
+        }
+        if (verbose) {
+            console.log(`✅ ${result.action === 'created' ? 'Created' : 'Updated'} issue #${result.issueNumber}`);
+            console.log(`   URL: ${result.issueUrl}`);
+            console.log(`   Tasks linked: ${result.tasksLinked}`);
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: error.message
+        };
+    }
+}
+// Helper functions
+async function findSpecWeaveRoot(specPath) {
+    let currentDir = path.dirname(specPath);
+    while (true) {
+        const specweaveDir = path.join(currentDir, '.specweave');
+        try {
+            await fs.access(specweaveDir);
+            return currentDir;
+        }
+        catch {
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                throw new Error('.specweave directory not found');
+            }
+            currentDir = parentDir;
+        }
+    }
+}
+function buildTaskMapping(increments, owner, repo) {
+    if (increments.length === 0)
+        return undefined;
+    const firstIncrement = increments[0];
+    const tasks = firstIncrement.tasks.map((task) => ({
+        id: task.id,
+        title: task.title,
+        userStories: task.userStories,
+        githubIssue: task.githubIssue
+    }));
+    return {
+        incrementId: firstIncrement.id,
+        tasks,
+        tasksUrl: `https://github.com/${owner}/${repo}/blob/develop/.specweave/increments/${firstIncrement.id}/tasks.md`
+    };
+}
+async function findArchitectureDocs(rootDir, specId) {
+    const docs = [];
+    const archDir = path.join(rootDir, '.specweave/docs/internal/architecture');
+    try {
+        // Check for ADRs
+        const adrDir = path.join(archDir, 'adr');
+        try {
+            const adrs = await fs.readdir(adrDir);
+            const relatedAdrs = adrs.filter(file => file.includes(specId.replace('spec-', '')));
+            for (const adr of relatedAdrs) {
+                docs.push({
+                    type: 'adr',
+                    path: path.join(adrDir, adr),
+                    title: adr.replace('.md', '').replace(/-/g, ' ')
+                });
+            }
+        }
+        catch { }
+        // Check for HLD
+        const hlds = await fs.readdir(archDir);
+        const relatedHlds = hlds.filter(file => file.includes('hld') && file.includes(specId.replace('spec-', '')));
+        for (const hld of relatedHlds) {
+            docs.push({
+                type: 'hld',
+                path: path.join(archDir, hld),
+                title: hld.replace('.md', '').replace(/-/g, ' ')
+            });
+        }
+    }
+    catch { }
+    return docs;
+}
+function buildSourceLinks(incrementId, owner, repo) {
+    if (!incrementId)
+        return undefined;
+    const baseUrl = `https://github.com/${owner}/${repo}/blob/develop/.specweave`;
+    return {
+        spec: `${baseUrl}/docs/internal/specs/default/spec-${incrementId.replace(/^\d+-/, '')}.md`,
+        plan: `${baseUrl}/increments/${incrementId}/plan.md`,
+        tasks: `${baseUrl}/increments/${incrementId}/tasks.md`
+    };
+}
+async function findExistingIssue(client, specId) {
+    try {
+        const issues = await client.listIssuesInTimeRange('ALL');
+        return issues.find((issue) => issue.title.includes(`[${specId}]`) && issue.labels?.some((l) => l.name === 'spec')) || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=enhanced-github-sync.js.map

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

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

package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Epic Content Builder - Hierarchical GitHub issue content for Feature Specs
+ *
+ * Architecture:
+ * - Reads FS-* folder (FEATURE.md + us-*.md files)
+ * - Reads increment tasks.md files to map tasks to user stories
+ * - Generates hierarchical issue body:
+ *   1. User Stories section (with status + increment)
+ *   2. Tasks section (grouped by User Story)
+ *
+ * Key Features:
+ * - NO single "Increment" field (epics span multiple increments)
+ * - User Stories are checkable with status and increment link
+ * - Tasks grouped under their User Story
+ * - Shows which increment each US/task belongs to
+ */
+export declare class EpicContentBuilder {
+    private epicFolder;
+    private projectRoot;
+    constructor(epicFolder: string, projectRoot: string);
+    /**
+     * Build hierarchical GitHub issue body
+     *
+     * Format:
+     * - Epic overview
+     * - User Stories section (checkable, with status + increment)
+     * - Tasks section (grouped by User Story)
+     */
+    buildIssueBody(): Promise<string>;
+    /**
+     * Read Epic FEATURE.md frontmatter
+     */
+    private readEpicMetadata;
+    /**
+     * Read all user stories from us-*.md files
+     */
+    private readUserStories;
+    /**
+     * Extract tasks for a user story from its Implementation section
+     */
+    private extractTasksForUserStory;
+    /**
+     * Build overview section
+     */
+    private buildOverviewSection;
+    /**
+     * Build User Stories section
+     */
+    private buildUserStoriesSection;
+    /**
+     * Build Tasks section (grouped by User Story)
+     */
+    private buildTasksSection;
+    /**
+     * Normalize status values
+     */
+    private normalizeStatus;
+    /**
+     * Get status emoji
+     */
+    private getStatusEmoji;
+}
+//# sourceMappingURL=epic-content-builder.d.ts.map

package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-content-builder.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/epic-content-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuCH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKnD;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBvC;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,eAAe;IA0C7B;;OAEG;YACW,wBAAwB;IAoEtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/plugins/specweave-github/lib/epic-content-builder.js

@@ -0,0 +1,216 @@
+/**
+ * Epic Content Builder - Hierarchical GitHub issue content for Feature Specs
+ *
+ * Architecture:
+ * - Reads FS-* folder (FEATURE.md + us-*.md files)
+ * - Reads increment tasks.md files to map tasks to user stories
+ * - Generates hierarchical issue body:
+ *   1. User Stories section (with status + increment)
+ *   2. Tasks section (grouped by User Story)
+ *
+ * Key Features:
+ * - NO single "Increment" field (epics span multiple increments)
+ * - User Stories are checkable with status and increment link
+ * - Tasks grouped under their User Story
+ * - Shows which increment each US/task belongs to
+ */
+import { readdir, readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+export class EpicContentBuilder {
+    constructor(epicFolder, projectRoot) {
+        this.epicFolder = epicFolder;
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Build hierarchical GitHub issue body
+     *
+     * Format:
+     * - Epic overview
+     * - User Stories section (checkable, with status + increment)
+     * - Tasks section (grouped by User Story)
+     */
+    async buildIssueBody() {
+        // 1. Read Epic metadata
+        const epicData = await this.readEpicMetadata();
+        // 2. Read User Stories
+        const userStories = await this.readUserStories();
+        // 3. Build sections
+        const overview = this.buildOverviewSection(epicData);
+        const userStoriesSection = this.buildUserStoriesSection(userStories);
+        const tasksSection = this.buildTasksSection(userStories);
+        // 4. Combine
+        return `${overview}\n\n---\n\n${userStoriesSection}\n\n---\n\n${tasksSection}\n\n---\n\n🤖 Auto-created by SpecWeave Epic Sync`;
+    }
+    /**
+     * Read Epic FEATURE.md frontmatter
+     */
+    async readEpicMetadata() {
+        const featurePath = path.join(this.epicFolder, 'FEATURE.md');
+        const content = await readFile(featurePath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error('FEATURE.md missing YAML frontmatter');
+        }
+        return yaml.parse(match[1]);
+    }
+    /**
+     * Read all user stories from us-*.md files
+     */
+    async readUserStories() {
+        const files = await readdir(this.epicFolder);
+        const usFiles = files.filter((f) => f.startsWith('us-') && f.endsWith('.md'));
+        const userStories = [];
+        for (const file of usFiles.sort()) {
+            const filePath = path.join(this.epicFolder, file);
+            const content = await readFile(filePath, 'utf-8');
+            const match = content.match(/^---\n([\s\S]*?)\n---/);
+            if (!match) {
+                console.warn(`   ⚠️  ${file} missing frontmatter, skipping`);
+                continue;
+            }
+            const frontmatter = yaml.parse(match[1]);
+            const bodyContent = content.slice(match[0].length).trim();
+            // Extract increment from Implementation section
+            const incrementMatch = bodyContent.match(/\*\*Increment\*\*:\s*\[([^\]]+)\]/);
+            const increment = incrementMatch ? incrementMatch[1] : null;
+            // Extract tasks from Implementation section
+            const tasks = await this.extractTasksForUserStory(frontmatter.id, increment, bodyContent);
+            userStories.push({
+                id: frontmatter.id,
+                title: frontmatter.title,
+                status: this.normalizeStatus(frontmatter.status),
+                increment,
+                tasks,
+            });
+        }
+        return userStories;
+    }
+    /**
+     * Extract tasks for a user story from its Implementation section
+     */
+    async extractTasksForUserStory(userStoryId, incrementId, content) {
+        if (!incrementId) {
+            return []; // No increment yet, no tasks
+        }
+        // Find increment folder
+        const incrementFolder = path.join(this.projectRoot, '.specweave', 'increments', incrementId);
+        if (!existsSync(incrementFolder)) {
+            console.warn(`   ⚠️  Increment folder not found: ${incrementId}`);
+            return [];
+        }
+        const tasksPath = path.join(incrementFolder, 'tasks.md');
+        if (!existsSync(tasksPath)) {
+            console.warn(`   ⚠️  tasks.md not found in ${incrementId}`);
+            return [];
+        }
+        // Read tasks.md
+        const tasksContent = await readFile(tasksPath, 'utf-8');
+        // Extract task links from user story's Implementation section
+        // Format: - [T-001: Title](link#t-001-title)
+        const taskLinkPattern = /- \[([T-\d]+):\s*([^\]]+)\]/g;
+        const taskLinks = [];
+        let match;
+        while ((match = taskLinkPattern.exec(content)) !== null) {
+            taskLinks.push({
+                id: match[1], // e.g., "T-001"
+                title: match[2].trim(),
+            });
+        }
+        // Parse tasks from tasks.md to get completion status
+        const tasks = [];
+        for (const taskLink of taskLinks) {
+            // Find task in tasks.md by heading pattern: ### T-001: Title
+            const taskPattern = new RegExp(`###\\s+${taskLink.id}:\\s*([^\\n]+)[\\s\\S]*?\\*\\*Status\\*\\*:\\s*\\[([x\\s])\\]`, 'i');
+            const taskMatch = tasksContent.match(taskPattern);
+            const isCompleted = taskMatch ? taskMatch[2] === 'x' : false;
+            tasks.push({
+                id: taskLink.id,
+                title: taskLink.title,
+                status: isCompleted,
+                userStoryId,
+            });
+        }
+        return tasks;
+    }
+    /**
+     * Build overview section
+     */
+    buildOverviewSection(epic) {
+        return `# [${epic.id}] ${epic.title}\n\n**Status**: ${epic.status}\n**Created**: ${epic.created}\n**Last Updated**: ${epic.last_updated}`;
+    }
+    /**
+     * Build User Stories section
+     */
+    buildUserStoriesSection(userStories) {
+        const total = userStories.length;
+        const completed = userStories.filter((us) => us.status === 'complete').length;
+        const percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
+        let section = `## User Stories\n\nProgress: ${completed}/${total} user stories complete (${percentage}%)\n\n`;
+        for (const us of userStories) {
+            const checkbox = us.status === 'complete' ? '[x]' : '[ ]';
+            const statusEmoji = this.getStatusEmoji(us.status);
+            const incrementLink = us.increment
+                ? `[${us.increment}](../../increments/${us.increment}/)`
+                : 'TBD';
+            section += `- ${checkbox} **${us.id}: ${us.title}** (${statusEmoji} ${us.status} | Increment: ${incrementLink})\n`;
+        }
+        return section;
+    }
+    /**
+     * Build Tasks section (grouped by User Story)
+     */
+    buildTasksSection(userStories) {
+        const totalTasks = userStories.reduce((sum, us) => sum + us.tasks.length, 0);
+        const completedTasks = userStories.reduce((sum, us) => sum + us.tasks.filter((t) => t.status).length, 0);
+        const percentage = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+        let section = `## Tasks by User Story\n\nProgress: ${completedTasks}/${totalTasks} tasks complete (${percentage}%)\n\n`;
+        for (const us of userStories) {
+            if (us.tasks.length === 0) {
+                continue; // Skip user stories with no tasks yet
+            }
+            const incrementLink = us.increment
+                ? `[${us.increment}](../../increments/${us.increment}/tasks.md)`
+                : 'TBD';
+            section += `### ${us.id}: ${us.title} (Increment: ${incrementLink})\n\n`;
+            for (const task of us.tasks) {
+                const checkbox = task.status ? '[x]' : '[ ]';
+                section += `- ${checkbox} ${task.id}: ${task.title}\n`;
+            }
+            section += '\n';
+        }
+        return section;
+    }
+    /**
+     * Normalize status values
+     */
+    normalizeStatus(status) {
+        const normalized = status.toLowerCase();
+        if (normalized === 'complete' || normalized === 'completed')
+            return 'complete';
+        if (normalized === 'active' || normalized === 'in-progress')
+            return 'active';
+        if (normalized === 'planning')
+            return 'planning';
+        return 'not-started';
+    }
+    /**
+     * Get status emoji
+     */
+    getStatusEmoji(status) {
+        switch (status) {
+            case 'complete':
+                return '✅';
+            case 'active':
+                return '🚧';
+            case 'planning':
+                return '📋';
+            case 'not-started':
+                return '⏳';
+            default:
+                return '❓';
+        }
+    }
+}
+//# sourceMappingURL=epic-content-builder.js.map

package/dist/plugins/specweave-github/lib/epic-content-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-content-builder.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/epic-content-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAkC7B,MAAM,OAAO,kBAAkB;IAI7B,YAAY,UAAkB,EAAE,WAAmB;QACjD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc;QAClB,wBAAwB;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE/C,uBAAuB;QACvB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAEjD,oBAAoB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,kBAAkB,GAAG,IAAI,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;QACrE,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAEzD,aAAa;QACb,OAAO,GAAG,QAAQ,cAAc,kBAAkB,cAAc,YAAY,mDAAmD,CAAC;IAClI,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAErD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAoB,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAE9E,MAAM,WAAW,GAAgB,EAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAErD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,gCAAgC,CAAC,CAAC;gBAC7D,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAyB,CAAC;YACjE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAE1D,gDAAgD;YAChD,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAC9E,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAE5D,4CAA4C;YAC5C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAC/C,WAAW,CAAC,EAAE,EACd,SAAS,EACT,WAAW,CACZ,CAAC;YAEF,WAAW,CAAC,IAAI,CAAC;gBACf,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC;gBAChD,SAAS;gBACT,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,wBAAwB,CACpC,WAAmB,EACnB,WAA0B,EAC1B,OAAe;QAEf,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC,CAAC,6BAA6B;QAC1C,CAAC;QAED,wBAAwB;QACxB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAC/B,IAAI,CAAC,WAAW,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,CACZ,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,gBAAgB;QAChB,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAExD,8DAA8D;QAC9D,6CAA6C;QAC7C,MAAM,eAAe,GAAG,8BAA8B,CAAC;QACvD,MAAM,SAAS,GAAyC,EAAE,CAAC;QAE3D,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,gBAAgB;gBAC9B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;aACvB,CAAC,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,6DAA6D;YAC7D,MAAM,WAAW,GAAG,IAAI,MAAM,CAC5B,UAAU,QAAQ,CAAC,EAAE,+DAA+D,EACpF,GAAG,CACJ,CAAC;YACF,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAElD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAE7D,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,MAAM,EAAE,WAAW;gBACnB,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAqB;QAChD,OAAO,MAAM,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAAC,MAAM,kBAAkB,IAAI,CAAC,OAAO,uBAAuB,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5I,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,WAAwB;QACtD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QAC9E,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzE,IAAI,OAAO,GAAG,gCAAgC,SAAS,IAAI,KAAK,2BAA2B,UAAU,QAAQ,CAAC;QAE9G,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACnD,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS;gBAChC,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,sBAAsB,EAAE,CAAC,SAAS,IAAI;gBACxD,CAAC,CAAC,KAAK,CAAC;YAEV,OAAO,IAAI,KAAK,QAAQ,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,WAAW,IAAI,EAAE,CAAC,MAAM,iBAAiB,aAAa,KAAK,CAAC;QACrH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,WAAwB;QAChD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CACvC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAC1D,CAAC,CACF,CAAC;QACF,MAAM,UAAU,GACd,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvE,IAAI,OAAO,GAAG,uCAAuC,cAAc,IAAI,UAAU,oBAAoB,UAAU,QAAQ,CAAC;QAExH,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,SAAS,CAAC,sCAAsC;YAClD,CAAC;YAED,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS;gBAChC,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,sBAAsB,EAAE,CAAC,SAAS,YAAY;gBAChE,CAAC,CAAC,KAAK,CAAC;YAEV,OAAO,IAAI,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,gBAAgB,aAAa,OAAO,CAAC;YAEzE,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC7C,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;YACzD,CAAC;YAED,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,MAAc;QAEd,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,WAAW;YAAE,OAAO,UAAU,CAAC;QAC/E,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,aAAa;YAAE,OAAO,QAAQ,CAAC;QAC7E,IAAI,UAAU,KAAK,UAAU;YAAE,OAAO,UAAU,CAAC;QACjD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,MAA0D;QAE1D,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,UAAU;gBACb,OAAO,GAAG,CAAC;YACb,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC;YACd,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC;YACd,KAAK,aAAa;gBAChB,OAAO,GAAG,CAAC;YACb;gBACE,OAAO,GAAG,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/plugins/specweave-github/lib/github-client.d.ts

@@ -31,7 +31,7 @@ export declare class GitHubClient {
      */
     private getMilestoneByTitle;
     /**
-     * Create epic issue (increment-level)
+     * Create epic issue (increment-level) with FULL DUPLICATE PROTECTION
      */
     createEpicIssue(title: string, body: string, milestone?: number | string, labels?: string[]): Promise<GitHubIssue>;
     /**

package/dist/plugins/specweave-github/lib/github-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,CAAC,EAAE,MAAM;IAKzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAevF;;;;;;OAMG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,eAAe,CAAC;IAuB3B;;OAEG;YACW,mBAAmB;IAUjC;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IAgCvB;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IAmCvB;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAezD;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActE;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAelF;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,OAAO,CAAC,WAAW,EAAE,CAAC;IA+BzB,OAAO,CAAC,KAAK;IAIb;;;;OAIG;WACU,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAsBnI"}
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGvD,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,CAAC,EAAE,MAAM;IAKzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAevF;;;;;;OAMG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,eAAe,CAAC;IAuB3B;;OAEG;YACW,mBAAmB;IAUjC;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IA0CvB;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IAmCvB;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAezD;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActE;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAelF;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,OAAO,CAAC,WAAW,EAAE,CAAC;IA+BzB,OAAO,CAAC,KAAK;IAIb;;;;OAIG;WACU,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAsBnI"}

package/dist/plugins/specweave-github/lib/github-client.js

@@ -3,6 +3,7 @@
  * Uses `gh` command for GitHub API operations
  */
 import { execSync } from 'child_process';
+import { DuplicateDetector } from './duplicate-detector.js';
 export class GitHubClient {
     constructor(repo) {
         // Auto-detect repo from git remote if not provided
@@ -83,24 +84,35 @@ export class GitHubClient {
         }
     }
     /**
-     * Create epic issue (increment-level)
+     * Create epic issue (increment-level) with FULL DUPLICATE PROTECTION
      */
     async createEpicIssue(title, body, milestone, labels = []) {
-        const labelArgs = labels.map(l => `-l "${l}"`).join(' ');
-        const milestoneArg = milestone ? `-m "${milestone}"` : '';
-        // Create issue (returns URL)
-        const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(body)}" ${labelArgs} ${milestoneArg}`;
+        // Extract title pattern for duplicate detection (e.g., "[FS-031]" from "[FS-031] Feature Title")
+        const titlePattern = DuplicateDetector.extractTitlePattern(title);
+        if (!titlePattern) {
+            throw new Error(`Epic issue title must start with pattern like [FS-XXX] or [INC-XXXX]: ${title}`);
+        }
         try {
-            const issueUrl = execSync(createCmd, { encoding: 'utf-8' }).trim();
-            // Extract issue number from URL (e.g., https://github.com/owner/repo/issues/123)
-            const issueNumber = parseInt(issueUrl.split('/').pop() || '0', 10);
-            if (!issueNumber) {
-                throw new Error('Failed to extract issue number from URL: ' + issueUrl);
-            }
-            // Fetch issue details
-            const viewCmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
+            // Use DuplicateDetector for full 3-phase protection
+            const result = await DuplicateDetector.createWithProtection({
+                title,
+                body,
+                titlePattern,
+                labels: labels.length > 0 ? labels : ['specweave', 'increment'],
+                milestone: milestone?.toString(),
+                repo: this.repo
+            });
+            // Fetch full issue details (DuplicateDetector returns minimal info)
+            const viewCmd = `gh issue view ${result.issue.number} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
             const output = execSync(viewCmd, { encoding: 'utf-8' });
             const issue = JSON.parse(output);
+            // Log duplicate detection results if any
+            if (result.wasReused) {
+                console.log(`   ♻️  Reused existing issue #${result.issue.number} (duplicate prevention)`);
+            }
+            if (result.duplicatesFound > 0) {
+                console.log(`   🛡️  Duplicates detected: ${result.duplicatesFound} (auto-closed: ${result.duplicatesClosed})`);
+            }
             return {
                 ...issue,
                 html_url: issue.url,