specweave 0.21.3 → 0.22.0

package/CLAUDE.md

@@ -24,21 +24,23 @@ Users receive a different CLAUDE.md via the template system.
 /SESSION-SUMMARY-2025-10-28.md         # NO! Goes to increment reports/
 /ADR-006-DEEP-ANALYSIS.md              # NO! Goes to .specweave/docs/internal/architecture/adr/
 /ANALYSIS-MULTI-TOOL-COMPARISON.md     # NO! Goes to increment reports/
+/QUICK-START.md                        # NO! Goes to increment reports/
 /migration-helper.sh                   # NO! Goes to increment scripts/
 /execution.log                         # NO! Goes to increment logs/
 
 ✅ CORRECT - INCREMENT FOLDERS:
 .specweave/increments/0004-plugin-architecture/
-├── spec.md                            # Spec files (core 3)
+├── spec.md                            # ⚠️ ONLY THESE 3 FILES in root!
 ├── plan.md
 ├── tasks.md                           # Tasks with embedded tests
-├── reports/                           # ✅ PUT REPORTS HERE!
+├── reports/                           # ✅ ALL REPORTS HERE!
 │   ├── PLUGIN-MIGRATION-COMPLETE.md   # ✅ Completion reports
 │   ├── SESSION-SUMMARY.md             # ✅ Session summaries
+│   ├── QUICK-START.md                 # ✅ Quick start guides
 │   └── ANALYSIS-*.md                  # ✅ Analysis files
-├── scripts/                           # ✅ PUT SCRIPTS HERE!
+├── scripts/                           # ✅ ALL SCRIPTS HERE!
 │   └── migration-helper.sh            # ✅ Helper scripts
-└── logs/                              # ✅ PUT LOGS HERE!
+└── logs/                              # ✅ ALL LOGS HERE!
     └── execution.log                  # ✅ Execution logs
 
 .specweave/docs/internal/architecture/ # ✅ PUT ADRS/DIAGRAMS HERE!
@@ -48,6 +50,105 @@ Users receive a different CLAUDE.md via the template system.
 
 **Before committing, ALWAYS check**: `git status` - If you see `.md` files in root, MOVE THEM!
 
