specweave 0.17.0 → 0.17.2

package/.claude-plugin/marketplace.json

@@ -215,6 +215,28 @@
         "name": "Anton Abyzov",
         "email": "anton@spec-weave.com"
       }
+    },
+    {
+      "name": "specweave-release",
+      "description": "Release management - version alignment, RC workflows, multi-repo coordination, semantic versioning",
+      "source": "./plugins/specweave-release",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton@spec-weave.com"
+      }
+    },
+    {
+      "name": "specweave-mobile",
+      "description": "React Native & Expo mobile development - environment setup, debugging, performance optimization, native modules, testing, Metro bundler configuration",
+      "source": "./plugins/specweave-mobile",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton@spec-weave.com"
+      }
     }
   ]
 }

package/CLAUDE.md

@@ -1375,54 +1375,73 @@ specweave/
 | **operations/** | Production ops (How we run) | Runbooks, incidents, performance | `runbook-api.md`, `performance-tuning.md` |
 | **governance/** | Policies (Guardrails) | Security, compliance, coding standards | `security-policy.md`, `coding-standards.md` |
 
-### Multi-Project Organization (v0.8.0+)
+### Multi-Project Organization (v0.8.0+, Flattened v0.16.11+)
 
-**NEW**: Projects folder for multi-team/multi-repo organizations
+**FLATTENED STRUCTURE** (v0.16.11): Simpler, cleaner paths with document-type-first organization
 
 ```
 .specweave/docs/internal/
-├── strategy/              # Cross-project
-├── architecture/          # System-wide ADRs
-├── delivery/              # Cross-project
-├── operations/            # Cross-project
-├── governance/            # Cross-project
+├── strategy/              # Cross-project (unchanged)
+├── architecture/          # System-wide ADRs (unchanged)
+├── delivery/              # Cross-project (unchanged)
+├── operations/            # Cross-project (unchanged)
+├── governance/            # Cross-project (unchanged)
 │
-└── projects/              # 🆕 Multi-project support
-    ├── default/           # Default project (single-project mode)
-    │   ├── specs/         # Living docs specs (feature-level)
-    │   ├── modules/       # Module/component documentation
-    │   ├── team/          # Team playbooks (conventions, workflows)
-    │   ├── architecture/  # Project-specific ADRs
-    │   └── legacy/        # Brownfield imports
-    │
-    ├── web-app/           # Additional projects
-    ├── mobile-app/
-    └── platform-infra/
+├── specs/                 # ✨ FLATTENED: Living docs specs
+│   ├── default/           # Default project (single-project mode)
+│   ├── backend/           # Backend project
+│   ├── frontend/          # Frontend project
+│   └── _parent/           # Parent repository (multi-repo setups)
+│
+├── modules/               # ✨ FLATTENED: Module documentation
+│   ├── default/
+│   ├── backend/
+│   └── frontend/
+│
+├── team/                  # ✨ FLATTENED: Team playbooks
+│   ├── default/
+│   ├── backend/
+│   └── frontend/
+│
+├── project-arch/          # ✨ RENAMED: Project-specific ADRs
+│   ├── backend/           # (Renamed to avoid conflict with top-level architecture/)
+│   └── frontend/
+│
+└── legacy/                # ✨ FLATTENED: Brownfield imports
+    ├── default/
+    └── backend/
 ```
 
+**Benefits of Flattened Structure**:
+- ✅ Simpler paths (no extra `projects/` nesting)
+- ✅ Consistent with cross-project folders (all at same level)
+- ✅ Clearer parent repo naming (`_parent` for multi-repo)
+- ✅ Easier GitHub sync (shorter paths)
+- ✅ Document-type-first organization (group by specs/, modules/, etc.)
+
 **Five Documentation Types Per Project**:
 
-1. **specs/** - Living documentation specs (user stories, acceptance criteria)
+1. **specs/{project-id}/** - Living documentation specs (user stories, acceptance criteria)
    - Permanent, feature-level knowledge base
    - ALL user stories for a feature area
    - 3-digit numbers: `spec-001-user-auth.md`
 
-2. **modules/** - Module/component documentation
+2. **modules/{project-id}/** - Module/component documentation
    - Architecture, API contracts, integration guides
    - Created when module >1000 lines or has security implications
    - Example: `auth-module.md`, `payment-module.md`
 
-3. **team/** - Team playbooks
+3. **team/{project-id}/** - Team playbooks
    - Onboarding, conventions, workflows, contacts
    - Team-specific processes and practices
    - Example: `onboarding.md`, `conventions.md`, `workflows.md`
 
-4. **architecture/** - Project-specific ADRs (optional)
+4. **project-arch/{project-id}/** - Project-specific ADRs (optional)
    - Decisions affecting only this project
    - Use top-level `architecture/` for system-wide decisions
    - Example: `adr/0001-use-postgres.md`
 
-5. **legacy/** - Brownfield imports (temporary)
+5. **legacy/{project-id}/** - Brownfield imports (temporary)
    - Imported from Notion, Confluence, Wiki
    - Migration report + classified files
    - Clean up after migration complete
@@ -1444,7 +1463,7 @@ specweave/
 
 ### The Core Question: Why Two Locations?
 
-1. **Living Docs Specs**: `.specweave/docs/internal/projects/{project-id}/specs/spec-NNN-feature-area.md` - **Permanent, feature-level knowledge base**
+1. **Living Docs Specs**: `.specweave/docs/internal/specs/{project-id}/spec-NNN-feature-area.md` - **Permanent, feature-level knowledge base**
 2. **Increment Specs**: `.specweave/increments/####-name/spec.md` - **Temporary, focused implementation snapshot**
 
 **Key Difference**: Specs use **3-digit numbers** (001, 002, 003) for **feature areas**, increments use **4-digit numbers** (0001, 0002, 0003) for **implementations**.
@@ -1453,7 +1472,7 @@ specweave/
 
 **Living Docs Specs = Permanent, Feature-Level Knowledge Base**
 
-- **Location**: `.specweave/docs/internal/projects/default/specs/spec-001-core-framework-architecture.md` (single project) or `.specweave/docs/internal/projects/web-app/specs/spec-001-user-auth.md` (multi-project)
+- **Location**: `.specweave/docs/internal/specs/default/spec-001-core-framework-architecture.md` (single project) or `.specweave/docs/internal/specs/web-app/spec-001-user-auth.md` (multi-project)
 - **Purpose**: COMPLETE, PERMANENT source of truth for entire feature area
 - **Lifecycle**: Created once, updated over time, NEVER deleted
 - **Scope**: Comprehensive feature area (e.g., "Core Framework", 10-50 user stories)
@@ -1482,7 +1501,7 @@ specweave/
 
 **Living Docs Spec** (Permanent, Feature-Level):
 ```
-File: .specweave/docs/internal/projects/default/specs/spec-001-core-framework-architecture.md
+File: .specweave/docs/internal/specs/default/spec-001-core-framework-architecture.md
 
 # SPEC-001: Core Framework & Architecture
 Foundation framework with CLI, plugin system, cross-platform support
@@ -1916,7 +1935,7 @@ plugins/specweave/
 2. ✅ **hooks.json references them** - Uses `${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh`
 3. ✅ **Automatic discovery** - Claude Code reads plugin's hooks.json at startup
 4. ✅ **Runtime merging** - Plugin hooks merge with user/project hooks automatically
-5. ❌ **`.claude/hooks/` is NOT used** - This directory is irrelevant to the hook system!
+5. ✅ **SpecWeave doesn't use `.claude/`** - Plugin hooks live in `plugins/`, but users CAN add custom hooks to `.claude/settings.json`
 
 ### Hook Discovery Flow
 
@@ -1945,15 +1964,20 @@ plugins/specweave/
 
 ### What `.claude/` Actually Contains
 
-**NOTHING!** SpecWeave does NOT create `.claude/` folder in user projects.
+**SpecWeave doesn't create it!** But users can create `.claude/settings.json` for custom hooks/settings.
 
-**Why?**
+**Why SpecWeave doesn't create `.claude/`:**
 - Marketplace registration is GLOBAL via CLI (`claude plugin marketplace add`)
-- No per-project settings.json needed
-- No hook files (hooks come from plugins, not project)
+- No per-project settings.json needed for SpecWeave
+- No hook files needed (hooks come from plugins, not project)
 - Cleaner project structure
 
-**If you see `.claude/settings.json`** in your project:
+**Valid uses of `.claude/` folder:**
+- ✅ User-defined custom hooks (`.claude/settings.json`)
+- ✅ Project-specific hook configurations
+- ✅ Local settings (`.claude/settings.local.json`)
+
+**If you see `.claude/settings.json`** created by SpecWeave in your project:
 - It's from an older version of SpecWeave (<v0.14.0)
 - Safe to delete - marketplace is already registered globally
 - Won't affect functionality

package/bin/specweave.js

@@ -38,7 +38,7 @@ program
   .option('-l, --language <lang>', 'Language for generated content (en, ru, es, zh, de, fr, ja, ko, pt)', 'en')
   .option('-f, --force', 'Force fresh start (non-interactive, removes existing .specweave)', false)
   .action(async (projectName, options) => {
-    const { initCommand } = await import('../dist/cli/commands/init.js');
+    const { initCommand } = await import('../dist/src/cli/commands/init.js');
     await initCommand(projectName, options);
   });
 
@@ -48,7 +48,7 @@ program
 //   .description('Manage increments (create, list, status)')
 //   .option('-p, --priority <level>', 'Priority level (P1, P2, P3)', 'P1')
 //   .action(async (action, name, options) => {
-//     const { incrementCommand } = require('../dist/cli/commands/increment');
+//     const { incrementCommand } = require('../dist/src/cli/commands/increment');
 //     await incrementCommand(action, name, options);
 //   });
 
@@ -59,7 +59,7 @@ program
   .option('-g, --global', 'Install globally to ~/.claude/')
   .option('-l, --local', 'Install locally to .claude/ (default)')
   .action(async (componentName, options) => {
-    const { installCommand } = await import('../dist/cli/commands/install.js');
+    const { installCommand } = await import('../dist/src/cli/commands/install.js');
     await installCommand(componentName, options);
   });
 
@@ -69,7 +69,7 @@ program
   .description('List available and installed components')
   .option('--installed', 'Show only installed components')
   .action(async (options) => {
-    const { listCommand } = await import('../dist/cli/commands/list.js');
+    const { listCommand } = await import('../dist/src/cli/commands/list.js');
     await listCommand(options);
   });
 
@@ -80,7 +80,7 @@ program
   .option('-r, --reason <text>', 'Reason for pausing')
   .option('-f, --force', 'Force pause (update reason if already paused)')
   .action(async (incrementId, options) => {
-    const { pauseCommand } = await import('../dist/cli/commands/pause.js');
+    const { pauseCommand } = await import('../dist/src/cli/commands/pause.js');
     await pauseCommand(incrementId, options);
   });
 
@@ -89,7 +89,7 @@ program
   .description('Resume a paused or abandoned increment')
   .option('-f, --force', 'Force resume (bypass WIP limit checks)')
   .action(async (incrementId, options) => {
-    const { resumeCommand } = await import('../dist/cli/commands/resume.js');
+    const { resumeCommand } = await import('../dist/src/cli/commands/resume.js');
     await resumeCommand(incrementId, options);
   });
 
@@ -99,7 +99,7 @@ program
   .option('-r, --reason <text>', 'Reason for abandoning')
   .option('-f, --force', 'Force abandon (skip confirmation)')
   .action(async (incrementId, options) => {
-    const { abandonCommand } = await import('../dist/cli/commands/abandon.js');
+    const { abandonCommand } = await import('../dist/src/cli/commands/abandon.js');
     await abandonCommand(incrementId, options);
   });
 
@@ -109,7 +109,7 @@ program
   .option('-v, --verbose', 'Show detailed information')
   .option('-t, --type <type>', 'Filter by increment type (feature, hotfix, bug, etc.)')
   .action(async (options) => {
-    const { statusCommand } = await import('../dist/cli/commands/status.js');
+    const { statusCommand } = await import('../dist/src/cli/commands/status.js');
     await statusCommand(options);
   });
 
@@ -121,11 +121,11 @@ program
   .option('--clear', 'Clear status line cache')
   .option('--config <path>', 'Path to config file')
   .action(async (options) => {
-    const { registerStatusLineCommand } = await import('../dist/cli/commands/status-line.js');
+    const { registerStatusLineCommand } = await import('../dist/src/cli/commands/status-line.js');
     const tempProgram = new Command();
     registerStatusLineCommand(tempProgram);
     // Execute action manually since we need the temp program
-    const manager = await import('../dist/core/status-line/status-line-manager.js').then(m => m.StatusLineManager);
+    const manager = await import('../dist/src/core/status-line/status-line-manager.js').then(m => m.StatusLineManager);
     const StatusLineManager = manager;
     const path = await import('path');
     const fs = await import('fs');
@@ -188,10 +188,19 @@ program
     if (!options.projectRoot) {
       options.projectRoot = process.cwd();
     }
-    const { checkDisciplineCommand } = await import('../dist/cli/commands/check-discipline.js');
+    const { checkDisciplineCommand } = await import('../dist/src/cli/commands/check-discipline.js');
     await checkDisciplineCommand(options);
   });
 
+// Revert WIP limit command - Restore original WIP limit after temporary adjustment
+program
+  .command('revert-wip-limit')
+  .description('Revert WIP limit to original value after temporary adjustment')
+  .action(async () => {
+    const { revertWipLimitCommand } = await import('../dist/src/cli/commands/revert-wip-limit.js');
+    await revertWipLimitCommand();
+  });
+
 // QA command - Quality assessment
 program
   .command('qa <increment-id>')
@@ -207,7 +216,7 @@ program
   .option('-f, --force', 'Force run even if rule-based fails')
   .option('-v, --verbose', 'Show recommendations')
   .action(async (incrementId, options) => {
-    const { qaCommand } = await import('../dist/cli/commands/qa.js');
+    const { qaCommand } = await import('../dist/src/cli/commands/qa.js');
     await qaCommand(incrementId, options);
   });
 
@@ -220,12 +229,12 @@ program
   .option('--dry-run', 'Show what would be installed without installing', false)
   .option('-v, --verbose', 'Show detailed validation steps', false)
   .action(async (options) => {
-    const { setupValidatePluginsCommand } = await import('../dist/cli/commands/validate-plugins.js');
+    const { setupValidatePluginsCommand } = await import('../dist/src/cli/commands/validate-plugins.js');
     // Create a temporary program for this command
     const tempProgram = new Command();
     setupValidatePluginsCommand(tempProgram);
     // Execute the action directly
-    await import('../dist/cli/commands/validate-plugins.js').then(m => m.runValidation(options));
+    await import('../dist/src/cli/commands/validate-plugins.js').then(m => m.runValidation(options));
   });
 
 // Validate Jira command - Jira resource validation
@@ -234,7 +243,7 @@ program
   .description('Validate Jira configuration and create missing resources')
   .option('--env <path>', 'Path to .env file', '.env')
   .action(async (options) => {
-    const { runJiraValidation } = await import('../dist/cli/commands/validate-jira.js');
+    const { runJiraValidation } = await import('../dist/src/cli/commands/validate-jira.js');
     await runJiraValidation(options);
   });
 

package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Git Diff Analyzer
+ *
+ * Extracts modified files from git diff for reflection analysis
+ * Parses git diff output to get file changes, line counts, and content
+ *
+ * @module git-diff-analyzer
+ */
+import { GitDiffInfo } from './types/reflection-types';
+/**
+ * Check if directory is a git repository
+ * @param dir Directory to check (defaults to cwd)
+ * @returns True if directory is in a git repository
+ */
+export declare function isGitRepository(dir?: string): boolean;
+/**
+ * Get list of modified files in the working directory
+ * Includes both staged and unstaged changes
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @returns Array of file paths relative to git root
+ */
+export declare function getModifiedFilesList(cwd?: string): string[];
+/**
+ * Parse git diff numstat output to get line counts
+ * Format: <added>\t<removed>\t<filename>
+ *
+ * @param numstatOutput Output from git diff --numstat
+ * @returns Map of filename to {added, removed} counts
+ */
+export declare function parseNumstat(numstatOutput: string): Map<string, {
+    added: number;
+    removed: number;
+}>;
+/**
+ * Get diff content for a specific file
+ * @param file File path relative to git root
+ * @param cwd Working directory (optional)
+ * @returns Diff content as string
+ */
+export declare function getFileDiff(file: string, cwd?: string): string;
+/**
+ * Get current file content
+ * @param file File path (can be absolute or relative to cwd)
+ * @param cwd Working directory (optional)
+ * @returns File content as string, or empty string if file doesn't exist
+ */
+export declare function getFileContent(file: string, cwd?: string): string;
+/**
+ * Get modified files with diff information
+ * Main function for reflection analysis
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @param maxFiles Maximum number of files to return (optional, defaults to 100)
+ * @returns Array of GitDiffInfo objects with file changes
+ */
+export declare function getModifiedFiles(cwd?: string, maxFiles?: number): GitDiffInfo[];
+/**
+ * Get summary statistics for modified files
+ * Useful for reflection metadata
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @returns Summary with file count, total lines added/removed
+ */
+export declare function getModifiedFilesSummary(modifiedFiles: GitDiffInfo[]): {
+    count: number;
+    linesAdded: number;
+    linesRemoved: number;
+    totalChanges: number;
+};
+/**
+ * Filter files by extension
+ * Useful for focusing reflection on specific file types
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param extensions Array of file extensions (e.g., ['.ts', '.js'])
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export declare function filterFilesByExtension(modifiedFiles: GitDiffInfo[], extensions: string[]): GitDiffInfo[];
+/**
+ * Exclude files matching patterns
+ * Useful for excluding generated files, test files, etc.
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param patterns Array of glob patterns to exclude
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export declare function excludeFilesByPattern(modifiedFiles: GitDiffInfo[], patterns: string[]): GitDiffInfo[];
+//# sourceMappingURL=git-diff-analyzer.d.ts.map

package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-analyzer.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/git-diff-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAqBvD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAOpE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBnG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAajE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAY,GACrB,WAAW,EAAE,CA8Cf;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAUA;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,WAAW,EAAE,EAC5B,UAAU,EAAE,MAAM,EAAE,GACnB,WAAW,EAAE,CAKf;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,WAAW,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAAE,GACjB,WAAW,EAAE,CAQf"}

package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.js

@@ -0,0 +1,226 @@
+/**
+ * Git Diff Analyzer
+ *
+ * Extracts modified files from git diff for reflection analysis
+ * Parses git diff output to get file changes, line counts, and content
+ *
+ * @module git-diff-analyzer
+ */
+import { execSync } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Execute git command safely
+ * @param command Git command to execute
+ * @param cwd Working directory (optional)
+ * @returns Command output as string
+ * @throws Error if command fails
+ */
+function executeGitCommand(command, cwd) {
+    try {
+        return execSync(command, {
+            cwd: cwd || process.cwd(),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+    }
+    catch (error) {
+        throw new Error(`Git command failed: ${command}. ${error.message}`);
+    }
+}
+/**
+ * Check if directory is a git repository
+ * @param dir Directory to check (defaults to cwd)
+ * @returns True if directory is in a git repository
+ */
+export function isGitRepository(dir = process.cwd()) {
+    try {
+        executeGitCommand('git rev-parse --git-dir', dir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get list of modified files in the working directory
+ * Includes both staged and unstaged changes
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @returns Array of file paths relative to git root
+ */
+export function getModifiedFilesList(cwd) {
+    if (!isGitRepository(cwd)) {
+        return [];
+    }
+    try {
+        // Get both staged and unstaged changes
+        const output = executeGitCommand('git diff --name-only HEAD', cwd);
+        if (!output.trim()) {
+            return [];
+        }
+        return output
+            .trim()
+            .split('\n')
+            .filter(file => file.length > 0)
+            .filter(file => !file.startsWith('.git/')); // Exclude .git directory
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse git diff numstat output to get line counts
+ * Format: <added>\t<removed>\t<filename>
+ *
+ * @param numstatOutput Output from git diff --numstat
+ * @returns Map of filename to {added, removed} counts
+ */
+export function parseNumstat(numstatOutput) {
+    const stats = new Map();
+    if (!numstatOutput.trim()) {
+        return stats;
+    }
+    const lines = numstatOutput.trim().split('\n');
+    for (const line of lines) {
+        const parts = line.split('\t');
+        if (parts.length < 3)
+            continue;
+        const added = parts[0] === '-' ? 0 : parseInt(parts[0], 10);
+        const removed = parts[1] === '-' ? 0 : parseInt(parts[1], 10);
+        const filename = parts[2];
+        stats.set(filename, { added, removed });
+    }
+    return stats;
+}
+/**
+ * Get diff content for a specific file
+ * @param file File path relative to git root
+ * @param cwd Working directory (optional)
+ * @returns Diff content as string
+ */
+export function getFileDiff(file, cwd) {
+    if (!isGitRepository(cwd)) {
+        return '';
+    }
+    try {
+        // Get unified diff for the file
+        const output = executeGitCommand(`git diff HEAD -- "${file}"`, cwd);
+        return output;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Get current file content
+ * @param file File path (can be absolute or relative to cwd)
+ * @param cwd Working directory (optional)
+ * @returns File content as string, or empty string if file doesn't exist
+ */
+export function getFileContent(file, cwd) {
+    try {
+        const workingDir = cwd || process.cwd();
+        const absolutePath = path.isAbsolute(file) ? file : path.join(workingDir, file);
+        if (!fs.existsSync(absolutePath)) {
+            return '';
+        }
+        return fs.readFileSync(absolutePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Get modified files with diff information
+ * Main function for reflection analysis
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @param maxFiles Maximum number of files to return (optional, defaults to 100)
+ * @returns Array of GitDiffInfo objects with file changes
+ */
+export function getModifiedFiles(cwd, maxFiles = 100) {
+    if (!isGitRepository(cwd)) {
+        return [];
+    }
+    const workingDir = cwd || process.cwd();
+    // Get list of modified files
+    const modifiedFiles = getModifiedFilesList(workingDir);
+    if (modifiedFiles.length === 0) {
+        return [];
+    }
+    // Limit number of files to prevent overwhelming the analysis
+    const filesToAnalyze = modifiedFiles.slice(0, maxFiles);
+    // Get line count statistics
+    let numstatOutput = '';
+    try {
+        numstatOutput = executeGitCommand('git diff --numstat HEAD', workingDir);
+    }
+    catch {
+        // If numstat fails, continue with empty stats
+    }
+    const stats = parseNumstat(numstatOutput);
+    // Build GitDiffInfo array
+    const result = [];
+    for (const file of filesToAnalyze) {
+        const fileStat = stats.get(file) || { added: 0, removed: 0 };
+        const diffContent = getFileDiff(file, workingDir);
+        // Only include files with actual changes
+        if (fileStat.added > 0 || fileStat.removed > 0 || diffContent.length > 0) {
+            result.push({
+                file,
+                linesAdded: fileStat.added,
+                linesRemoved: fileStat.removed,
+                content: diffContent
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Get summary statistics for modified files
+ * Useful for reflection metadata
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @returns Summary with file count, total lines added/removed
+ */
+export function getModifiedFilesSummary(modifiedFiles) {
+    return {
+        count: modifiedFiles.length,
+        linesAdded: modifiedFiles.reduce((sum, file) => sum + file.linesAdded, 0),
+        linesRemoved: modifiedFiles.reduce((sum, file) => sum + file.linesRemoved, 0),
+        totalChanges: modifiedFiles.reduce((sum, file) => sum + file.linesAdded + file.linesRemoved, 0)
+    };
+}
+/**
+ * Filter files by extension
+ * Useful for focusing reflection on specific file types
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param extensions Array of file extensions (e.g., ['.ts', '.js'])
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export function filterFilesByExtension(modifiedFiles, extensions) {
+    return modifiedFiles.filter(file => {
+        const ext = path.extname(file.file).toLowerCase();
+        return extensions.some(allowedExt => ext === allowedExt.toLowerCase());
+    });
+}
+/**
+ * Exclude files matching patterns
+ * Useful for excluding generated files, test files, etc.
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param patterns Array of glob patterns to exclude
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export function excludeFilesByPattern(modifiedFiles, patterns) {
+    return modifiedFiles.filter(file => {
+        return !patterns.some(pattern => {
+            // Simple pattern matching (supports * wildcard)
+            const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+            return regex.test(file.file);
+        });
+    });
+}
+//# sourceMappingURL=git-diff-analyzer.js.map

package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.js.map

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