specweave 1.0.593 → 2.0.0

package/plugins/specweave/lib/hooks/reflection-prompt-builder.js

@@ -1,182 +0,0 @@
-import { ReflectionDepth } from "./types/reflection-types";
-function buildAnalysisInstructions(config) {
-  const { depth, categories } = config;
-  const instructions = [];
-  switch (depth) {
-    case ReflectionDepth.QUICK:
-      instructions.push("**Analysis Mode**: QUICK (<15s)");
-      instructions.push("- Focus on CRITICAL and HIGH severity issues only");
-      instructions.push("- Skip lessons learned section");
-      instructions.push("- Provide concise feedback (1-2 sentences per issue)");
-      break;
-    case ReflectionDepth.STANDARD:
-      instructions.push("**Analysis Mode**: STANDARD (<30s)");
-      instructions.push("- Full analysis across all enabled categories");
-      instructions.push("- Include lessons learned");
-      instructions.push("- Provide actionable feedback with code examples");
-      break;
-    case ReflectionDepth.DEEP:
-      instructions.push("**Analysis Mode**: DEEP (<60s)");
-      instructions.push("- Comprehensive analysis with detailed explanations");
-      instructions.push("- Include architectural recommendations");
-      instructions.push("- Suggest refactoring opportunities");
-      instructions.push("- Analyze code metrics (complexity, coupling, cohesion)");
-      break;
-  }
-  instructions.push("");
-  instructions.push("**Enabled Analysis Categories**:");
-  if (categories.security) {
-    instructions.push("- \u2705 **Security**: OWASP Top 10 vulnerabilities (SQL injection, XSS, secrets, etc.)");
-  }
-  if (categories.quality) {
-    instructions.push("- \u2705 **Quality**: Code duplication, complexity, error handling, naming conventions");
-  }
-  if (categories.testing) {
-    instructions.push("- \u2705 **Testing**: Edge cases, error paths, integration/E2E coverage");
-  }
-  if (categories.performance) {
-    instructions.push("- \u2705 **Performance**: N+1 queries, algorithmic complexity, caching opportunities");
-  }
-  if (categories.technicalDebt) {
-    instructions.push("- \u2705 **Technical Debt**: TODOs, deprecated APIs, temporary hacks");
-  }
-  return instructions.join("\n");
-}
-function buildFileContext(modifiedFiles, includeFullDiff = false) {
-  const context = [];
-  context.push("## Modified Files Context");
-  context.push("");
-  context.push(`**Files Changed**: ${modifiedFiles.length}`);
-  const totalAdded = modifiedFiles.reduce((sum, f) => sum + f.linesAdded, 0);
-  const totalRemoved = modifiedFiles.reduce((sum, f) => sum + f.linesRemoved, 0);
-  context.push(`**Lines Added**: +${totalAdded}`);
-  context.push(`**Lines Removed**: -${totalRemoved}`);
-  context.push("");
-  context.push("### File Summary");
-  context.push("");
-  for (const file of modifiedFiles) {
-    context.push(`- \`${file.file}\`: +${file.linesAdded} -${file.linesRemoved}`);
-  }
-  context.push("");
-  if (includeFullDiff) {
-    context.push("### Detailed Changes");
-    context.push("");
-    for (const file of modifiedFiles) {
-      context.push(`#### ${file.file}`);
-      context.push("");
-      context.push("```diff");
-      const diffLines = file.content.split("\n").slice(0, 100);
-      context.push(diffLines.join("\n"));
-      if (file.content.split("\n").length > 100) {
-        context.push("... (diff truncated)");
-      }
-      context.push("```");
-      context.push("");
-    }
-  }
-  return context.join("\n");
-}
-function buildTaskContext(taskId, taskName) {
-  const context = [];
-  context.push("## Task Information");
-  context.push("");
-  context.push(`**Task ID**: ${taskId}`);
-  if (taskName) {
-    context.push(`**Task Name**: ${taskName}`);
-  }
-  context.push("");
-  return context.join("\n");
-}
-function buildReflectionPrompt(options) {
-  const {
-    taskId,
-    taskName,
-    modifiedFiles,
-    config,
-    incrementId,
-    includeFullDiff = false
-  } = options;
-  const sections = [];
-  sections.push("# Self-Reflection Request");
-  sections.push("");
-  sections.push("You are a senior software engineer performing self-reflection on recently completed work.");
-  sections.push("Analyze the following code changes and provide comprehensive, actionable feedback.");
-  sections.push("");
-  sections.push(buildTaskContext(taskId, taskName));
-  if (incrementId) {
-    sections.push(`**Increment**: ${incrementId}`);
-    sections.push("");
-  }
-  sections.push("---");
-  sections.push("");
-  sections.push(buildAnalysisInstructions(config));
-  sections.push("");
-  sections.push("---");
-  sections.push("");
-  sections.push(buildFileContext(modifiedFiles, includeFullDiff));
-  sections.push("---");
-  sections.push("");
-  sections.push("## Analysis Request");
-  sections.push("");
-  sections.push("Please analyze the modified files and provide a comprehensive self-reflection following the exact format specified in the reflective-reviewer agent documentation.");
-  sections.push("");
-  sections.push("**Required Sections**:");
-  sections.push("1. \u2705 What Was Accomplished");
-  sections.push("2. \u{1F3AF} Quality Assessment (Strengths + Issues)");
-  sections.push("3. \u{1F527} Recommended Follow-Up Actions (Priority 1/2/3)");
-  if (config.depth !== ReflectionDepth.QUICK) {
-    sections.push("4. \u{1F4DA} Lessons Learned");
-    sections.push("5. \u{1F4CA} Metrics (Code Quality, Security, Test Coverage, Technical Debt, Performance)");
-  }
-  sections.push("");
-  sections.push("**Critical Requirements**:");
-  sections.push("- \u2705 Be SPECIFIC: Always include file paths and line numbers");
-  sections.push("- \u2705 Be CONSTRUCTIVE: Provide code examples for fixes, not just criticism");
-  sections.push("- \u2705 Be ACTIONABLE: Every issue should have a clear next step");
-  sections.push("- \u2705 Be BALANCED: Mention both strengths and issues");
-  sections.push("- \u2705 Be HONEST: Don't sugarcoat issues, but acknowledge strengths");
-  sections.push("");
-  sections.push(`**Severity Threshold**: Flag issues with severity >= ${config.criticalThreshold}`);
-  sections.push("");
-  sections.push("---");
-  sections.push("");
-  sections.push("**Please provide your self-reflection analysis now.**");
-  return sections.join("\n");
-}
-function estimatePromptTokens(prompt) {
-  return Math.ceil(prompt.length / 4);
-}
-function truncateModifiedFiles(modifiedFiles, maxTokens = 8e3) {
-  const maxChars = maxTokens * 4;
-  let currentChars = 0;
-  const truncated = [];
-  for (const file of modifiedFiles) {
-    const fileChars = file.content.length + file.file.length + 50;
-    if (currentChars + fileChars > maxChars) {
-      const remainingChars = maxChars - currentChars;
-      if (remainingChars > 200) {
-        const truncatedContent = file.content.slice(0, remainingChars - 50) + "\n... (diff truncated)";
-        truncated.push({
-          ...file,
-          content: truncatedContent
-        });
-      }
-      break;
-    }
-    truncated.push(file);
-    currentChars += fileChars;
-  }
-  return truncated;
-}
-function buildSimplifiedPrompt(options) {
-  return buildReflectionPrompt({
-    ...options,
-    includeFullDiff: false
-  });
-}
-export {
-  buildReflectionPrompt,
-  buildSimplifiedPrompt,
-  estimatePromptTokens,
-  truncateModifiedFiles
-};