+### 📁 Increment Structure Rules (MANDATORY)
+
+**ONLY 3 files allowed in increment root**:
+1. ✅ `spec.md` - Specification
+2. ✅ `plan.md` - Implementation plan
+3. ✅ `tasks.md` - Tasks with embedded tests
+
+**Everything else MUST be in subfolders**:
+- `reports/` - Session summaries, completion reports, analysis files, quick-start guides
+- `scripts/` - Helper scripts, migrations, utilities
+- `logs/` - Execution logs, debug output, temp files
+
+**Examples of files that belong in subfolders**:
+- `QUICK-START.md` → `reports/QUICK-START.md`
+- `SESSION-NOTES.md` → `reports/SESSION-NOTES.md`
+- `ULTRATHINK-*.md` → `reports/ULTRATHINK-*.md`
+- `validation.sh` → `scripts/validation.sh`
+- `debug.log` → `logs/debug.log`
+
+**Why this matters**:
+- ✅ Clean, predictable structure
+- ✅ Easy to find files by type
+- ✅ No increment root clutter
+- ✅ Consistent across all increments
+
+---
+
+## 🛡️ CRITICAL: NEVER DELETE .specweave/ DIRECTORIES!
+
+**⛔ MASS DELETION PROTECTION IS ACTIVE ⛔**
+
+**PROTECTED DIRECTORIES**:
+- `.specweave/docs/` - All project documentation (internal + public)
+- `.specweave/increments/` - All increment history and specifications
+
+**WHAT THIS MEANS**:
+- ❌ **NEVER** run `rm -rf .specweave/docs` or `rm -rf .specweave/increments`
+- ❌ **NEVER** delete more than 50 files in these directories at once
+- ✅ Pre-commit hook will **BLOCK** accidental mass deletions
+- ✅ If intentional, bypass with `git commit --no-verify`
+
+**WHY THIS EXISTS**:
+On 2025-11-17, an accidental mass deletion occurred (1,200+ files). All files were recovered via `git restore`, but this protection prevents future incidents.
+
+**IF YOU ACCIDENTALLY DELETE**:
+```bash
+# Immediately restore:
+git restore .specweave/
+
+# Verify restoration:
+git status
+```
+
+**See**: `.specweave/increments/0039/reports/ACCIDENTAL-DELETION-RECOVERY-2025-11-17.md`
+
+---
+
+## ⚠️ CRITICAL: NEVER USE `specweave init . --force` FOR REINSTALLS!
+
+**⛔ COMMON MISTAKE THAT DELETES ALL DATA ⛔**
+
+**THE DANGER**:
+```bash
+# ❌ DANGEROUS (deletes ALL increments and docs):
+specweave init . --force
+
+# What --force actually does:
+# 1. Skips all confirmation prompts
+# 2. AUTOMATICALLY DELETES .specweave/ entirely
+# 3. Loses all increments, docs, and history
+# 4. No backup unless you create one manually
+```
+
+**SAFE ALTERNATIVES**:
+```bash
+# ✅ SAFE - Update files, keep all data:
+specweave init .
+# When prompted, select: "Continue working"
+
+# ✅ SAFE - Always interactive, never deletes:
+npx specweave init .
+```
+
+**WHY THIS MATTERS**:
+- Documentation used to recommend `--force` for troubleshooting (FIXED in v0.21.4+)
+- Users followed the docs and lost all their work
+- Now `--force` has multiple safeguards:
+  - ⚠️ BIG RED WARNING before deletion
+  - ✅ ALWAYS requires confirmation (even in force mode)
+  - 📦 Automatic backup created before deletion
+  - 🔒 Pre-commit hook blocks accidental commits
+
+**IF YOU NEED A FRESH START**:
+1. Backup first: `cp -r .specweave .specweave.backup-$(date +%Y%m%d)`
+2. Run: `specweave init .` (select "Fresh start" option)
+3. Or: `specweave init . --force` (requires confirmation + creates auto-backup)
+
+**NEVER use `--force` unless you want to DELETE EVERYTHING!**
+
 ---
 
 ## Tool Support
@@ -353,12 +454,103 @@ npm run build              # Compile TypeScript
 
 ### Testing
 
+**Test Framework**: **Vitest** (migrated from Jest on 2025-11-17)
+
 ```bash
-npm test                    # Unit tests
-npm run test:integration    # Integration tests (includes build verification)
+npm test                    # Smoke tests (quick validation)
+npm run test:unit           # Unit tests with Vitest
+npm run test:integration    # Integration tests with Vitest
 npm run test:e2e            # E2E tests (Playwright)
+npm run test:all            # All tests
+npm run test:coverage       # Coverage report
+```
+
+**Why Vitest?**
+- ✅ ESM-native (no tsconfig hacks)
+- ✅ Faster than Jest
+- ✅ Better TypeScript integration
+- ✅ Native import.meta.url support
+- ✅ Modern, actively maintained
+
+**Test Organization** (4 categories):
+- `tests/unit/` - Pure logic tests (no I/O) - **Vitest**
+- `tests/plugin-validation/` - Plugin structure contracts
+- `tests/integration/` - 4 semantic categories - **Vitest**:
+  - `external-tools/` - GitHub, JIRA, ADO, Kafka sync
+  - `core/` - Core framework + workflows
+  - `generators/` - Code generation (frontend, backend, ML)
+  - `features/` - Feature plugins (Figma, i18n, diagrams, etc.)
+- `tests/e2e/` - Full user scenarios - **Playwright**
+
+**Writing Tests**:
+```typescript
+// Import from vitest (NOT jest)
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+
+// Mocking
+vi.mock('fs/promises');
+const mockFn = vi.fn();
+vi.clearAllMocks();
+```
+
+**Details**: `.specweave/docs/internal/architecture/TEST-ORGANIZATION-PROPOSAL.md`
+
+### Test Isolation (CRITICAL - Prevents .specweave/ Deletion!)
+
+**🚨 MANDATORY FOR ALL TESTS creating .specweave/ structures:**
+
+**THE PROBLEM**: Tests using `process.cwd()` can accidentally delete the project `.specweave/` folder containing all your work!
+
+**CORRECT PATTERN** (ALWAYS use this):
+```typescript
+import * as os from 'os';
+import * as path from 'path';
+
+// ✅ SAFE: Uses isolated temp directory
+const testRoot = path.join(os.tmpdir(), 'test-name-' + Date.now());
+```
+
+**DANGEROUS PATTERN** (NEVER use this):
+```typescript
+// ❌ DANGER: Creates directories in project root!
+const testRoot = path.join(process.cwd(), '.test-something');
+const testPath = path.join(__dirname, '..', '.specweave', 'increments');
 ```
 
