specweave 1.0.506 → 1.0.508

package/plugins/specweave/lib/integrations/ado/project-selector.ts

@@ -0,0 +1,304 @@
+/**
+ * ADO Project Selector with Pagination
+ *
+ * Features:
+ * - Fetches all ADO projects via API
+ * - Interactive multi-select with search
+ * - Manual project name entry (comma-separated)
+ * - Handles large project lists (50+ projects)
+ * - Validates project names
+ */
+
+import { select, checkbox, input, Separator } from '@inquirer/prompts';
+import { AdoClient } from '../../../../../src/integrations/ado/ado-client.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface ProjectSelectionResult {
+  selectedNames: string[];
+  method: 'interactive' | 'manual' | 'all';
+}
+
+export interface ProjectSelectorOptions {
+  /** Allow manual entry of project names */
+  allowManualEntry?: boolean;
+
+  /** Allow "Select All" option */
+  allowSelectAll?: boolean;
+
+  /** Pre-select these project names */
+  preSelected?: string[];
+
+  /** Minimum projects to select (0 = optional) */
+  minSelection?: number;
+
+  /** Maximum projects to select (undefined = unlimited) */
+  maxSelection?: number;
+
+  /** Page size for pagination */
+  pageSize?: number;
+}
+
+// ============================================================================
+// ADO Project Fetching
+// ============================================================================
+
+/**
+ * Fetch all ADO projects from API
+ */
+export async function fetchAllAdoProjects(
+  client: AdoClient
+): Promise<any[]> {
+  console.log('🔍 Fetching Azure DevOps projects...');
+
+  try {
+    const projects = await client.getProjects();
+
+    console.log(`✅ Found ${projects.length} Azure DevOps projects\n`);
+
+    return projects;
+  } catch (error) {
+    console.error('❌ Failed to fetch ADO projects:', (error as Error).message);
+    throw error;
+  }
+}
+
+// ============================================================================
+// Interactive Project Selection
+// ============================================================================
+
+/**
+ * Interactive project selector with search and pagination
+ */
+export async function selectAdoProjects(
+  client: AdoClient,
+  options: ProjectSelectorOptions = {}
+): Promise<ProjectSelectionResult> {
+  const {
+    allowManualEntry = true,
+    allowSelectAll = true,
+    preSelected = [],
+    minSelection = 1,
+    maxSelection,
+    pageSize = 15,
+  } = options;
+
+  // Fetch all projects
+  const allProjects = await fetchAllAdoProjects(client);
+
+  if (allProjects.length === 0) {
+    console.log('⚠️  No Azure DevOps projects found');
+    return {
+      selectedNames: [],
+      method: 'interactive',
+    };
+  }
+
+  // Show project overview
+  console.log('📋 Available Azure DevOps Projects:\n');
+  console.log(`   Total: ${allProjects.length} projects\n`);
+
+  // Decide selection method
+  const selectionMethod = await select({
+    message: 'How would you like to select projects?',
+    choices: [
+      {
+        name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
+        value: 'interactive' as const,
+      },
+      {
+        name: '✏️  Manual entry (type project names)',
+        value: 'manual' as const,
+      },
+      ...(allowSelectAll
+        ? [
+            {
+              name: `✨ Select all (${allProjects.length} projects)`,
+              value: 'all' as const,
+            },
+          ]
+        : []),
+    ],
+  });
+
+  if (selectionMethod === 'all') {
+    return {
+      selectedNames: allProjects.map((p) => p.name),
+      method: 'all',
+    };
+  }
+
+  if (selectionMethod === 'manual') {
+    return await manualProjectEntry(allProjects, minSelection, maxSelection);
+  }
+
+  // Interactive selection
+  return await interactiveProjectSelection(
+    allProjects,
+    preSelected,
+    minSelection,
+    maxSelection,
+    pageSize
+  );
+}
+
+/**
+ * Interactive project selection with checkbox
+ */
+async function interactiveProjectSelection(
+  allProjects: any[],
+  preSelected: string[],
+  minSelection: number,
+  maxSelection: number | undefined,
+  pageSize: number
+): Promise<ProjectSelectionResult> {
+  console.log('💡 Use <space> to select, <a> to toggle all, <i> to invert\n');
+
+  const choices = [
+    ...allProjects.map((p) => ({
+      name: formatProjectChoice(p),
+      value: p.name,
+      checked: preSelected.includes(p.name),
+    })),
+    // Add separator and manual entry option at the end
+    new Separator(),
+    {
+      name: '✏️  Enter project names manually instead',
+      value: '__MANUAL__',
+      checked: false,
+    },
+  ];
+
+  const selectedNames = await checkbox({
+    message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
+    choices,
+    pageSize,
+    loop: false,
+    validate: (selected: readonly string[]) => {
+      const actualSelected = selected.filter((k) => k !== '__MANUAL__');
+
+      if (actualSelected.length < minSelection) {
+        return `Please select at least ${minSelection} project(s)`;
+      }
+
+      if (maxSelection && actualSelected.length > maxSelection) {
+        return `Please select at most ${maxSelection} project(s)`;
+      }
+
+      return true;
+    },
+  });
+
+  // Check if user chose manual entry
+  if (selectedNames.includes('__MANUAL__')) {
+    return await manualProjectEntry(allProjects, minSelection, maxSelection);
+  }
+
+  console.log(`\n✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
+
+  return {
+    selectedNames,
+    method: 'interactive',
+  };
+}
+
+/**
+ * Manual project name entry (comma-separated)
+ */
+async function manualProjectEntry(
+  allProjects: any[],
+  minSelection: number,
+  maxSelection: number | undefined
+): Promise<ProjectSelectionResult> {
+  console.log('\n📝 Enter project names manually\n');
+  console.log('💡 Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n');
+
+  if (allProjects.length > 0) {
+    console.log('Available project names:');
+    console.log(
+      allProjects
+        .map((p) => p.name)
+        .join(', ')
+        .substring(0, 100) + (allProjects.length > 20 ? '...' : '')
+    );
+    console.log('');
+  }
+
+  const manualNames = await input({
+    message: 'Project names:',
+    validate: (inputValue: string) => {
+      if (!inputValue.trim()) {
+        return 'Please enter at least one project name';
+      }
+
+      const names = inputValue
+        .split(',')
+        .map((n) => n.trim())
+        .filter((n) => n.length > 0);
+
+      if (names.length < minSelection) {
+        return `Please enter at least ${minSelection} project name(s)`;
+      }
+
+      if (maxSelection && names.length > maxSelection) {
+        return `Please enter at most ${maxSelection} project name(s)`;
+      }
+
+      return true;
+    },
+  });
+
+  const selectedNames = manualNames
+    .split(',')
+    .map((n: string) => n.trim())
+    .filter((n: string) => n.length > 0);
+
+  // Warn about unknown projects
+  const knownNames = allProjects.map((p) => p.name);
+  const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
+
+  if (unknownNames.length > 0) {
+    console.log(`\n⚠️  Unknown project names (will be used anyway): ${unknownNames.join(', ')}`);
+    console.log('   Make sure these projects exist in your Azure DevOps organization.\n');
+  }
+
+  console.log(`✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
+
+  return {
+    selectedNames,
+    method: 'manual',
+  };
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Format project choice for display
+ */
+function formatProjectChoice(project: any): string {
+  const visibility = project.visibility || 'private';
+  const state = project.state || 'wellFormed';
+
+  return `${project.name.padEnd(30)} - ${project.description || 'No description'} (${visibility}, ${state})`;
+}
+
+/**
+ * Quick project selector - select single project
+ */
+export async function selectSingleAdoProject(
+  client: AdoClient,
+  message: string = 'Select Azure DevOps project:'
+): Promise<string> {
+  const result = await selectAdoProjects(client, {
+    allowManualEntry: true,
+    allowSelectAll: false,
+    minSelection: 1,
+    maxSelection: 1,
+  });
+
+  return result.selectedNames[0];
+}

package/plugins/specweave/lib/integrations/github/CodeValidator.js

@@ -0,0 +1,195 @@
+import * as fs from "../../../../../src/utils/fs-native.js";
+import path from "path";
+class CodeValidator {
+  constructor(options = {}) {
+    this.options = {
+      minLines: options.minLines ?? 3,
+      minChars: options.minChars ?? 50,
+      projectRoot: options.projectRoot ?? process.cwd()
+    };
+  }
+  /**
+   * Validate that code exists for a task
+   *
+   * Extracts file paths from task description and verifies:
+   * 1. Files exist
+   * 2. Files have meaningful content
+   * 3. Files are not just stubs
+   *
+   * @param taskDescription - Task description with file paths
+   * @param taskId - Task ID for error messages
+   * @returns Validation result
+   */
+  async validateTask(taskDescription, taskId) {
+    const filePaths = this.extractFilePaths(taskDescription);
+    if (filePaths.length === 0) {
+      return {
+        taskId,
+        valid: true,
+        files: [],
+        reason: "No file paths specified in task description"
+      };
+    }
+    const fileResults = [];
+    let allValid = true;
+    const reasons = [];
+    for (const filePath of filePaths) {
+      const result = await this.validateFile(filePath);
+      fileResults.push(result);
+      if (!result.exists) {
+        allValid = false;
+        reasons.push(`File not found: ${filePath}`);
+      } else if (!result.hasContent) {
+        allValid = false;
+        reasons.push(`File has no meaningful content: ${filePath} (${result.reason})`);
+      }
+    }
+    return {
+      taskId,
+      valid: allValid,
+      files: fileResults,
+      reason: reasons.length > 0 ? reasons.join("; ") : void 0
+    };
+  }
+  /**
+   * Validate a single file
+   *
+   * @param filePath - Path to file (relative or absolute)
+   * @returns File validation result
+   */
+  async validateFile(filePath) {
+    const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(this.options.projectRoot, filePath);
+    const exists = await fs.pathExists(absolutePath);
+    if (!exists) {
+      return {
+        path: filePath,
+        exists: false,
+        hasContent: false,
+        lineCount: 0,
+        reason: "File does not exist"
+      };
+    }
+    const content = await fs.readFile(absolutePath, "utf-8");
+    const lines = content.split("\n");
+    const nonEmptyLines = lines.filter((line) => line.trim().length > 0);
+    if (nonEmptyLines.length < this.options.minLines) {
+      return {
+        path: filePath,
+        exists: true,
+        hasContent: false,
+        lineCount: nonEmptyLines.length,
+        reason: `Only ${nonEmptyLines.length} non-empty lines (minimum: ${this.options.minLines})`
+      };
+    }
+    const trimmedContent = content.trim();
+    if (trimmedContent.length < this.options.minChars) {
+      return {
+        path: filePath,
+        exists: true,
+        hasContent: false,
+        lineCount: nonEmptyLines.length,
+        reason: `Only ${trimmedContent.length} characters (minimum: ${this.options.minChars})`
+      };
+    }
+    const stubPatterns = [
+      /^\/\/\s*TODO:/i,
+      /^#\s*TODO:/i,
+      /^\s*throw new Error\(['"]Not implemented['"]\)/i,
+      /^\s*return null;?\s*$/m,
+      /^\s*pass\s*$/m,
+      // Python
+      /^\s*\.\.\.$/m
+      // TypeScript
+    ];
+    const isStub = stubPatterns.some((pattern) => pattern.test(trimmedContent));
+    if (isStub) {
+      return {
+        path: filePath,
+        exists: true,
+        hasContent: false,
+        lineCount: nonEmptyLines.length,
+        reason: "File contains stub/placeholder code"
+      };
+    }
+    return {
+      path: filePath,
+      exists: true,
+      hasContent: true,
+      lineCount: nonEmptyLines.length
+    };
+  }
+  /**
+   * Extract file paths from task description
+   *
+   * Supports multiple formats:
+   * - **Files**: src/foo.ts, src/bar.ts
+   * - **Files to create**: src/foo.ts
+   * - **Files to modify**: src/bar.ts
+   * - Inline code blocks with file paths
+   *
+   * @param description - Task description text
+   * @returns Array of file paths
+   */
+  extractFilePaths(description) {
+    const paths = /* @__PURE__ */ new Set();
+    const filesMatch = description.match(/\*\*Files\*\*:\s*([^\n]+)/i);
+    if (filesMatch) {
+      const filePaths = filesMatch[1].split(",").map((p) => p.trim());
+      filePaths.forEach((p) => paths.add(p));
+    }
+    const createMatch = description.match(/\*\*Files to create\*\*:\s*([^\n]+)/i);
+    if (createMatch) {
+      const filePaths = createMatch[1].split(",").map((p) => p.trim());
+      filePaths.forEach((p) => paths.add(p));
+    }
+    const modifyMatch = description.match(/\*\*Files to modify\*\*:\s*([^\n]+)/i);
+    if (modifyMatch) {
+      const filePaths = modifyMatch[1].split(",").map((p) => p.trim());
+      filePaths.forEach((p) => paths.add(p));
+    }
+    const inlineMatches = description.matchAll(/`([a-zA-Z0-9_\-./]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|h))`/g);
+    for (const match of inlineMatches) {
+      paths.add(match[1]);
+    }
+    const listMatches = description.matchAll(/^[-*]\s+([a-zA-Z0-9_\-./]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|h))/gm);
+    for (const match of listMatches) {
+      paths.add(match[1]);
+    }
+    return Array.from(paths);
+  }
+  /**
+   * Batch validate multiple tasks
+   *
+   * @param tasks - Array of {taskId, description}
+   * @returns Array of validation results
+   */
+  async validateTasks(tasks) {
+    const validationPromises = tasks.map(
+      (task) => this.validateTask(task.description, task.taskId)
+    );
+    return Promise.all(validationPromises);
+  }
+  /**
+   * Get summary of validation results
+   *
+   * @param results - Array of task validation results
+   * @returns Summary statistics
+   */
+  summarizeResults(results) {
+    const total = results.length;
+    const valid = results.filter((r) => r.valid).length;
+    const invalid = results.filter((r) => !r.valid).length;
+    const noFiles = results.filter((r) => r.files.length === 0).length;
+    const invalidTasks = results.filter((r) => !r.valid).map((r) => r.taskId);
+    return {
+      total,
+      valid,
+      invalid,
+      noFiles,
+      invalidTasks
+    };
+  }
+}
+export {
+  CodeValidator
+};