specweave 0.28.17 → 0.28.20

package/dist/src/cli/helpers/issue-tracker/ado-area-selection.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ADO Area Path Selection Helper (v0.29.0+)
+ *
+ * Provides UI prompts for selecting ADO area paths and mapping them to SpecWeave projects.
+ * Used during `specweave init` when user selects area path-based team organization.
+ *
+ * @module cli/helpers/issue-tracker/ado-area-selection
+ */
+import type { AdoAreaPathMappingConfig } from '../../../core/types/sync-profile.js';
+/**
+ * ADO organization strategy
+ */
+export type AdoOrganizationStrategy = 'single-project' | 'area-path-based' | 'team-based' | 'multi-project';
+/**
+ * Area path selection result
+ */
+export interface AreaPathSelectionResult {
+    /** Selected organization strategy */
+    strategy: AdoOrganizationStrategy;
+    /** Area path mapping config (only for area-path-based strategy) */
+    areaPathMapping?: AdoAreaPathMappingConfig;
+    /** Selected project names (for multi-project strategy) */
+    projectNames?: string[];
+    /** Single project name (for single-project strategy) */
+    projectName?: string;
+    /** Teams (for team-based strategy, maps to area paths) */
+    teams?: string[];
+}
+/**
+ * Prompt user to select ADO organization strategy
+ *
+ * @param hasMultipleAreaPaths Whether the project has multiple area paths
+ * @returns Selected strategy
+ */
+export declare function promptAdoOrganizationStrategy(hasMultipleAreaPaths: boolean): Promise<AdoOrganizationStrategy>;
+/**
+ * Fetch and display area paths for an ADO project
+ * Prompts user to select area paths and map them to SpecWeave projects
+ *
+ * @param organization ADO organization name
+ * @param project ADO project name
+ * @param pat Personal Access Token
+ * @param projectRoot Path to SpecWeave project root (for existing project IDs)
+ * @returns Area path mapping configuration
+ */
+export declare function promptAreaPathSelection(organization: string, project: string, pat: string, projectRoot: string): Promise<AdoAreaPathMappingConfig | null>;
+/**
+ * Complete area path selection flow
+ * Orchestrates strategy selection and area path mapping
+ *
+ * @param credentials ADO credentials (partial)
+ * @param projectRoot Path to SpecWeave project root
+ * @returns Area path selection result
+ */
+export declare function completeAreaPathSelectionFlow(credentials: {
+    organization: string;
+    project: string;
+    pat: string;
+    teams?: string[];
+}, projectRoot: string): Promise<AreaPathSelectionResult>;
+/**
+ * Display summary of area path mapping
+ */
+export declare function displayAreaPathMappingSummary(mapping: AdoAreaPathMappingConfig): void;
+//# sourceMappingURL=ado-area-selection.d.ts.map

package/dist/src/cli/helpers/issue-tracker/ado-area-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-area-selection.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/ado-area-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAsB,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAWxG;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,QAAQ,EAAE,uBAAuB,CAAC;IAElC,mEAAmE;IACnE,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAE3C,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,oBAAoB,EAAE,OAAO,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA6BlC;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CA2I1C;AAED;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,EACD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAgGlC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAgBrF"}

package/dist/src/cli/helpers/issue-tracker/ado-area-selection.js

