specweave 0.8.19 → 0.8.21

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}`);
+    }
+  }
 }

package/plugins/specweave-github/lib/repo-selector.ts

@@ -0,0 +1,329 @@
+/**
+ * GitHub Repository Selector with Pagination
+ *
+ * Features:
+ * - Fetches all GitHub repos via gh CLI
+ * - Interactive multi-select with search
+ * - Manual repo entry (comma-separated, format: owner/repo)
+ * - Handles large repo lists (50+ repos)
+ * - Validates repo names
+ */
+
+import inquirer from 'inquirer';
+import { GitHubClient } from './github-client.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface RepoSelectionResult {
+  selectedRepos: string[]; // Format: "owner/repo"
+  method: 'interactive' | 'manual' | 'all';
+}
+
+export interface RepoSelectorOptions {
+  /** Allow manual entry of repo names */
+  allowManualEntry?: boolean;
+
+  /** Allow "Select All" option */
+  allowSelectAll?: boolean;
+
+  /** Pre-select these repos (owner/repo format) */
+  preSelected?: string[];
+
+  /** Minimum repos to select (0 = optional) */
+  minSelection?: number;
+
+  /** Maximum repos to select (undefined = unlimited) */
+  maxSelection?: number;
+
+  /** Page size for pagination */
+  pageSize?: number;
+
+  /** Filter by owner/org */
+  owner?: string;
+
+  /** Maximum number of repos to fetch (default: 100) */
+  limit?: number;
+}
+
+// ============================================================================
+// GitHub Repository Fetching
+// ============================================================================
+
+/**
+ * Fetch all GitHub repositories via gh CLI
+ */
+export async function fetchAllGitHubRepos(
+  owner?: string,
+  limit: number = 100
+): Promise<Array<{owner: string, name: string, fullName: string}>> {
+  console.log('🔍 Fetching GitHub repositories...');
+
+  try {
+    const repos = await GitHubClient.getRepositories(owner, limit);
+
+    console.log(`✅ Found ${repos.length} GitHub repositories\n`);
+
+    return repos;
+  } catch (error) {
+    console.error('❌ Failed to fetch GitHub repositories:', (error as Error).message);
+    throw error;
+  }
+}
+
+// ============================================================================
+// Interactive Repository Selection
+// ============================================================================
+
+/**
+ * Interactive repository selector with search and pagination
+ */
+export async function selectGitHubRepos(
+  options: RepoSelectorOptions = {}
+): Promise<RepoSelectionResult> {
+  const {
+    allowManualEntry = true,
+    allowSelectAll = true,
+    preSelected = [],
+    minSelection = 1,
+    maxSelection,
+    pageSize = 15,
+    owner,
+    limit = 100,
+  } = options;
+
+  // Fetch all repositories
+  const allRepos = await fetchAllGitHubRepos(owner, limit);
+
+  if (allRepos.length === 0) {
+    console.log('⚠️  No GitHub repositories found');
+    return {
+      selectedRepos: [],
+      method: 'interactive',
+    };
+  }
+
+  // Show repository overview
+  console.log('📋 Available GitHub Repositories:\n');
+  console.log(`   Total: ${allRepos.length} repositories\n`);
+
+  // Decide selection method
+  const { selectionMethod } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'selectionMethod',
+      message: 'How would you like to select repositories?',
+      choices: [
+        {
+          name: `📋 Interactive (browse and select from ${allRepos.length} repositories)`,
+          value: 'interactive',
+        },
+        {
+          name: '✏️  Manual entry (type repository names)',
+          value: 'manual',
+        },
+        ...(allowSelectAll
+          ? [
+              {
+                name: `✨ Select all (${allRepos.length} repositories)`,
+                value: 'all',
+              },
+            ]
+          : []),
+      ],
+    },
+  ]);
+
+  if (selectionMethod === 'all') {
+    return {
+      selectedRepos: allRepos.map((r) => r.fullName),
+      method: 'all',
+    };
+  }
+
+  if (selectionMethod === 'manual') {
+    return await manualRepoEntry(allRepos, minSelection, maxSelection);
+  }
+
+  // Interactive selection
+  return await interactiveRepoSelection(
+    allRepos,
+    preSelected,
+    minSelection,
+    maxSelection,
+    pageSize
+  );
+}
+
+/**
+ * Interactive repository selection with checkbox
+ */
+async function interactiveRepoSelection(
+  allRepos: Array<{owner: string, name: string, fullName: string}>,
+  preSelected: string[],
+  minSelection: number,
+  maxSelection: number | undefined,
+  pageSize: number
+): Promise<RepoSelectionResult> {
+  console.log('💡 Use <space> to select, <a> to toggle all, <i> to invert\n');
+
+  const choices = allRepos.map((r) => ({
+    name: formatRepoChoice(r),
+    value: r.fullName,
+    checked: preSelected.includes(r.fullName),
+  }));
+
+  // Add manual entry option at the end
+  choices.push(
+    new inquirer.Separator(),
+    {
+      name: '✏️  Enter repository names manually instead',
+      value: '__MANUAL__',
+      checked: false,
+    } as any
+  );
+
+  const { selectedRepos } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'selectedRepos',
+      message: `Select GitHub repositories (${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} repository(ies)`;
+        }
+
+        if (maxSelection && actualSelected.length > maxSelection) {
+          return `Please select at most ${maxSelection} repository(ies)`;
+        }
+
+        return true;
+      },
+    },
+  ]);
+
+  // Check if user chose manual entry
+  if (selectedRepos.includes('__MANUAL__')) {
+    return await manualRepoEntry(allRepos, minSelection, maxSelection);
+  }
+
+  console.log(`\n✅ Selected ${selectedRepos.length} repositories: ${selectedRepos.join(', ')}\n`);
+
+  return {
+    selectedRepos,
+    method: 'interactive',
+  };
+}
+
+/**
+ * Manual repository entry (comma-separated, format: owner/repo)
+ */
+async function manualRepoEntry(
+  allRepos: Array<{owner: string, name: string, fullName: string}>,
+  minSelection: number,
+  maxSelection: number | undefined
+): Promise<RepoSelectionResult> {
+  console.log('\n📝 Enter repository names manually\n');
+  console.log('💡 Format: Comma-separated owner/repo format (e.g., octocat/Hello-World,owner/repo2)\n');
+
+  if (allRepos.length > 0) {
+    console.log('Available repositories:');
+    console.log(
+      allRepos
+        .map((r) => r.fullName)
+        .join(', ')
+        .substring(0, 100) + (allRepos.length > 20 ? '...' : '')
+    );
+    console.log('');
+  }
+
+  const { manualRepos } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'manualRepos',
+      message: 'Repository names:',
+      validate: (input: string) => {
+        if (!input.trim()) {
+          return 'Please enter at least one repository name';
+        }
+
+        const repos = input
+          .split(',')
+          .map((r) => r.trim())
+          .filter((r) => r.length > 0);
+
+        if (repos.length < minSelection) {
+          return `Please enter at least ${minSelection} repository name(s)`;
+        }
+
+        if (maxSelection && repos.length > maxSelection) {
+          return `Please enter at most ${maxSelection} repository name(s)`;
+        }
+
+        // Validate format (owner/repo)
+        const invalidRepos = repos.filter((r) => !/^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_.-]+$/.test(r));
+        if (invalidRepos.length > 0) {
+          return `Invalid repository format: ${invalidRepos.join(', ')}. Use owner/repo format (e.g., octocat/Hello-World).`;
+        }
+
+        return true;
+      },
+    },
+  ]);
+
+  const selectedRepos = manualRepos
+    .split(',')
+    .map((r: string) => r.trim())
+    .filter((r: string) => r.length > 0);
+
+  // Warn about unknown repositories
+  const knownRepos = allRepos.map((r) => r.fullName);
+  const unknownRepos = selectedRepos.filter((r) => !knownRepos.includes(r));
+
+  if (unknownRepos.length > 0) {
+    console.log(`\n⚠️  Unknown repository names (will be used anyway): ${unknownRepos.join(', ')}`);
+    console.log('   Make sure these repositories exist and you have access to them.\n');
+  }
+
+  console.log(`✅ Selected ${selectedRepos.length} repositories: ${selectedRepos.join(', ')}\n`);
+
+  return {
+    selectedRepos,
+    method: 'manual',
+  };
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Format repository choice for display
+ */
+function formatRepoChoice(repo: {owner: string, name: string, fullName: string}): string {
+  return `${repo.fullName.padEnd(40)} (${repo.owner})`;
+}
+
+/**
+ * Quick repo selector - select single repository
+ */
+export async function selectSingleGitHubRepo(
+  message: string = 'Select GitHub repository:',
+  owner?: string
+): Promise<string> {
+  const result = await selectGitHubRepos({
+    allowManualEntry: true,
+    allowSelectAll: false,
+    minSelection: 1,
+    maxSelection: 1,
+    owner,
+  });
+
+  return result.selectedRepos[0];
+}