cc-agentic-framework 1.14.1

package/dist/lib/backlog/ticket-processor.js

@@ -0,0 +1,422 @@
+/**
+ * Ticket Processing Module
+ *
+ * Transforms CSV ticket data into markdown files with YAML frontmatter.
+ * Handles ticket file creation, frontmatter generation, and directory organization.
+ *
+ * Based on import_jira_data.py ticket processing sections.
+ *
+ * @module ticket-processor
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { stringifyFrontmatter } from '../common/yaml-frontmatter.js';
+/**
+ * Issue type mapping from Jira to document type
+ */
+const ISSUE_TYPE_MAP = {
+    Story: 'story',
+    Task: 'task',
+    Bug: 'bug',
+    Spike: 'spike',
+    Epic: 'epic',
+    'Sub-task': 'task', // Sub-tasks treated as tasks
+};
+/**
+ * Folder mapping for ticket types
+ */
+const FOLDER_MAP = {
+    story: 'stories',
+    task: 'tasks',
+    bug: 'bugs',
+    spike: 'spikes',
+};
+/**
+ * Priority mapping to P0/P1/P2 format
+ */
+const PRIORITY_MAP = {
+    Critical: 'P0',
+    High: 'P1',
+    Medium: 'P2',
+    Low: 'P2',
+};
+/**
+ * Convert text to kebab-case filename.
+ *
+ * Removes ticket prefixes, project prefixes, special characters.
+ * Limits length to 60 characters.
+ *
+ * @param text - Input text (e.g., "APM-R: FE: PCR Analyzer: Fix shimmer loading")
+ * @returns Kebab-case filename (e.g., "fix-shimmer-loading")
+ *
+ * @example
+ * ```typescript
+ * sanitizeFilename("DAPM-1315: Fix Shimmer Loading")
+ * // Returns: "fix-shimmer-loading"
+ *
+ * sanitizeFilename("APM-R: FE: Component: Fix Bug")
+ * // Returns: "fix-bug"
+ * ```
+ */
+export function sanitizeFilename(text) {
+    // Remove Jira ticket prefix if present (e.g., "DAPM-1315: " -> "")
+    let cleaned = text.replace(/^[A-Z]+-\d+:?\s*/, '');
+    // Remove project prefix patterns like "APM-R: FE: Component:"
+    cleaned = cleaned.replace(/^APM-R:\s*(?:FE|BE|FS|App|Bug):\s*/, '');
+    cleaned = cleaned.replace(/^APM-R:\s*/, '');
+    // Remove component prefix patterns like "Component: " (but not single-word prefixes like "Fix:")
+    // Only remove if it's a multi-word prefix or specific component patterns
+    cleaned = cleaned.replace(/^[A-Z][a-zA-Z]+(?:\s+[A-Z][a-zA-Z]+)*:\s+/, '');
+    // Convert to lowercase
+    cleaned = cleaned.toLowerCase();
+    // Replace spaces and special chars with hyphens
+    cleaned = cleaned.replace(/[^\w\s-]/g, '');
+    cleaned = cleaned.replace(/[-\s]+/g, '-');
+    // Remove leading/trailing hyphens
+    cleaned = cleaned.replace(/^-+|-+$/g, '');
+    // Limit length to ~60 chars to leave room for ticket number prefix
+    if (cleaned.length > 60) {
+        cleaned = cleaned.substring(0, 60);
+        // Split at last hyphen to avoid cutting mid-word
+        const lastHyphen = cleaned.lastIndexOf('-');
+        if (lastHyphen > 0) {
+            cleaned = cleaned.substring(0, lastHyphen);
+        }
+    }
+    return cleaned;
+}
+/**
+ * Convert Jira wiki markup to markdown.
+ *
+ * @param jiraText - Jira wiki markup text
+ * @returns Markdown formatted text
+ *
+ * @example
+ * ```typescript
+ * convertJiraToMarkdown("h2. Header\nThis is *bold*")
+ * // Returns: "## Header\nThis is **bold**"
+ * ```
+ */
+export function convertJiraToMarkdown(jiraText) {
+    if (!jiraText || jiraText.trim() === '') {
+        return '';
+    }
+    let text = String(jiraText);
+    // Code blocks (must be done FIRST to protect code content)
+    text = text.replace(/\{noformat\}/g, '```');
+    text = text.replace(/\{code(?::[a-z]+)?\}/g, '```');
+    // Inline code (must be done early to protect code content)
+    text = text.replace(/\{\{([^}]+)\}\}/g, '`$1`');
+    // Numbered lists (must be done BEFORE headers to avoid conflict with # symbol)
+    text = text.replace(/^#\s+/gm, '1. ');
+    // Bullet lists (asterisk lists)
+    text = text.replace(/^\*\s+/gm, '- ');
+    // Headers (must be done AFTER list conversions to avoid conflicts)
+    text = text.replace(/^h1\.\s+(.+)$/gm, '# $1');
+    text = text.replace(/^h2\.\s+(.+)$/gm, '## $1');
+    text = text.replace(/^h3\.\s+(.+)$/gm, '### $1');
+    text = text.replace(/^h4\.\s+(.+)$/gm, '#### $1');
+    // Bold (must be done AFTER list conversions to avoid conflicts with *)
+    text = text.replace(/\*([^*]+)\*/g, '**$1**');
+    // Links
+    text = text.replace(/\[([^|]+)\|([^\]]+)\]/g, '[$1]($2)');
+    // Remove Jira smart-link annotations
+    text = text.replace(/\|smart-link/g, '');
+    return text;
+}
+/**
+ * Extract acceptance criteria from Jira field.
+ *
+ * Converts Jira markup and extracts bullet points, removing "Verify" prefix.
+ *
+ * @param acText - Raw acceptance criteria text from Jira
+ * @returns List of criteria strings
+ *
+ * @example
+ * ```typescript
+ * extractAcceptanceCriteria("- Verify feature works\n- Verify no errors")
+ * // Returns: ["feature works", "no errors"]
+ * ```
+ */
+export function extractAcceptanceCriteria(acText) {
+    if (!acText || acText.trim() === '') {
+        return [];
+    }
+    // Convert to markdown first
+    const text = convertJiraToMarkdown(acText);
+    // Extract bullet points
+    const criteria = [];
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('- ') || trimmed.startsWith('* ')) {
+            let criterion = trimmed.substring(2).trim();
+            // Remove "Verify" prefix if present (handles both plain and bold)
+            // Matches: Verify, *Verify*, **Verify**
+            criterion = criterion.replace(/^(\*{1,2})?Verify(\*{1,2})?\s+/i, '');
+            if (criterion) {
+                criteria.push(criterion);
+            }
+        }
+    }
+    return criteria;
+}
+/**
+ * Parse Jira date format to ISO 8601 (YYYY-MM-DD).
+ *
+ * @param jiraDateStr - Jira date string (e.g., "18/Nov/25 12:59 PM" or "2025-11-18")
+ * @returns ISO 8601 date string (YYYY-MM-DD) or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * parseJiraDate("18/Nov/25 12:59 PM")
+ * // Returns: "2025-11-18"
+ * ```
+ */
+export function parseJiraDate(jiraDateStr) {
+    if (!jiraDateStr || jiraDateStr.trim() === '') {
+        return null;
+    }
+    const trimmed = jiraDateStr.trim();
+    // Try parsing Jira format: "18/Nov/25 12:59 PM"
+    try {
+        const datePart = trimmed.split(' ')[0];
+        const [day, month, year] = datePart.split('/');
+        // Month name to number mapping
+        const months = {
+            Jan: '01',
+            Feb: '02',
+            Mar: '03',
+            Apr: '04',
+            May: '05',
+            Jun: '06',
+            Jul: '07',
+            Aug: '08',
+            Sep: '09',
+            Oct: '10',
+            Nov: '11',
+            Dec: '12',
+        };
+        if (day && month && year && months[month]) {
+            // Convert 2-digit year to 4-digit (25 -> 2025)
+            const fullYear = year.length === 2 ? `20${year}` : year;
+            return `${fullYear}-${months[month]}-${day.padStart(2, '0')}`;
+        }
+    }
+    catch {
+        // Continue to next parsing attempt
+    }
+    // Try ISO format: "2025-11-18"
+    if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) {
+        return trimmed;
+    }
+    return null;
+}
+/**
+ * Generate YAML frontmatter for ticket file (v10.1.1 format).
+ *
+ * Uses flat structure with jira-* and framework-* prefixes.
+ *
+ * @param ticket - Ticket data from CSV
+ * @param milestone - Optional milestone ID for framework-milestone field
+ * @returns Frontmatter data object
+ *
+ * @example
+ * ```typescript
+ * const frontmatter = generateTicketFrontmatter(ticket, 'Nov2025');
+ * ```
+ */
+export function generateTicketFrontmatter(ticket, milestone) {
+    // Map issue type to document type
+    const documentType = ISSUE_TYPE_MAP[ticket.issueType] || 'task';
+    // Map priority
+    const priorityCode = PRIORITY_MAP[ticket.priority] || 'P2';
+    // Parse dates
+    const today = new Date().toISOString().split('T')[0];
+    const createdDate = parseJiraDate(ticket.created) || today;
+    const updatedDate = parseJiraDate(ticket.updated) || today;
+    // Parse labels
+    let labels = [];
+    if (ticket.labels) {
+        labels = ticket.labels
+            .split(/[,\n]/)
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0);
+    }
+    if (labels.length === 0) {
+        labels = ['apm-r'];
+    }
+    // Build frontmatter (v10.1.1 flat structure)
+    const frontmatter = {};
+    // Generic fields (no prefix)
+    frontmatter.documentType = documentType;
+    frontmatter.version = '1.0';
+    frontmatter.title = ticket.summary;
+    frontmatter.description = ticket.summary.substring(0, 150); // Truncate to 150 chars
+    frontmatter.component = 'APM:  Reliability App'; // Exactly 2 spaces (critical!)
+    frontmatter.priority = priorityCode;
+    if (ticket.storyPoints !== undefined) {
+        frontmatter.storyPoints = ticket.storyPoints;
+    }
+    frontmatter.labels = labels;
+    frontmatter.createdDate = createdDate;
+    frontmatter.exportedDate = updatedDate;
+    // Jira fields (jira-* prefix)
+    frontmatter['jira-ticketId'] = ticket.ticketId;
+    frontmatter['jira-url'] = `https://wencosupport.atlassian.net/browse/${ticket.ticketId}`;
+    if (ticket.parentKey) {
+        frontmatter['jira-parent'] = ticket.parentKey;
+    }
+    frontmatter['jira-related'] = []; // Empty initially
+    frontmatter['jira-blocking'] = []; // Empty initially
+    frontmatter['jira-blockedBy'] = []; // Empty initially
+    // jira-fixVersion and jira-internalNotes are optional, only set if provided
+    // Framework fields (framework-* prefix)
+    frontmatter['framework-documentation'] = null;
+    frontmatter['framework-milestone'] = milestone || null;
+    frontmatter['framework-technicalGuides'] = [];
+    frontmatter['framework-relatedLocal'] = [];
+    return frontmatter;
+}
+/**
+ * Generate ticket body content (v10.1.1 format).
+ *
+ * Includes:
+ * - Title
+ * - Section dividers
+ * - Description section with user story
+ * - Acceptance criteria section
+ *
+ * @param ticket - Ticket data from CSV
+ * @param documentType - Document type (story, task, bug, etc.)
+ * @returns Markdown body content (without frontmatter)
+ *
+ * @example
+ * ```typescript
+ * const body = generateTicketBody(ticket, 'story');
+ * ```
+ */
+export function generateTicketBody(ticket, documentType) {
+    let content = '';
+    // Title
+    content += `# ${ticket.summary}\n\n`;
+    // Section divider before Description
+    content += '---\n\n';
+    // Description section
+    content += '## Description\n\n';
+    // User story (AS/WANT/SO THAT) - REQUIRED for stories/tasks
+    if (documentType === 'story' || documentType === 'task') {
+        content += '**AS** a user,\n';
+        content += `**I WANT** ${ticket.summary.toLowerCase()},\n`;
+        content += '**SO THAT** I can achieve the desired outcome.\n\n';
+    }
+    // Description content with bold labels instead of H3
+    if (ticket.description) {
+        let descMd = convertJiraToMarkdown(ticket.description);
+        // Replace H3 headings with bold labels
+        // Handle: ### heading → **heading:**
+        descMd = descMd.replace(/^### (.+?)$/gm, '**$1:**');
+        // Clean up double bold: ****heading:**:** → **heading:**
+        descMd = descMd.replace(/\*\*\*\*(.+?)\*\*:\*\*:/g, '**$1:**');
+        content += `${descMd}\n\n`;
+    }
+    // Section divider after Description
+    content += '---\n\n';
+    // Acceptance Criteria section
+    content += '## Acceptance Criteria\n\n';
+    const acList = extractAcceptanceCriteria(ticket.acceptanceCriteria);
+    if (acList.length > 0) {
+        for (const ac of acList) {
+            content += `- **Verify** ${ac}\n`;
+        }
+    }
+    else {
+        content += '- **Verify** implementation meets requirements\n';
+    }
+    return content;
+}
+/**
+ * Get the file path for a ticket based on its type and options.
+ *
+ * @param ticket - Ticket data from CSV
+ * @param options - Processing options
+ * @param documentType - Document type (story, task, bug, epic, spike)
+ * @returns Absolute file path for the ticket
+ *
+ * @example
+ * ```typescript
+ * const filePath = getTicketFilePath(ticket, options, 'story');
+ * // Returns: "/path/to/backlog/tickets/stories/1315-fix-shimmer-loading.md"
+ * ```
+ */
+export function getTicketFilePath(ticket, options, documentType) {
+    // Extract ticket number from issue key (e.g., "DAPM-1315" -> "1315")
+    const ticketNumber = ticket.ticketId.replace(/^[A-Z]+-/, '');
+    // Generate filename base
+    const filenameBase = sanitizeFilename(ticket.summary);
+    const filename = `${ticketNumber}-${filenameBase}.md`;
+    // Determine folder
+    let folder;
+    if (documentType === 'epic') {
+        folder = path.join(options.basePath, 'epics');
+    }
+    else {
+        const folderName = FOLDER_MAP[documentType] || 'tasks';
+        folder = path.join(options.basePath, 'tickets', folderName);
+    }
+    return path.join(folder, filename);
+}
+/**
+ * Process a single ticket: generate markdown file with YAML frontmatter.
+ *
+ * Creates or updates ticket file in the appropriate directory.
+ *
+ * @param ticket - CSV ticket data
+ * @param options - Processing options
+ * @returns Processing result with file path and status
+ *
+ * @example
+ * ```typescript
+ * const result = await processTicket(ticket, {
+ *   basePath: 'backlog',
+ *   importType: 'sprint',
+ *   sprintId: '2025-W50',
+ *   dryRun: false
+ * });
+ * ```
+ */
+export async function processTicket(ticket, options) {
+    // Map issue type to document type
+    const documentType = ISSUE_TYPE_MAP[ticket.issueType] || 'task';
+    // Determine milestone
+    const milestone = options.importType === 'milestone' ? options.milestoneId : undefined;
+    // Generate frontmatter
+    const frontmatter = generateTicketFrontmatter(ticket, milestone);
+    // Generate body
+    const body = generateTicketBody(ticket, documentType);
+    // Combine frontmatter and body
+    const content = stringifyFrontmatter(frontmatter, body);
+    // Get file path
+    const filePath = getTicketFilePath(ticket, options, documentType);
+    // Check if file exists
+    const fileExists = await fs.pathExists(filePath);
+    // Dry run mode
+    if (options.dryRun) {
+        return {
+            filePath,
+            content,
+            created: false,
+            updated: false,
+        };
+    }
+    // Create directory if needed
+    await fs.ensureDir(path.dirname(filePath));
+    // Write file
+    await fs.writeFile(filePath, content, 'utf-8');
+    return {
+        filePath,
+        content,
+        created: !fileExists,
+        updated: fileExists,
+    };
+}
+//# sourceMappingURL=ticket-processor.js.map

package/dist/lib/backlog/ticket-processor.js.map

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

package/dist/lib/backlog/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared types for backlog module
+ *
+ * @module types
+ */
+/**
+ * CSV ticket data structure
+ */
+export interface CsvTicket {
+    ticketId: string;
+    summary: string;
+    issueType: string;
+    documentType: 'story' | 'task' | 'bug' | 'spike' | 'epic';
+    description?: string;
+    status?: string;
+    priority?: string;
+    storyPoints?: number;
+    parentKey?: string;
+    parentSummary?: string;
+    epic?: string;
+    sprint?: string;
+    fixVersions?: string;
+    milestone?: string;
+    labels?: string[];
+    acceptanceCriteria?: string;
+    assignee?: string;
+    createdDate?: string;
+    updatedDate?: string;
+    filename: string;
+    reporter?: string;
+    component?: string;
+    dueDate?: string;
+    linkedIssues?: string[];
+    epicLink?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/backlog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/lib/backlog/types.js

@@ -0,0 +1,7 @@
+/**
+ * Shared types for backlog module
+ *
+ * @module types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/backlog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/backlog/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lib/backlog/validator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Backlog Validator
+ *
+ * Validates all backlog tickets for completeness and cross-reference integrity.
+ *
+ * Checks:
+ * - YAML frontmatter completeness (required fields)
+ * - Cross-references (epic links, ticket dependencies)
+ * - Milestone codes exist
+ * - File naming conventions
+ * - Link validity
+ *
+ * @module backlog/validator
+ */
+/**
+ * Custom error for ticket validation failures
+ */
+export declare class TicketValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validation report tracking results
+ */
+export declare class ValidationReport {
+    valid: number;
+    warnings: string[];
+    errors: string[];
+    /**
+     * Add a warning to the report
+     */
+    addWarning(filePath: string, message: string): void;
+    /**
+     * Add an error to the report
+     */
+    addError(filePath: string, message: string): void;
+    /**
+     * Mark a ticket as valid
+     */
+    addValid(): void;
+    /**
+     * Get formatted summary of validation results
+     */
+    getSummary(): string;
+}
+/**
+ * Validate a single ticket file
+ *
+ * @param filePath - Path to ticket file
+ * @param report - ValidationReport to track results
+ * @param basePath - Optional base path for relative path calculation
+ */
+export declare function validateTicket(filePath: string, report: ValidationReport, basePath?: string): Promise<void>;
+/**
+ * Validate all tickets in a backlog directory
+ *
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - Show detailed progress
+ * @returns ValidationReport with results
+ */
+export declare function validateBacklog(backlogDir: string, verbose?: boolean): Promise<ValidationReport>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/backlog/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AA0CD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,KAAK,EAAE,MAAM,CAAK;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAM;IACxB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,UAAU,IAAI,MAAM;CA6BrB;AAkBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAsGf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAkE3B"}