@@ -0,0 +1,278 @@
+/**
+ * ADO Area Path Selection Helper (v0.29.0+)
+ *
+ * Provides UI prompts for selecting ADO area paths and mapping them to SpecWeave projects.
+ * Used during `specweave init` when user selects area path-based team organization.
+ *
+ * @module cli/helpers/issue-tracker/ado-area-selection
+ */
+import chalk from 'chalk';
+import { select, checkbox, input, confirm } from '@inquirer/prompts';
+import ora from 'ora';
+import { fetchAreaPathsForProject, } from '../../../../plugins/specweave-ado/lib/ado-board-resolver.js';
+import { generateProjectId, getExistingProjectIds, normalizeToProjectId, } from '../../../utils/project-id-generator.js';
+/**
+ * Prompt user to select ADO organization strategy
+ *
+ * @param hasMultipleAreaPaths Whether the project has multiple area paths
+ * @returns Selected strategy
+ */
+export async function promptAdoOrganizationStrategy(hasMultipleAreaPaths) {
+    console.log(chalk.cyan('\n🔷 Azure DevOps Project Organization\n'));
+    const defaultStrategy = hasMultipleAreaPaths ? 'area-path-based' : 'single-project';
+    const strategy = await select({
+        message: 'How do you want to organize work items?',
+        choices: [
+            {
+                name: 'Single project (all work at root level)',
+                value: 'single-project',
+                description: 'Best for small teams or single-product companies',
+            },
+            {
+                name: 'Area path-based teams (area paths → SpecWeave projects)',
+                value: 'area-path-based',
+                description: 'Best for enterprise teams using area paths for organization',
+            },
+            {
+                name: 'Team-based organization (teams → SpecWeave projects)',
+                value: 'team-based',
+                description: 'Best when teams have dedicated areas in ADO',
+            },
+        ],
+        default: defaultStrategy,
+    });
+    return strategy;
+}
+/**
+ * Fetch and display area paths for an ADO project
+ * Prompts user to select area paths and map them to SpecWeave projects
+ *
+ * @param organization ADO organization name
+ * @param project ADO project name
+ * @param pat Personal Access Token
+ * @param projectRoot Path to SpecWeave project root (for existing project IDs)
+ * @returns Area path mapping configuration
+ */
+export async function promptAreaPathSelection(organization, project, pat, projectRoot) {
+    const spinner = ora(`Fetching area paths from project ${project}...`).start();
+    try {
+        // Fetch available area paths
+        const areaPaths = await fetchAreaPathsForProject(organization, project, pat);
+        spinner.succeed(`Found ${areaPaths.length} area path(s) in project ${project}`);
+        if (areaPaths.length === 0) {
+            console.log(chalk.yellow('\n⚠️  No area paths found in this project.'));
+            console.log(chalk.gray('   Using root level organization.\n'));
+            return null;
+        }
+        // Filter to show only top-level area paths (direct children of project root)
+        // Exclude the root itself
+        const topLevelPaths = areaPaths.filter((ap) => {
+            // Path format: "ProjectName" (root) or "ProjectName\\ChildArea"
+            const parts = ap.path.split('\\');
+            return parts.length === 2; // Direct child of root
+        });
+        if (topLevelPaths.length === 0) {
+            console.log(chalk.yellow('\n⚠️  No child area paths found (only root area exists).'));
+            console.log(chalk.gray('   You can create area paths in ADO and run this setup again.\n'));
+            return null;
+        }
+        // Show area paths and let user select
+        console.log(chalk.cyan('\n📋 Select area paths to map to SpecWeave projects:\n'));
+        // Filter out archive/inactive paths by default (uncheck them)
+        const isArchivePath = (areaPath) => areaPath.name.toLowerCase().includes('archive') ||
+            areaPath.name.toLowerCase().includes('inactive') ||
+            areaPath.name.toLowerCase().includes('deprecated') ||
+            areaPath.name.toLowerCase().includes('legacy');
+        const selectedPaths = await checkbox({
+            message: 'Select area paths (Space to toggle, Enter to confirm):',
+            choices: topLevelPaths.map((ap) => ({
+                name: `${ap.name}${ap.hasChildren ? ' (has sub-areas)' : ''}`,
+                value: ap.path,
+                checked: !isArchivePath(ap), // Pre-select non-archive paths
+            })),
+        });
+        if (selectedPaths.length === 0) {
+            console.log(chalk.yellow('\n⚠️  No area paths selected. Falling back to single-project mode.\n'));
+            return null;
+        }
+        // Get existing project IDs to prevent collisions
+        const existingIds = getExistingProjectIds(projectRoot);
+        // Map selected area paths to SpecWeave projects
+        console.log(chalk.cyan('\n🏷️  Mapping area paths to SpecWeave projects:\n'));
+        const areaPathMappings = [];
+        for (const pathStr of selectedPaths) {
+            const areaPath = areaPaths.find((ap) => ap.path === pathStr);
+            if (!areaPath)
+                continue;
+            // Suggest a project ID based on area path name
+            const suggestedId = generateProjectId({
+                externalContainer: project,
+                localName: areaPath.name,
+                provider: 'ado',
+                existingIds: [...existingIds, ...areaPathMappings.map((m) => m.specweaveProject)],
+            });
+            // Allow user to customize the project ID
+            const projectId = await input({
+                message: `SpecWeave project ID for "${areaPath.name}":`,
+                default: suggestedId.id,
+                validate: (val) => {
+                    if (!val || val.trim() === '') {
+                        return 'Project ID cannot be empty';
+                    }
+                    const normalized = normalizeToProjectId(val);
+                    if (normalized !== val) {
+                        return `Invalid format. Suggested: "${normalized}"`;
+                    }
+                    if (existingIds.includes(val) || areaPathMappings.some((m) => m.specweaveProject === val)) {
+                        return `Project ID "${val}" already exists. Choose a different name.`;
+                    }
+                    return true;
+                },
+            });
+            // Ask about including child area paths
+            let includeChildren = true;
+            if (areaPath.hasChildren) {
+                includeChildren = await confirm({
+                    message: `Include child area paths under "${areaPath.name}"?`,
+                    default: true,
+                });
+            }
+            // Optional: Add keywords for auto-classification
+            const addKeywords = await confirm({
+                message: `Add keywords for auto-classification of user stories to ${projectId}?`,
+                default: false,
+            });
+            let keywords;
+            if (addKeywords) {
+                const keywordsInput = await input({
+                    message: 'Keywords (comma-separated, e.g., "backend, api, database"):',
+                    default: '',
+                });
+                keywords = keywordsInput
+                    .split(',')
+                    .map((k) => k.trim())
+                    .filter((k) => k.length > 0);
+            }
+            areaPathMappings.push({
+                areaPath: areaPath.path,
+                specweaveProject: projectId,
+                includeChildren,
+                keywords,
+            });
+            console.log(chalk.green(`   ✓ ${areaPath.path} → ${projectId}`));
+        }
+        console.log('');
+        return {
+            project,
+            mappings: areaPathMappings,
+        };
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch area paths');
+        console.error(chalk.red(`   Error: ${error.message}\n`));
+        return null;
+    }
+}
+/**
+ * Complete area path selection flow
+ * Orchestrates strategy selection and area path mapping
+ *
+ * @param credentials ADO credentials (partial)
+ * @param projectRoot Path to SpecWeave project root
+ * @returns Area path selection result
+ */
+export async function completeAreaPathSelectionFlow(credentials, projectRoot) {
+    // Check if there are area paths in the project
+    const spinner = ora('Checking project structure...').start();
+    try {
+        const areaPaths = await fetchAreaPathsForProject(credentials.organization, credentials.project, credentials.pat);
+        const hasMultipleAreaPaths = areaPaths.filter((ap) => {
+            const parts = ap.path.split('\\');
+            return parts.length === 2; // Direct children
+        }).length > 0;
+        spinner.stop();
+        // Ask about organization strategy
+        const strategy = await promptAdoOrganizationStrategy(hasMultipleAreaPaths);
+        if (strategy === 'single-project') {
+            return {
+                strategy: 'single-project',
+                projectName: credentials.project,
+            };
+        }
+        if (strategy === 'team-based') {
+            // Team-based maps to area paths internally
+            // Ask user to enter team names if not already provided
+            let teams = credentials.teams || [];
+            if (teams.length === 0) {
+                const teamsInput = await input({
+                    message: 'Enter team names (comma-separated):',
+                    default: '',
+                });
+                teams = teamsInput
+                    .split(',')
+                    .map((t) => t.trim())
+                    .filter((t) => t.length > 0);
+            }
+            if (teams.length === 0) {
+                console.log(chalk.yellow('\n⚠️  No teams specified. Falling back to single-project mode.\n'));
+                return {
+                    strategy: 'single-project',
+                    projectName: credentials.project,
+                };
+            }
+            return {
+                strategy: 'team-based',
+                projectName: credentials.project,
+                teams,
+            };
+        }
+        if (strategy === 'area-path-based') {
+            const areaPathMapping = await promptAreaPathSelection(credentials.organization, credentials.project, credentials.pat, projectRoot);
+            if (areaPathMapping && areaPathMapping.mappings.length > 0) {
+                return {
+                    strategy: 'area-path-based',
+                    areaPathMapping,
+                };
+            }
+            // Fall back to single-project if no area paths selected
+            return {
+                strategy: 'single-project',
+                projectName: credentials.project,
+            };
+        }
+        // multi-project (rare for ADO)
+        return {
+            strategy: 'single-project',
+            projectName: credentials.project,
+        };
+    }
+    catch (error) {
+        spinner.stop();
+        console.error(chalk.yellow(`\n⚠️  Could not analyze project structure: ${error.message}`));
+        console.log(chalk.gray('   Proceeding with single-project mode.\n'));
+        return {
+            strategy: 'single-project',
+            projectName: credentials.project,
+        };
+    }
+}
+/**
+ * Display summary of area path mapping
+ */
+export function displayAreaPathMappingSummary(mapping) {
+    console.log(chalk.cyan.bold('\n🔷 ADO Area Path Mapping Summary\n'));
+    console.log(chalk.gray(`   Project: ${mapping.project}`));
+    console.log(chalk.gray(`   Area paths mapped: ${mapping.mappings.length}\n`));
+    for (const area of mapping.mappings) {
+        console.log(chalk.green(`   ✓ ${area.areaPath}`));
+        console.log(chalk.gray(`     → SpecWeave project: ${area.specweaveProject}`));
+        if (area.includeChildren) {
+            console.log(chalk.gray(`     → Includes child areas: yes`));
+        }
+        if (area.keywords && area.keywords.length > 0) {
+            console.log(chalk.gray(`     → Keywords: ${area.keywords.join(', ')}`));
+        }
+    }
+    console.log('');
+}
+//# sourceMappingURL=ado-area-selection.js.map

