specweave 0.23.2 → 0.23.4

package/CLAUDE.md

@@ -314,6 +314,90 @@ npx tsx src/core/status-line-validator.ts
 
 **Incident Reference**: 2025-11-20 - Status line showed 21/52 tasks when actually 26/52 were complete (10% desync). Root cause: Tasks marked complete without using TodoWrite, so hooks never fired. Added validation layer and tests to prevent future occurrences.
 
+### 7b. GitHub Duplicate Prevention (CRITICAL!)
+
+**CRITICAL**: External tool items (GitHub issues, JIRA tickets, ADO work items) MUST NEVER be duplicated.
+
+**Rule**: ALWAYS use DuplicateDetector for GitHub issue creation.
+
+**Why This Matters**:
+- GitHub search has eventual consistency (2-5 second lag)
+- Race conditions can create duplicates if sync runs multiple times quickly
+- Manual search with `--limit 1` hides duplicates
+
+**The ONLY Way to Create GitHub Issues**:
+```typescript
+import { DuplicateDetector } from './duplicate-detector.js';
+
+// ✅ CORRECT: Use DuplicateDetector.createWithProtection()
+const titlePattern = `[${featureId}][${userStory.id}]`;  // e.g., "[FS-047][US-001]"
+const result = await DuplicateDetector.createWithProtection({
+  title: issueContent.title,
+  body: issueContent.body,
+  titlePattern,
+  labels: issueContent.labels,
+  milestone: milestoneTitle,
+  repo: `${owner}/${repo}`
+});
+
+// Provides automatic:
+// ✅ Phase 1 (Detection): Search for existing before create
+// ✅ Phase 2 (Verification): Count-check after creation
+// ✅ Phase 3 (Reflection): Auto-close duplicates, keep oldest
+
+// ❌ WRONG: Manual gh issue create (no duplicate protection!)
+execSync('gh issue create --title "..." --body "..."');
+```
+
+**3-Phase Protection**:
+1. **Detection** - Search GitHub for existing issues BEFORE creating
+2. **Verification** - Count-check AFTER creation (handles eventual consistency)
+3. **Reflection** - Auto-close duplicates if detected, keep oldest
+
+**Search Limits** (CRITICAL!):
+```typescript
+// ❌ WRONG: --limit 1 hides duplicates!
+gh issue list --search "[FS-047][US-001] in:title" --limit 1
+// Returns ONLY 1 result even if 10 duplicates exist!
+
+// ✅ CORRECT: --limit 50 detects duplicates
+gh issue list --search "[FS-047][US-001] in:title" --limit 50
+// Returns up to 50 results, enabling duplicate detection
+```
+
+**Cleanup Existing Duplicates**:
+```bash
+# Preview what will be cleaned up:
+bash scripts/cleanup-duplicate-github-issues.sh --dry-run
+
+# Actually close duplicates (keeps oldest):
+bash scripts/cleanup-duplicate-github-issues.sh
+```
+
+**Validation**:
+```bash
+# Check for duplicates:
+gh issue list --json title,createdAt --limit 100 | \
+  jq -r '.[] | .title' | sort | uniq -d
+
+# If output is empty → No duplicates! ✅
+# If output shows titles → Duplicates exist, investigate!
+```
+
+**Why This Matters**:
+- Incident 2025-11-20: 10+ duplicate User Story issues created
+- Root Cause #1: Race condition (GitHub search eventual consistency lag)
+- Root Cause #2: `--limit 1` bug (hid duplicates in search results)
+- Root Cause #3: No post-create verification
+- **Fix**: DuplicateDetector integration (github-feature-sync.ts:149-227)
+
+**Protected Files**:
+- `plugins/specweave-github/lib/github-feature-sync.ts` - Uses DuplicateDetector
+- `plugins/specweave-github/lib/duplicate-detector.ts` - 3-phase protection
+- `plugins/specweave-github/lib/github-client-v2.ts` - Fixed --limit 50
+
+**Incident Reference**: 2025-11-20 - Duplicate GitHub issues for User Stories ([SP-US-006], [SP-US-007], etc.). Root cause: Race conditions + --limit 1 bug + missing DuplicateDetector integration. Fixed by implementing 3-phase protection. See `.specweave/increments/0047-us-task-linkage/reports/DUPLICATE-GITHUB-ISSUES-ROOT-CAUSE.md`.
+
 ### 8. NEVER Use `console.*` in Production Code
 
 **Rule**: ALL `src/` code MUST use logger abstraction, NEVER `console.log/error/warn`.
