cc-agentic-framework 1.14.1

package/dist/lib/backlog/jira-import-workflows.js

@@ -0,0 +1,339 @@
+/**
+ * Smart lookup and resolution workflows for Jira imports.
+ *
+ * Integrates validators, lookup, and prompts to provide smart sprint/milestone
+ * resolution with user prompting support and rename detection.
+ *
+ * @module jira-import-workflows
+ */
+import { findSprintByName, findSprintByJiraId, findMilestoneByName, findMilestoneById, } from './jira-lookup.js';
+/**
+ * Resolve sprint metadata through smart lookup workflow.
+ *
+ * Workflow:
+ * 1. Extract sprint name from CSV Sprint column
+ * 2. Search existing sprint files by name
+ * 3. If found with jiraSprintId -> use it, no prompt
+ * 4. If not found -> prompt user for Jira sprint ID (or use from args)
+ * 5. If user provides ID -> search by ID
+ * 6. If found by ID -> check if renamed, update name
+ * 7. If not found -> create new sprint
+ *
+ * @param args - Parsed command-line arguments
+ * @param csvData - Extracted CSV data (CSVExtraction)
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - Show detailed output
+ * @returns Sprint resolution with sprint_id, sprint_name, jira_sprint_id
+ * @throws Error if critical validation fails
+ */
+export async function resolveSprintMetadata(args, csvData, backlogDir, verbose = false) {
+    if (verbose) {
+        console.error('🔍 Smart Sprint Lookup:');
+    }
+    // Get sprint name from args or CSV
+    const sprintName = args.sprintName || csvData.sprintName;
+    if (!sprintName) {
+        throw new Error('❌ Cannot determine sprint name from CSV or arguments');
+    }
+    if (verbose) {
+        console.error(`  Sprint Name (CSV): ${sprintName}`);
+    }
+    // Step 2: Search by name
+    if (verbose) {
+        console.error('  Searching by name...');
+    }
+    const foundByName = await findSprintByName(sprintName, backlogDir);
+    if (foundByName) {
+        if (verbose) {
+            console.error(`  ✅ Found by name: ${foundByName.sprintId}`);
+            if (foundByName.jiraSprintId) {
+                console.error(`  ✅ Jira Sprint ID: ${foundByName.jiraSprintId}`);
+            }
+        }
+        if (foundByName.jiraSprintId) {
+            // Step 3: Already have Jira ID, use it
+            return {
+                sprintId: foundByName.sprintId,
+                sprintName,
+                jiraSprintId: foundByName.jiraSprintId,
+            };
+        }
+    }
+    if (verbose) {
+        console.error('  ⚠️  Not found by name, checking for Jira ID...');
+    }
+    // Step 4: Check if Jira sprint ID was provided via args
+    const jiraSprintId = args.jiraSprintId || null;
+    if (jiraSprintId) {
+        // Step 5: Search by Jira ID
+        if (verbose) {
+            console.error(`  Searching by Jira ID: ${jiraSprintId}...`);
+        }
+        const foundById = await findSprintByJiraId(jiraSprintId, backlogDir);
+        if (foundById) {
+            // Step 6: Check if renamed
+            if (verbose) {
+                console.error(`  ✅ Found by ID: ${foundById.sprintId}`);
+            }
+            if (foundById.sprintName !== sprintName) {
+                if (verbose) {
+                    console.error('  ⚠️  Sprint appears to be renamed:');
+                    console.error(`     Old: ${foundById.sprintName}`);
+                    console.error(`     New: ${sprintName}`);
+                }
+                // In dry-run mode, confirm rename would be auto-accepted
+                // In real mode, this would update the sprint file
+                // For now, we'll just log it
+            }
+            return {
+                sprintId: foundById.sprintId,
+                sprintName,
+                jiraSprintId,
+            };
+        }
+    }
+    // Step 7: Create new sprint
+    if (verbose) {
+        console.error('  Creating new sprint file...');
+    }
+    // Extract sprint ID from sprint name (e.g., "APM-APP-2025W45" -> "2025-W45")
+    let sprintId = extractSprintIdFromName(sprintName);
+    if (!sprintId) {
+        sprintId = generateSprintId();
+    }
+    if (verbose) {
+        console.error(`  ✅ New sprint ID: ${sprintId}`);
+    }
+    return {
+        sprintId,
+        sprintName,
+        jiraSprintId,
+    };
+}
+/**
+ * Resolve milestone metadata through smart lookup workflow.
+ *
+ * Workflow:
+ * 1. Extract milestone name from CSV Fix Versions
+ * 2. Search existing milestone files by name
+ * 3. If found -> use existing ID
+ * 4. If not found -> prompt user for milestone ID (suggest from name)
+ * 5. If user provides ID -> search by ID
+ * 6. If found by ID -> check if renamed, update name
+ * 7. If not found -> create new milestone
+ *
+ * @param args - Parsed command-line arguments
+ * @param csvData - Extracted CSV data (CSVExtraction)
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - Show detailed output
+ * @returns Milestone resolution with milestone_id, milestone_name, jira_milestone_id
+ * @throws Error if critical validation fails
+ */
+export async function resolveMilestoneMetadata(args, csvData, backlogDir, verbose = false) {
+    if (verbose) {
+        console.error('🔍 Smart Milestone Lookup:');
+    }
+    // Get milestone name from args or CSV
+    const milestoneName = args.milestoneName || csvData.milestoneName;
+    if (!milestoneName) {
+        throw new Error('❌ Cannot determine milestone name from CSV or arguments');
+    }
+    if (verbose) {
+        console.error(`  Milestone Name (CSV): ${milestoneName}`);
+    }
+    // Step 2: Search by name
+    if (verbose) {
+        console.error('  Searching by name...');
+    }
+    const foundByName = await findMilestoneByName(milestoneName, backlogDir);
+    if (foundByName) {
+        if (verbose) {
+            console.error(`  ✅ Found by name: ${foundByName.milestoneId}`);
+        }
+        return {
+            milestoneId: foundByName.milestoneId,
+            milestoneName,
+            jiraMilestoneId: foundByName.milestoneId,
+        };
+    }
+    if (verbose) {
+        console.error('  ⚠️  Not found by name, checking for milestone ID...');
+    }
+    // Step 3b: Check if jira-milestone-id was provided via CLI
+    const jiraMilestoneIdArg = args.jiraMilestoneId;
+    if (jiraMilestoneIdArg) {
+        if (verbose) {
+            console.error(`  Using provided Jira milestone ID: ${jiraMilestoneIdArg}`);
+        }
+        // In v11.1+, the filename is generated from Jira name via sanitization
+        // Use the provided ID as-is
+        const milestoneId = jiraMilestoneIdArg;
+        if (verbose) {
+            console.error(`  ✅ New milestone with provided Jira ID: ${milestoneId}`);
+        }
+        return {
+            milestoneId,
+            milestoneName,
+            jiraMilestoneId: jiraMilestoneIdArg,
+        };
+    }
+    // Step 4: Suggest milestone ID from name (used in dry-run or when no ID provided)
+    const milestoneId = suggestMilestoneIdFromName(milestoneName);
+    if (!milestoneId) {
+        throw new Error(`❌ Could not determine milestone ID for: ${milestoneName}`);
+    }
+    if (verbose) {
+        console.error(`  Milestone ID: ${milestoneId}`);
+    }
+    // Step 5: Search by ID
+    if (verbose) {
+        console.error(`  Searching by ID: ${milestoneId}...`);
+    }
+    const foundById = await findMilestoneById(milestoneId, backlogDir);
+    if (foundById) {
+        // Step 6: Check if renamed
+        if (verbose) {
+            console.error(`  ✅ Found by ID: ${foundById.milestoneId}`);
+        }
+        if (foundById.milestoneName && foundById.milestoneName !== milestoneName) {
+            if (verbose) {
+                console.error('  ⚠️  Milestone appears to be renamed:');
+                console.error(`     Old: ${foundById.milestoneName}`);
+                console.error(`     New: ${milestoneName}`);
+            }
+            // In dry-run mode, confirm rename would be auto-accepted
+            // In real mode, this would update the milestone file
+            // For now, we'll just log it
+        }
+        return {
+            milestoneId,
+            milestoneName,
+            jiraMilestoneId: milestoneId,
+        };
+    }
+    // Step 7: Create new milestone
+    if (verbose) {
+        console.error('  Creating new milestone file...');
+        console.error(`  ✅ New milestone ID: ${milestoneId}`);
+    }
+    return {
+        milestoneId,
+        milestoneName,
+        jiraMilestoneId: milestoneId,
+    };
+}
+/**
+ * Extract local sprint ID from sprint name.
+ *
+ * Looks for patterns like "APM-APP-2025W45" or "APM-2025W45" and converts
+ * to "2025-W45" format.
+ *
+ * @param sprintName - Sprint name from CSV (e.g., "APM-APP-2025W45")
+ * @returns Sprint ID (e.g., "2025-W45") or null if cannot parse
+ */
+export function extractSprintIdFromName(sprintName) {
+    if (!sprintName) {
+        return null;
+    }
+    // Pattern: year-week (with optional prefix)
+    // Examples: "APM-APP-2025W45" -> "2025-W45"
+    //           "2025W45" -> "2025-W45"
+    const patterns = [
+        /(\d{4})W(\d{1,2})/, // YYYYWNN format
+        /(\d{4})-W(\d{1,2})/, // YYYY-WNN format
+    ];
+    for (const pattern of patterns) {
+        const match = sprintName.match(pattern);
+        if (match) {
+            const year = match[1];
+            const week = match[2];
+            return `${year}-W${week}`;
+        }
+    }
+    return null;
+}
+/**
+ * Generate a new sprint ID based on current date.
+ *
+ * @returns Sprint ID (e.g., "2025-W50")
+ */
+export function generateSprintId() {
+    const now = new Date();
+    // Get ISO week number
+    // ISO week date calculation:
+    // - Week starts on Monday
+    // - Week 1 is the week with the year's first Thursday
+    const getISOWeek = (date) => {
+        const target = new Date(date.valueOf());
+        const dayNr = (date.getDay() + 6) % 7; // Monday = 0, Sunday = 6
+        target.setDate(target.getDate() - dayNr + 3); // Nearest Thursday
+        const firstThursday = target.valueOf();
+        target.setMonth(0, 1); // January 1
+        if (target.getDay() !== 4) {
+            target.setMonth(0, 1 + ((4 - target.getDay() + 7) % 7));
+        }
+        const weekNumber = 1 + Math.ceil((firstThursday - target.valueOf()) / 604800000);
+        return {
+            year: target.getFullYear(),
+            week: weekNumber,
+        };
+    };
+    const { year, week } = getISOWeek(now);
+    return `${year}-W${week}`;
+}
+/**
+ * Suggest milestone ID from milestone name.
+ *
+ * Extracts month abbreviation and year from milestone name.
+ * Examples:
+ *   "January 2026" -> "Jan2026"
+ *   "November 2025" -> "Nov2025"
+ *   "January 2026 (W51, W1, W3)" -> "Jan2026"
+ *
+ * @param milestoneName - Milestone name from CSV (e.g., "January 2026 (W51, W1, W3)")
+ * @returns Suggested milestone ID (e.g., "Jan2026") or null if cannot parse
+ */
+export function suggestMilestoneIdFromName(milestoneName) {
+    if (!milestoneName) {
+        return null;
+    }
+    // Remove everything after parentheses
+    const cleanName = milestoneName.split('(')[0].trim();
+    // Month mapping
+    const months = {
+        january: 'Jan',
+        february: 'Feb',
+        march: 'Mar',
+        april: 'Apr',
+        may: 'May',
+        june: 'Jun',
+        july: 'Jul',
+        august: 'Aug',
+        september: 'Sep',
+        october: 'Oct',
+        november: 'Nov',
+        december: 'Dec',
+    };
+    // Split into words and look for month and year
+    const words = cleanName.toLowerCase().split(/\s+/);
+    let monthAbbr = null;
+    let year = null;
+    for (const word of words) {
+        // Check if word is a month
+        for (const [monthName, abbr] of Object.entries(months)) {
+            if (word.startsWith(monthName)) {
+                monthAbbr = abbr;
+                break;
+            }
+        }
+        // Check if word is a 4-digit year
+        if (/^\d{4}$/.test(word)) {
+            year = word;
+        }
+    }
+    if (monthAbbr && year) {
+        return `${monthAbbr}${year}`;
+    }
+    return null;
+}
+//# sourceMappingURL=jira-import-workflows.js.map

