specweave 1.0.593 → 2.0.3

package/plugins/specweave/lib/hooks/sync-us-tasks.js

@@ -1,476 +0,0 @@
-#!/usr/bin/env node
-/**
- * US-Task Synchronization Module
- *
- * Syncs task completion status from tasks.md to living docs User Story files.
- * Updates:
- * - Task lists in US files (replaces "No tasks defined")
- * - AC checkboxes based on task completion
- *
- * Part of increment 0047-us-task-linkage implementation.
- */
-
-import { readFileSync, existsSync, promises as fs } from 'fs';
-import path from 'path';
-import { parseTasksWithUSLinks, getAllTasks } from '../vendor/generators/spec/task-parser.js';
-import { glob } from 'glob';
-import { getCachedTasks, needsSync, recordSync, batchFileUpdates } from './sync-cache.js';
-
-/**
- * Sync tasks from tasks.md to living docs User Story files
- *
- * @param {string} incrementId - Increment ID (e.g., "0047-us-task-linkage")
- * @param {string} projectRoot - Project root directory
- * @param {string} featureId - Feature ID (e.g., "FS-047")
- * @param {object} options - Sync options
- * @returns {Promise<SyncResult>} Sync result
- */
-export async function syncUSTasksToLivingDocs(incrementId, projectRoot, featureId, options = {}) {
-  try {
-    console.log(`   📋 Syncing tasks to living docs User Stories...`);
-
-    const tasksPath = path.join(projectRoot, '.specweave', 'increments', incrementId, 'tasks.md');
-
-    // Check if tasks.md exists
-    if (!existsSync(tasksPath)) {
-      console.log(`   ⚠️  tasks.md not found, skipping task sync`);
-      return { success: true, updatedFiles: [], errors: [] };
-    }
-
-    // Parse tasks with US linkage (with caching for performance)
-    let tasksByUS;
-    try {
-      tasksByUS = getCachedTasks(tasksPath, parseTasksWithUSLinks);
-    } catch (error) {
-      console.error(`   ❌ Failed to parse tasks.md:`, error.message);
-      return { success: false, updatedFiles: [], errors: [error.message] };
-    }
-
-    const allTasks = getAllTasks(tasksByUS);
-    console.log(`   ✓ Parsed ${allTasks.length} tasks from tasks.md`);
-
-    // Check for tasks without US linkage (backward compatibility)
-    const unassignedTasks = tasksByUS['unassigned'] || [];
-    if (unassignedTasks.length > 0) {
-      console.log(`   ⚠️  ${unassignedTasks.length} tasks without User Story linkage (old format)`);
-    }
-
-    // Get project ID (default to "specweave" for now, can be enhanced later)
-    const projectId = getProjectId(projectRoot, incrementId) || 'specweave';
-
-    const updatedFiles = [];
-    const errors = [];
-    const filesToUpdate = []; // Batch file updates
-
-    // For each User Story with tasks, update its living docs file
-    for (const [usId, tasks] of Object.entries(tasksByUS)) {
-      if (usId === 'unassigned') continue; // Skip unassigned tasks
-
-      try {
-        // Find US file in living docs
-        const usFilePath = await findUSFile(projectRoot, projectId, featureId, usId);
-
-        if (!usFilePath) {
-          console.log(`   ⚠️  Living docs file not found for ${usId}, skipping`);
-          continue;
-        }
-
-        // Incremental sync: Check if sync is needed
-        if (!needsSync(usFilePath, tasks, tasksPath)) {
-          console.log(`   ⏭️  ${usId} unchanged, skipping sync`);
-          continue;
-        }
-
-        // Update US file with task list
-        const result = await updateUSFile(usFilePath, tasks, incrementId);
-
-        if (result.updated) {
-          filesToUpdate.push({ path: usFilePath, content: result.content });
-          recordSync(usFilePath, tasks); // Cache sync result for next run
-          console.log(`   ✓ Prepared update for ${usId} (${tasks.length} tasks)`);
-        }
-      } catch (error) {
-        console.error(`   ❌ Error updating ${usId}:`, error.message);
-        errors.push(`${usId}: ${error.message}`);
-      }
-    }
-
-    // Batch write all file updates (reduce I/O)
-    if (filesToUpdate.length > 0) {
-      await batchFileUpdates(filesToUpdate);
-      updatedFiles.push(...filesToUpdate.map(f => f.path));
-    }
-
-    if (updatedFiles.length > 0) {
-      console.log(`   ✅ Updated ${updatedFiles.length} User Story file(s)`);
-    } else {
-      console.log(`   ℹ️  No User Story files updated`);
-    }
-
-    return {
-      success: errors.length === 0,
-      updatedFiles,
-      errors
-    };
-  } catch (error) {
-    console.error(`   ❌ US-Task sync failed:`, error);
-    return { success: false, updatedFiles: [], errors: [error.message] };
-  }
-}
-
-/**
- * Find User Story file in living docs
- *
- * @param {string} projectRoot - Project root
- * @param {string} projectId - Project ID (e.g., "specweave")
- * @param {string} featureId - Feature ID (e.g., "FS-047")
- * @param {string} usId - User Story ID (e.g., "US-001")
- * @returns {Promise<string|null>} Path to US file or null if not found
- */
-async function findUSFile(projectRoot, projectId, featureId, usId) {
-  // Pattern: .specweave/docs/internal/specs/{project}/{feature}/us-{id}-*.md
-  const pattern = path.join(
-    projectRoot,
-    '.specweave',
-    'docs',
-    'internal',
-    'specs',
-    projectId,
-    featureId,
-    `${usId.toLowerCase()}-*.md`
-  );
-
-  const files = await glob(pattern);
-
-  if (files.length === 0) {
-    return null;
-  }
-
-  if (files.length > 1) {
-    console.log(`   ⚠️  Multiple files found for ${usId}, using first: ${path.basename(files[0])}`);
-  }
-
-  return files[0];
-}
-
-/**
- * Update User Story file with task list and AC checkboxes
- *
- * @param {string} usFilePath - Path to US markdown file
- * @param {Array} tasks - Tasks linked to this US
- * @param {string} incrementId - Increment ID
- * @returns {Promise<{updated: boolean, content: string}>} Update result
- */
-async function updateUSFile(usFilePath, tasks, incrementId) {
-  let content = await fs.readFile(usFilePath, 'utf-8');
-  let updated = false;
-
-  // 1. Update origin badge (NEW - T-034)
-  const updatedOrigin = updateOriginBadge(content, usFilePath);
-  if (updatedOrigin !== content) {
-    content = updatedOrigin;
-    updated = true;
-  }
-
-  // 2. Update task list section
-  const taskList = generateTaskList(tasks, incrementId);
-  const newTasksSection = `## Tasks\n\n${taskList}`;
-
-  // Replace existing tasks section
-  if (content.includes('## Tasks')) {
-    // Replace everything from "## Tasks" to next "##" or end of file
-    const tasksRegex = /(## Tasks\n\n)(?:.*?)(?=\n## |\n---\n|$)/s;
-    const newContent = content.replace(tasksRegex, newTasksSection);
-
-    if (newContent !== content) {
-      content = newContent;
-      updated = true;
-    }
-  }
-
-  // 3. Update AC checkboxes based on task completion
-  const updatedACs = updateACCheckboxes(content, tasks);
-  if (updatedACs !== content) {
-    content = updatedACs;
-    updated = true;
-  }
-
-  return { updated, content };
-}
-
-/**
- * Update origin badge in User Story file
- * Detects origin from US ID (E suffix = external)
- *
- * @param {string} content - US file content
- * @param {string} usFilePath - Path to US file
- * @returns {string} Updated content with origin badge
- */
-function updateOriginBadge(content, usFilePath) {
-  // Extract US ID from filename (e.g., us-001e-title.md -> US-001E)
-  const filename = path.basename(usFilePath);
-  const usIdMatch = filename.match(/^(us-\d{3}e?)-/i);
-
-  if (!usIdMatch) {
-    return content; // Can't determine US ID, skip
-  }
-
-  const usId = usIdMatch[1].toUpperCase();
-  const isExternal = usId.endsWith('E');
-
-  // Validate origin immutability (prevent internal ↔ external changes)
-  const existingOrigin = extractExistingOrigin(content);
-  if (existingOrigin) {
-    const existingIsExternal = existingOrigin !== 'internal';
-    if (isExternal !== existingIsExternal) {
-      console.log(`   ⚠️  Origin immutable: Cannot change ${usId} from ${existingOrigin} to ${isExternal ? 'external' : 'internal'}`);
-      return content; // Don't modify origin
-    }
-  }
-
-  // Determine origin badge
-  let originBadge;
-  if (isExternal) {
-    // Try to detect external source from metadata
-    const externalSource = detectExternalSource(content);
-    originBadge = getExternalOriginBadge(externalSource, content);
-  } else {
-    originBadge = '🏠 **Internal**';
-  }
-
-  // Check if origin badge already exists
-  const originPattern = /\*\*Origin\*\*:\s*.*/;
-  if (originPattern.test(content)) {
-    // Replace existing origin badge
-    return content.replace(originPattern, `**Origin**: ${originBadge}`);
-  }
-
-  // Add origin badge after frontmatter (if exists) or at beginning
-  const frontmatterEnd = content.match(/^---\n.*?\n---\n/s);
-  if (frontmatterEnd) {
-    const insertPos = frontmatterEnd[0].length;
-    return content.slice(0, insertPos) + `\n**Origin**: ${originBadge}\n\n` + content.slice(insertPos);
-  }
-
-  // No frontmatter, add at beginning after title
-  const titleMatch = content.match(/^#\s+.+\n/);
-  if (titleMatch) {
-    const insertPos = titleMatch[0].length;
-    return content.slice(0, insertPos) + `\n**Origin**: ${originBadge}\n\n` + content.slice(insertPos);
-  }
-
-  // Fallback: add at very beginning
-  return `**Origin**: ${originBadge}\n\n` + content;
-}
-
-/**
- * Extract existing origin from content (for immutability validation)
- *
- * @param {string} content - US file content
- * @returns {string|null} Existing origin (internal, github, jira, ado) or null
- */
-function extractExistingOrigin(content) {
-  const originMatch = content.match(/\*\*Origin\*\*:\s*(.+)/);
-  if (!originMatch) {
-    return null;
-  }
-
-  const originText = originMatch[1].toLowerCase();
-  if (originText.includes('internal')) {
-    return 'internal';
-  }
-  if (originText.includes('github')) {
-    return 'github';
-  }
-  if (originText.includes('jira')) {
-    return 'jira';
-  }
-  if (originText.includes('ado') || originText.includes('azure')) {
-    return 'ado';
-  }
-  if (originText.includes('external')) {
-    return 'external'; // Generic external
-  }
-
-  return null;
-}
-
-/**
- * Detect external source from content metadata
- *
- * @param {string} content - US file content
- * @returns {string} External source (github, jira, ado) or 'unknown'
- */
-function detectExternalSource(content) {
-  // Check frontmatter for external_source or externalSource
-  const frontmatterMatch = content.match(/^---\n(.*?)\n---/s);
-  if (frontmatterMatch) {
-    const frontmatter = frontmatterMatch[1];
-    if (frontmatter.includes('external_source: github') || frontmatter.includes('externalSource: github')) {
-      return 'github';
-    }
-    if (frontmatter.includes('external_source: jira') || frontmatter.includes('externalSource: jira')) {
-      return 'jira';
-    }
-    if (frontmatter.includes('external_source: ado') || frontmatter.includes('externalSource: ado')) {
-      return 'ado';
-    }
-  }
-
-  // Check for external ID patterns
-  if (content.includes('externalId: GH-') || content.includes('external_id: GH-')) {
-    return 'github';
-  }
-  if (content.includes('externalId: JIRA-') || content.includes('external_id: JIRA-')) {
-    return 'jira';
-  }
-  if (content.includes('externalId: ADO-') || content.includes('external_id: ADO-')) {
-    return 'ado';
-  }
-
-  return 'unknown';
-}
-
-/**
- * Get external origin badge with link if available
- *
- * @param {string} source - External source (github, jira, ado)
- * @param {string} content - US file content
- * @returns {string} Origin badge markdown
- */
-function getExternalOriginBadge(source, content) {
-  // Extract external ID and URL from content
-  const externalIdMatch = content.match(/external_?[iI]d:\s*([^\n]+)/);
-  const externalUrlMatch = content.match(/external_?[uU]rl:\s*([^\n]+)/);
-
-  const externalId = externalIdMatch ? externalIdMatch[1].trim() : null;
-  const externalUrl = externalUrlMatch ? externalUrlMatch[1].trim() : null;
-
-  switch (source) {
-    case 'github':
-      if (externalId && externalUrl) {
-        return `🔗 [GitHub ${externalId}](${externalUrl})`;
-      }
-      return '🔗 **GitHub**';
-    case 'jira':
-      if (externalId && externalUrl) {
-        return `🎫 [JIRA ${externalId}](${externalUrl})`;
-      }
-      return '🎫 **JIRA**';
-    case 'ado':
-      if (externalId && externalUrl) {
-        return `📋 [ADO ${externalId}](${externalUrl})`;
-      }
-      return '📋 **Azure DevOps**';
-    default:
-      return '🔗 **External**';
-  }
-}
-
-/**
- * Generate task list markdown
- *
- * @param {Array} tasks - Tasks to list
- * @param {string} incrementId - Increment ID
- * @returns {string} Markdown task list
- */
-function generateTaskList(tasks, incrementId) {
-  if (tasks.length === 0) {
-    return '_No tasks defined for this user story_';
-  }
-
-  return tasks.map(task => {
-    const checkbox = task.status === 'completed' ? 'x' : ' ';
-    const link = `../../../../increments/${incrementId}/tasks.md#${task.id}`;
-    return `- [${checkbox}] [${task.id}](${link}): ${task.title}`;
-  }).join('\n');
-}
-
-/**
- * Update AC checkboxes based on task completion
- *
- * @param {string} content - US file content
- * @param {Array} tasks - Tasks linked to this US
- * @returns {string} Updated content
- */
-function updateACCheckboxes(content, tasks) {
-  // Collect all AC-IDs satisfied by completed tasks
-  const satisfiedACs = new Set();
-
-  tasks.forEach(task => {
-    if (task.status === 'completed' && task.satisfiesACs) {
-      task.satisfiesACs.forEach(acId => satisfiedACs.add(acId));
-    }
-  });
-
-  // Update AC checkboxes
-  let updatedContent = content;
-
-  satisfiedACs.forEach(acId => {
-    // Replace: - [ ] **AC-US1-01** with - [x] **AC-US1-01**
-    const uncheckedRegex = new RegExp(`- \\[ \\] \\*\\*${escapeRegex(acId)}\\*\\*`, 'g');
-    updatedContent = updatedContent.replace(uncheckedRegex, `- [x] **${acId}**`);
-  });
-
-  // Also uncheck ACs that are no longer satisfied (tasks incomplete/pending)
-  // Extract all AC-IDs from content
-  const acPattern = /- \[[x ]\] \*\*(AC-US\d+-\d{2})\*\*/g;
-  let match;
-  const allACs = [];
-
-  while ((match = acPattern.exec(content)) !== null) {
-    allACs.push(match[1]);
-  }
-
-  // Uncheck ACs not in satisfiedACs set
-  allACs.forEach(acId => {
-    if (!satisfiedACs.has(acId)) {
-      const checkedRegex = new RegExp(`- \\[x\\] \\*\\*${escapeRegex(acId)}\\*\\*`, 'g');
-      updatedContent = updatedContent.replace(checkedRegex, `- [ ] **${acId}**`);
-    }
-  });
-
-  return updatedContent;
-}
-
-/**
- * Escape special regex characters
- */
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-/**
- * Get project ID from metadata or config
- *
- * @param {string} projectRoot - Project root
- * @param {string} incrementId - Increment ID
- * @returns {string|null} Project ID or null
- */
-function getProjectId(projectRoot, incrementId) {
-  try {
-    // Try to get from metadata.json
-    const metadataPath = path.join(projectRoot, '.specweave', 'increments', incrementId, 'metadata.json');
-    if (existsSync(metadataPath)) {
-      const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
-      if (metadata.project) {
-        return metadata.project;
-      }
-    }
-
-    // Try to get from config.json
-    const configPath = path.join(projectRoot, '.specweave', 'config.json');
-    if (existsSync(configPath)) {
-      const config = JSON.parse(readFileSync(configPath, 'utf-8'));
-      if (config.defaultProject) {
-        return config.defaultProject;
-      }
-    }
-
-    // Default to "specweave" (single-project mode)
-    return 'specweave';
-  } catch (error) {
-    console.log(`   ⚠️  Could not determine project ID, using default: "specweave"`);
-    return 'specweave';
-  }
-}

package/plugins/specweave/lib/hooks/translate-file.d.ts

@@ -1,59 +0,0 @@
-/**
- * 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 sw: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/plugins/specweave/lib/hooks/translate-file.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"translate-file.d.ts","sourceRoot":"","sources":["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"}