package/plugins/specweave/lib/hooks/reflection-prompt-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflection-prompt-builder.js","sourceRoot":"","sources":["reflection-prompt-builder.ts"],"names":[],"mappings":"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"}

package/plugins/specweave/lib/hooks/reflection-prompt-builder.ts

@@ -1,306 +0,0 @@
-/**
- * Reflection Prompt Builder
- *
- * Builds comprehensive prompts for the reflective-reviewer agent
- * Includes modified files context, configuration, task information
- *
- * @module reflection-prompt-builder
- */
-
-import { ReflectionConfig, ReflectionDepth, GitDiffInfo } from './types/reflection-types';
-
-/**
- * Build analysis instructions based on configuration
- * @param config Reflection configuration
- * @returns Markdown-formatted analysis instructions
- */
-function buildAnalysisInstructions(config: ReflectionConfig): string {
-  const { depth, categories } = config;
-
-  const instructions: string[] = [];
-
-  // Depth-specific instructions
-  switch (depth) {
-    case ReflectionDepth.QUICK:
-      instructions.push('**Analysis Mode**: QUICK (<15s)');
-      instructions.push('- Focus on CRITICAL and HIGH severity issues only');
-      instructions.push('- Skip lessons learned section');
-      instructions.push('- Provide concise feedback (1-2 sentences per issue)');
-      break;
-
-    case ReflectionDepth.STANDARD:
-      instructions.push('**Analysis Mode**: STANDARD (<30s)');
-      instructions.push('- Full analysis across all enabled categories');
-      instructions.push('- Include lessons learned');
-      instructions.push('- Provide actionable feedback with code examples');
-      break;
-
-    case ReflectionDepth.DEEP:
-      instructions.push('**Analysis Mode**: DEEP (<60s)');
-      instructions.push('- Comprehensive analysis with detailed explanations');
-      instructions.push('- Include architectural recommendations');
-      instructions.push('- Suggest refactoring opportunities');
-      instructions.push('- Analyze code metrics (complexity, coupling, cohesion)');
-      break;
-  }
-
-  instructions.push('');
-  instructions.push('**Enabled Analysis Categories**:');
-
-  // Category-specific instructions
-  if (categories.security) {
-    instructions.push('- ✅ **Security**: OWASP Top 10 vulnerabilities (SQL injection, XSS, secrets, etc.)');
-  }
-  if (categories.quality) {
-    instructions.push('- ✅ **Quality**: Code duplication, complexity, error handling, naming conventions');
-  }
-  if (categories.testing) {
-    instructions.push('- ✅ **Testing**: Edge cases, error paths, integration/E2E coverage');
-  }
-  if (categories.performance) {
-    instructions.push('- ✅ **Performance**: N+1 queries, algorithmic complexity, caching opportunities');
-  }
-  if (categories.technicalDebt) {
-    instructions.push('- ✅ **Technical Debt**: TODOs, deprecated APIs, temporary hacks');
-  }
-
-  return instructions.join('\n');
-}
-
-/**
- * Build file context section with modified files
- * @param modifiedFiles Array of modified files
- * @param includeFullDiff Whether to include full diff content (default: false for large changes)
- * @returns Markdown-formatted file context
- */
-function buildFileContext(
-  modifiedFiles: GitDiffInfo[],
-  includeFullDiff: boolean = false
-): string {
-  const context: string[] = [];
-
-  context.push('## Modified Files Context');
-  context.push('');
-  context.push(`**Files Changed**: ${modifiedFiles.length}`);
-
-  const totalAdded = modifiedFiles.reduce((sum, f) => sum + f.linesAdded, 0);
-  const totalRemoved = modifiedFiles.reduce((sum, f) => sum + f.linesRemoved, 0);
-
-  context.push(`**Lines Added**: +${totalAdded}`);
-  context.push(`**Lines Removed**: -${totalRemoved}`);
-  context.push('');
-
-  // List all modified files with stats
-  context.push('### File Summary');
-  context.push('');
-  for (const file of modifiedFiles) {
-    context.push(`- \`${file.file}\`: +${file.linesAdded} -${file.linesRemoved}`);
-  }
-  context.push('');
-
-  // Include diff content if requested and not too large
-  if (includeFullDiff) {
-    context.push('### Detailed Changes');
-    context.push('');
-
-    for (const file of modifiedFiles) {
-      context.push(`#### ${file.file}`);
-      context.push('');
-      context.push('```diff');
-      // Truncate very large diffs (max 100 lines per file)
-      const diffLines = file.content.split('\n').slice(0, 100);
-      context.push(diffLines.join('\n'));
-      if (file.content.split('\n').length > 100) {
-        context.push('... (diff truncated)');
-      }
-      context.push('```');
-      context.push('');
-    }
-  }
-
-  return context.join('\n');
-}
-
-/**
- * Build task information section
- * @param taskId Task identifier (e.g., "T-005")
- * @param taskName Human-readable task name
- * @returns Markdown-formatted task context
- */
-function buildTaskContext(taskId: string, taskName?: string): string {
-  const context: string[] = [];
-
-  context.push('## Task Information');
-  context.push('');
-  context.push(`**Task ID**: ${taskId}`);
-
-  if (taskName) {
-    context.push(`**Task Name**: ${taskName}`);
-  }
-
-  context.push('');
-
-  return context.join('\n');
-}
-
-/**
- * Build the complete reflection prompt
- * Main function for creating agent prompts
- *
- * @param options Prompt options
- * @returns Complete markdown-formatted prompt for reflective-reviewer agent
- */
-export function buildReflectionPrompt(options: {
-  taskId: string;
-  taskName?: string;
-  modifiedFiles: GitDiffInfo[];
-  config: ReflectionConfig;
-  incrementId?: string;
-  includeFullDiff?: boolean;
-}): string {
-  const {
-    taskId,
-    taskName,
-    modifiedFiles,
-    config,
-    incrementId,
-    includeFullDiff = false
-  } = options;
-
-  const sections: string[] = [];
-
-  // Header
-  sections.push('# Self-Reflection Request');
-  sections.push('');
-  sections.push('You are a senior software engineer performing self-reflection on recently completed work.');
-  sections.push('Analyze the following code changes and provide comprehensive, actionable feedback.');
-  sections.push('');
-
-  // Task context
-  sections.push(buildTaskContext(taskId, taskName));
-
-  // Increment context (if provided)
-  if (incrementId) {
-    sections.push(`**Increment**: ${incrementId}`);
-    sections.push('');
-  }
-
-  // Analysis instructions
-  sections.push('---');
-  sections.push('');
-  sections.push(buildAnalysisInstructions(config));
-  sections.push('');
-
-  // File context
-  sections.push('---');
-  sections.push('');
-  sections.push(buildFileContext(modifiedFiles, includeFullDiff));
-
-  // Analysis request
-  sections.push('---');
-  sections.push('');
-  sections.push('## Analysis Request');
-  sections.push('');
-  sections.push('Please analyze the modified files and provide a comprehensive self-reflection following the exact format specified in the reflective-reviewer agent documentation.');
-  sections.push('');
-  sections.push('**Required Sections**:');
-  sections.push('1. ✅ What Was Accomplished');
-  sections.push('2. 🎯 Quality Assessment (Strengths + Issues)');
-  sections.push('3. 🔧 Recommended Follow-Up Actions (Priority 1/2/3)');
-
-  if (config.depth !== ReflectionDepth.QUICK) {
-    sections.push('4. 📚 Lessons Learned');
-    sections.push('5. 📊 Metrics (Code Quality, Security, Test Coverage, Technical Debt, Performance)');
-  }
-
-  sections.push('');
-  sections.push('**Critical Requirements**:');
-  sections.push('- ✅ Be SPECIFIC: Always include file paths and line numbers');
-  sections.push('- ✅ Be CONSTRUCTIVE: Provide code examples for fixes, not just criticism');
-  sections.push('- ✅ Be ACTIONABLE: Every issue should have a clear next step');
-  sections.push('- ✅ Be BALANCED: Mention both strengths and issues');
-  sections.push('- ✅ Be HONEST: Don\'t sugarcoat issues, but acknowledge strengths');
-
-  sections.push('');
-  sections.push(`**Severity Threshold**: Flag issues with severity >= ${config.criticalThreshold}`);
-
-  sections.push('');
-  sections.push('---');
-  sections.push('');
-  sections.push('**Please provide your self-reflection analysis now.**');
-
-  return sections.join('\n');
-}
-
-/**
- * Estimate token count for prompt (rough approximation)
- * Used for cost estimation
- *
- * @param prompt Reflection prompt
- * @returns Estimated token count (1 token ≈ 4 characters)
- */
-export function estimatePromptTokens(prompt: string): number {
-  // Rough approximation: 1 token ≈ 4 characters
-  return Math.ceil(prompt.length / 4);
-}
-
-/**
- * Truncate large diffs to fit within token budget
- * Preserves most recent changes (bottom of diff)
- *
- * @param modifiedFiles Array of modified files
- * @param maxTokens Maximum tokens to use (default: 8000)
- * @returns Truncated array of modified files
- */
-export function truncateModifiedFiles(
-  modifiedFiles: GitDiffInfo[],
-  maxTokens: number = 8000
-): GitDiffInfo[] {
-  const maxChars = maxTokens * 4; // Approximate token-to-char ratio
-  let currentChars = 0;
-  const truncated: GitDiffInfo[] = [];
-
-  for (const file of modifiedFiles) {
-    const fileChars = file.content.length + file.file.length + 50; // File metadata
-
-    if (currentChars + fileChars > maxChars) {
-      // Truncate this file's diff
-      const remainingChars = maxChars - currentChars;
-      if (remainingChars > 200) {
-        // Only include if we can show at least 200 chars
-        const truncatedContent = file.content.slice(0, remainingChars - 50) + '\n... (diff truncated)';
-        truncated.push({
-          ...file,
-          content: truncatedContent
-        });
-      }
-      break;
-    }
-
-    truncated.push(file);
-    currentChars += fileChars;
-  }
-
-  return truncated;
-}
-
-/**
- * Build a simplified prompt for very large changes
- * Used when full diff exceeds reasonable token budget
- *
- * @param options Prompt options (same as buildReflectionPrompt)
- * @returns Simplified prompt with file list only (no diffs)
- */
-export function buildSimplifiedPrompt(options: {
-  taskId: string;
-  taskName?: string;
-  modifiedFiles: GitDiffInfo[];
-  config: ReflectionConfig;
-  incrementId?: string;
-}): string {
-  // Build prompt without full diff content
-  return buildReflectionPrompt({
-    ...options,
-    includeFullDiff: false
-  });
-}

