specweave 0.17.15 → 0.17.17

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

@@ -0,0 +1,220 @@
+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";
+async function syncSpecWithEnhancedContent(options) {
+  const { specPath, owner, repo, dryRun = false, verbose = false } = options;
+  try {
+    const baseSpec = await parseSpecContent(specPath);
+    if (!baseSpec) {
+      return {
+        success: false,
+        action: "error",
+        error: "Failed to parse spec content"
+      };
+    }
+    if (verbose) {
+      console.log(`\u{1F4C4} Parsed spec: ${baseSpec.identifier.compact}`);
+    }
+    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(`\u{1F517} Found ${mapping.increments.length} related increments`);
+      console.log(`\u{1F4CB} Mapped ${Object.keys(mapping.userStoryMappings).length} user stories to tasks`);
+    }
+    const taskMapping = buildTaskMapping(mapping.increments, owner, repo);
+    const architectureDocs = await findArchitectureDocs(rootDir, specId);
+    const sourceLinks = buildSourceLinks(mapping.increments[0]?.id, owner, repo);
+    const enhancedSpec = {
+      ...baseSpec,
+      summary: baseSpec.description,
+      taskMapping,
+      architectureDocs,
+      sourceLinks
+    };
+    const builder = new EnhancedContentBuilder();
+    const originalBuildExternal = builder.buildExternalDescription.bind(builder);
+    const description = (() => {
+      const sections = [];
+      sections.push(builder.buildSummarySection(enhancedSpec));
+      if (enhancedSpec.userStories && enhancedSpec.userStories.length > 0) {
+        sections.push(builder.buildUserStoriesSection(enhancedSpec.userStories));
+      }
+      if (enhancedSpec.taskMapping) {
+        sections.push(builder.buildTasksSection(enhancedSpec.taskMapping, {
+          showCheckboxes: true,
+          showProgressBar: true,
+          showCompletionStatus: true,
+          provider: "github"
+        }));
+      }
+      if (enhancedSpec.architectureDocs && enhancedSpec.architectureDocs.length > 0) {
+        sections.push(builder.buildArchitectureSection(enhancedSpec.architectureDocs));
+      }
+      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(`\u{1F4DD} Generated description: ${description.length} characters`);
+    }
+    if (dryRun) {
+      console.log("\u{1F50D} 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
+      };
+    }
+    if (!owner || !repo) {
+      return {
+        success: false,
+        action: "error",
+        error: "GitHub owner/repo not specified"
+      };
+    }
+    const client = GitHubClientV2.fromRepo(owner, repo);
+    const labelDetector = new LabelDetector(void 0, false);
+    const detection = labelDetector.detectType(
+      await fs.readFile(specPath, "utf-8"),
+      mapping.increments[0]?.id
+    );
+    const githubLabels = labelDetector.getGitHubLabels(detection.type);
+    const allLabels = ["spec", ...githubLabels];
+    if (verbose) {
+      console.log(`\u{1F3F7}\uFE0F  Detected type: ${detection.type} (${detection.confidence}% confidence)`);
+      console.log(`   Labels: ${allLabels.join(", ")}`);
+    }
+    const existingIssue = await findExistingIssue(client, baseSpec.identifier.compact);
+    let result;
+    if (existingIssue) {
+      await client.updateIssueBody(existingIssue.number, description);
+      await client.addLabels(existingIssue.number, allLabels);
+      result = {
+        success: true,
+        action: "updated",
+        issueNumber: existingIssue.number,
+        issueUrl: existingIssue.html_url,
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    } else {
+      const issue = await client.createEpicIssue(
+        `[${baseSpec.identifier.compact}] ${baseSpec.title}`,
+        description,
+        void 0,
+        allLabels
+        // Apply labels at creation
+      );
+      result = {
+        success: true,
+        action: "created",
+        issueNumber: issue.number,
+        issueUrl: issue.html_url,
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+      await mapper.updateSpecWithIncrementLinks(specId, mapping.increments[0]?.id);
+    }
+    if (verbose) {
+      console.log(`\u2705 ${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
+    };
+  }
+}
+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 void 0;
+  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 {
+    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 {
+    }
+    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 void 0;
+  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;
+  }
+}
+export {
+  syncSpecWithEnhancedContent
+};

package/plugins/specweave-github/lib/enhanced-github-sync.ts

@@ -0,0 +1,322 @@
+/**
+ * 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, EnhancedSpecContent } from '../../../src/core/sync/enhanced-content-builder.js';
+import { SpecIncrementMapper, TaskInfo } from '../../../src/core/sync/spec-increment-mapper.js';
+import { parseSpecContent, SpecContent } 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';
+
+export interface EnhancedGitHubSyncOptions {
+  specPath: string;
+  owner?: string;
+  repo?: string;
+  dryRun?: boolean;
+  verbose?: boolean;
+}
+
+export interface EnhancedSyncResult {
+  success: boolean;
+  action: 'created' | 'updated' | 'no-change' | 'error';
+  issueNumber?: number;
+  issueUrl?: string;
+  error?: string;
+  tasksLinked?: number;
+}
+
+/**
+ * Enhanced sync with rich content including task mappings
+ */
+export async function syncSpecWithEnhancedContent(
+  options: EnhancedGitHubSyncOptions
+): Promise<EnhancedSyncResult> {
+  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: EnhancedSpecContent = {
+      ...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: string[] = [];
+
+      // 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: EnhancedSyncResult;
+
+    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: any) {
+    return {
+      success: false,
+      action: 'error',
+      error: error.message
+    };
+  }
+}
+
+// Helper functions
+
+async function findSpecWeaveRoot(specPath: string): Promise<string> {
+  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: any[],
+  owner: string,
+  repo: string
+): any {
+  if (increments.length === 0) return undefined;
+
+  const firstIncrement = increments[0];
+  const tasks = firstIncrement.tasks.map((task: TaskInfo) => ({
+    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: string,
+  specId: string
+): Promise<any[]> {
+  const docs: any[] = [];
+  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: string | undefined, owner: string, repo: string): any {
+  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: GitHubClientV2, specId: string): Promise<any | null> {
+  try {
+    const issues = await client.listIssuesInTimeRange('ALL');
+    return issues.find((issue: any) => issue.title.includes(`[${specId}]`) && issue.labels?.some((l: any) => l.name === 'spec')) || null;
+  } catch {
+    return null;
+  }
+}

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

@@ -1,4 +1,5 @@
 import { execSync } from "child_process";
+import { DuplicateDetector } from "./duplicate-detector.js";
 class GitHubClient {
   constructor(repo) {
     this.repo = repo || this.detectRepo();
@@ -70,21 +71,31 @@ 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}"` : "";
-    const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(body)}" ${labelArgs} ${milestoneArg}`;
+    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();
-      const issueNumber = parseInt(issueUrl.split("/").pop() || "0", 10);
-      if (!issueNumber) {
-        throw new Error("Failed to extract issue number from URL: " + issueUrl);
-      }
-      const viewCmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
+      const result = await DuplicateDetector.createWithProtection({
+        title,
+        body,
+        titlePattern,
+        labels: labels.length > 0 ? labels : ["specweave", "increment"],
+        milestone: milestone?.toString(),
+        repo: this.repo
+      });
+      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);
+      if (result.wasReused) {
+        console.log(`   \u267B\uFE0F  Reused existing issue #${result.issue.number} (duplicate prevention)`);
+      }
+      if (result.duplicatesFound > 0) {
+        console.log(`   \u{1F6E1}\uFE0F  Duplicates detected: ${result.duplicatesFound} (auto-closed: ${result.duplicatesClosed})`);
+      }
       return {
         ...issue,
         html_url: issue.url,

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

@@ -5,6 +5,7 @@
 
 import { execSync } from 'child_process';
 import { GitHubIssue, GitHubMilestone } from './types';
+import { DuplicateDetector } from './duplicate-detector.js';
 
 export class GitHubClient {
   private repo: string;
@@ -96,7 +97,7 @@ export class GitHubClient {
   }
 
   /**
-   * Create epic issue (increment-level)
+   * Create epic issue (increment-level) with FULL DUPLICATE PROTECTION
    */
   async createEpicIssue(
     title: string,
@@ -104,27 +105,37 @@ export class GitHubClient {
     milestone?: number | string,
     labels: string[] = []
   ): Promise<GitHubIssue> {
-    const labelArgs = labels.map(l => `-l "${l}"`).join(' ');
-    const milestoneArg = milestone ? `-m "${milestone}"` : '';
+    // Extract title pattern for duplicate detection (e.g., "[FS-031]" from "[FS-031] Feature Title")
+    const titlePattern = DuplicateDetector.extractTitlePattern(title);
 
-    // Create issue (returns URL)
-    const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(body)}" ${labelArgs} ${milestoneArg}`;
+    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,