specweave 0.21.2 → 0.22.0

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

@@ -1,43 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,203 +0,0 @@
-/**
- * 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

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

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-/**
- * SpecWeave Living Docs Auto-Sync
- *
- * Automatically syncs living documentation after task completion.
- *
- * Supports two modes:
- * 1. Simple mode: Copy spec.md to living docs (legacy)
- * 2. Intelligent mode: Parse, classify, and distribute content (v0.18.0+)
- *
- * 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 sync mode (simple or intelligent)
- * 3. Runs appropriate sync strategy
- * 4. Syncs to external tools (GitHub/Jira/ADO)
- * 5. Logs sync actions
- *
- * @author SpecWeave Team
- * @version 2.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

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