package/plugins/specweave/lib/hooks/reflection-storage.d.ts

@@ -1,64 +0,0 @@
-/**
- * Reflection Storage Manager
- *
- * Writes reflection results to markdown files in increment logs
- * Stores reflections in .specweave/increments/{id}/logs/reflections/
- *
- * @module reflection-storage
- */
-import { ReflectionResult } from './types/reflection-types';
-/**
- * Generate markdown content from reflection result
- * Follows the exact format specified in reflective-reviewer agent
- *
- * @param result Reflection result object
- * @returns Markdown-formatted reflection content
- */
-export declare function generateReflectionMarkdown(result: ReflectionResult): string;
-/**
- * Get reflection log directory for an increment
- * @param incrementId Increment identifier (e.g., "0016-self-reflection-system")
- * @param projectRoot Project root directory (optional, auto-detected if not provided)
- * @returns Path to reflection logs directory
- */
-export declare function getReflectionLogDir(incrementId: string, projectRoot?: string): string;
-/**
- * Generate filename for reflection log
- * @param taskId Task identifier (e.g., "T-005")
- * @param timestamp Optional timestamp (defaults to current date)
- * @returns Filename (e.g., "task-T-005-reflection-2025-11-10.md")
- */
-export declare function getReflectionFilename(taskId: string, timestamp?: Date): string;
-/**
- * Save reflection result to markdown file
- * Creates directory structure if it doesn't exist
- *
- * @param result Reflection result to save
- * @param incrementId Increment identifier
- * @param taskId Task identifier
- * @param projectRoot Project root directory (optional)
- * @returns Path to saved reflection file
- * @throws Error if file cannot be written
- */
-export declare function saveReflection(result: ReflectionResult, incrementId: string, taskId: string, projectRoot?: string): string;
-/**
- * List all reflection files for an increment
- * @param incrementId Increment identifier
- * @param projectRoot Project root directory (optional)
- * @returns Array of reflection file paths (sorted by date, newest first)
- */
-export declare function listReflections(incrementId: string, projectRoot?: string): string[];
-/**
- * Read reflection from file
- * @param filepath Path to reflection markdown file
- * @returns Markdown content as string
- * @throws Error if file cannot be read
- */
-export declare function readReflection(filepath: string): string;
-/**
- * Delete reflection file
- * @param filepath Path to reflection markdown file
- * @throws Error if file cannot be deleted
- */
-export declare function deleteReflection(filepath: string): void;
-//# sourceMappingURL=reflection-storage.d.ts.map

package/plugins/specweave/lib/hooks/reflection-storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflection-storage.d.ts","sourceRoot":"","sources":["reflection-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,gBAAgB,EAAiB,MAAM,0BAA0B,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0N3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,IAAI,GACf,MAAM,CAKR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAmBR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,EAAE,CAkBV;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMvD"}