specweave 0.13.6 → 0.15.0

package/dist/hooks/lib/run-self-reflection.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Core Reflection Engine
+ *
+ * Orchestrates the self-reflection process:
+ * 1. Load configuration
+ * 2. Get modified files
+ * 3. Build prompt
+ * 4. Invoke reflective-reviewer agent
+ * 5. Parse response
+ * 6. Store reflection
+ *
+ * @module run-self-reflection
+ */
+import { ReflectionContext, ReflectionExecutionResult } from './types/reflection-types';
+/**
+ * Run self-reflection analysis
+ * Main entry point for the reflection system
+ *
+ * @param context Reflection context with increment, task, and files
+ * @returns Reflection execution result (success or error)
+ */
+export declare function runSelfReflection(context: ReflectionContext): Promise<ReflectionExecutionResult>;
+/**
+ * Create reflection context from hook environment
+ * Helper function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional, auto-detected)
+ * @returns Reflection context ready for runSelfReflection
+ */
+export declare function createReflectionContext(incrementId: string, taskId: string, projectRoot?: string): ReflectionContext;
+/**
+ * Run reflection with automatic context creation
+ * Convenience function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional)
+ * @returns Reflection execution result
+ */
+export declare function runReflectionAuto(incrementId: string, taskId: string, projectRoot?: string): Promise<ReflectionExecutionResult>;
+//# sourceMappingURL=run-self-reflection.d.ts.map

package/dist/hooks/lib/run-self-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-self-reflection.d.ts","sourceRoot":"","sources":["../../../src/hooks/lib/run-self-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EAG1B,MAAM,0BAA0B,CAAC;AAuFlC;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,yBAAyB,CAAC,CA2FpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,iBAAiB,CAanB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAGpC"}

package/dist/hooks/lib/run-self-reflection.js