package/dist/src/cli/helpers/issue-tracker/ado-area-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-area-selection.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/ado-area-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,OAAO,EACL,wBAAwB,GAEzB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wCAAwC,CAAC;AA+BhD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,oBAA6B;IAE7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;IAEpE,MAAM,eAAe,GACnB,oBAAoB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAE9D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAA0B;QACrD,OAAO,EAAE,yCAAyC;QAClD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,yCAAyC;gBAC/C,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EAAE,kDAAkD;aAChE;YACD;gBACE,IAAI,EAAE,yDAAyD;gBAC/D,KAAK,EAAE,iBAAiB;gBACxB,WAAW,EAAE,6DAA6D;aAC3E;YACD;gBACE,IAAI,EAAE,sDAAsD;gBAC5D,KAAK,EAAE,YAAY;gBACnB,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,OAAe,EACf,GAAW,EACX,WAAmB;IAEnB,MAAM,OAAO,GAAG,GAAG,CAAC,oCAAoC,OAAO,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IAE9E,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7E,OAAO,CAAC,OAAO,CAAC,SAAS,SAAS,CAAC,MAAM,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,6EAA6E;QAC7E,0BAA0B;QAC1B,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;YAC5C,gEAAgE;YAChE,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,uBAAuB;QACpD,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC,CAAC;YACtF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC,CAAC;YAC3F,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC,CAAC;QAElF,8DAA8D;QAC9D,MAAM,aAAa,GAAG,CAAC,QAAqB,EAAE,EAAE,CAC9C,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC;YACnC,OAAO,EAAE,wDAAwD;YACjE,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAClC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC7D,KAAK,EAAE,EAAE,CAAC,IAAI;gBACd,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,+BAA+B;aAC7D,CAAC,CAAC;SACJ,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sEAAsE,CAAC,CAAC,CAAC;YAClG,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iDAAiD;QACjD,MAAM,WAAW,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAEvD,gDAAgD;QAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC,CAAC;QAE9E,MAAM,gBAAgB,GAAyB,EAAE,CAAC;QAElD,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC7D,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,+CAA+C;YAC/C,MAAM,WAAW,GAAG,iBAAiB,CAAC;gBACpC,iBAAiB,EAAE,OAAO;gBAC1B,SAAS,EAAE,QAAQ,CAAC,IAAI;gBACxB,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;aAClF,CAAC,CAAC;YAEH,yCAAyC;YACzC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC;gBAC5B,OAAO,EAAE,6BAA6B,QAAQ,CAAC,IAAI,IAAI;gBACvD,OAAO,EAAE,WAAW,CAAC,EAAE;gBACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;oBAChB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;wBAC9B,OAAO,4BAA4B,CAAC;oBACtC,CAAC;oBACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;oBAC7C,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;wBACvB,OAAO,+BAA+B,UAAU,GAAG,CAAC;oBACtD,CAAC;oBACD,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,GAAG,CAAC,EAAE,CAAC;wBAC1F,OAAO,eAAe,GAAG,4CAA4C,CAAC;oBACxE,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;aACF,CAAC,CAAC;YAEH,uCAAuC;YACvC,IAAI,eAAe,GAAG,IAAI,CAAC;YAC3B,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACzB,eAAe,GAAG,MAAM,OAAO,CAAC;oBAC9B,OAAO,EAAE,mCAAmC,QAAQ,CAAC,IAAI,IAAI;oBAC7D,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;YAED,iDAAiD;YACjD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC;gBAChC,OAAO,EAAE,2DAA2D,SAAS,GAAG;gBAChF,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YAEH,IAAI,QAA8B,CAAC;YACnC,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC;oBAChC,OAAO,EAAE,6DAA6D;oBACtE,OAAO,EAAE,EAAE;iBACZ,CAAC,CAAC;gBACH,QAAQ,GAAG,aAAa;qBACrB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACjC,CAAC;YAED,gBAAgB,CAAC,IAAI,CAAC;gBACpB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,gBAAgB,EAAE,SAAS;gBAC3B,eAAe;gBACf,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,QAAQ,CAAC,IAAI,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,gBAAgB;SAC3B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAKC,EACD,WAAmB;IAEnB,+CAA+C;IAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,+BAA+B,CAAC,CAAC,KAAK,EAAE,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAC9C,WAAW,CAAC,YAAY,EACxB,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,GAAG,CAChB,CAAC;QAEF,MAAM,oBAAoB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;YACnD,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,kBAAkB;QAC/C,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEd,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,kCAAkC;QAClC,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC,oBAAoB,CAAC,CAAC;QAE3E,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YAClC,OAAO;gBACL,QAAQ,EAAE,gBAAgB;gBAC1B,WAAW,EAAE,WAAW,CAAC,OAAO;aACjC,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,2CAA2C;YAC3C,uDAAuD;YACvD,IAAI,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;YAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC;oBAC7B,OAAO,EAAE,qCAAqC;oBAC9C,OAAO,EAAE,EAAE;iBACZ,CAAC,CAAC;gBACH,KAAK,GAAG,UAAU;qBACf,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACjC,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,kEAAkE,CAAC,CAAC,CAAC;gBAC9F,OAAO;oBACL,QAAQ,EAAE,gBAAgB;oBAC1B,WAAW,EAAE,WAAW,CAAC,OAAO;iBACjC,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,YAAY;gBACtB,WAAW,EAAE,WAAW,CAAC,OAAO;gBAChC,KAAK;aACN,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YACnC,MAAM,eAAe,GAAG,MAAM,uBAAuB,CACnD,WAAW,CAAC,YAAY,EACxB,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,GAAG,EACf,WAAW,CACZ,CAAC;YAEF,IAAI,eAAe,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,OAAO;oBACL,QAAQ,EAAE,iBAAiB;oBAC3B,eAAe;iBAChB,CAAC;YACJ,CAAC;YAED,wDAAwD;YACxD,OAAO;gBACL,QAAQ,EAAE,gBAAgB;gBAC1B,WAAW,EAAE,WAAW,CAAC,OAAO;aACjC,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,WAAW,CAAC,OAAO;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,8CAA8C,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC,CAAC;QAErE,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,WAAW,CAAC,OAAO;SACjC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAiC;IAC7E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAE9E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/cli/helpers/issue-tracker/jira-board-selection.d.ts