package/dist/lib/backlog/jira-import-workflows.js.map

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

package/dist/lib/backlog/jira-lookup.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Smart lookup for sprints and milestones by name or Jira ID.
+ *
+ * Enables rename detection and prevents duplicates by searching existing
+ * sprint/milestone files by name and Jira ID.
+ *
+ * @module jira-lookup
+ */
+/**
+ * Metadata extracted from sprint file YAML
+ */
+export interface SprintMetadata {
+    /** Path to the sprint file */
+    filePath: string;
+    /** Local ID (e.g., "2025-W45") */
+    sprintId: string;
+    /** Sprint name from CSV Sprint column (e.g., "APM-APP-2025W45") */
+    sprintName?: string;
+    /** Numeric Jira ID (e.g., "16786") */
+    jiraSprintId?: string;
+    /** Associated milestone ID */
+    milestone?: string;
+    /** Committed story points */
+    committed: number;
+    /** Number of tickets in sprint */
+    ticketCount: number;
+}
+/**
+ * Metadata extracted from milestone file YAML
+ */
+export interface MilestoneMetadata {
+    /** Path to the milestone file */
+    filePath: string;
+    /** Local ID (e.g., "Jan2026") */
+    milestoneId: string;
+    /** Full name from CSV (e.g., "January 2026") */
+    milestoneName?: string;
+    /** Jira milestone ID */
+    jiraMilestoneId?: string;
+    /** Committed story points */
+    committed: number;
+    /** Number of tickets in milestone */
+    ticketCount: number;
+}
+/**
+ * Parse YAML frontmatter from sprint file.
+ *
+ * Handles both old format (without jiraSprintId) and new format.
+ *
+ * @param sprintFile - Path to sprint markdown file
+ * @returns SprintMetadata if valid, null if parsing fails
+ */
+export declare function parseSprintFileYaml(sprintFile: string): Promise<SprintMetadata | null>;
+/**
+ * Parse YAML frontmatter from milestone file.
+ *
+ * Handles both old format (without jiraMilestoneId) and new format.
+ *
+ * @param milestoneFile - Path to milestone markdown file
+ * @returns MilestoneMetadata if valid, null if parsing fails
+ */
+export declare function parseMilestoneFileYaml(milestoneFile: string): Promise<MilestoneMetadata | null>;
+/**
+ * Find sprint file by sprint name (from CSV).
+ *
+ * Searches sprints/ directory for matching sprintName in YAML.
+ * Handles both exact matches and normalized comparisons.
+ *
+ * @param sprintName - Sprint name from CSV Sprint column (e.g., "APM-APP-2026-W1")
+ * @param backlogDir - Path to backlog directory
+ * @returns SprintMetadata if found, null otherwise
+ */
+export declare function findSprintByName(sprintName: string, backlogDir: string): Promise<SprintMetadata | null>;
+/**
+ * Find sprint file by Jira sprint ID.
+ *
+ * Searches sprints/ directory for matching jiraSprintId in YAML.
+ * Enables detection of renamed sprints.
+ *
+ * @param jiraSprintId - Numeric Jira sprint ID (e.g., "16786")
+ * @param backlogDir - Path to backlog directory
+ * @returns SprintMetadata if found, null otherwise
+ */
+export declare function findSprintByJiraId(jiraSprintId: string, backlogDir: string): Promise<SprintMetadata | null>;
+/**
+ * Find milestone file by milestone name (from CSV Fix Versions).
+ *
+ * Searches milestones/ directory for matching milestoneName in YAML.
+ * Handles both exact matches and normalized comparisons.
+ *
+ * @param milestoneName - Milestone name from CSV Fix Versions (e.g., "January 2026 (W51, W1, W3)")
+ * @param backlogDir - Path to backlog directory
+ * @returns MilestoneMetadata if found, null otherwise
+ */
+export declare function findMilestoneByName(milestoneName: string, backlogDir: string): Promise<MilestoneMetadata | null>;
+/**
+ * Find milestone file by milestone ID.
+ *
+ * Searches milestones/ directory for matching milestone_id (filename stem).
+ * Enables detection of renamed milestones.
+ *
+ * @param milestoneId - Local milestone ID (e.g., "Jan2026")
+ * @param backlogDir - Path to backlog directory
+ * @returns MilestoneMetadata if found, null otherwise
+ */
+export declare function findMilestoneById(milestoneId: string, backlogDir: string): Promise<MilestoneMetadata | null>;
+/**
+ * List all sprint files with metadata.
+ *
+ * @param backlogDir - Path to backlog directory
+ * @returns List of SprintMetadata objects sorted by sprint ID
+ */
+export declare function listAllSprints(backlogDir: string): Promise<SprintMetadata[]>;
+/**
+ * List all milestone files with metadata.
+ *
+ * @param backlogDir - Path to backlog directory
+ * @returns List of MilestoneMetadata objects sorted by milestone ID
+ */
+export declare function listAllMilestones(backlogDir: string): Promise<MilestoneMetadata[]>;
+//# sourceMappingURL=jira-lookup.d.ts.map

package/dist/lib/backlog/jira-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-lookup.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/jira-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAuBD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAiC5F;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgCrG;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmBhC;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmBhC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmBnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAanC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAoBlF;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoBxF"}