specweave 0.23.0 → 0.23.2

package/plugins/specweave/lib/hooks/auto-transition.js.bak

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { AutoTransitionManager } from "../../../../dist/src/core/increment/auto-transition-manager.js";
+async function main() {
+  const event = process.argv[2];
+  const incrementId = process.argv[3];
+  const force = process.argv.includes("--force");
+  if (!event || !incrementId) {
+    console.error("Usage: auto-transition.ts <event> <increment-id> [--force]");
+    console.error("Events: spec-created, tasks-created, task-started, auto-correct");
+    console.error("Example: node auto-transition.ts spec-created 0039-ultra-smart-next-command");
+    process.exit(1);
+  }
+  const projectRoot = process.cwd();
+  const manager = new AutoTransitionManager(projectRoot);
+  let result;
+  try {
+    switch (event) {
+      case "spec-created":
+        result = await manager.handleSpecCreated(incrementId);
+        break;
+      case "tasks-created":
+        result = await manager.handleTasksCreated(incrementId);
+        break;
+      case "task-started":
+        result = await manager.handleTaskStarted(incrementId);
+        break;
+      case "auto-correct":
+        result = await manager.autoCorrect(incrementId, force);
+        break;
+      default:
+        console.error(`\u274C Unknown event: ${event}`);
+        console.error("Valid events: spec-created, tasks-created, task-started, auto-correct");
+        process.exit(1);
+    }
+    if (result.transitioned) {
+      console.log(`\u2705 Auto-transition: ${result.from} \u2192 ${result.to}`);
+      console.log(`   Reason: ${result.reason}`);
+    } else {
+      console.log(`\u2139\uFE0F  No transition: ${result.reason}`);
+    }
+    process.exit(0);
+  } catch (error) {
+    console.error("\u274C Auto-transition error:", error);
+    process.exit(1);
+  }
+}
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+  main();
+}

package/plugins/specweave/lib/hooks/auto-transition.ts.bak

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+/**
+ * Auto-Transition Hook Handler
+ *
+ * CLI wrapper for AutoTransitionManager
+ * Called by bash hooks to trigger status transitions
+ *
+ * Events:
+ * - spec-created: When spec.md is created (BACKLOG → PLANNING)
+ * - tasks-created: When tasks.md is created (PLANNING/BACKLOG → ACTIVE)
+ * - task-started: When first task is started (PLANNING → ACTIVE)
+ * - auto-correct: Fix status based on artifacts
+ *
+ * Usage:
+ *   node auto-transition.ts spec-created 0039-ultra-smart-next-command
+ *   node auto-transition.ts tasks-created 0039-ultra-smart-next-command
+ *   node auto-transition.ts task-started 0039-ultra-smart-next-command
+ *   node auto-transition.ts auto-correct 0039-ultra-smart-next-command
+ */
+
+import { AutoTransitionManager } from '../../../../dist/src/core/increment/auto-transition-manager.js';
+
+async function main() {
+  const event = process.argv[2];
+  const incrementId = process.argv[3];
+  const force = process.argv.includes('--force');
+
+  if (!event || !incrementId) {
+    console.error('Usage: auto-transition.ts <event> <increment-id> [--force]');
+    console.error('Events: spec-created, tasks-created, task-started, auto-correct');
+    console.error('Example: node auto-transition.ts spec-created 0039-ultra-smart-next-command');
+    process.exit(1);
+  }
+
+  const projectRoot = process.cwd();
+  const manager = new AutoTransitionManager(projectRoot);
+
+  let result;
+
+  try {
+    switch (event) {
+      case 'spec-created':
+        result = await manager.handleSpecCreated(incrementId);
+        break;
+
+      case 'tasks-created':
+        result = await manager.handleTasksCreated(incrementId);
+        break;
+
+      case 'task-started':
+        result = await manager.handleTaskStarted(incrementId);
+        break;
+
+      case 'auto-correct':
+        result = await manager.autoCorrect(incrementId, force);
+        break;
+
+      default:
+        console.error(`❌ Unknown event: ${event}`);
+        console.error('Valid events: spec-created, tasks-created, task-started, auto-correct');
+        process.exit(1);
+    }
+
+    // Display result
+    if (result.transitioned) {
+      console.log(`✅ Auto-transition: ${result.from} → ${result.to}`);
+      console.log(`   Reason: ${result.reason}`);
+    } else {
+      console.log(`ℹ️  No transition: ${result.reason}`);
+    }
+
+    process.exit(0);
+  } catch (error) {
+    console.error('❌ Auto-transition error:', error);
+    process.exit(1);
+  }
+}
+
+// Run if executed directly
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+  main();
+}