@@ -0,0 +1,64 @@
+/**
+ * JIRA Board Selection Helper (v0.29.0+)
+ *
+ * Provides UI prompts for selecting JIRA boards and mapping them to SpecWeave projects.
+ * Used during `specweave init` when user selects board-based team organization.
+ *
+ * @module cli/helpers/issue-tracker/jira-board-selection
+ */
+import type { JiraBoardMappingConfig } from '../../../core/types/sync-profile.js';
+import { JiraClient } from '../../../integrations/jira/jira-client.js';
+/**
+ * JIRA organization strategy
+ */
+export type JiraOrganizationStrategy = 'single-project' | 'board-based' | 'multi-project';
+/**
+ * Board selection result
+ */
+export interface BoardSelectionResult {
+    /** Selected organization strategy */
+    strategy: JiraOrganizationStrategy;
+    /** Board mapping config (only for board-based strategy) */
+    boardMapping?: JiraBoardMappingConfig;
+    /** Selected project keys (for multi-project strategy) */
+    projectKeys?: string[];
+    /** Single project key (for single-project strategy) */
+    projectKey?: string;
+}
+/**
+ * Prompt user to select JIRA organization strategy
+ *
+ * @param projectCount Number of projects user has access to
+ * @returns Selected strategy
+ */
+export declare function promptOrganizationStrategy(projectCount: number): Promise<JiraOrganizationStrategy>;
+/**
+ * Fetch and display boards for a JIRA project
+ * Prompts user to select boards and map them to SpecWeave projects
+ *
+ * @param client JIRA client for API calls
+ * @param projectKey JIRA project key (e.g., "CORE")
+ * @param projectRoot Path to SpecWeave project root (for existing project IDs)
+ * @returns Board mapping configuration
+ */
+export declare function promptBoardSelection(client: JiraClient, projectKey: string, projectRoot: string): Promise<JiraBoardMappingConfig | null>;
+/**
+ * Complete board selection flow
+ * Orchestrates strategy selection and board mapping
+ *
+ * @param credentials JIRA credentials (partial)
+ * @param selectedProjects Already selected JIRA projects
+ * @param projectRoot Path to SpecWeave project root
+ * @returns Board selection result
+ */
+export declare function completeBoardSelectionFlow(credentials: {
+    domain: string;
+    email: string;
+    token: string;
+    instanceType: 'cloud' | 'server';
+}, selectedProjects: string[], projectRoot: string): Promise<BoardSelectionResult>;
+/**
+ * Display summary of board mapping
+ */
+export declare function displayBoardMappingSummary(mapping: JiraBoardMappingConfig): void;
+//# sourceMappingURL=jira-board-selection.d.ts.map

package/dist/src/cli/helpers/issue-tracker/jira-board-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-board-selection.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/jira-board-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAQvE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,aAAa,GACb,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,EAAE,wBAAwB,CAAC;IAEnC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAEtC,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAgCnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAoHxC;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;CAClC,EACD,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAwF/B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAahF"}