@@ -762,6 +846,190 @@ bash scripts/validate-marketplace-plugins.sh
 - Validation script: `scripts/validate-marketplace-plugins.sh`
 - Fix script: `bin/fix-marketplace-errors.sh`
 
+### 15. Skills vs Agents: Understanding the Distinction (CRITICAL!)
+
+**NEVER confuse skills with agents** - They are different components with different invocation methods.
+
+**The Problem**:
+Empty agent directories cause "Agent type not found" errors when someone tries to invoke them. This happened with `specweave:increment-quality-judge-v2` which existed as a skill but had an empty agent directory.
+
+**Key Differences**:
+
+| Aspect | Skills | Agents |
+|--------|--------|--------|
+| **Location** | `plugins/*/skills/name/SKILL.md` | `plugins/*/agents/name/AGENT.md` |
+| **Invocation** | Skill tool or slash commands | Task tool with `subagent_type` |
+| **Activation** | Automatic (based on keywords) | Explicit (you call them) |
+| **Required File** | `SKILL.md` with YAML frontmatter | `AGENT.md` or agent config |
+| **Purpose** | Expand context with knowledge | Execute multi-step tasks |
+
+**Correct Invocation Examples**:
+
+```typescript
+// ✅ CORRECT: Invoking a skill
+Skill({ skill: "increment-quality-judge-v2" });
+// OR use slash command:
+/specweave:qa 0047
+
+// ✅ CORRECT: Invoking an agent
+Task({
+  subagent_type: "specweave:qa-lead:qa-lead",
+  prompt: "Create test plan for increment 0047"
+});
+
+// ❌ WRONG: Trying to invoke skill as agent
+Task({
+  subagent_type: "specweave:increment-quality-judge-v2",  // ERROR!
+  prompt: "Quality assessment"
+});
+```
+
+**Agent Naming Convention** (CRITICAL!):
+
+Claude Code agents follow a strict naming pattern for `subagent_type`:
+
+**Directory-based agents**: `{plugin-name}:{directory-name}:{name-from-yaml}`
+
+Examples:
+- Agent at `plugins/specweave/agents/qa-lead/AGENT.md` with `name: qa-lead`
+  → Invoke as: `specweave:qa-lead:qa-lead`
+- Agent at `plugins/specweave/agents/pm/AGENT.md` with `name: pm`
+  → Invoke as: `specweave:pm:pm`
+- Agent at `plugins/specweave/agents/architect/AGENT.md` with `name: architect`
+  → Invoke as: `specweave:architect:architect`
+
+**Why the "duplication"?**
+The pattern is `{plugin}:{directory}:{yaml-name}`. When the directory name matches the YAML `name` field (best practice), it creates the appearance of duplication: `qa-lead:qa-lead`.
+
+**File-based agents** (legacy pattern):
+- Agent at `plugins/specweave/agents/code-reviewer.md`
+  → Invoke as: `specweave:code-reviewer` (no duplication)
+
+**How to find the correct agent type**:
+```bash
+# List all available agents
+ls -la plugins/specweave/agents/
+
+# Check YAML name field
+head -5 plugins/specweave/agents/qa-lead/AGENT.md
+# Output: name: qa-lead
+
+# Construct agent type: specweave:qa-lead:qa-lead
+```
+
+**Common Mistakes**:
+```typescript
+// ❌ WRONG: Missing the directory/name duplication
+Task({ subagent_type: "specweave:qa-lead", ... });
+// Error: Agent type 'specweave:qa-lead' not found
+
+// ✅ CORRECT: Full pattern with duplication
+Task({ subagent_type: "specweave:qa-lead:qa-lead", ... });
+```
+
+**Directory Structure Requirements**:
+
+```bash
+# ✅ CORRECT: Skill with SKILL.md
+plugins/specweave/skills/increment-quality-judge-v2/
+  └── SKILL.md  (with YAML frontmatter)
+
+# ✅ CORRECT: Agent with AGENT.md
+plugins/specweave/agents/qa-lead/
+  └── AGENT.md
+
+# ❌ WRONG: Empty agent directory
+plugins/specweave/agents/increment-quality-judge-v2/
+  (empty - no AGENT.md!)
+
+# ❌ WRONG: Skill missing SKILL.md
+plugins/specweave/skills/my-skill/
+  └── some-file.txt  (not SKILL.md!)
+```
+
+**SKILL.md Format** (MANDATORY):
+```yaml
+---
+name: skill-name
+description: What it does AND trigger keywords. Include all variations.
+---
+
+# Skill Content
+
+Your skill documentation here...
+```
+
+**Validation** (MANDATORY before commits):
+
+```bash
+# Check for empty/invalid directories
+bash scripts/validate-plugin-directories.sh
+
+# Auto-fix empty directories
+bash scripts/validate-plugin-directories.sh --fix
+
+# This catches:
+# - Empty agent/skill directories
+# - Missing SKILL.md files
+# - Missing YAML frontmatter
+# - Invalid plugin structures
+```
+
+**Common Mistakes**:
+
+1. **Creating empty agent directories during scaffolding**
+   ```bash
+   # ❌ WRONG
+   mkdir -p plugins/specweave/agents/new-agent
+   git add . && git commit  # Empty directory!
+
+   # ✅ CORRECT
+   mkdir -p plugins/specweave/agents/new-agent
+   echo "---" > plugins/specweave/agents/new-agent/AGENT.md
+   # ... add agent content ...
+   git add . && git commit
+   ```
+
+2. **Copying skill as agent without changing structure**
+   - Skills need `SKILL.md` with YAML
+   - Agents need `AGENT.md` or config
+   - Don't copy-paste between them!
+
+3. **Using wrong invocation method**
+   - Check available skills: Skills list in context
+   - Check available agents: Error message shows all agents
+   - Skills → Skill tool or slash commands
+   - Agents → Task tool
+
+**When to Use Skills vs Agents**:
+
+**Use Skills when**:
+- Providing domain knowledge (e.g., Kafka best practices)
+- Expanding Claude's context with project-specific info
+- Explaining concepts, patterns, frameworks
+- Want automatic activation based on keywords
+
+**Use Agents when**:
+- Need multi-step task execution (e.g., generate docs)
+- Require specialized sub-agent capabilities
+- Building complex workflows with tools
+- Want explicit control over when they run
+
+**Incident History**:
+- **2025-11-20**: `specweave:increment-quality-judge-v2` agent invocation failed because only skill existed. Empty agent directory caused "Agent type not found" error. Fixed by removing empty directory and documenting distinction.
+
+**Prevention**:
+1. Run `bash scripts/validate-plugin-directories.sh` before commits
+2. Never create empty agent/skill directories
+3. Always include required files (SKILL.md, AGENT.md)
+4. Test invocation method matches component type
+5. Use pre-commit hook (blocks invalid structures)
+
+**See Also**:
+- Validation script: `scripts/validate-plugin-directories.sh`
+- Skills index: `plugins/specweave/skills/SKILLS-INDEX.md`
+- Claude Code Skills docs: `~/CLAUDE.md` (Personal skills reference)
+
 ---
 
 ## Project Structure