@@ -0,0 +1,203 @@
+/**
+ * Core Reflection Engine
+ *
+ * Orchestrates the self-reflection process:
+ * 1. Load configuration
+ * 2. Get modified files
+ * 3. Build prompt
+ * 4. Invoke reflective-reviewer agent
+ * 5. Parse response
+ * 6. Store reflection
+ *
+ * @module run-self-reflection
+ */
+import { loadAndValidateReflectionConfig } from './reflection-config-loader';
+import { getModifiedFiles, getModifiedFilesSummary } from './git-diff-analyzer';
+import { buildReflectionPrompt, estimatePromptTokens } from './reflection-prompt-builder';
+import { parseReflectionMarkdown, validateReflectionResult } from './reflection-parser';
+import { saveReflection } from './reflection-storage';
+import { ReflectionMode, ReflectionModel } from './types/reflection-types';
+/**
+ * Check if reflection should run for the current context
+ *
+ * @param context Reflection context with config and modified files
+ * @returns True if reflection should run
+ */
+function shouldRunReflection(context) {
+    const { config, modifiedFiles } = context;
+    // Check if reflection is enabled
+    if (!config.enabled) {
+        return false;
+    }
+    // Check mode
+    if (config.mode === ReflectionMode.DISABLED) {
+        return false;
+    }
+    if (config.mode === ReflectionMode.MANUAL) {
+        // Manual mode requires explicit invocation
+        // This function is only called in auto mode, so skip
+        return false;
+    }
+    // Check if there are modified files to analyze
+    if (modifiedFiles.length === 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Estimate reflection cost based on model and prompt size
+ *
+ * @param model Reflection model (haiku, sonnet, opus)
+ * @param promptTokens Estimated prompt token count
+ * @param responseTokens Estimated response token count (default: 2000)
+ * @returns Estimated cost in USD
+ */
+function estimateReflectionCost(model, promptTokens, responseTokens = 2000) {
+    // Pricing per 1M tokens (as of Nov 2025)
+    const pricing = {
+        [ReflectionModel.HAIKU]: { input: 0.80, output: 4.00 },
+        [ReflectionModel.SONNET]: { input: 3.00, output: 15.00 },
+        [ReflectionModel.OPUS]: { input: 15.00, output: 75.00 }
+    };
+    const modelPricing = pricing[model];
+    const inputCost = (promptTokens / 1000000) * modelPricing.input;
+    const outputCost = (responseTokens / 1000000) * modelPricing.output;
+    return inputCost + outputCost;
+}
+/**
+ * Invoke reflective-reviewer agent to analyze code
+ *
+ * @param prompt Reflection prompt
+ * @param model Model to use (haiku, sonnet, opus)
+ * @returns Agent response (markdown reflection)
+ */
+async function invokeReflectiveReviewerAgent(prompt, model) {
+    // NOTE: This is a placeholder for agent invocation
+    // In the real implementation, this would use Claude Code's Task tool
+    // to invoke the specweave:reflective-reviewer:reflective-reviewer agent
+    //
+    // For now, we'll return a mock response to enable testing
+    // The actual implementation will be in the hook integration (T-008)
+    throw new Error('Agent invocation not implemented yet. ' +
+        'This function will be implemented in hook integration (T-008). ' +
+        'Call this from the post-task-completion hook using the Task tool.');
+}
+/**
+ * Run self-reflection analysis
+ * Main entry point for the reflection system
+ *
+ * @param context Reflection context with increment, task, and files
+ * @returns Reflection execution result (success or error)
+ */
+export async function runSelfReflection(context) {
+    const { incrementId, taskId, modifiedFiles, config } = context;
+    const startTime = Date.now();
+    try {
+        // Step 1: Check if reflection should run
+        if (!shouldRunReflection(context)) {
+            return {
+                success: true,
+                result: undefined,
+                error: undefined
+            };
+        }
+        // Step 2: Build reflection prompt
+        const prompt = buildReflectionPrompt({
+            taskId,
+            taskName: `Task ${taskId}`, // Will be enhanced with actual task name in hook
+            modifiedFiles,
+            config,
+            incrementId,
+            includeFullDiff: false // Use simplified prompt for token efficiency
+        });
+        // Step 3: Estimate cost
+        const promptTokens = estimatePromptTokens(prompt);
+        const estimatedCost = estimateReflectionCost(config.model, promptTokens);
+        // Step 4: Invoke reflective-reviewer agent
+        const agentResponse = await invokeReflectiveReviewerAgent(prompt, config.model);
+        // Step 5: Parse response
+        const endTime = Date.now();
+        const reflectionTime = Math.round((endTime - startTime) / 1000); // seconds
+        const reflectionResult = parseReflectionMarkdown(agentResponse, `Task ${taskId}`, config.model, reflectionTime, estimatedCost);
+        // Step 6: Add file modification stats
+        const fileStats = getModifiedFilesSummary(modifiedFiles);
+        reflectionResult.filesModified = {
+            count: fileStats.count,
+            linesAdded: fileStats.linesAdded,
+            linesRemoved: fileStats.linesRemoved
+        };
+        // Step 7: Validate reflection result
+        const validation = validateReflectionResult(reflectionResult);
+        if (!validation.valid) {
+            return {
+                success: false,
+                error: {
+                    message: 'Reflection validation failed',
+                    code: 'VALIDATION_ERROR',
+                    details: validation.errors
+                }
+            };
+        }
+        // Step 8: Store reflection (if enabled)
+        if (config.storeReflections) {
+            try {
+                saveReflection(reflectionResult, incrementId, taskId);
+            }
+            catch (storageError) {
+                // Storage failure shouldn't fail the entire reflection
+                console.warn(`Failed to store reflection: ${storageError.message}`);
+            }
+        }
+        // Step 9: Return success
+        return {
+            success: true,
+            result: reflectionResult
+        };
+    }
+    catch (error) {
+        // Graceful degradation: Return error but don't throw
+        return {
+            success: false,
+            error: {
+                message: error.message || 'Unknown error during reflection',
+                code: 'REFLECTION_ERROR',
+                details: error.stack
+            }
+        };
+    }
+}
+/**
+ * Create reflection context from hook environment
+ * Helper function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional, auto-detected)
+ * @returns Reflection context ready for runSelfReflection
+ */
+export function createReflectionContext(incrementId, taskId, projectRoot) {
+    // Load and validate configuration
+    const config = loadAndValidateReflectionConfig(projectRoot);
+    // Get modified files from git
+    const modifiedFiles = getModifiedFiles(projectRoot);
+    return {
+        incrementId,
+        taskId,
+        modifiedFiles,
+        config
+    };
+}
+/**
+ * Run reflection with automatic context creation
+ * Convenience function for hook integration
+ *
+ * @param incrementId Increment identifier
+ * @param taskId Task identifier
+ * @param projectRoot Project root directory (optional)
+ * @returns Reflection execution result
+ */
+export async function runReflectionAuto(incrementId, taskId, projectRoot) {
+    const context = createReflectionContext(incrementId, taskId, projectRoot);
+    return runSelfReflection(context);
+}
+//# sourceMappingURL=run-self-reflection.js.map

package/dist/hooks/lib/run-self-reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-self-reflection.js","sourceRoot":"","sources":["../../../src/hooks/lib/run-self-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAGL,cAAc,EACd,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAA0B;IACrD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAE1C,iCAAiC;IACjC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,aAAa;IACb,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1C,2CAA2C;QAC3C,qDAAqD;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAC7B,KAAsB,EACtB,YAAoB,EACpB,iBAAyB,IAAI;IAE7B,yCAAyC;IACzC,MAAM,OAAO,GAAG;QACd,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACtD,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;QACxD,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;KACxD,CAAC;IAEF,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,CAAC,YAAY,GAAG,OAAS,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC;IAClE,MAAM,UAAU,GAAG,CAAC,cAAc,GAAG,OAAS,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;IAEtE,OAAO,SAAS,GAAG,UAAU,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,6BAA6B,CAC1C,MAAc,EACd,KAAsB;IAEtB,mDAAmD;IACnD,qEAAqE;IACrE,wEAAwE;IACxE,EAAE;IACF,0DAA0D;IAC1D,oEAAoE;IAEpE,MAAM,IAAI,KAAK,CACb,wCAAwC;QACxC,iEAAiE;QACjE,mEAAmE,CACpE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA0B;IAE1B,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,yCAAyC;QACzC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,SAAS;aACjB,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACnC,MAAM;YACN,QAAQ,EAAE,QAAQ,MAAM,EAAE,EAAE,iDAAiD;YAC7E,aAAa;YACb,MAAM;YACN,WAAW;YACX,eAAe,EAAE,KAAK,CAAC,6CAA6C;SACrE,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,sBAAsB,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAEzE,2CAA2C;QAC3C,MAAM,aAAa,GAAG,MAAM,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAEhF,yBAAyB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU;QAE3E,MAAM,gBAAgB,GAAG,uBAAuB,CAC9C,aAAa,EACb,QAAQ,MAAM,EAAE,EAChB,MAAM,CAAC,KAAK,EACZ,cAAc,EACd,aAAa,CACd,CAAC;QAEF,sCAAsC;QACtC,MAAM,SAAS,GAAG,uBAAuB,CAAC,aAAa,CAAC,CAAC;QACzD,gBAAgB,CAAC,aAAa,GAAG;YAC/B,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,YAAY,EAAE,SAAS,CAAC,YAAY;SACrC,CAAC;QAEF,qCAAqC;QACrC,MAAM,UAAU,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,OAAO,EAAE,8BAA8B;oBACvC,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,UAAU,CAAC,MAAM;iBAC3B;aACF,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,cAAc,CAAC,gBAAgB,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,YAAiB,EAAE,CAAC;gBAC3B,uDAAuD;gBACvD,OAAO,CAAC,IAAI,CAAC,+BAA+B,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,gBAAgB;SACzB,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,qDAAqD;QACrD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,iCAAiC;gBAC3D,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,KAAK,CAAC,KAAK;aACrB;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,MAAc,EACd,WAAoB;IAEpB,kCAAkC;IAClC,MAAM,MAAM,GAAG,+BAA+B,CAAC,WAAW,CAAC,CAAC;IAE5D,8BAA8B;IAC9B,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEpD,OAAO;QACL,WAAW;QACX,MAAM;QACN,aAAa;QACb,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,MAAc,EACd,WAAoB;IAEpB,MAAM,OAAO,GAAG,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1E,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/hooks/lib/sync-living-docs.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * SpecWeave Living Docs Auto-Sync
+ *
+ * Automatically syncs living documentation after task completion.
+ *
+ * Usage:
+ *   node dist/hooks/lib/sync-living-docs.js <incrementId>
+ *
+ * Example:
+ *   node dist/hooks/lib/sync-living-docs.js 0006-llm-native-i18n
+ *
+ * What it does:
+ * 1. Checks if sync_living_docs enabled in config
+ * 2. Detects changed docs via git diff
+ * 3. Invokes /sync-docs update command (future implementation)
+ * 4. Logs sync actions
+ *
+ * @author SpecWeave Team
+ * @version 1.0.0
+ */
+/**
+ * Main function - sync living docs for given increment
+ */
+declare function syncLivingDocs(incrementId: string): Promise<void>;
+export { syncLivingDocs };
+//# sourceMappingURL=sync-living-docs.d.ts.map

package/dist/hooks/lib/sync-living-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-living-docs.d.ts","sourceRoot":"","sources":["../../../src/hooks/lib/sync-living-docs.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH;;GAEG;AACH,iBAAe,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDhE;AAyDD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/lib/sync-living-docs.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * SpecWeave Living Docs Auto-Sync
+ *
+ * Automatically syncs living documentation after task completion.
+ *
+ * Usage:
+ *   node dist/hooks/lib/sync-living-docs.js <incrementId>
+ *
+ * Example:
+ *   node dist/hooks/lib/sync-living-docs.js 0006-llm-native-i18n
+ *
+ * What it does:
+ * 1. Checks if sync_living_docs enabled in config
+ * 2. Detects changed docs via git diff
+ * 3. Invokes /sync-docs update command (future implementation)
+ * 4. Logs sync actions
+ *
+ * @author SpecWeave Team
+ * @version 1.0.0
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { execSync } from 'child_process';
+/**
+ * Main function - sync living docs for given increment
+ */
+async function syncLivingDocs(incrementId) {
+    try {
+        console.log(`\n📚 Checking living docs sync for increment: ${incrementId}`);
+        // 1. Load config
+        const configPath = path.join(process.cwd(), '.specweave', 'config.json');
+        let config = {};
+        if (fs.existsSync(configPath)) {
+            config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        }
+        // 2. Check if sync enabled
+        const syncEnabled = config.hooks?.post_task_completion?.sync_living_docs ?? false;
+        if (!syncEnabled) {
+            console.log('ℹ️  Living docs sync disabled in config');
+            console.log('   To enable: Set hooks.post_task_completion.sync_living_docs = true');
+            return;
+        }
+        console.log('✅ Living docs sync enabled');
+        // 3. Detect changed docs via git diff
+        const changedDocs = detectChangedDocs();
+        if (changedDocs.length === 0) {
+            console.log('ℹ️  No living docs changed (no git diff in .specweave/docs/)');
+            return;
+        }
+        console.log(`📄 Detected ${changedDocs.length} changed doc(s):`);
+        changedDocs.forEach((doc) => console.log(`   - ${doc}`));
+        // 4. Invoke /sync-docs update command
+        // TODO: Implement actual sync command invocation
+        // For now, just log what would happen
+        console.log('\n🔄 Syncing living docs...');
+        console.log('   (Actual sync command invocation to be implemented in future version)');
+        console.log('   Would invoke: /sync-docs update');
+        // Future implementation:
+        // await invokeSyncDocsCommand(incrementId);
+        console.log('✅ Living docs sync check complete\n');
+    }
+    catch (error) {
+        console.error('❌ Error syncing living docs:', error);
+        // Don't exit with error - this is best-effort
+    }
+}
+/**
+ * Detect changed documentation files via git diff
+ */
+function detectChangedDocs() {
+    try {
+        // Get changed files in .specweave/docs/
+        const output = execSync('git diff --name-only .specweave/docs/ 2>/dev/null || true', {
+            encoding: 'utf-8',
+            cwd: process.cwd(),
+        }).trim();
+        if (!output) {
+            return [];
+        }
+        // Filter to only .md files
+        const files = output
+            .split('\n')
+            .filter((f) => f.endsWith('.md'))
+            .filter((f) => f.length > 0);
+        return files;
+    }
+    catch (error) {
+        console.warn('⚠️  Could not detect git changes:', error);
+        return [];
+    }
+}
+/**
+ * Invoke /sync-docs update command
+ * TODO: Implement actual command invocation
+ */
+async function invokeSyncDocsCommand(incrementId) {
+    // This will be implemented in future version when /sync-docs command is ready
+    console.log(`   Invoking /sync-docs update for ${incrementId}`);
+}
+// CLI entry point
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+    const incrementId = process.argv[2];
+    if (!incrementId) {
+        console.error('❌ Usage: sync-living-docs <incrementId>');
+        console.error('   Example: sync-living-docs 0006-llm-native-i18n');
+        process.exit(1);
+    }
+    syncLivingDocs(incrementId).catch((error) => {
+        console.error('❌ Fatal error:', error);
+        // Don't exit with error code - best-effort sync
+    });
+}
+export { syncLivingDocs };
+//# sourceMappingURL=sync-living-docs.js.map

package/dist/hooks/lib/sync-living-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-living-docs.js","sourceRoot":"","sources":["../../../src/hooks/lib/sync-living-docs.ts"],"names":[],"mappings":"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"}

package/dist/hooks/lib/translate-file.d.ts

@@ -0,0 +1,59 @@
+/**
+ * File Translation CLI Utility
+ *
+ * Translates a single file from detected source language to target language
+ * using the translation utilities and LLM invocation.
+ *
+ * This script is called from:
+ * - Post-increment-planning hook (auto-translate spec.md, plan.md, tasks.md)
+ * - Post-task-completion hook (auto-translate living docs)
+ * - Manual /specweave:translate command
+ *
+ * Usage:
+ *   node translate-file.js <file-path> [--target-lang en] [--preview]
+ *
+ * @see src/utils/translation.ts
+ * @see .specweave/increments/0006-llm-native-i18n/reports/DESIGN-POST-GENERATION-TRANSLATION.md
+ */
+import { type SupportedLanguage } from '../../utils/translation.js';
+/**
+ * CLI options
+ */
+interface CLIOptions {
+    filePath: string;
+    targetLang: SupportedLanguage;
+    preview: boolean;
+    verbose: boolean;
+}
+/**
+ * Translation result
+ */
+interface FileTranslationResult {
+    success: boolean;
+    filePath: string;
+    sourceLanguage: SupportedLanguage;
+    targetLanguage: SupportedLanguage;
+    warnings: string[];
+    cost: number;
+    tokensUsed: number;
+    preview?: string;
+}
+/**
+ * Main translation function
+ *
+ * @param options - CLI options
+ * @returns Translation result
+ */
+export declare function translateFile(options: CLIOptions): Promise<FileTranslationResult>;
+/**
+ * Batch translate multiple files
+ *
+ * @param filePaths - Array of file paths to translate
+ * @param targetLang - Target language
+ * @param preview - Preview mode
+ * @param verbose - Verbose output
+ * @returns Array of translation results
+ */
+export declare function batchTranslateFiles(filePaths: string[], targetLang?: SupportedLanguage, preview?: boolean, verbose?: boolean): Promise<FileTranslationResult[]>;
+export {};
+//# sourceMappingURL=translate-file.d.ts.map

package/dist/hooks/lib/translate-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-file.d.ts","sourceRoot":"","sources":["../../../src/hooks/lib/translate-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,iBAAiB,CAAC;IAClC,cAAc,EAAE,iBAAiB,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqHvF;AAyGD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,GAAE,iBAAwB,EACpC,OAAO,GAAE,OAAe,EACxB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA6ClC"}