cc-agentic-framework 1.14.1

package/dist/lib/backlog/milestone-migrator.js

@@ -0,0 +1,401 @@
+/**
+ * Milestone Migration Module
+ *
+ * Ported from Python: modules/backlog/src/backlog/migrate_milestones.py
+ *                     modules/backlog/src/backlog/validate_milestone_migration.py
+ *
+ * Handles migration of milestone files from local ID naming convention
+ * (Jan2026.md) to Jira source-of-truth naming (apm-r-app-january-2026-w51-w1-w3.md).
+ *
+ * Features:
+ * - Detect old milestone format
+ * - Convert to new format preserving data
+ * - Validate migration success
+ * - Track changes for rollback
+ *
+ * @module milestone-migrator
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { glob } from 'glob';
+import { parseFrontmatter } from '../common/yaml-frontmatter.js';
+import { sanitizeMilestoneName, validateMilestoneFilename } from './milestone-sanitizer.js';
+/**
+ * Track migration changes for reporting and rollback
+ */
+export class MigrationTracker {
+    changes;
+    trackerFile;
+    constructor(trackerFile) {
+        this.trackerFile = trackerFile || '.migration-tracker.json';
+        this.changes = {
+            timestamp: new Date().toISOString(),
+            milestoneRenames: {},
+            ticketUpdates: [],
+        };
+    }
+    /**
+     * Track a milestone file rename
+     */
+    addRename(oldName, newName) {
+        this.changes.milestoneRenames[oldName] = newName;
+    }
+    /**
+     * Track a ticket file update
+     */
+    addTicketUpdate(ticketPath) {
+        this.changes.ticketUpdates.push(ticketPath);
+    }
+    /**
+     * Save migration tracking file
+     */
+    async save() {
+        await fs.writeJson(this.trackerFile, this.changes, { spaces: 2 });
+    }
+    /**
+     * Load migration tracking file
+     */
+    static async load(trackerFile) {
+        const file = trackerFile || '.migration-tracker.json';
+        if (!(await fs.pathExists(file))) {
+            return null;
+        }
+        return await fs.readJson(file);
+    }
+}
+/**
+ * Extract milestone name and Jira ID from milestone file frontmatter.
+ *
+ * @param milestoneFile - Path to milestone markdown file
+ * @returns Milestone metadata or empty object if not found
+ * @throws {Error} If file cannot be read
+ */
+export async function readMilestoneMetadata(milestoneFile) {
+    const content = await fs.readFile(milestoneFile, 'utf-8');
+    const { data } = parseFrontmatter(content);
+    return {
+        milestoneName: data.milestoneName,
+        jiraMilestoneId: data.jiraMilestoneId,
+    };
+}
+/**
+ * Check if a milestone filename is already sanitized.
+ *
+ * A milestone is considered already sanitized if:
+ * - It's all lowercase
+ * - Contains only hyphens (no unsafe chars)
+ * - No consecutive hyphens
+ *
+ * @param filename - Milestone filename to check
+ * @returns True if already sanitized, false otherwise
+ */
+function isAlreadySanitized(filename) {
+    // Skip template files
+    if (filename.startsWith('.')) {
+        return true;
+    }
+    // Check if it matches sanitization pattern
+    return validateMilestoneFilename(filename);
+}
+/**
+ * Build migration plan for all milestones in a directory.
+ *
+ * Scans milestone directory and identifies files that need migration.
+ * Skips already-sanitized files and files without Jira metadata.
+ *
+ * @param milestonesDir - Path to milestones directory
+ * @returns Migration plan mapping old filenames to new filenames
+ *
+ * @example
+ * ```typescript
+ * const plan = await getMigrationPlan('/path/to/backlog/milestones');
+ * // Returns: {
+ * //   'Jan2026.md': {
+ * //     newFilename: 'apm-r-app-january-2026-w51-w1-w3.md',
+ * //     milestoneName: 'APM-R: App: January 2026 (W51, W1, W3)',
+ * //     jiraMilestoneId: undefined
+ * //   }
+ * // }
+ * ```
+ */
+export async function getMigrationPlan(milestonesDir) {
+    const plan = {};
+    // Find all milestone files
+    const pattern = path.join(milestonesDir, '*.md');
+    const files = await glob(pattern, { absolute: true });
+    for (const filePath of files.sort()) {
+        const filename = path.basename(filePath);
+        // Skip already-sanitized files
+        if (isAlreadySanitized(filename)) {
+            continue;
+        }
+        try {
+            // Read metadata to get Jira name
+            const metadata = await readMilestoneMetadata(filePath);
+            if (metadata.milestoneName) {
+                // Generate new sanitized filename from Jira name
+                const newFilename = sanitizeMilestoneName(metadata.milestoneName);
+                plan[filename] = {
+                    newFilename,
+                    milestoneName: metadata.milestoneName,
+                    jiraMilestoneId: metadata.jiraMilestoneId,
+                };
+            }
+            // If no milestoneName, skip this file (will be logged as warning)
+        }
+        catch (error) {
+            // Skip files that can't be read
+            console.warn(`Warning: Could not read ${filePath}:`, error);
+        }
+    }
+    return plan;
+}
+/**
+ * Apply the migration plan to rename milestone files.
+ *
+ * Renames files according to the migration plan and tracks all changes.
+ * In dry-run mode, no files are actually changed.
+ *
+ * @param backlogDir - Base backlog directory
+ * @param plan - Migration plan from getMigrationPlan()
+ * @param dryRun - If true, preview changes only without applying
+ * @returns Migration tracker with all changes recorded
+ *
+ * @example
+ * ```typescript
+ * const plan = await getMigrationPlan(milestonesDir);
+ * const tracker = await applyMigration('/path/to/backlog', plan, false);
+ * await tracker.save(); // Save for rollback capability
+ * ```
+ */
+export async function applyMigration(backlogDir, plan, dryRun = false) {
+    const tracker = new MigrationTracker(path.join(backlogDir, '.migration-tracker.json'));
+    const milestonesDir = path.join(backlogDir, 'milestones');
+    const entries = Object.entries(plan).sort();
+    if (entries.length === 0) {
+        return tracker;
+    }
+    for (const [oldName, entry] of entries) {
+        const oldPath = path.join(milestonesDir, oldName);
+        const newPath = path.join(milestonesDir, entry.newFilename);
+        // Check if target already exists
+        if (await fs.pathExists(newPath)) {
+            console.warn(`Warning: ${entry.newFilename} already exists, skipping`);
+            continue;
+        }
+        if (dryRun) {
+            // Just preview, don't actually rename
+            continue;
+        }
+        try {
+            await fs.move(oldPath, newPath);
+            tracker.addRename(oldName, entry.newFilename);
+        }
+        catch (error) {
+            console.error(`Failed to rename ${oldName}:`, error);
+        }
+    }
+    return tracker;
+}
+/**
+ * Validate milestone architecture compliance.
+ *
+ * Checks that:
+ * 1. Milestone files use sanitized Jira names for filenames
+ * 2. Ticket files don't have deprecated 'milestone:' field
+ * 3. Milestone files have Jira metadata (milestoneName or jiraMilestoneId)
+ *
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - If true, show detailed validation for each file
+ * @returns Validation result with errors and warnings
+ *
+ * @example
+ * ```typescript
+ * const result = await validateMilestoneArchitecture('/path/to/backlog', false);
+ * if (!result.valid) {
+ *   console.error('Validation failed:', result.errors);
+ * }
+ * ```
+ */
+export async function validateMilestoneArchitecture(backlogDir, verbose = false) {
+    const result = {
+        valid: true,
+        errors: [],
+        warnings: [],
+    };
+    const milestonesDir = path.join(backlogDir, 'milestones');
+    const ticketsDir = path.join(backlogDir, 'tickets');
+    // Validate milestones directory exists
+    if (!(await fs.pathExists(milestonesDir))) {
+        result.valid = false;
+        result.errors.push(`Milestones directory not found: ${milestonesDir}`);
+        return result;
+    }
+    // Validate milestone files
+    await validateMilestoneFiles(milestonesDir, result, verbose);
+    // Validate ticket files (if tickets directory exists)
+    if (await fs.pathExists(ticketsDir)) {
+        await validateTicketFiles(ticketsDir, backlogDir, result, verbose);
+    }
+    return result;
+}
+/**
+ * Validate milestone file structure
+ */
+async function validateMilestoneFiles(milestonesDir, result, verbose) {
+    const pattern = path.join(milestonesDir, '*.md');
+    const files = await glob(pattern, { absolute: true });
+    for (const filePath of files) {
+        const filename = path.basename(filePath);
+        // Skip template files
+        if (filename.startsWith('.')) {
+            continue;
+        }
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const { data } = parseFrontmatter(content);
+            // Validate 1: No deprecated "milestone:" field in frontmatter
+            if (data.milestone) {
+                result.errors.push(`${filename}: YAML contains deprecated 'milestone:' field`);
+                result.valid = false;
+            }
+            // Validate 2: Has milestoneName or jiraMilestoneId
+            const hasJiraMetadata = data.milestoneName || data.jiraMilestoneId;
+            if (!hasJiraMetadata) {
+                // Only warn for actual milestone files
+                if (!filename.includes('Demo') && !filename.includes('UC') && !filename.includes('Post')) {
+                    result.warnings.push(`${filename}: Missing Jira metadata (milestoneName or jiraMilestoneId)`);
+                }
+            }
+            // Validate 3: Filename is sanitized
+            if (!validateMilestoneFilename(filename)) {
+                result.warnings.push(`${filename}: Filename may not be properly sanitized`);
+            }
+            if (verbose) {
+                console.log(`  ✓ ${filename}`);
+            }
+        }
+        catch (error) {
+            result.errors.push(`Failed to read ${filename}: ${error}`);
+            result.valid = false;
+        }
+    }
+}
+/**
+ * Validate all ticket files
+ */
+async function validateTicketFiles(ticketsDir, backlogDir, result, verbose) {
+    const ticketTypes = ['stories', 'tasks', 'bugs', 'spikes'];
+    const ticketsWithMilestoneField = [];
+    for (const ticketType of ticketTypes) {
+        const typeDir = path.join(ticketsDir, ticketType);
+        if (!(await fs.pathExists(typeDir))) {
+            continue;
+        }
+        const pattern = path.join(typeDir, '*.md');
+        const files = await glob(pattern, { absolute: true });
+        for (const filePath of files) {
+            // Skip README files
+            if (filePath.endsWith('README.md')) {
+                continue;
+            }
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                const { data } = parseFrontmatter(content);
+                if (data.milestone) {
+                    const relativePath = path.relative(backlogDir, filePath);
+                    ticketsWithMilestoneField.push(relativePath);
+                }
+            }
+            catch (error) {
+                result.errors.push(`Failed to read ${filePath}: ${error}`);
+                result.valid = false;
+            }
+        }
+    }
+    if (ticketsWithMilestoneField.length > 0) {
+        result.valid = false;
+        result.warnings.push(`Found ${ticketsWithMilestoneField.length} tickets with deprecated 'milestone:' field`);
+        if (verbose) {
+            ticketsWithMilestoneField.slice(0, 10).forEach((ticket) => {
+                result.warnings.push(`  - ${ticket}`);
+            });
+            if (ticketsWithMilestoneField.length > 10) {
+                result.warnings.push(`  ... and ${ticketsWithMilestoneField.length - 10} more`);
+            }
+        }
+    }
+}
+/**
+ * Print migration plan for user review
+ *
+ * @param plan - Migration plan to display
+ */
+export function printMigrationPlan(plan) {
+    console.log('');
+    console.log('='.repeat(80));
+    console.log('MIGRATION PLAN');
+    console.log('='.repeat(80));
+    const entries = Object.entries(plan).sort();
+    if (entries.length === 0) {
+        console.log('No milestones to migrate (all already using Jira names)');
+        return;
+    }
+    for (const [oldName, entry] of entries) {
+        console.log('');
+        console.log(oldName);
+        console.log(`  → ${entry.newFilename}`);
+        if (entry.milestoneName) {
+            console.log(`  Jira: ${entry.milestoneName}`);
+        }
+        if (entry.jiraMilestoneId) {
+            console.log(`  ID: ${entry.jiraMilestoneId}`);
+        }
+    }
+    console.log('');
+    console.log('='.repeat(80));
+    console.log(`Total milestones to migrate: ${entries.length}`);
+    console.log('='.repeat(80));
+    console.log('');
+}
+/**
+ * Print validation results
+ *
+ * @param result - Validation result to display
+ */
+export function printValidationResults(result) {
+    console.log('='.repeat(80));
+    console.log('VALIDATION RESULTS');
+    console.log('='.repeat(80));
+    console.log('');
+    if (result.valid && result.errors.length === 0 && result.warnings.length === 0) {
+        console.log('✓ All validations passed!');
+        console.log('');
+        console.log('Architecture Status:');
+        console.log('  ✓ Milestone files use Jira source-of-truth');
+        console.log('  ✓ No deprecated \'milestone:\' fields in tickets');
+        console.log('  ✓ New naming convention is active');
+        console.log('');
+        console.log('='.repeat(80));
+        return;
+    }
+    if (result.errors.length > 0) {
+        console.log(`✗ ${result.errors.length} ERRORS:`);
+        result.errors.forEach((error) => {
+            console.log(`   ${error}`);
+        });
+        console.log('');
+    }
+    if (result.warnings.length > 0) {
+        console.log(`⚠ ${result.warnings.length} WARNINGS:`);
+        result.warnings.slice(0, 10).forEach((warning) => {
+            console.log(`   ${warning}`);
+        });
+        if (result.warnings.length > 10) {
+            console.log(`   ... and ${result.warnings.length - 10} more`);
+        }
+        console.log('');
+    }
+    console.log('='.repeat(80));
+}
+//# sourceMappingURL=milestone-migrator.js.map