package/dist/plugins/specweave/lib/utils/fs-native.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Native Node.js fs API Helpers
+ *
+ * Drop-in replacements for fs-extra methods using only Node.js stdlib.
+ * All methods use native Node.js 20+ APIs with no external dependencies.
+ *
+ * Migration from fs-extra:
+ * - import fs from 'fs-extra' → import * as fs from './utils/fs-native.js'
+ * - All fs-extra methods work as drop-in replacements
+ *
+ * Benefits:
+ * - Zero bundle overhead (no npm packages)
+ * - Works in marketplace (no node_modules needed)
+ * - Faster startup (native APIs)
+ * - Better debugging (native stack traces)
+ */
+import { promises as fsPromises, existsSync, mkdirSync, readFileSync, writeFileSync, statSync, readdirSync, rmSync, unlinkSync } from 'fs';
+/**
+ * Ensures that a directory exists. If the directory does not exist, it is created.
+ * @param dirPath - The directory path to ensure
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Synchronous version of ensureDir
+ */
+export declare function ensureDirSync(dirPath: string): void;
+/**
+ * Alias for ensureDirSync (fs-extra compatibility)
+ */
+export declare function mkdirpSync(dirPath: string): void;
+/**
+ * Check if a path exists
+ * @param filePath - The path to check
+ */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/**
+ * Synchronous version of pathExists
+ */
+export { existsSync };
+/**
+ * Read a JSON file and parse it
+ * @param filePath - The JSON file path
+ */
+export declare function readJson(filePath: string): Promise<any>;
+/**
+ * Synchronous version of readJson
+ */
+export declare function readJsonSync(filePath: string): any;
+/**
+ * Write a JSON file with formatting
+ * @param filePath - The JSON file path
+ * @param data - The data to write
+ * @param options - Options (spaces for indentation)
+ */
+export declare function writeJson(filePath: string, data: any, options?: {
+    spaces?: number;
+}): Promise<void>;
+/**
+ * Synchronous version of writeJson
+ */
+export declare function writeJsonSync(filePath: string, data: any, options?: {
+    spaces?: number;
+}): void;
+/**
+ * Remove a file or directory (recursively)
+ * @param targetPath - The path to remove
+ */
+export declare function remove(targetPath: string): Promise<void>;
+/**
+ * Synchronous version of remove
+ */
+export declare function removeSync(targetPath: string): void;
+/**
+ * Copy a file or directory
+ * @param src - Source path
+ * @param dest - Destination path
+ * @param options - Copy options
+ */
+export declare function copy(src: string, dest: string, options?: {
+    overwrite?: boolean;
+    filter?: (src: string) => boolean;
+}): Promise<void>;
+/**
+ * Synchronous version of copy
+ */
+export declare function copySync(src: string, dest: string, options?: {
+    overwrite?: boolean;
+    filter?: (src: string) => boolean;
+}): void;
+/**
+ * Ensure a file exists (create if it doesn't)
+ * @param filePath - The file path
+ */
+export declare function ensureFile(filePath: string): Promise<void>;
+/**
+ * Synchronous version of ensureFile
+ */
+export declare function ensureFileSync(filePath: string): void;
+export declare const readFile: typeof fsPromises.readFile, writeFile: typeof fsPromises.writeFile, appendFile: typeof fsPromises.appendFile, stat: typeof fsPromises.stat, readdir: typeof fsPromises.readdir, access: typeof fsPromises.access, unlink: typeof fsPromises.unlink, rmdir: typeof fsPromises.rmdir, rename: typeof fsPromises.rename, chmod: typeof fsPromises.chmod;
+export { readFileSync, writeFileSync, statSync, readdirSync, unlinkSync, mkdirSync, rmSync, };
+declare const _default: {
+    ensureDir: typeof ensureDir;
+    pathExists: typeof pathExists;
+    readJson: typeof readJson;
+    writeJson: typeof writeJson;
+    remove: typeof remove;
+    copy: typeof copy;
+    ensureFile: typeof ensureFile;
+    readFile: typeof fsPromises.readFile;
+    writeFile: typeof fsPromises.writeFile;
+    appendFile: typeof fsPromises.appendFile;
+    stat: typeof fsPromises.stat;
+    readdir: typeof fsPromises.readdir;
+    access: typeof fsPromises.access;
+    unlink: typeof fsPromises.unlink;
+    ensureDirSync: typeof ensureDirSync;
+    mkdirpSync: typeof mkdirpSync;
+    existsSync: typeof existsSync;
+    readJsonSync: typeof readJsonSync;
+    writeJsonSync: typeof writeJsonSync;
+    removeSync: typeof removeSync;
+    copySync: typeof copySync;
+    ensureFileSync: typeof ensureFileSync;
+    readFileSync: typeof readFileSync;
+    writeFileSync: typeof writeFileSync;
+    statSync: import("fs").StatSyncFn;
+    readdirSync: typeof readdirSync;
+    unlinkSync: typeof unlinkSync;
+    mkdirSync: typeof mkdirSync;
+    rmSync: typeof rmSync;
+};
+export default _default;
+//# sourceMappingURL=fs-native.d.ts.map

