specweave 0.17.0 → 0.17.2

package/dist/plugins/specweave/lib/hooks/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/plugins/specweave/lib/hooks/run-self-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-self-reflection.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/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/plugins/specweave/lib/hooks/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/plugins/specweave/lib/hooks/run-self-reflection.js.map

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

package/dist/plugins/specweave/lib/hooks/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/plugins/specweave/lib/hooks/sync-living-docs.d.ts.map

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

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

@@ -0,0 +1,180 @@
+#!/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. Copy increment spec to living docs
+        const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
+        // 4. Detect changed docs via git diff
+        const changedDocs = detectChangedDocs();
+        if (changedDocs.length === 0 && !specCopied) {
+            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. Sync to GitHub if configured
+        await syncToGitHub(incrementId, changedDocs);
+        console.log('✅ Living docs sync complete\n');
+    }
+    catch (error) {
+        console.error('❌ Error syncing living docs:', error);
+        // Don't exit with error - this is best-effort
+    }
+}
+/**
+ * Copy increment spec to living docs
+ * Returns true if spec was copied, false if skipped
+ */
+async function copyIncrementSpecToLivingDocs(incrementId) {
+    try {
+        const incrementSpecPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
+        const livingDocsPath = path.join(process.cwd(), '.specweave', 'docs', 'internal', 'specs', `spec-${incrementId}.md`);
+        // Check if increment spec exists
+        if (!fs.existsSync(incrementSpecPath)) {
+            console.log(`⚠️  Increment spec not found: ${incrementSpecPath}`);
+            return false;
+        }
+        // Check if living docs spec already exists and is identical
+        if (fs.existsSync(livingDocsPath)) {
+            const incrementContent = await fs.readFile(incrementSpecPath, 'utf-8');
+            const livingDocsContent = await fs.readFile(livingDocsPath, 'utf-8');
+            if (incrementContent === livingDocsContent) {
+                console.log(`ℹ️  Living docs spec already up-to-date: spec-${incrementId}.md`);
+                return false;
+            }
+        }
+        // Ensure target directory exists
+        await fs.ensureDir(path.dirname(livingDocsPath));
+        // Copy spec to living docs
+        await fs.copy(incrementSpecPath, livingDocsPath);
+        console.log(`✅ Copied increment spec to living docs: spec-${incrementId}.md`);
+        return true;
+    }
+    catch (error) {
+        console.error(`❌ Error copying increment spec: ${error}`);
+        return false;
+    }
+}
+/**
+ * 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 [];
+    }
+}
+/**
+ * Sync changed docs to GitHub
+ */
+async function syncToGitHub(incrementId, changedDocs) {
+    try {
+        console.log('\n🔄 Syncing to GitHub...');
+        // Dynamic import to avoid circular dependencies
+        const { loadIncrementMetadata, detectRepo, collectLivingDocs, updateIssueLivingDocs, postArchitectureComment } = await import('../../../specweave-github/lib/github-issue-updater.js');
+        // 1. Load metadata
+        const metadata = await loadIncrementMetadata(incrementId);
+        if (!metadata?.github?.issue) {
+            console.log('ℹ️  No GitHub issue linked, skipping GitHub sync');
+            return;
+        }
+        // 2. Detect repository
+        const repoInfo = await detectRepo();
+        if (!repoInfo) {
+            console.log('⚠️  Could not detect GitHub repository, skipping GitHub sync');
+            return;
+        }
+        const { owner, repo } = repoInfo;
+        const issueNumber = metadata.github.issue;
+        console.log(`   Syncing to ${owner}/${repo}#${issueNumber}`);
+        // 3. Collect all living docs
+        const livingDocs = await collectLivingDocs(incrementId);
+        // 4. Update issue with living docs section
+        if (livingDocs.specs.length > 0 || livingDocs.architecture.length > 0 || livingDocs.diagrams.length > 0) {
+            await updateIssueLivingDocs(issueNumber, livingDocs, owner, repo);
+        }
+        // 5. Post comments for newly created architecture docs
+        for (const docPath of changedDocs) {
+            if (docPath.includes('/architecture/')) {
+                await postArchitectureComment(issueNumber, docPath, owner, repo);
+            }
+        }
+        console.log('✅ GitHub sync complete');
+    }
+    catch (error) {
+        console.error('❌ Error syncing to GitHub:', error);
+        console.error('   (Non-blocking - continuing...)');
+    }
+}
+// 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/plugins/specweave/lib/hooks/sync-living-docs.js.map

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

package/dist/plugins/specweave/lib/hooks/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 '../../../../src/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/plugins/specweave/lib/hooks/translate-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-file.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/translate-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,sCAAsC,CAAC;AAE9C;;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"}