specweave 0.8.19 → 0.8.20

package/plugins/specweave-ado/lib/project-selector.js

@@ -0,0 +1,211 @@
+/**
+ * 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 inquirer from 'inquirer';
+// ============================================================================
+// ADO Project Fetching
+// ============================================================================
+/**
+ * Fetch all ADO projects from API
+ */
+export async function fetchAllAdoProjects(client) {
+    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.message);
+        throw error;
+    }
+}
+// ============================================================================
+// Interactive Project Selection
+// ============================================================================
+/**
+ * Interactive project selector with search and pagination
+ */
+export async function selectAdoProjects(client, options = {}) {
+    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 inquirer.prompt([
+        {
+            type: 'list',
+            name: 'selectionMethod',
+            message: 'How would you like to select projects?',
+            choices: [
+                {
+                    name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
+                    value: 'interactive',
+                },
+                {
+                    name: '✏️  Manual entry (type project names)',
+                    value: 'manual',
+                },
+                ...(allowSelectAll
+                    ? [
+                        {
+                            name: `✨ Select all (${allProjects.length} projects)`,
+                            value: 'all',
+                        },
+                    ]
+                    : []),
+            ],
+        },
+    ]);
+    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, preSelected, minSelection, maxSelection, pageSize) {
+    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 manual entry option at the end
+    choices.push(new inquirer.Separator(), {
+        name: '✏️  Enter project names manually instead',
+        value: '__MANUAL__',
+        checked: false,
+    });
+    const { selectedNames } = await inquirer.prompt([
+        {
+            type: 'checkbox',
+            name: 'selectedNames',
+            message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
+            choices,
+            pageSize,
+            loop: false,
+            validate: (selected) => {
+                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, minSelection, maxSelection) {
+    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 inquirer.prompt([
+        {
+            type: 'input',
+            name: 'manualNames',
+            message: 'Project names:',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return 'Please enter at least one project name';
+                }
+                const names = input
+                    .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) => n.trim())
+        .filter((n) => 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) {
+    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, message = 'Select Azure DevOps project:') {
+    const result = await selectAdoProjects(client, {
+        allowManualEntry: true,
+        allowSelectAll: false,
+        minSelection: 1,
+        maxSelection: 1,
+    });
+    return result.selectedNames[0];
+}
+//# sourceMappingURL=project-selector.js.map

package/plugins/specweave-ado/lib/project-selector.js.map

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

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

@@ -0,0 +1,317 @@
+/**
+ * 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 inquirer from 'inquirer';
+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 inquirer.prompt([
+    {
+      type: 'list',
+      name: 'selectionMethod',
+      message: 'How would you like to select projects?',
+      choices: [
+        {
+          name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
+          value: 'interactive',
+        },
+        {
+          name: '✏️  Manual entry (type project names)',
+          value: 'manual',
+        },
+        ...(allowSelectAll
+          ? [
+              {
+                name: `✨ Select all (${allProjects.length} projects)`,
+                value: 'all',
+              },
+            ]
+          : []),
+      ],
+    },
+  ]);
+
+  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 manual entry option at the end
+  choices.push(
+    new inquirer.Separator(),
+    {
+      name: '✏️  Enter project names manually instead',
+      value: '__MANUAL__',
+      checked: false,
+    } as any
+  );
+
+  const { selectedNames } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'selectedNames',
+      message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
+      choices,
+      pageSize,
+      loop: false,
+      validate: (selected: 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 inquirer.prompt([
+    {
+      type: 'input',
+      name: 'manualNames',
+      message: 'Project names:',
+      validate: (input: string) => {
+        if (!input.trim()) {
+          return 'Please enter at least one project name';
+        }
+
+        const names = input
+          .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-github/lib/github-client.ts

@@ -327,4 +327,32 @@ export class GitHubClient {
   private sleep(ms: number): Promise<void> {
     return new Promise(resolve => setTimeout(resolve, ms));
   }
+
+  /**
+   * Get all repositories accessible to the user
+   * @param owner Optional: filter by specific owner/org (e.g., 'octocat', 'my-org')
+   * @param limit Maximum number of repos to fetch (default: 100, max: 1000)
+   */
+  static async getRepositories(owner?: string, limit: number = 100): Promise<Array<{owner: string, name: string, fullName: string}>> {
+    try {
+      const ownerFilter = owner ? `${owner}/` : '';
+      const cmd = `gh repo list ${ownerFilter} --limit ${limit} --json owner,name,nameWithOwner`;
+
+      const output = execSync(cmd, { encoding: 'utf-8' }).trim();
+
+      if (!output) {
+        return [];
+      }
+
+      const repos = JSON.parse(output);
+
+      return repos.map((repo: any) => ({
+        owner: repo.owner?.login || '',
+        name: repo.name,
+        fullName: repo.nameWithOwner
+      }));
+    } catch (error: any) {
+      throw new Error(`Failed to fetch repositories: ${error.message}`);
+    }
+  }
 }