cc-agentic-framework 1.14.1

package/dist/lib/backlog/jira-lookup.js

@@ -0,0 +1,232 @@
+/**
+ * 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
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { parseFrontmatter } from '../common/yaml-frontmatter.js';
+/**
+ * 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 async function parseSprintFileYaml(sprintFile) {
+    try {
+        const content = await fs.readFile(sprintFile, 'utf-8');
+        // Extract YAML frontmatter
+        if (!content.startsWith('---')) {
+            return null;
+        }
+        const endIdx = content.indexOf('\n---\n', 3);
+        if (endIdx === -1) {
+            return null;
+        }
+        const result = parseFrontmatter(content);
+        const metadata = result.data;
+        // Extract sprint ID from filename (e.g., "2025-W45.md" -> "2025-W45")
+        const sprintId = path.basename(sprintFile, '.md');
+        return {
+            filePath: sprintFile,
+            sprintId,
+            sprintName: metadata.sprintName || undefined,
+            jiraSprintId: metadata.jiraSprintId || undefined,
+            milestone: metadata.milestone || undefined,
+            committed: metadata.committed || 0,
+            ticketCount: metadata.ticketCount || 0,
+        };
+    }
+    catch (error) {
+        console.error(`❌ Error parsing sprint file ${sprintFile}: ${error}`);
+        return 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 async function parseMilestoneFileYaml(milestoneFile) {
+    try {
+        const content = await fs.readFile(milestoneFile, 'utf-8');
+        // Extract YAML frontmatter
+        if (!content.startsWith('---')) {
+            return null;
+        }
+        const endIdx = content.indexOf('\n---\n', 3);
+        if (endIdx === -1) {
+            return null;
+        }
+        const result = parseFrontmatter(content);
+        const metadata = result.data;
+        // Extract milestone ID from filename (e.g., "Jan2026.md" -> "Jan2026")
+        const milestoneId = path.basename(milestoneFile, '.md');
+        return {
+            filePath: milestoneFile,
+            milestoneId,
+            milestoneName: metadata.milestoneName || undefined,
+            jiraMilestoneId: metadata.jiraMilestoneId || undefined,
+            committed: metadata.committed || 0,
+            ticketCount: metadata.ticketCount || 0,
+        };
+    }
+    catch (error) {
+        console.error(`❌ Error parsing milestone file ${milestoneFile}: ${error}`);
+        return 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 async function findSprintByName(sprintName, backlogDir) {
+    const sprintsDir = path.join(backlogDir, 'sprints');
+    if (!(await fs.pathExists(sprintsDir))) {
+        return null;
+    }
+    const files = await fs.readdir(sprintsDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+    for (const file of mdFiles) {
+        const sprintFile = path.join(sprintsDir, file);
+        const sprint = await parseSprintFileYaml(sprintFile);
+        if (sprint && sprint.sprintName === sprintName) {
+            return sprint;
+        }
+    }
+    return 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 async function findSprintByJiraId(jiraSprintId, backlogDir) {
+    const sprintsDir = path.join(backlogDir, 'sprints');
+    if (!(await fs.pathExists(sprintsDir))) {
+        return null;
+    }
+    const files = await fs.readdir(sprintsDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+    for (const file of mdFiles) {
+        const sprintFile = path.join(sprintsDir, file);
+        const sprint = await parseSprintFileYaml(sprintFile);
+        if (sprint && sprint.jiraSprintId === jiraSprintId) {
+            return sprint;
+        }
+    }
+    return 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 async function findMilestoneByName(milestoneName, backlogDir) {
+    const milestonesDir = path.join(backlogDir, 'milestones');
+    if (!(await fs.pathExists(milestonesDir))) {
+        return null;
+    }
+    const files = await fs.readdir(milestonesDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+    for (const file of mdFiles) {
+        const milestoneFile = path.join(milestonesDir, file);
+        const milestone = await parseMilestoneFileYaml(milestoneFile);
+        if (milestone && milestone.milestoneName === milestoneName) {
+            return milestone;
+        }
+    }
+    return 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 async function findMilestoneById(milestoneId, backlogDir) {
+    const milestonesDir = path.join(backlogDir, 'milestones');
+    if (!(await fs.pathExists(milestonesDir))) {
+        return null;
+    }
+    const milestoneFile = path.join(milestonesDir, `${milestoneId}.md`);
+    if (await fs.pathExists(milestoneFile)) {
+        return await parseMilestoneFileYaml(milestoneFile);
+    }
+    return null;
+}
+/**
+ * List all sprint files with metadata.
+ *
+ * @param backlogDir - Path to backlog directory
+ * @returns List of SprintMetadata objects sorted by sprint ID
+ */
+export async function listAllSprints(backlogDir) {
+    const sprints = [];
+    const sprintsDir = path.join(backlogDir, 'sprints');
+    if (!(await fs.pathExists(sprintsDir))) {
+        return sprints;
+    }
+    const files = await fs.readdir(sprintsDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+    for (const file of mdFiles) {
+        const sprintFile = path.join(sprintsDir, file);
+        const sprint = await parseSprintFileYaml(sprintFile);
+        if (sprint) {
+            sprints.push(sprint);
+        }
+    }
+    return sprints.sort((a, b) => a.sprintId.localeCompare(b.sprintId));
+}
+/**
+ * List all milestone files with metadata.
+ *
+ * @param backlogDir - Path to backlog directory
+ * @returns List of MilestoneMetadata objects sorted by milestone ID
+ */
+export async function listAllMilestones(backlogDir) {
+    const milestones = [];
+    const milestonesDir = path.join(backlogDir, 'milestones');
+    if (!(await fs.pathExists(milestonesDir))) {
+        return milestones;
+    }
+    const files = await fs.readdir(milestonesDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+    for (const file of mdFiles) {
+        const milestoneFile = path.join(milestonesDir, file);
+        const milestone = await parseMilestoneFileYaml(milestoneFile);
+        if (milestone) {
+            milestones.push(milestone);
+        }
+    }
+    return milestones.sort((a, b) => a.milestoneId.localeCompare(b.milestoneId));
+}
+//# sourceMappingURL=jira-lookup.js.map

package/dist/lib/backlog/jira-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-lookup.js","sourceRoot":"","sources":["../../../src/lib/backlog/jira-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA6DjE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEvD,2BAA2B;QAC3B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAoB,OAAO,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAE7B,sEAAsE;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAElD,OAAO;YACL,QAAQ,EAAE,UAAU;YACpB,QAAQ;YACR,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,SAAS;YAC5C,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,SAAS;YAChD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,SAAS;YAC1C,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,CAAC;YAClC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAChE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAE1D,2BAA2B;QAC3B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAuB,OAAO,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAE7B,uEAAuE;QACvE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAExD,OAAO;YACL,QAAQ,EAAE,aAAa;YACvB,WAAW;YACX,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,SAAS;YAClD,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,SAAS;YACtD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,CAAC;YAClC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,aAAa,KAAK,KAAK,EAAE,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,UAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEpD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAAoB,EACpB,UAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEpD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,MAAM,IAAI,MAAM,CAAC,YAAY,KAAK,YAAY,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,aAAqB,EACrB,UAAkB;IAElB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE1D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAC9D,IAAI,SAAS,IAAI,SAAS,CAAC,aAAa,KAAK,aAAa,EAAE,CAAC;YAC3D,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,UAAkB;IAElB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE1D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC;IACpE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,OAAO,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEpD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACxD,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE1D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAC9D,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAC/E,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * Interactive prompts for Jira operations
+ *
+ * Provides interactive prompts for missing sprint/milestone data.
+ * Prompts users for Jira IDs when smart lookup cannot find matching
+ * existing files. Supports dry-run mode (no prompts, shows what would be asked).
+ *
+ * Usage:
+ *   import { promptForJiraSprintId, suggestMilestoneIdFromName } from './jira-prompts.js';
+ *
+ *   const jiraId = await promptForJiraSprintId('APM-APP-2026-W1', false);
+ *   const suggested = suggestMilestoneIdFromName('January 2026');
+ */
+/**
+ * Check if the current environment supports interactive prompts
+ *
+ * @returns True if interactive mode is available (TTY and not in CI)
+ */
+export declare function isInteractive(): boolean;
+/**
+ * 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 declare function suggestMilestoneIdFromName(milestoneName: string): string | null;
+/**
+ * Prompt user for Jira sprint ID when not found via smart lookup
+ *
+ * Provides helpful context and examples.
+ *
+ * @param sprintName - Sprint name from CSV (e.g., "APM-APP-2026-W1")
+ * @param dryRun - If true, show what would be prompted but don't actually prompt
+ * @returns Jira sprint ID (numeric string) or null if user skips
+ */
+export declare function promptForJiraSprintId(sprintName: string, dryRun?: boolean): Promise<string | null>;
+/**
+ * Prompt user for milestone ID when not found via smart lookup
+ *
+ * Provides helpful context, examples, and smart suggestion from milestone name.
+ *
+ * @param milestoneName - Milestone name from CSV (e.g., "January 2026 (W51, W1, W3)")
+ * @param dryRun - If true, show what would be prompted but don't actually prompt
+ * @returns Milestone ID (e.g., "Jan2026") or null if user skips
+ */
+export declare function promptForMilestoneId(milestoneName: string, dryRun?: boolean): Promise<string | null>;
+/**
+ * Confirm smart lookup result when name differs from CSV
+ *
+ * Used when sprint found by Jira ID but name differs from CSV.
+ *
+ * @param lookupType - 'sprint' or 'milestone'
+ * @param foundId - Found local ID
+ * @param foundName - Found name from file
+ * @param csvName - Name from CSV
+ * @param dryRun - If true, show what would be confirmed but don't actually prompt
+ * @returns True if confirmed, false otherwise
+ */
+export declare function confirmSmartLookup(lookupType: 'sprint' | 'milestone', foundId: string, foundName: string, csvName: string, dryRun?: boolean): Promise<boolean>;
+//# sourceMappingURL=jira-prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jira-prompts.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/jira-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiD/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0CxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsExB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,QAAQ,GAAG,WAAW,EAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,OAAO,CAAC,CA+BlB"}

package/dist/lib/backlog/jira-prompts.js

@@ -0,0 +1,232 @@
+/**
+ * Interactive prompts for Jira operations
+ *
+ * Provides interactive prompts for missing sprint/milestone data.
+ * Prompts users for Jira IDs when smart lookup cannot find matching
+ * existing files. Supports dry-run mode (no prompts, shows what would be asked).
+ *
+ * Usage:
+ *   import { promptForJiraSprintId, suggestMilestoneIdFromName } from './jira-prompts.js';
+ *
+ *   const jiraId = await promptForJiraSprintId('APM-APP-2026-W1', false);
+ *   const suggested = suggestMilestoneIdFromName('January 2026');
+ */
+import { prompt } from './prompt-utils.js';
+import chalk from 'chalk';
+/**
+ * Check if the current environment supports interactive prompts
+ *
+ * @returns True if interactive mode is available (TTY and not in CI)
+ */
+export function isInteractive() {
+    return Boolean(process.stdin.isTTY) && !process.env.CI;
+}
+/**
+ * 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 name to abbreviation 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;
+}
+/**
+ * Prompt user for Jira sprint ID when not found via smart lookup
+ *
+ * Provides helpful context and examples.
+ *
+ * @param sprintName - Sprint name from CSV (e.g., "APM-APP-2026-W1")
+ * @param dryRun - If true, show what would be prompted but don't actually prompt
+ * @returns Jira sprint ID (numeric string) or null if user skips
+ */
+export async function promptForJiraSprintId(sprintName, dryRun = false) {
+    if (dryRun) {
+        console.error(chalk.blue(`ℹ️  [DRY RUN] Would prompt: Enter Jira sprint ID for '${sprintName}' (numeric, e.g., 16786)`));
+        return null;
+    }
+    if (!isInteractive()) {
+        console.error(chalk.blue('ℹ️  Non-interactive mode. Skipping prompt.'));
+        return null;
+    }
+    // Display context
+    console.error(chalk.yellow(`\n⚠️  Sprint '${sprintName}' not found in existing sprints.`));
+    console.error(chalk.blue('ℹ️  Need Jira sprint ID to find or create sprint file.'));
+    console.error(chalk.blue('ℹ️  Jira sprint IDs are numeric (e.g., 16786, 16787)'));
+    console.error(chalk.blue('ℹ️  Find sprint ID in Jira: Projects → APM → Backlog → Sprint details'));
+    const { sprintId } = await prompt([
+        {
+            type: 'input',
+            name: 'sprintId',
+            message: `Enter Jira sprint ID for '${sprintName}' (or press Enter to skip):`,
+            validate: (input) => {
+                if (!input) {
+                    return true; // Allow empty (skip)
+                }
+                if (!/^\d+$/.test(input)) {
+                    return 'Invalid format. Sprint ID must be numeric (e.g., 16786)';
+                }
+                return true;
+            },
+        },
+    ]);
+    if (!sprintId) {
+        console.error(chalk.yellow('⚠️  Skipping. New sprint file will be created.'));
+        return null;
+    }
+    return sprintId;
+}
+/**
+ * Prompt user for milestone ID when not found via smart lookup
+ *
+ * Provides helpful context, examples, and smart suggestion from milestone name.
+ *
+ * @param milestoneName - Milestone name from CSV (e.g., "January 2026 (W51, W1, W3)")
+ * @param dryRun - If true, show what would be prompted but don't actually prompt
+ * @returns Milestone ID (e.g., "Jan2026") or null if user skips
+ */
+export async function promptForMilestoneId(milestoneName, dryRun = false) {
+    const suggested = suggestMilestoneIdFromName(milestoneName);
+    if (dryRun) {
+        let promptText = `Enter milestone ID for '${milestoneName}'`;
+        if (suggested) {
+            promptText += ` (suggested: ${suggested})`;
+        }
+        promptText += ' (e.g., Jan2026, Nov2025)';
+        console.error(chalk.blue(`ℹ️  [DRY RUN] Would prompt: ${promptText}`));
+        return null;
+    }
+    if (!isInteractive()) {
+        console.error(chalk.blue('ℹ️  Non-interactive mode.'));
+        if (suggested) {
+            console.error(chalk.blue(`ℹ️  Using suggested milestone ID: ${suggested}`));
+            return suggested;
+        }
+        console.error(chalk.blue('ℹ️  No suggestion available. Skipping prompt.'));
+        return null;
+    }
+    // Display context
+    console.error(chalk.yellow(`\n⚠️  Milestone '${milestoneName}' not found in existing milestones.`));
+    console.error(chalk.blue('ℹ️  Need milestone ID for milestone file (v11.1+).'));
+    console.error(chalk.blue('ℹ️  Milestone filename will be generated from Jira name using sanitization.'));
+    console.error(chalk.blue('ℹ️  Use any ID format: Jan2026, UC2, PostUC2, Demo, etc.'));
+    if (suggested) {
+        console.error(chalk.blue(`ℹ️  Suggestion from name: ${suggested}`));
+    }
+    const { milestoneId } = await prompt([
+        {
+            type: 'input',
+            name: 'milestoneId',
+            message: suggested
+                ? `Enter milestone ID for '${milestoneName}' (default: ${suggested}):`
+                : `Enter milestone ID for '${milestoneName}' (or press Enter to skip):`,
+            default: suggested || undefined,
+            validate: (input) => {
+                // Empty with suggestion is valid (uses default)
+                if (!input && suggested) {
+                    return true;
+                }
+                // Empty without suggestion means skip
+                if (!input) {
+                    return true;
+                }
+                // Validate alphanumeric format
+                if (!/^[A-Za-z0-9\-_]+$/.test(input)) {
+                    return 'Invalid format. Use alphanumeric format (letters, numbers, hyphens): Jan2026, UC2, Post-UC2, etc.';
+                }
+                return true;
+            },
+        },
+    ]);
+    // Handle empty input with suggestion (use suggestion)
+    if (!milestoneId && suggested) {
+        return suggested;
+    }
+    if (!milestoneId) {
+        console.error(chalk.yellow('⚠️  Skipping. New milestone file will be created.'));
+        return null;
+    }
+    return milestoneId;
+}
+/**
+ * Confirm smart lookup result when name differs from CSV
+ *
+ * Used when sprint found by Jira ID but name differs from CSV.
+ *
+ * @param lookupType - 'sprint' or 'milestone'
+ * @param foundId - Found local ID
+ * @param foundName - Found name from file
+ * @param csvName - Name from CSV
+ * @param dryRun - If true, show what would be confirmed but don't actually prompt
+ * @returns True if confirmed, false otherwise
+ */
+export async function confirmSmartLookup(lookupType, foundId, foundName, csvName, dryRun = false) {
+    if (dryRun) {
+        console.error(chalk.blue(`ℹ️  [DRY RUN] Would confirm: ${lookupType} renamed? '${foundName}' → '${csvName}'`));
+        return true;
+    }
+    if (!isInteractive()) {
+        console.error(chalk.blue('ℹ️  Non-interactive mode. Using existing name.'));
+        return false;
+    }
+    // Display context
+    console.error(chalk.yellow(`\n⚠️  ${lookupType.charAt(0).toUpperCase() + lookupType.slice(1)} appears to have been renamed.`));
+    console.error(chalk.blue(`ℹ️  Found: '${foundName}'`));
+    console.error(chalk.blue(`ℹ️  CSV has: '${csvName}'`));
+    console.error(chalk.blue(`ℹ️  Local ID: ${foundId}`));
+    const { confirm } = await prompt([
+        {
+            type: 'confirm',
+            name: 'confirm',
+            message: `Update ${lookupType} name to CSV value? '${foundName}' → '${csvName}'`,
+            default: false,
+        },
+    ]);
+    return confirm;
+}
+//# sourceMappingURL=jira-prompts.js.map

package/dist/lib/backlog/jira-prompts.js.map

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

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

@@ -0,0 +1,123 @@
+/**
+ * CSV validation and data extraction for Jira imports.
+ *
+ * Validates CSV schema, extracts sprint/milestone data, and validates
+ * argument formats before import processing.
+ *
+ * @module jira-validators
+ */
+/**
+ * CSV validation error
+ */
+export declare class CsvValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Result of CSV validation
+ */
+export interface CsvValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Data extracted from CSV for import
+ */
+export interface CsvExtraction {
+    sprintName?: string;
+    milestoneName?: string;
+    uniqueSprints: string[];
+    uniqueMilestones: string[];
+    hasSprintColumn: boolean;
+    hasFixVersionsColumn: boolean;
+}
+/**
+ * Result of argument validation
+ */
+export interface ArgumentValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate CSV file schema and required columns.
+ *
+ * @param csvPath - Path to CSV file
+ * @param importType - 'sprint' or 'milestone'
+ * @param verbose - Print detailed validation messages
+ * @returns Validation result with errors
+ */
+export declare function validateCsvSchema(csvPath: string, importType: 'sprint' | 'milestone', verbose?: boolean): Promise<CsvValidationResult>;
+/**
+ * Extract sprint data from CSV file.
+ *
+ * Identifies unique sprints in the CSV and extracts sprint names
+ * from the Sprint column.
+ *
+ * @param csvPath - Path to CSV file
+ * @param verbose - Print extraction details
+ * @returns CSV extraction with unique sprints identified
+ */
+export declare function extractSprintDataFromCsv(csvPath: string, verbose?: boolean): Promise<CsvExtraction>;
+/**
+ * Extract milestone data from CSV file.
+ *
+ * Identifies unique milestones in the CSV and extracts milestone names
+ * from the Fix Versions column.
+ *
+ * @param csvPath - Path to CSV file
+ * @param verbose - Print extraction details
+ * @returns CSV extraction with unique milestones identified
+ */
+export declare function extractMilestoneDataFromCsv(csvPath: string, verbose?: boolean): Promise<CsvExtraction>;
+/**
+ * Parse milestone name from Fix Versions string.
+ *
+ * Fix Versions often contains descriptive milestone names.
+ * Example: "January 2026 (W51, W1, W3)" -> "January 2026 (W51, W1, W3)"
+ * Example: "January 2026, February 2026" -> "January 2026"
+ *
+ * Handles multiple top-level milestones by taking the first one,
+ * while preserving commas inside parentheses.
+ *
+ * @param fixVersions - Raw Fix Versions value from CSV
+ * @returns Parsed milestone name or null
+ */
+export declare function parseMilestoneNameFromFixVersions(fixVersions: string): string | null;
+/**
+ * Validate sprint ID format (local ID like "2025-W45").
+ *
+ * Sprint IDs should be: YYYY-WXX format
+ *
+ * @param sprintId - Sprint ID to validate
+ * @returns True if valid format, false otherwise
+ */
+export declare function validateSprintIdFormat(sprintId: string): boolean;
+/**
+ * Validate Jira sprint ID format (numeric only).
+ *
+ * Jira sprint IDs are numeric values (e.g., "16786")
+ *
+ * @param jiraSprintId - Jira sprint ID to validate
+ * @returns True if valid format, false otherwise
+ */
+export declare function validateJiraSprintIdFormat(jiraSprintId: string): boolean;
+/**
+ * Validate milestone ID format (alphanumeric like "Jan2026").
+ *
+ * Milestone IDs should be: Month + Year format (e.g., "Jan2026", "Nov2025")
+ *
+ * @param milestoneId - Milestone ID to validate
+ * @returns True if valid format, false otherwise
+ */
+export declare function validateMilestoneIdFormat(milestoneId: string): boolean;
+/**
+ * Validate command-line arguments based on import type.
+ *
+ * Checks that arguments are in correct format and appropriate for the
+ * specified import type.
+ *
+ * @param argsDict - Dictionary of parsed arguments
+ * @param importType - 'sprint' or 'milestone'
+ * @returns Validation result with errors
+ */
+export declare function validateArguments(argsDict: Record<string, string>, importType: 'sprint' | 'milestone'): ArgumentValidationResult;
+//# sourceMappingURL=jira-validators.d.ts.map