+**Why This Matters**:
+1. Tests create mock `.specweave/` structures for testing
+2. Cleanup uses `fs.rm(testRoot, { recursive: true })`
+3. If `testRoot` points to project root → **DELETES REAL .specweave/!**
+4. You lose all increments, docs, and history
+
+**Use Test Utilities** (RECOMMENDED):
+```typescript
+import { createIsolatedTestDir, createSpecweaveStructure } from '../test-utils/isolated-test-dir';
+
+test('my test', async () => {
+  const { testDir, cleanup } = await createIsolatedTestDir('my-test');
+
+  try {
+    // Setup .specweave structure in isolated directory
+    await createSpecweaveStructure(testDir);
+
+    // Test code here - NEVER touches project .specweave/
+    const incrementPath = path.join(testDir, '.specweave', 'increments', '0001-test');
+    // ...
+  } finally {
+    await cleanup(); // ALWAYS cleanup
+  }
+});
+```
+
+**Protection Layers**:
+1. ✅ **Pre-commit hook**: Blocks commits with dangerous test patterns
+2. ✅ **Test utilities**: `tests/test-utils/isolated-test-dir.ts`
+3. ✅ **Documentation**: This section
+
+**Related Incident**: 2025-11-17 - Multiple `.specweave/` deletions traced to dangerous test patterns
+**Root Cause Analysis**: `.specweave/increments/0037/reports/DELETION-ROOT-CAUSE-2025-11-17.md`
+
 ### Build Health Checks
 
 **CRITICAL**: TypeScript ES Modules require specific practices:

package/README.md

@@ -232,8 +232,18 @@ Claude implements Task 1:
 # Install SpecWeave
 npm install -g specweave
 
-# Initialize new project
+# Initialize with Strategic Init (AI-powered research)
 specweave init my-project
+
+# Strategic Init guides you through 6 phases:
+# Phase 1: Vision & Market Research
+# Phase 2: Scaling & Performance Goals
+# Phase 3: Data & Compliance Detection
+# Phase 4: Budget & Cloud Credits
+# Phase 5: Methodology & Organization
+# Phase 6: Repository Selection (optional)
+
+# Result: Architecture recommendation, team plan, cost estimates
 cd my-project
 
 # Start building
@@ -242,6 +252,15 @@ cd my-project
 /specweave:done 0001                        # Complete increment
 ```
 
+### Multi-Project Setup
+```bash
+# Initialize with multiple projects
+specweave init --projects backend,frontend,mobile
+
+# Tasks automatically split by project keyword detection
+# Each project gets its own user stories and GitHub issues
+```
+
 ### Brownfield (Existing Project)
 ```bash
 # Initialize SpecWeave in existing project
