specweave 0.12.6 → 0.13.0

package/plugins/specweave/hooks/post-increment-completion.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+
+# Post-Increment-Completion Hook
+# Runs after an increment is marked as complete
+#
+# This hook closes GitHub issues automatically when increments complete
+
+set -e
+
+HOOK_NAME="post-increment-completion"
+INCREMENT_ID="${1:-}"
+
+# Check if increment ID provided
+if [ -z "$INCREMENT_ID" ]; then
+  echo "⚠️  $HOOK_NAME: No increment ID provided" >&2
+  exit 0
+fi
+
+# Get project root
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../../.." && pwd)"
+INCREMENT_DIR="$PROJECT_ROOT/.specweave/increments/$INCREMENT_ID"
+
+# Check if increment exists
+if [ ! -d "$INCREMENT_DIR" ]; then
+  echo "⚠️  $HOOK_NAME: Increment $INCREMENT_ID not found" >&2
+  exit 0
+fi
+
+# Read metadata.json
+METADATA_FILE="$INCREMENT_DIR/metadata.json"
+if [ ! -f "$METADATA_FILE" ]; then
+  echo "⚠️  $HOOK_NAME: No metadata.json found for $INCREMENT_ID" >&2
+  exit 0
+fi
+
+# Extract GitHub issue number
+ISSUE_NUMBER=$(jq -r '.github.issue // empty' "$METADATA_FILE" 2>/dev/null)
+
+if [ -z "$ISSUE_NUMBER" ] || [ "$ISSUE_NUMBER" = "null" ]; then
+  # No GitHub issue linked - skip
+  exit 0
+fi
+
+# Check if gh CLI is available
+if ! command -v gh &> /dev/null; then
+  echo "⚠️  $HOOK_NAME: GitHub CLI (gh) not found - skipping issue closure" >&2
+  exit 0
+fi
+
+# Check if issue is already closed
+ISSUE_STATE=$(gh issue view "$ISSUE_NUMBER" --json state --jq '.state' 2>/dev/null || echo "")
+
+if [ "$ISSUE_STATE" = "CLOSED" ]; then
+  echo "✓ GitHub issue #$ISSUE_NUMBER already closed"
+  exit 0
+fi
+
+# Close the GitHub issue with completion message
+echo "🔗 Closing GitHub issue #$ISSUE_NUMBER for increment $INCREMENT_ID..."
+
+# Create completion comment
+COMPLETION_COMMENT="## ✅ Increment Complete
+
+Increment \`$INCREMENT_ID\` has been marked as complete.
+
+**Completion Details:**
+- Completed: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
+- All tasks completed
+- Tests passed
+- Documentation updated
+
+---
+🤖 Auto-closed by SpecWeave post-increment-completion hook"
+
+# Close issue with comment
+gh issue close "$ISSUE_NUMBER" --comment "$COMPLETION_COMMENT" 2>/dev/null || {
+  echo "⚠️  Failed to close issue #$ISSUE_NUMBER" >&2
+  exit 0
+}
+
+echo "✅ GitHub issue #$ISSUE_NUMBER closed successfully"
+
+exit 0

package/plugins/specweave/hooks/post-increment-planning.sh

@@ -170,9 +170,9 @@ translate_file() {
   # In production, this would invoke the LLM via Task tool
   # For now, we'll create a marker file to indicate translation is needed
 
-  if [ -f "$PROJECT_ROOT/dist/hooks/lib/translate-file.js" ]; then
+  if [ -f "${CLAUDE_PLUGIN_ROOT}/lib/hooks/translate-file.js" ]; then
     # Production: Use compiled TypeScript
-    node "$PROJECT_ROOT/dist/hooks/lib/translate-file.js" "$file_path" --target-lang en --verbose 2>&1 | while read -r line; do
+    node "${CLAUDE_PLUGIN_ROOT}/lib/hooks/translate-file.js" "$file_path" --target-lang en --verbose 2>&1 | while read -r line; do
       echo "     $line"
     done
 

package/plugins/specweave/hooks/post-task-completion.sh

@@ -184,7 +184,7 @@ if command -v node &> /dev/null; then
     echo "[$(date)] 📝 Updating tasks.md for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
 
     # Run task updater (non-blocking, best-effort)
-    node dist/hooks/lib/update-tasks-md.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+    node ${CLAUDE_PLUGIN_ROOT}/lib/hooks/update-tasks-md.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
       echo "[$(date)] ⚠️  Failed to update tasks.md (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
     }
   else
@@ -203,7 +203,7 @@ if command -v node &> /dev/null; then
     echo "[$(date)] 📚 Checking living docs sync for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
 
     # Run living docs sync (non-blocking, best-effort)
-    node dist/hooks/lib/sync-living-docs.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+    node ${CLAUDE_PLUGIN_ROOT}/lib/hooks/sync-living-docs.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
       echo "[$(date)] ⚠️  Failed to sync living docs (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
     }
   fi
@@ -218,152 +218,31 @@ if command -v node &> /dev/null; then
     echo "[$(date)] 🌐 Checking if living docs translation is needed for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
 
     # Run living docs translation (non-blocking, best-effort)
-    node dist/hooks/lib/translate-living-docs.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+    node ${CLAUDE_PLUGIN_ROOT}/lib/hooks/translate-living-docs.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
       echo "[$(date)] ⚠️  Failed to translate living docs (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
     }
   fi
 fi
 
 # ============================================================================
-# SYNC TO EXTERNAL TRACKERS (NEW in v0.7.0 - GitHub/Jira/ADO)
+# EXTERNAL TRACKER SYNC (REMOVED in v0.13.0 - Moved to Plugin Hooks)
 # ============================================================================
+#
+# External tool sync logic has been moved to respective plugin hooks:
+# - GitHub sync: plugins/specweave-github/hooks/post-task-completion.sh
+# - JIRA sync: plugins/specweave-jira/hooks/post-task-completion.sh
+# - Azure DevOps sync: plugins/specweave-ado/hooks/post-task-completion.sh
+#
+# When multiple plugins are installed, Claude Code fires all hooks in parallel.
+# This architecture provides:
+# - Clean separation of concerns (core vs. external tools)
+# - Optional plugins (GitHub sync only runs if specweave-github installed)
+# - Independent testing and maintenance
+# - No external tool dependencies in core plugin
+#
+# See: .specweave/increments/0018-strict-increment-discipline-enforcement/reports/HOOKS-ARCHITECTURE-ANALYSIS.md
 
-if [ -n "$CURRENT_INCREMENT" ]; then
-  echo "[$(date)] 🔗 Checking external tracker sync for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  # Check for metadata.json with GitHub/Jira issue link
-  METADATA_FILE=".specweave/increments/$CURRENT_INCREMENT/metadata.json"
-
-  if [ -f "$METADATA_FILE" ]; then
-    # Detect tracker type from metadata
-    GITHUB_ISSUE=$(jq -r '.github.issue // empty' "$METADATA_FILE" 2>/dev/null)
-    JIRA_ISSUE=$(jq -r '.jira.issue // empty' "$METADATA_FILE" 2>/dev/null)
-    ADO_ITEM=$(jq -r '.ado.item // empty' "$METADATA_FILE" 2>/dev/null)
-
-    # GitHub sync (if issue exists and gh CLI available)
-    if [ -n "$GITHUB_ISSUE" ] && command -v gh &> /dev/null; then
-      echo "[$(date)] 🔄 Syncing to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
-
-      # Run GitHub sync - Update CHECKBOXES in issue description
-      TASKS_FILE=".specweave/increments/$CURRENT_INCREMENT/tasks.md"
-
-      if [ -f "$TASKS_FILE" ]; then
-        echo "[$(date)] 📊 Syncing task checkboxes to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
-
-        # Get list of completed tasks from tasks.md
-        # Find all "## T-XXX:" headers where the task has "[x]" checkbox
-        COMPLETED_TASK_IDS=$(awk '
-          /^## T-[0-9]+:/ {
-            task_id = $2
-            gsub(/:/, "", task_id)
-            current_task = task_id
-            task_title = substr($0, index($0, $3))
-            next
-          }
-          /^- \[x\]/ && current_task != "" {
-            # Found a completed checkbox under a task
-            print current_task
-            current_task = ""
-          }
-        ' "$TASKS_FILE" 2>/dev/null)
-
-        echo "[$(date)] Completed tasks found: $COMPLETED_TASK_IDS" >> "$DEBUG_LOG" 2>/dev/null || true
-
-        # Read current issue body
-        ISSUE_BODY=$(gh issue view "$GITHUB_ISSUE" --json body -q .body 2>/dev/null || echo "")
-
-        if [ -n "$ISSUE_BODY" ]; then
-          # Create temporary file for updated body
-          TEMP_BODY=$(mktemp)
-          echo "$ISSUE_BODY" > "$TEMP_BODY"
-
-          # Update checkboxes for completed tasks
-          # Pattern: "- [ ] task-name" -> "- [x] task-name"
-          for task_id in $COMPLETED_TASK_IDS; do
-            # Update checkbox for this task ID
-            # Look for patterns like "[ ] T-013:" or "[ ] CLAUDE.md updates" etc.
-            sed -i.bak "s/- \[ \] \(.*${task_id}.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
-            sed -i.bak "s/- \[ \] \(.*T-0*${task_id#T-}[: ].*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
-
-            echo "[$(date)] Updated checkbox for task: $task_id" >> "$DEBUG_LOG" 2>/dev/null || true
-          done
-
-          # Also update based on task names (more reliable)
-          # Check for common patterns in issue body
-          if grep -q "test-aware-planner" "$TASKS_FILE" && grep -q "\[x\]" "$TASKS_FILE"; then
-            sed -i.bak "s/- \[ \] \(.*test-aware-planner.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
-          fi
-          if grep -q "PM.*increment-planner" "$TASKS_FILE" && grep -q "\[x\]" "$TASKS_FILE"; then
-            sed -i.bak "s/- \[ \] \(.*PM.*increment-planner.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
-            sed -i.bak "s/- \[ \] \(.*Enhanced PM.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
-          fi
-          if grep -q "CLAUDE.md" "$TASKS_FILE" && grep -q "\[x\]" "$TASKS_FILE"; then
-            sed -i.bak "s/- \[ \] \(.*CLAUDE\.md.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
-          fi
-
-          # Read updated body
-          UPDATED_BODY=$(cat "$TEMP_BODY")
-
-          # Update issue with new body
-          gh issue edit "$GITHUB_ISSUE" --body "$UPDATED_BODY" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-            echo "[$(date)] ⚠️  Failed to update issue description (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-          }
-
-          # Cleanup
-          rm -f "$TEMP_BODY" "$TEMP_BODY.bak"
-
-          echo "[$(date)] ✅ Issue description checkboxes updated" >> "$DEBUG_LOG" 2>/dev/null || true
-        fi
-
-        # Calculate progress for comment
-        TOTAL_TASKS=$(grep -c "^## T-[0-9]" "$TASKS_FILE" 2>/dev/null || echo "0")
-        COMPLETED_TASKS=$(echo "$COMPLETED_TASK_IDS" | wc -w | tr -d ' ')
-
-        if [ "$TOTAL_TASKS" -gt 0 ]; then
-          PROGRESS_PCT=$((COMPLETED_TASKS * 100 / TOTAL_TASKS))
-
-          # Post progress comment
-          gh issue comment "$GITHUB_ISSUE" --body "**Progress Update**: $COMPLETED_TASKS/$TOTAL_TASKS tasks ($PROGRESS_PCT%)\n\nIncrement: \`$CURRENT_INCREMENT\`\n\n---\n🤖 Auto-updated by SpecWeave" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-            echo "[$(date)] ⚠️  Failed to comment on GitHub issue (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-          }
-        fi
-      else
-        echo "[$(date)] ℹ️  tasks.md not found, skipping GitHub sync" >> "$DEBUG_LOG" 2>/dev/null || true
-      fi
-    fi
-
-    # Jira sync (if issue exists)
-    if [ -n "$JIRA_ISSUE" ]; then
-      echo "[$(date)] 🔄 Syncing to Jira issue $JIRA_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
-
-      # Run Jira sync command (non-blocking)
-      if command -v node &> /dev/null && [ -f "dist/commands/jira-sync.js" ]; then
-        node dist/commands/jira-sync.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-          echo "[$(date)] ⚠️  Failed to sync to Jira (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-        }
-      fi
-    fi
-
-    # Azure DevOps sync (if work item exists)
-    if [ -n "$ADO_ITEM" ]; then
-      echo "[$(date)] 🔄 Syncing to Azure DevOps item $ADO_ITEM" >> "$DEBUG_LOG" 2>/dev/null || true
-
-      # Run ADO sync command (non-blocking)
-      if command -v node &> /dev/null && [ -f "dist/commands/ado-sync.js" ]; then
-        node dist/commands/ado-sync.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-          echo "[$(date)] ⚠️  Failed to sync to Azure DevOps (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-        }
-      fi
-    fi
-
-    # Log if no external tracker configured
-    if [ -z "$GITHUB_ISSUE" ] && [ -z "$JIRA_ISSUE" ] && [ -z "$ADO_ITEM" ]; then
-      echo "[$(date)] ℹ️  No external tracker configured for $CURRENT_INCREMENT (skipping sync)" >> "$DEBUG_LOG" 2>/dev/null || true
-    fi
-  else
-    echo "[$(date)] ℹ️  No metadata.json found for $CURRENT_INCREMENT (skipping tracker sync)" >> "$DEBUG_LOG" 2>/dev/null || true
-  fi
-fi
+echo "[$(date)] ℹ️  External tracker sync moved to plugin hooks (GitHub/JIRA/ADO)" >> "$DEBUG_LOG" 2>/dev/null || true
 
 # ============================================================================
 # SELF-REFLECTION (NEW in v0.12.0-beta - AI Self-Reflection System)
@@ -378,7 +257,7 @@ if command -v node &> /dev/null; then
 
     if [ -n "$LATEST_TASK" ]; then
       # Prepare reflection context (non-blocking, best-effort)
-      node dist/hooks/lib/prepare-reflection-context.js "$CURRENT_INCREMENT" "$LATEST_TASK" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+      node ${CLAUDE_PLUGIN_ROOT}/lib/hooks/prepare-reflection-context.js "$CURRENT_INCREMENT" "$LATEST_TASK" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
         echo "[$(date)] ⚠️  Failed to prepare reflection context (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
       }
     else

package/plugins/specweave/hooks/user-prompt-submit.sh

@@ -0,0 +1,142 @@
+#!/bin/bash
+
+# SpecWeave UserPromptSubmit Hook
+# Fires BEFORE user's command executes (prompt-based hook)
+# Purpose: Discipline validation, context injection, command suggestions
+
+set -euo pipefail
+
+# Read input JSON from stdin
+INPUT=$(cat)
+
+# Extract prompt from JSON
+PROMPT=$(echo "$INPUT" | node -e "
+  const input = JSON.parse(require('fs').readFileSync(0, 'utf-8'));
+  console.log(input.prompt || '');
+")
+
+# ==============================================================================
+# DISCIPLINE VALIDATION: Block /specweave:increment if incomplete increments exist
+# ==============================================================================
+
+if echo "$PROMPT" | grep -q "/specweave:increment"; then
+  # Check for incomplete increments
+  SPECWEAVE_DIR=".specweave"
+
+  if [[ -d "$SPECWEAVE_DIR/increments" ]]; then
+    INCOMPLETE_INCREMENTS=$(find "$SPECWEAVE_DIR/increments" -mindepth 1 -maxdepth 1 -type d | while read increment_dir; do
+      metadata="$increment_dir/metadata.json"
+      if [[ -f "$metadata" ]]; then
+        status=$(node -e "
+          try {
+            const data = JSON.parse(require('fs').readFileSync('$metadata', 'utf-8'));
+            console.log(data.status || 'unknown');
+          } catch (e) {
+            console.log('unknown');
+          }
+        ")
+
+        if [[ "$status" == "active" || "$status" == "planning" ]]; then
+          echo "$(basename "$increment_dir")"
+        fi
+      fi
+    done)
+
+    if [[ -n "$INCOMPLETE_INCREMENTS" ]]; then
+      # Count incomplete increments
+      COUNT=$(echo "$INCOMPLETE_INCREMENTS" | wc -l | xargs)
+
+      # Block execution
+      cat <<EOF
+{
+  "decision": "block",
+  "reason": "❌ Cannot create new increment! You have $COUNT incomplete increment(s):\n\n$(echo "$INCOMPLETE_INCREMENTS" | sed 's/^/  - /')\n\n💡 Complete or close them first:\n  - /specweave:done <id>     # Mark as complete\n  - /specweave:pause <id>    # Pause for later\n  - /specweave:abandon <id>  # Abandon if obsolete\n\nℹ️ The discipline exists for a reason:\n  ✓ Prevents scope creep\n  ✓ Ensures completions are tracked\n  ✓ Maintains living docs accuracy\n  ✓ Keeps work focused"
+}
+EOF
+      exit 0
+    fi
+  fi
+fi
+
+# ==============================================================================
+# CONTEXT INJECTION: Add current increment status
+# ==============================================================================
+
+CONTEXT=""
+
+# Find active increment
+if [[ -d ".specweave/increments" ]]; then
+  ACTIVE_INCREMENT=$(find .specweave/increments -mindepth 1 -maxdepth 1 -type d | while read increment_dir; do
+    metadata="$increment_dir/metadata.json"
+    if [[ -f "$metadata" ]]; then
+      status=$(node -e "
+        try {
+          const data = JSON.parse(require('fs').readFileSync('$metadata', 'utf-8'));
+          if (data.status === 'active') {
+            console.log('$(basename "$increment_dir")');
+          }
+        } catch (e) {}
+      ")
+
+      if [[ -n "$status" ]]; then
+        echo "$status"
+        break
+      fi
+    fi
+  done)
+
+  if [[ -n "$ACTIVE_INCREMENT" ]]; then
+    # Get task completion percentage
+    TASKS_FILE=".specweave/increments/$ACTIVE_INCREMENT/tasks.md"
+    if [[ -f "$TASKS_FILE" ]]; then
+      TASK_STATS=$(grep -E "^\s*-\s*\[[ x]\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
+      COMPLETED_TASKS=$(grep -E "^\s*-\s*\[x\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
+
+      if [[ "$TASK_STATS" -gt 0 ]]; then
+        PERCENTAGE=$(( COMPLETED_TASKS * 100 / TASK_STATS ))
+        CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT ($PERCENTAGE% complete, $COMPLETED_TASKS/$TASK_STATS tasks)"
+      else
+        CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT"
+      fi
+    else
+      CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT"
+    fi
+  fi
+fi
+
+# ==============================================================================
+# COMMAND SUGGESTIONS: Guide users to structured workflow
+# ==============================================================================
+
+if echo "$PROMPT" | grep -qiE "(add|create|implement|build|develop)" && ! echo "$PROMPT" | grep -q "/specweave:"; then
+  if [[ -n "$CONTEXT" ]]; then
+    CONTEXT="$CONTEXT
+
+💡 TIP: Consider using SpecWeave commands for structured development:
+  - /specweave:increment \"feature name\"  # Plan new increment
+  - /specweave:do                         # Execute current tasks
+  - /specweave:progress                   # Check progress"
+  fi
+fi
+
+# ==============================================================================
+# OUTPUT: Approve with context or no context
+# ==============================================================================
+
+if [[ -n "$CONTEXT" ]]; then
+  cat <<EOF
+{
+  "decision": "approve",
+  "systemMessage": "$CONTEXT"
+}
+EOF
+else
+  # Just approve, no extra context
+  cat <<EOF
+{
+  "decision": "approve"
+}
+EOF
+fi
+
+exit 0

package/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/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-analyzer.d.ts","sourceRoot":"","sources":["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"}