package/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts.bak

@@ -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.js.bak

@@ -0,0 +1,142 @@
+import { execSync } from "child_process";
+import fs from "fs-extra";
+import path from "path";
+function executeGitCommand(command, cwd) {
+  try {
+    return execSync(command, {
+      cwd: cwd || process.cwd(),
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+  } catch (error) {
+    throw new Error(`Git command failed: ${command}. ${error.message}`);
+  }
+}
+function isGitRepository(dir = process.cwd()) {
+  try {
+    executeGitCommand("git rev-parse --git-dir", dir);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getModifiedFilesList(cwd) {
+  if (!isGitRepository(cwd)) {
+    return [];
+  }
+  try {
+    const output = executeGitCommand("git diff --name-only HEAD", cwd);
+    if (!output.trim()) {
+      return [];
+    }
+    return output.trim().split("\n").filter((file) => file.length > 0).filter((file) => !file.startsWith(".git/"));
+  } catch {
+    return [];
+  }
+}
+function parseNumstat(numstatOutput) {
+  const stats = /* @__PURE__ */ new Map();
+  if (!numstatOutput.trim()) {
+    return stats;
+  }
+  const lines = numstatOutput.trim().split("\n");
+  for (const line of lines) {
+    const parts = line.split("	");
+    if (parts.length < 3) continue;
+    const added = parts[0] === "-" ? 0 : parseInt(parts[0], 10);
+    const removed = parts[1] === "-" ? 0 : parseInt(parts[1], 10);
+    const filename = parts[2];
+    stats.set(filename, { added, removed });
+  }
+  return stats;
+}
+function getFileDiff(file, cwd) {
+  if (!isGitRepository(cwd)) {
+    return "";
+  }
+  try {
+    const output = executeGitCommand(`git diff HEAD -- "${file}"`, cwd);
+    return output;
+  } catch {
+    return "";
+  }
+}
+function getFileContent(file, cwd) {
+  try {
+    const workingDir = cwd || process.cwd();
+    const absolutePath = path.isAbsolute(file) ? file : path.join(workingDir, file);
+    if (!fs.existsSync(absolutePath)) {
+      return "";
+    }
+    return fs.readFileSync(absolutePath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function getModifiedFiles(cwd, maxFiles = 100) {
+  if (!isGitRepository(cwd)) {
+    return [];
+  }
+  const workingDir = cwd || process.cwd();
+  const modifiedFiles = getModifiedFilesList(workingDir);
+  if (modifiedFiles.length === 0) {
+    return [];
+  }
+  const filesToAnalyze = modifiedFiles.slice(0, maxFiles);
+  let numstatOutput = "";
+  try {
+    numstatOutput = executeGitCommand("git diff --numstat HEAD", workingDir);
+  } catch {
+  }
+  const stats = parseNumstat(numstatOutput);
+  const result = [];
+  for (const file of filesToAnalyze) {
+    const fileStat = stats.get(file) || { added: 0, removed: 0 };
+    const diffContent = getFileDiff(file, workingDir);
+    if (fileStat.added > 0 || fileStat.removed > 0 || diffContent.length > 0) {
+      result.push({
+        file,
+        linesAdded: fileStat.added,
+        linesRemoved: fileStat.removed,
+        content: diffContent
+      });
+    }
+  }
+  return result;
+}
+function getModifiedFilesSummary(modifiedFiles) {
+  return {
+    count: modifiedFiles.length,
+    linesAdded: modifiedFiles.reduce((sum, file) => sum + file.linesAdded, 0),
+    linesRemoved: modifiedFiles.reduce((sum, file) => sum + file.linesRemoved, 0),
+    totalChanges: modifiedFiles.reduce(
+      (sum, file) => sum + file.linesAdded + file.linesRemoved,
+      0
+    )
+  };
+}
+function filterFilesByExtension(modifiedFiles, extensions) {
+  return modifiedFiles.filter((file) => {
+    const ext = path.extname(file.file).toLowerCase();
+    return extensions.some((allowedExt) => ext === allowedExt.toLowerCase());
+  });
+}
+function excludeFilesByPattern(modifiedFiles, patterns) {
+  return modifiedFiles.filter((file) => {
+    return !patterns.some((pattern) => {
+      const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+      return regex.test(file.file);
+    });
+  });
+}
+export {
+  excludeFilesByPattern,
+  filterFilesByExtension,
+  getFileContent,
+  getFileDiff,
+  getModifiedFiles,
+  getModifiedFilesList,
+  getModifiedFilesSummary,
+  isGitRepository,
+  parseNumstat
+};

package/plugins/specweave/lib/hooks/git-diff-analyzer.ts.bak

@@ -0,0 +1,269 @@
+/**
+ * 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 { execSync } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+import { GitDiffInfo } from './types/reflection-types';
+
+/**
+ * Execute git command safely
+ * @param command Git command to execute
+ * @param cwd Working directory (optional)
+ * @returns Command output as string
+ * @throws Error if command fails
+ */
+function executeGitCommand(command: string, cwd?: string): string {
+  try {
+    return execSync(command, {
+      cwd: cwd || process.cwd(),
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+  } catch (error: any) {
+    throw new Error(`Git command failed: ${command}. ${error.message}`);
+  }
+}
+
+/**
+ * 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 function isGitRepository(dir: string = process.cwd()): boolean {
+  try {
+    executeGitCommand('git rev-parse --git-dir', dir);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 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 function getModifiedFilesList(cwd?: string): string[] {
+  if (!isGitRepository(cwd)) {
+    return [];
+  }
+
+  try {
+    // Get both staged and unstaged changes
+    const output = executeGitCommand('git diff --name-only HEAD', cwd);
+
+    if (!output.trim()) {
+      return [];
+    }
+
+    return output
+      .trim()
+      .split('\n')
+      .filter(file => file.length > 0)
+      .filter(file => !file.startsWith('.git/')); // Exclude .git directory
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * 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 function parseNumstat(numstatOutput: string): Map<string, { added: number; removed: number }> {
+  const stats = new Map<string, { added: number; removed: number }>();
+
+  if (!numstatOutput.trim()) {
+    return stats;
+  }
+
+  const lines = numstatOutput.trim().split('\n');
+
+  for (const line of lines) {
+    const parts = line.split('\t');
+    if (parts.length < 3) continue;
+
+    const added = parts[0] === '-' ? 0 : parseInt(parts[0], 10);
+    const removed = parts[1] === '-' ? 0 : parseInt(parts[1], 10);
+    const filename = parts[2];
+
+    stats.set(filename, { added, removed });
+  }
+
+  return stats;
+}
+
+/**
+ * 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 function getFileDiff(file: string, cwd?: string): string {
+  if (!isGitRepository(cwd)) {
+    return '';
+  }
+
+  try {
+    // Get unified diff for the file
+    const output = executeGitCommand(`git diff HEAD -- "${file}"`, cwd);
+    return output;
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * 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 function getFileContent(file: string, cwd?: string): string {
+  try {
+    const workingDir = cwd || process.cwd();
+    const absolutePath = path.isAbsolute(file) ? file : path.join(workingDir, file);
+
+    if (!fs.existsSync(absolutePath)) {
+      return '';
+    }
+
+    return fs.readFileSync(absolutePath, 'utf-8');
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * 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 function getModifiedFiles(
+  cwd?: string,
+  maxFiles: number = 100
+): GitDiffInfo[] {
+  if (!isGitRepository(cwd)) {
+    return [];
+  }
+
+  const workingDir = cwd || process.cwd();
+
+  // Get list of modified files
+  const modifiedFiles = getModifiedFilesList(workingDir);
+
+  if (modifiedFiles.length === 0) {
+    return [];
+  }
+
+  // Limit number of files to prevent overwhelming the analysis
+  const filesToAnalyze = modifiedFiles.slice(0, maxFiles);
+
+  // Get line count statistics
+  let numstatOutput = '';
+  try {
+    numstatOutput = executeGitCommand('git diff --numstat HEAD', workingDir);
+  } catch {
+    // If numstat fails, continue with empty stats
+  }
+
+  const stats = parseNumstat(numstatOutput);
+
+  // Build GitDiffInfo array
+  const result: GitDiffInfo[] = [];
+
+  for (const file of filesToAnalyze) {
+    const fileStat = stats.get(file) || { added: 0, removed: 0 };
+    const diffContent = getFileDiff(file, workingDir);
+
+    // Only include files with actual changes
+    if (fileStat.added > 0 || fileStat.removed > 0 || diffContent.length > 0) {
+      result.push({
+        file,
+        linesAdded: fileStat.added,
+        linesRemoved: fileStat.removed,
+        content: diffContent
+      });
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 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 function getModifiedFilesSummary(modifiedFiles: GitDiffInfo[]): {
+  count: number;
+  linesAdded: number;
+  linesRemoved: number;
+  totalChanges: number;
+} {
+  return {
+    count: modifiedFiles.length,
+    linesAdded: modifiedFiles.reduce((sum, file) => sum + file.linesAdded, 0),
+    linesRemoved: modifiedFiles.reduce((sum, file) => sum + file.linesRemoved, 0),
+    totalChanges: modifiedFiles.reduce(
+      (sum, file) => sum + file.linesAdded + file.linesRemoved,
+      0
+    )
+  };
+}
+
+/**
+ * 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 function filterFilesByExtension(
+  modifiedFiles: GitDiffInfo[],
+  extensions: string[]
+): GitDiffInfo[] {
+  return modifiedFiles.filter(file => {
+    const ext = path.extname(file.file).toLowerCase();
+    return extensions.some(allowedExt => ext === allowedExt.toLowerCase());
+  });
+}
+
+/**
+ * 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 function excludeFilesByPattern(
+  modifiedFiles: GitDiffInfo[],
+  patterns: string[]
+): GitDiffInfo[] {
+  return modifiedFiles.filter(file => {
+    return !patterns.some(pattern => {
+      // Simple pattern matching (supports * wildcard)
+      const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+      return regex.test(file.file);
+    });
+  });
+}

package/plugins/specweave/lib/hooks/invoke-translator-skill.d.ts.bak

@@ -0,0 +1,60 @@
+/**
+ * Translator Skill Invocation Utility
+ *
+ * Provides programmatic invocation of the translator skill for automated translation.
+ * Used by hooks and CLI scripts to translate content without manual intervention.
+ *
+ * @see plugins/specweave/skills/translator/SKILL.md
+ * @see plugins/specweave/commands/translate.md
+ */
+import { type SupportedLanguage } from '../../../../src/utils/translation.js';
+/**
+ * Translation result
+ */
+export interface TranslationResult {
+    success: boolean;
+    sourceLanguage: SupportedLanguage;
+    targetLanguage: SupportedLanguage;
+    originalContent: string;
+    translatedContent?: string;
+    error?: string;
+}
+/**
+ * Invokes translator skill to translate content
+ *
+ * This function integrates with the translator skill by:
+ * 1. Preparing translation prompt
+ * 2. Writing prompt to a temp file
+ * 3. Outputting instructions for Claude to process
+ * 4. Returning the translated content
+ *
+ * In an automated context (hooks), this provides clear instructions.
+ * In an interactive context, the translator skill can auto-activate.
+ *
+ * @param content - Content to translate
+ * @param sourceLang - Source language
+ * @param targetLang - Target language
+ * @returns Translation result
+ */
+export declare function invokeTranslatorSkill(content: string, sourceLang: SupportedLanguage, targetLang?: SupportedLanguage): Promise<TranslationResult>;
+/**
+ * Translate a file using translator skill
+ *
+ * @param filePath - Path to file to translate
+ * @param targetLang - Target language
+ * @returns Translation result
+ */
+export declare function translateFile(filePath: string, targetLang?: SupportedLanguage): Promise<TranslationResult & {
+    filePath: string;
+}>;
+/**
+ * Batch translate multiple files
+ *
+ * @param filePaths - Array of file paths
+ * @param targetLang - Target language
+ * @returns Array of translation results
+ */
+export declare function batchTranslateFiles(filePaths: string[], targetLang?: SupportedLanguage): Promise<Array<TranslationResult & {
+    filePath: string;
+}>>;
+//# sourceMappingURL=invoke-translator-skill.d.ts.map