@@ -255,7 +274,7 @@ specweave init .
 /specweave:increment "Add dark mode"
 ```
 
-**[→ Complete Quickstart Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)**
+**[→ Complete Quickstart Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)** | **[→ Strategic Init Guide](https://spec-weave.com/docs/guides/strategic-init)**
 
 ---
 
@@ -296,12 +315,23 @@ specweave init .
 
 ## Key Features
 
+### Strategic Init - AI-Powered Architecture Planning (NEW!)
+
+- 🎯 **Research-Driven Discovery** - Answer 6 phases of questions about your product
+- 🏗️ **Architecture Recommendations** - Tech stack, scaling strategy, cost projections
+- 🔒 **Compliance Detection** - Auto-detects 30+ standards (HIPAA, GDPR, SOC2, etc.)
+- 👥 **Smart Team Planning** - Current and future team structure, hiring roadmap
+- ☁️ **Cloud Credits Discovery** - AWS Activate, Azure Startup, GCP eligibility
+- 📦 **Repository Selection** - Batch select 1-100+ repos with intelligent routing
+
+### Production Features
+
 - 🤖 **AI-Native Enterprise Sync** - Claude updates JIRA/GitHub/ADO automatically (bidirectional!)
 - 📚 **Living Documentation** - Auto-updates after every task (no manual sync!)
 - 🧪 **Test-Aware Planning** - Embedded tests in BDD format (Given/When/Then)
 - 🎯 **Disciplined Progress** - Can't start increment N+1 until N is DONE
 - ⏸️ **Intelligent Pausing** - Auto-detects blockers, pauses with context, resumes when ready
-- 🔄 **Smart Reopen (NEW!)** - Report "broken" → Auto-detects what to reopen, respects WIP limits
+- 🔄 **Smart Reopen** - Report "broken" → Auto-detects what to reopen, respects WIP limits
 - 👥 **Multi-Project Tracking** - Unlimited JIRA/ADO/GitHub repos, intelligent routing
 - 🤖 **AI Agents** - PM, Architect, Quality Judge guide your work
 - 🔧 **CI/CD Auto-Fix** - Workflow failures auto-fixed by Claude (just mention `@claude`)

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

@@ -0,0 +1,101 @@
+/**
+ * Code Validator
+ *
+ * Validates that completed tasks have actual code implementation.
+ * Prevents marking tasks as complete when:
+ * - Files don't exist
+ * - Files are empty or have trivial content
+ * - Implementation is incomplete
+ *
+ * Used by ThreeLayerSyncManager to enforce code-completion discipline.
+ *
+ * @module CodeValidator
+ */
+/**
+ * File validation result
+ */
+export interface FileValidationResult {
+    path: string;
+    exists: boolean;
+    hasContent: boolean;
+    lineCount: number;
+    reason?: string;
+}
+/**
+ * Task validation result
+ */
+export interface TaskValidationResult {
+    taskId: string;
+    valid: boolean;
+    files: FileValidationResult[];
+    reason?: string;
+}
+/**
+ * CodeValidator options
+ */
+export interface CodeValidatorOptions {
+    minLines?: number;
+    minChars?: number;
+    projectRoot?: string;
+}
+export declare class CodeValidator {
+    private options;
+    constructor(options?: CodeValidatorOptions);
+    /**
+     * Validate that code exists for a task
+     *
+     * Extracts file paths from task description and verifies:
+     * 1. Files exist
+     * 2. Files have meaningful content
+     * 3. Files are not just stubs
+     *
+     * @param taskDescription - Task description with file paths
+     * @param taskId - Task ID for error messages
+     * @returns Validation result
+     */
+    validateTask(taskDescription: string, taskId: string): Promise<TaskValidationResult>;
+    /**
+     * Validate a single file
+     *
+     * @param filePath - Path to file (relative or absolute)
+     * @returns File validation result
+     */
+    validateFile(filePath: string): Promise<FileValidationResult>;
+    /**
+     * Extract file paths from task description
+     *
+     * Supports multiple formats:
+     * - **Files**: src/foo.ts, src/bar.ts
+     * - **Files to create**: src/foo.ts
+     * - **Files to modify**: src/bar.ts
+     * - Inline code blocks with file paths
+     *
+     * @param description - Task description text
+     * @returns Array of file paths
+     */
+    extractFilePaths(description: string): string[];
+    /**
+     * Batch validate multiple tasks
+     *
+     * @param tasks - Array of {taskId, description}
+     * @returns Array of validation results
+     */
+    validateTasks(tasks: Array<{
+        taskId: string;
+        description: string;
+    }>): Promise<TaskValidationResult[]>;
+    /**
+     * Get summary of validation results
+     *
+     * @param results - Array of task validation results
+     * @returns Summary statistics
+     */
+    summarizeResults(results: TaskValidationResult[]): {
+        total: number;
+        valid: number;
+        invalid: number;
+        noFiles: number;
+        invalidTasks: string[];
+    };
+}
+//# sourceMappingURL=CodeValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CodeValidator.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/CodeValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAiC;gBAEpC,OAAO,GAAE,oBAAyB;IAQ9C;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsC1F;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4EnE;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAuC/C;;;;;OAKG;IACG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAS3G;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG;QACjD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB;CAeF"}

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

@@ -0,0 +1,219 @@
+/**
+ * Code Validator
+ *
+ * Validates that completed tasks have actual code implementation.
+ * Prevents marking tasks as complete when:
+ * - Files don't exist
+ * - Files are empty or have trivial content
+ * - Implementation is incomplete
+ *
+ * Used by ThreeLayerSyncManager to enforce code-completion discipline.
+ *
+ * @module CodeValidator
+ */
+import fs from 'fs-extra';
+import path from 'path';
+export class CodeValidator {
+    constructor(options = {}) {
+        this.options = {
+            minLines: options.minLines ?? 3,
+            minChars: options.minChars ?? 50,
+            projectRoot: options.projectRoot ?? process.cwd()
+        };
+    }
+    /**
+     * Validate that code exists for a task
+     *
+     * Extracts file paths from task description and verifies:
+     * 1. Files exist
+     * 2. Files have meaningful content
+     * 3. Files are not just stubs
+     *
+     * @param taskDescription - Task description with file paths
+     * @param taskId - Task ID for error messages
+     * @returns Validation result
+     */
+    async validateTask(taskDescription, taskId) {
+        const filePaths = this.extractFilePaths(taskDescription);
+        if (filePaths.length === 0) {
+            // No file paths specified - consider it valid (task might be non-code)
+            return {
+                taskId,
+                valid: true,
+                files: [],
+                reason: 'No file paths specified in task description'
+            };
+        }
+        const fileResults = [];
+        let allValid = true;
+        const reasons = [];
+        for (const filePath of filePaths) {
+            const result = await this.validateFile(filePath);
+            fileResults.push(result);
+            if (!result.exists) {
+                allValid = false;
+                reasons.push(`File not found: ${filePath}`);
+            }
+            else if (!result.hasContent) {
+                allValid = false;
+                reasons.push(`File has no meaningful content: ${filePath} (${result.reason})`);
+            }
+        }
+        return {
+            taskId,
+            valid: allValid,
+            files: fileResults,
+            reason: reasons.length > 0 ? reasons.join('; ') : undefined
+        };
+    }
+    /**
+     * Validate a single file
+     *
+     * @param filePath - Path to file (relative or absolute)
+     * @returns File validation result
+     */
+    async validateFile(filePath) {
+        // Resolve relative paths
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(this.options.projectRoot, filePath);
+        // Check if file exists
+        const exists = await fs.pathExists(absolutePath);
+        if (!exists) {
+            return {
+                path: filePath,
+                exists: false,
+                hasContent: false,
+                lineCount: 0,
+                reason: 'File does not exist'
+            };
+        }
+        // Read file content
+        const content = await fs.readFile(absolutePath, 'utf-8');
+        const lines = content.split('\n');
+        const nonEmptyLines = lines.filter(line => line.trim().length > 0);
+        // Check line count
+        if (nonEmptyLines.length < this.options.minLines) {
+            return {
+                path: filePath,
+                exists: true,
+                hasContent: false,
+                lineCount: nonEmptyLines.length,
+                reason: `Only ${nonEmptyLines.length} non-empty lines (minimum: ${this.options.minLines})`
+            };
+        }
+        // Check character count
+        const trimmedContent = content.trim();
+        if (trimmedContent.length < this.options.minChars) {
+            return {
+                path: filePath,
+                exists: true,
+                hasContent: false,
+                lineCount: nonEmptyLines.length,
+                reason: `Only ${trimmedContent.length} characters (minimum: ${this.options.minChars})`
+            };
+        }
+        // Check for stub patterns (common placeholder patterns)
+        const stubPatterns = [
+            /^\/\/\s*TODO:/i,
+            /^#\s*TODO:/i,
+            /^\s*throw new Error\(['"]Not implemented['"]\)/i,
+            /^\s*return null;?\s*$/m,
+            /^\s*pass\s*$/m, // Python
+            /^\s*\.\.\.$/m // TypeScript
+        ];
+        const isStub = stubPatterns.some(pattern => pattern.test(trimmedContent));
+        if (isStub) {
+            return {
+                path: filePath,
+                exists: true,
+                hasContent: false,
+                lineCount: nonEmptyLines.length,
+                reason: 'File contains stub/placeholder code'
+            };
+        }
+        // All checks passed
+        return {
+            path: filePath,
+            exists: true,
+            hasContent: true,
+            lineCount: nonEmptyLines.length
+        };
+    }
+    /**
+     * Extract file paths from task description
+     *
+     * Supports multiple formats:
+     * - **Files**: src/foo.ts, src/bar.ts
+     * - **Files to create**: src/foo.ts
+     * - **Files to modify**: src/bar.ts
+     * - Inline code blocks with file paths
+     *
+     * @param description - Task description text
+     * @returns Array of file paths
+     */
+    extractFilePaths(description) {
+        const paths = new Set();
+        // Pattern 1: **Files**: path1, path2, path3
+        const filesMatch = description.match(/\*\*Files\*\*:\s*([^\n]+)/i);
+        if (filesMatch) {
+            const filePaths = filesMatch[1].split(',').map(p => p.trim());
+            filePaths.forEach(p => paths.add(p));
+        }
+        // Pattern 2: **Files to create**: path1, path2
+        const createMatch = description.match(/\*\*Files to create\*\*:\s*([^\n]+)/i);
+        if (createMatch) {
+            const filePaths = createMatch[1].split(',').map(p => p.trim());
+            filePaths.forEach(p => paths.add(p));
+        }
+        // Pattern 3: **Files to modify**: path1, path2
+        const modifyMatch = description.match(/\*\*Files to modify\*\*:\s*([^\n]+)/i);
+        if (modifyMatch) {
+            const filePaths = modifyMatch[1].split(',').map(p => p.trim());
+            filePaths.forEach(p => paths.add(p));
+        }
+        // Pattern 4: Inline file references (e.g., `src/foo/bar.ts`)
+        const inlineMatches = description.matchAll(/`([a-zA-Z0-9_\-./]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|h))`/g);
+        for (const match of inlineMatches) {
+            paths.add(match[1]);
+        }
+        // Pattern 5: Markdown list items with file paths
+        const listMatches = description.matchAll(/^[-*]\s+([a-zA-Z0-9_\-./]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|h))/gm);
+        for (const match of listMatches) {
+            paths.add(match[1]);
+        }
+        return Array.from(paths);
+    }
+    /**
+     * Batch validate multiple tasks
+     *
+     * @param tasks - Array of {taskId, description}
+     * @returns Array of validation results
+     */
+    async validateTasks(tasks) {
+        // Use parallel validation for performance
+        const validationPromises = tasks.map(task => this.validateTask(task.description, task.taskId));
+        return Promise.all(validationPromises);
+    }
+    /**
+     * Get summary of validation results
+     *
+     * @param results - Array of task validation results
+     * @returns Summary statistics
+     */
+    summarizeResults(results) {
+        const total = results.length;
+        const valid = results.filter(r => r.valid).length;
+        const invalid = results.filter(r => !r.valid).length;
+        const noFiles = results.filter(r => r.files.length === 0).length;
+        const invalidTasks = results.filter(r => !r.valid).map(r => r.taskId);
+        return {
+            total,
+            valid,
+            invalid,
+            noFiles,
+            invalidTasks
+        };
+    }
+}
+//# sourceMappingURL=CodeValidator.js.map

package/dist/plugins/specweave-github/lib/CodeValidator.js.map

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