package/dist/lib/backlog/milestone-migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-migrator.js","sourceRoot":"","sources":["../../../src/lib/backlog/milestone-migrator.ts"],"names":[],"mappings":"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"}

package/dist/lib/backlog/milestone-sanitizer.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Milestone Name Sanitization Module
+ *
+ * Converts Jira milestone names to filesystem-safe filenames following the pattern:
+ * - "APM-R: App: January 2026 (W51, W1, W3)" → "apm-r-app-january-2026-w51-w1-w3.md"
+ *
+ * This module is the source of truth for milestone filename generation. All import,
+ * migration, and validation scripts must use this function to ensure consistency.
+ *
+ * Algorithm:
+ * 1. Normalize unicode characters (NFKD → ASCII)
+ * 2. Convert to lowercase
+ * 3. Remove filesystem-unsafe characters: /\:*?"<>|,&.
+ * 4. Replace spaces with hyphens
+ * 5. Remove parentheses (keep content)
+ * 6. Collapse consecutive hyphens
+ * 7. Remove leading/trailing hyphens
+ * 8. Handle empty → "untitled"
+ * 9. Limit to 200 characters
+ * 10. Add .md extension
+ *
+ * Edge Cases Handled:
+ * - Unicode characters (removed or transliterated)
+ * - Special characters (/, \, :, *, ?, ", |, <, >, etc.)
+ * - Very long names (truncated to 200 chars)
+ * - Names starting with numbers (allowed)
+ * - Empty/whitespace-only names (default to "untitled")
+ *
+ * @module milestone-sanitizer
+ */
+/**
+ * Convert Jira milestone name to filesystem-safe filename.
+ *
+ * @param milestoneName - Full Jira milestone name (e.g., "APM-R: App: January 2026 (W51, W1, W3)")
+ * @returns Filesystem-safe filename with .md extension (e.g., "apm-r-app-january-2026-w51-w1-w3.md")
+ *
+ * @example
+ * ```typescript
+ * sanitizeMilestoneName("APM-R: App: January 2026 (W51, W1, W3)")
+ * // Returns: 'apm-r-app-january-2026-w51-w1-w3.md'
+ *
+ * sanitizeMilestoneName("UC1-MVP")
+ * // Returns: 'uc1-mvp.md'
+ *
+ * sanitizeMilestoneName("Demo")
+ * // Returns: 'demo.md'
+ *
+ * sanitizeMilestoneName("Q1 2026: Planning & Design")
+ * // Returns: 'q1-2026-planning-design.md'
+ * ```
+ */
+export declare function sanitizeMilestoneName(milestoneName: string | null | undefined): string;
+/**
+ * Validate that a filename matches the sanitization pattern.
+ *
+ * @param filename - Filename to validate
+ * @returns True if filename is valid, False otherwise
+ *
+ * @example
+ * ```typescript
+ * validateMilestoneFilename('apm-r-app-january-2026.md')
+ * // Returns: true
+ *
+ * validateMilestoneFilename('Invalid--Name.md')
+ * // Returns: false (consecutive hyphens)
+ *
+ * validateMilestoneFilename('UPPERCASE.md')
+ * // Returns: false (must be lowercase)
+ * ```
+ */
+export declare function validateMilestoneFilename(filename: string): boolean;
+//# sourceMappingURL=milestone-sanitizer.d.ts.map

package/dist/lib/backlog/milestone-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-sanitizer.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/milestone-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkDtF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiCnE"}

package/dist/lib/backlog/milestone-sanitizer.js

@@ -0,0 +1,139 @@
+/**
+ * Milestone Name Sanitization Module
+ *
+ * Converts Jira milestone names to filesystem-safe filenames following the pattern:
+ * - "APM-R: App: January 2026 (W51, W1, W3)" → "apm-r-app-january-2026-w51-w1-w3.md"
+ *
+ * This module is the source of truth for milestone filename generation. All import,
+ * migration, and validation scripts must use this function to ensure consistency.
+ *
+ * Algorithm:
+ * 1. Normalize unicode characters (NFKD → ASCII)
+ * 2. Convert to lowercase
+ * 3. Remove filesystem-unsafe characters: /\:*?"<>|,&.
+ * 4. Replace spaces with hyphens
+ * 5. Remove parentheses (keep content)
+ * 6. Collapse consecutive hyphens
+ * 7. Remove leading/trailing hyphens
+ * 8. Handle empty → "untitled"
+ * 9. Limit to 200 characters
+ * 10. Add .md extension
+ *
+ * Edge Cases Handled:
+ * - Unicode characters (removed or transliterated)
+ * - Special characters (/, \, :, *, ?, ", |, <, >, etc.)
+ * - Very long names (truncated to 200 chars)
+ * - Names starting with numbers (allowed)
+ * - Empty/whitespace-only names (default to "untitled")
+ *
+ * @module milestone-sanitizer
+ */
+/**
+ * Convert Jira milestone name to filesystem-safe filename.
+ *
+ * @param milestoneName - Full Jira milestone name (e.g., "APM-R: App: January 2026 (W51, W1, W3)")
+ * @returns Filesystem-safe filename with .md extension (e.g., "apm-r-app-january-2026-w51-w1-w3.md")
+ *
+ * @example
+ * ```typescript
+ * sanitizeMilestoneName("APM-R: App: January 2026 (W51, W1, W3)")
+ * // Returns: 'apm-r-app-january-2026-w51-w1-w3.md'
+ *
+ * sanitizeMilestoneName("UC1-MVP")
+ * // Returns: 'uc1-mvp.md'
+ *
+ * sanitizeMilestoneName("Demo")
+ * // Returns: 'demo.md'
+ *
+ * sanitizeMilestoneName("Q1 2026: Planning & Design")
+ * // Returns: 'q1-2026-planning-design.md'
+ * ```
+ */
+export function sanitizeMilestoneName(milestoneName) {
+    // Handle null, undefined, or non-string input
+    if (!milestoneName || typeof milestoneName !== 'string') {
+        return 'untitled.md';
+    }
+    // Step 1: Normalize unicode characters
+    // Convert accented characters to ASCII equivalents (e.g., é → e)
+    // Note: Node.js doesn't have direct NFKD normalization like Python's unicodedata
+    // We use NFD (canonical decomposition) which is similar for most cases
+    const normalized = milestoneName.normalize('NFD');
+    // Remove all diacritic marks (Unicode combining characters)
+    const asciiName = normalized.replace(/[\u0300-\u036f]/g, '');
+    // Step 2: Convert to lowercase
+    const lowered = asciiName.toLowerCase();
+    // Step 3: Remove filesystem-unsafe and special characters
+    // Keep only: alphanumerics, hyphens, underscores, spaces (to be converted next)
+    // Characters to remove: / \ : * ? " | < > , & . and others
+    const unsafeChars = /[/\\:*?"<>|,&.]/g;
+    const cleaned = lowered.replace(unsafeChars, '');
+    // Step 4: Replace spaces (including tabs, newlines, etc.) with hyphens
+    const spaced = cleaned.replace(/\s+/g, '-');
+    // Step 5: Remove parentheses but keep their content
+    // "something (details)" → "something-details"
+    const parenthesized = spaced.replace(/[()]/g, '');
+    // Step 6: Collapse multiple consecutive hyphens into single hyphen
+    const dehyphenated = parenthesized.replace(/-+/g, '-');
+    // Step 7: Remove leading and trailing hyphens
+    let trimmed = dehyphenated.replace(/^-+|-+$/g, '');
+    // Step 8: Handle empty string
+    if (!trimmed) {
+        return 'untitled.md';
+    }
+    // Step 9: Limit to 200 characters (filesystem safety on some systems)
+    if (trimmed.length > 200) {
+        trimmed = trimmed.substring(0, 200);
+        // Remove trailing hyphens after truncation
+        trimmed = trimmed.replace(/-+$/, '');
+    }
+    // Step 10: Add .md extension
+    return `${trimmed}.md`;
+}
+/**
+ * Validate that a filename matches the sanitization pattern.
+ *
+ * @param filename - Filename to validate
+ * @returns True if filename is valid, False otherwise
+ *
+ * @example
+ * ```typescript
+ * validateMilestoneFilename('apm-r-app-january-2026.md')
+ * // Returns: true
+ *
+ * validateMilestoneFilename('Invalid--Name.md')
+ * // Returns: false (consecutive hyphens)
+ *
+ * validateMilestoneFilename('UPPERCASE.md')
+ * // Returns: false (must be lowercase)
+ * ```
+ */
+export function validateMilestoneFilename(filename) {
+    if (!filename) {
+        return false;
+    }
+    // Must end with .md
+    if (!filename.endsWith('.md')) {
+        return false;
+    }
+    // Must be lowercase
+    if (filename !== filename.toLowerCase()) {
+        return false;
+    }
+    // Must not contain unsafe characters
+    const unsafeChars = /[/\\:*?"<>|()]/;
+    if (unsafeChars.test(filename)) {
+        return false;
+    }
+    // Must not have consecutive hyphens
+    if (filename.includes('--')) {
+        return false;
+    }
+    // Must not start or end with hyphen
+    const base = filename.replace('.md', '');
+    if (base.startsWith('-') || base.endsWith('-')) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=milestone-sanitizer.js.map

package/dist/lib/backlog/milestone-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-sanitizer.js","sourceRoot":"","sources":["../../../src/lib/backlog/milestone-sanitizer.ts"],"names":[],"mappings":"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"}

package/dist/lib/backlog/prompt-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wrapper for inquirer to enable easier testing
+ *
+ * This module wraps inquirer's prompt function to make it easier to mock in tests.
+ * Since inquirer is an ESM-only package, wrapping it allows us to use CommonJS mocks in Jest.
+ */
+import inquirer, { Answers } from 'inquirer';
+export declare function prompt<T extends Answers = Answers>(questions: Parameters<typeof inquirer.prompt>[0]): Promise<T>;
+//# sourceMappingURL=prompt-utils.d.ts.map

package/dist/lib/backlog/prompt-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/prompt-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE7C,wBAAsB,MAAM,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEtH"}

package/dist/lib/backlog/prompt-utils.js

@@ -0,0 +1,11 @@
+/**
+ * Wrapper for inquirer to enable easier testing
+ *
+ * This module wraps inquirer's prompt function to make it easier to mock in tests.
+ * Since inquirer is an ESM-only package, wrapping it allows us to use CommonJS mocks in Jest.
+ */
+import inquirer from 'inquirer';
+export async function prompt(questions) {
+    return inquirer.prompt(questions);
+}
+//# sourceMappingURL=prompt-utils.js.map

package/dist/lib/backlog/prompt-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-utils.js","sourceRoot":"","sources":["../../../src/lib/backlog/prompt-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAqB,MAAM,UAAU,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,MAAM,CAA8B,SAAgD;IACxG,OAAO,QAAQ,CAAC,MAAM,CAAI,SAAS,CAAC,CAAC;AACvC,CAAC"}