package/dist/plugins/specweave/lib/utils/fs-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-native.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/utils/fs-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAgB,MAAM,IAAI,CAAC;AAIzJ;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAInD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAG7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAGlD;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAInD;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACnE,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACnE,IAAI,CA4BN;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKrD;AAGD,eAAO,MACL,QAAQ,8BACR,SAAS,+BACT,UAAU,gCACV,IAAI,0BACJ,OAAO,6BACP,MAAM,4BACN,MAAM,4BACN,KAAK,2BACL,MAAM,4BACN,KAAK,yBACO,CAAC;AAGf,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,GACP,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGF,wBAiCE"}

package/dist/plugins/specweave/lib/utils/fs-native.js

@@ -0,0 +1,224 @@
+/**
+ * Native Node.js fs API Helpers
+ *
+ * Drop-in replacements for fs-extra methods using only Node.js stdlib.
+ * All methods use native Node.js 20+ APIs with no external dependencies.
+ *
+ * Migration from fs-extra:
+ * - import fs from 'fs-extra' → import * as fs from './utils/fs-native.js'
+ * - All fs-extra methods work as drop-in replacements
+ *
+ * Benefits:
+ * - Zero bundle overhead (no npm packages)
+ * - Works in marketplace (no node_modules needed)
+ * - Faster startup (native APIs)
+ * - Better debugging (native stack traces)
+ */
+import { promises as fsPromises, existsSync, mkdirSync, readFileSync, writeFileSync, statSync, readdirSync, rmSync, unlinkSync, copyFileSync } from 'fs';
+import path from 'path';
+/**
+ * Ensures that a directory exists. If the directory does not exist, it is created.
+ * @param dirPath - The directory path to ensure
+ */
+export async function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        await fsPromises.mkdir(dirPath, { recursive: true });
+    }
+}
+/**
+ * Synchronous version of ensureDir
+ */
+export function ensureDirSync(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Alias for ensureDirSync (fs-extra compatibility)
+ */
+export function mkdirpSync(dirPath) {
+    ensureDirSync(dirPath);
+}
+/**
+ * Check if a path exists
+ * @param filePath - The path to check
+ */
+export async function pathExists(filePath) {
+    return existsSync(filePath);
+}
+/**
+ * Synchronous version of pathExists
+ */
+export { existsSync };
+/**
+ * Read a JSON file and parse it
+ * @param filePath - The JSON file path
+ */
+export async function readJson(filePath) {
+    const content = await fsPromises.readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Synchronous version of readJson
+ */
+export function readJsonSync(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Write a JSON file with formatting
+ * @param filePath - The JSON file path
+ * @param data - The data to write
+ * @param options - Options (spaces for indentation)
+ */
+export async function writeJson(filePath, data, options) {
+    const spaces = options?.spaces ?? 2;
+    const content = JSON.stringify(data, null, spaces);
+    await fsPromises.writeFile(filePath, content, 'utf-8');
+}
+/**
+ * Synchronous version of writeJson
+ */
+export function writeJsonSync(filePath, data, options) {
+    const spaces = options?.spaces ?? 2;
+    const content = JSON.stringify(data, null, spaces);
+    writeFileSync(filePath, content, 'utf-8');
+}
+/**
+ * Remove a file or directory (recursively)
+ * @param targetPath - The path to remove
+ */
+export async function remove(targetPath) {
+    if (existsSync(targetPath)) {
+        await fsPromises.rm(targetPath, { recursive: true, force: true });
+    }
+}
+/**
+ * Synchronous version of remove
+ */
+export function removeSync(targetPath) {
+    if (existsSync(targetPath)) {
+        rmSync(targetPath, { recursive: true, force: true });
+    }
+}
+/**
+ * Copy a file or directory
+ * @param src - Source path
+ * @param dest - Destination path
+ * @param options - Copy options
+ */
+export async function copy(src, dest, options) {
+    const srcStat = await fsPromises.stat(src);
+    if (srcStat.isFile()) {
+        // Copy single file
+        await fsPromises.mkdir(path.dirname(dest), { recursive: true });
+        await fsPromises.copyFile(src, dest);
+    }
+    else if (srcStat.isDirectory()) {
+        // Copy directory recursively
+        await fsPromises.mkdir(dest, { recursive: true });
+        const entries = await fsPromises.readdir(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            // Apply filter if provided
+            if (options?.filter && !options.filter(srcPath)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await copy(srcPath, destPath, options);
+            }
+            else {
+                await fsPromises.copyFile(srcPath, destPath);
+            }
+        }
+    }
+}
+/**
+ * Synchronous version of copy
+ */
+export function copySync(src, dest, options) {
+    const srcStat = statSync(src);
+    if (srcStat.isFile()) {
+        // Copy single file
+        mkdirSync(path.dirname(dest), { recursive: true });
+        copyFileSync(src, dest);
+    }
+    else if (srcStat.isDirectory()) {
+        // Copy directory recursively
+        mkdirSync(dest, { recursive: true });
+        const entries = readdirSync(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            // Apply filter if provided
+            if (options?.filter && !options.filter(srcPath)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                copySync(srcPath, destPath, options);
+            }
+            else {
+                copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+}
+/**
+ * Ensure a file exists (create if it doesn't)
+ * @param filePath - The file path
+ */
+export async function ensureFile(filePath) {
+    if (!existsSync(filePath)) {
+        await fsPromises.mkdir(path.dirname(filePath), { recursive: true });
+        await fsPromises.writeFile(filePath, '', 'utf-8');
+    }
+}
+/**
+ * Synchronous version of ensureFile
+ */
+export function ensureFileSync(filePath) {
+    if (!existsSync(filePath)) {
+        mkdirSync(path.dirname(filePath), { recursive: true });
+        writeFileSync(filePath, '', 'utf-8');
+    }
+}
+// Re-export common fs/promises methods for convenience
+export const { readFile, writeFile, appendFile, stat, readdir, access, unlink, rmdir, rename, chmod, } = fsPromises;
+// Re-export common synchronous methods
+export { readFileSync, writeFileSync, statSync, readdirSync, unlinkSync, mkdirSync, rmSync, };
+// Default export for convenience
+export default {
+    // Async methods
+    ensureDir,
+    pathExists,
+    readJson,
+    writeJson,
+    remove,
+    copy,
+    ensureFile,
+    readFile,
+    writeFile,
+    appendFile,
+    stat,
+    readdir,
+    access,
+    unlink,
+    // Sync methods
+    ensureDirSync,
+    mkdirpSync,
+    existsSync,
+    readJsonSync,
+    writeJsonSync,
+    removeSync,
+    copySync,
+    ensureFileSync,
+    readFileSync,
+    writeFileSync,
+    statSync,
+    readdirSync,
+    unlinkSync,
+    mkdirSync,
+    rmSync,
+};
+//# sourceMappingURL=fs-native.js.map

package/dist/plugins/specweave/lib/utils/fs-native.js.map

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

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

@@ -258,7 +258,7 @@ export class GitHubClientV2 {
             '--json',
             'number,title,state,url,labels',
             '--limit',
-            '1',
+            '50', // ✅ FIX: Increased from 1 to 50 to catch duplicates (Issue #0047)
         ]);
         if (result.exitCode !== 0) {
             // Search failed, return null (treat as not found)