cc-agentic-framework 1.14.1

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

@@ -0,0 +1,281 @@
+/**
+ * Ticket Generator Module
+ *
+ * Generates ticket content in v10.1.1 format including:
+ * - YAML frontmatter with jira-* and framework-* fields
+ * - Structured body with ## Description and ## Acceptance Criteria
+ *
+ * @module ticket-generator
+ */
+import { convertJiraToMarkdown, extractAcceptanceCriteria } from './csv-extractor.js';
+import { extractAsWantSoThat, extractContext, extractRequirements, extractTechnicalNotes } from './content-parser.js';
+/**
+ * Map Jira priority to framework priority (P1/P2/P3).
+ *
+ * @param jiraPriority - Jira priority string (High, Medium, Low, etc.)
+ * @returns Framework priority (P1, P2, or P3)
+ */
+export function mapPriority(jiraPriority) {
+    if (!jiraPriority) {
+        return 'P2';
+    }
+    const normalized = jiraPriority.toLowerCase();
+    if (normalized === 'highest' || normalized === 'high') {
+        return 'P1';
+    }
+    if (normalized === 'lowest' || normalized === 'low') {
+        return 'P3';
+    }
+    return 'P2';
+}
+/**
+ * Generate v10.1.1 compliant YAML frontmatter.
+ *
+ * @param ticket - CSV ticket data
+ * @returns Frontmatter object
+ */
+export function generateFrontmatter(ticket) {
+    // Generate Jira URL
+    const jiraBaseUrl = 'https://wencosupport.atlassian.net/browse';
+    const jiraUrl = `${jiraBaseUrl}/${ticket.ticketId}`;
+    const frontmatter = {
+        documentType: ticket.documentType,
+        title: ticket.summary,
+        description: ticket.summary.substring(0, 150),
+        priority: mapPriority(ticket.priority),
+        exportedDate: null,
+        'jira-ticketId': ticket.ticketId,
+        'jira-url': jiraUrl,
+        'jira-parent': ticket.parentKey || null,
+        'jira-related': [],
+        'jira-blocking': [],
+        'jira-blockedBy': [],
+        'jira-fixVersion': ticket.fixVersions || null,
+        'jira-internalNotes': null,
+        'framework-documentation': null,
+        'framework-milestone': null,
+        'framework-technicalGuides': [],
+        'framework-relatedLocal': [],
+    };
+    // Add optional fields if present
+    if (ticket.storyPoints) {
+        frontmatter.storyPoints = ticket.storyPoints;
+    }
+    if (ticket.milestone) {
+        frontmatter.milestone = ticket.milestone;
+    }
+    if (ticket.labels && ticket.labels.length > 0) {
+        frontmatter.labels = ticket.labels;
+    }
+    if (ticket.sprint) {
+        frontmatter.sprint = ticket.sprint;
+    }
+    if (ticket.assignee) {
+        frontmatter.assignee = ticket.assignee;
+    }
+    if (ticket.createdDate) {
+        frontmatter.createdDate = ticket.createdDate;
+    }
+    if (ticket.updatedDate) {
+        frontmatter.updatedDate = ticket.updatedDate;
+    }
+    return frontmatter;
+}
+/**
+ * Generate ticket body content in v10.1.1 format.
+ *
+ * Structure:
+ * - H1 title
+ * - ---
+ * - ## Description
+ *   - AS/WANT/SO THAT (if story)
+ *   - Context paragraphs
+ *   - Requirements list
+ *   - Technical Notes (if present)
+ * - ---
+ * - ## Acceptance Criteria
+ *
+ * @param ticket - CSV ticket data
+ * @returns Markdown body content
+ */
+export function generateBodyContent(ticket) {
+    const lines = [];
+    // H1 Title
+    lines.push(`# ${ticket.summary}`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    // Description section
+    lines.push('## Description');
+    lines.push('');
+    if (ticket.description) {
+        // Convert Jira markup to markdown
+        const markdownDescription = convertJiraToMarkdown(ticket.description);
+        // Try to extract structured sections
+        const asWantSoThat = extractAsWantSoThat(ticket.description);
+        const context = extractContext(ticket.description);
+        const requirements = extractRequirements(ticket.description);
+        const technicalNotes = extractTechnicalNotes(ticket.description);
+        // AS/WANT/SO THAT for stories
+        if (asWantSoThat && (ticket.documentType === 'story' || ticket.documentType === 'task')) {
+            lines.push(`**AS** ${asWantSoThat.asA},`);
+            lines.push(`**I WANT** ${asWantSoThat.iWant},`);
+            if (asWantSoThat.soThat) {
+                lines.push(`**SO THAT** ${asWantSoThat.soThat}.`);
+            }
+            lines.push('');
+        }
+        // Context
+        if (context) {
+            lines.push('**Context:**');
+            lines.push('');
+            lines.push(context);
+            lines.push('');
+        }
+        else if (!asWantSoThat) {
+            // If no structured content, use the whole description
+            lines.push(markdownDescription);
+            lines.push('');
+        }
+        // Requirements
+        if (requirements.length > 0) {
+            lines.push('**Requirements:**');
+            lines.push('');
+            for (const req of requirements) {
+                lines.push(`- ${req}`);
+            }
+            lines.push('');
+        }
+        // Technical Notes
+        if (technicalNotes.length > 0) {
+            lines.push('**Technical Notes:**');
+            lines.push('');
+            for (const note of technicalNotes) {
+                lines.push(`- ${note}`);
+            }
+            lines.push('');
+        }
+    }
+    else {
+        lines.push('*No description provided*');
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    // Acceptance Criteria section
+    lines.push('## Acceptance Criteria');
+    lines.push('');
+    if (ticket.acceptanceCriteria) {
+        const criteria = extractAcceptanceCriteria(ticket.acceptanceCriteria);
+        if (criteria.length > 0) {
+            for (const criterion of criteria) {
+                lines.push(`- **Verify** ${criterion}`);
+            }
+        }
+        else {
+            // Fall back to raw acceptance criteria
+            const markdownAc = convertJiraToMarkdown(ticket.acceptanceCriteria);
+            lines.push(markdownAc);
+        }
+    }
+    else {
+        // Default acceptance criteria
+        lines.push('- **Verify** implementation meets requirements');
+        lines.push('- **Verify** tests pass');
+        lines.push('- **Verify** code review completed');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format YAML value with proper escaping/quoting.
+ */
+function formatYamlValue(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'null';
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return '[]';
+        }
+        return JSON.stringify(value);
+    }
+    const str = String(value);
+    // Check if value needs quoting (contains special YAML characters)
+    const needsQuotes = /[:#[\]{}|>&*!?,\n]/.test(str) ||
+        str.startsWith('-') ||
+        str.startsWith('@') ||
+        str === 'true' ||
+        str === 'false' ||
+        str === 'null' ||
+        /^\d/.test(str);
+    if (needsQuotes) {
+        // Escape double quotes and wrap
+        const escaped = str.replace(/"/g, '\\"');
+        return `"${escaped}"`;
+    }
+    return str;
+}
+/**
+ * Generate complete ticket content with frontmatter and body.
+ *
+ * @param ticket - CSV ticket data
+ * @returns Complete markdown file content
+ */
+export function generateTicketContent(ticket) {
+    const frontmatter = generateFrontmatter(ticket);
+    const body = generateBodyContent(ticket);
+    // Build YAML frontmatter
+    const yamlLines = [];
+    // Core fields first
+    yamlLines.push(`documentType: ${formatYamlValue(frontmatter.documentType)}`);
+    yamlLines.push(`title: ${formatYamlValue(frontmatter.title)}`);
+    yamlLines.push(`description: ${formatYamlValue(frontmatter.description)}`);
+    yamlLines.push(`priority: ${formatYamlValue(frontmatter.priority)}`);
+    // Optional fields
+    if (frontmatter.storyPoints !== undefined) {
+        yamlLines.push(`storyPoints: ${formatYamlValue(frontmatter.storyPoints)}`);
+    }
+    if (frontmatter.milestone) {
+        yamlLines.push(`milestone: ${formatYamlValue(frontmatter.milestone)}`);
+    }
+    if (frontmatter.labels && frontmatter.labels.length > 0) {
+        yamlLines.push(`labels: ${formatYamlValue(frontmatter.labels)}`);
+    }
+    if (frontmatter.sprint) {
+        yamlLines.push(`sprint: ${formatYamlValue(frontmatter.sprint)}`);
+    }
+    if (frontmatter.assignee) {
+        yamlLines.push(`assignee: ${formatYamlValue(frontmatter.assignee)}`);
+    }
+    if (frontmatter.createdDate) {
+        yamlLines.push(`createdDate: ${formatYamlValue(frontmatter.createdDate)}`);
+    }
+    if (frontmatter.updatedDate) {
+        yamlLines.push(`updatedDate: ${formatYamlValue(frontmatter.updatedDate)}`);
+    }
+    yamlLines.push(`exportedDate: ${formatYamlValue(frontmatter.exportedDate)}`);
+    // Jira integration fields
+    yamlLines.push(`jira-ticketId: ${formatYamlValue(frontmatter['jira-ticketId'])}`);
+    yamlLines.push(`jira-url: ${formatYamlValue(frontmatter['jira-url'])}`);
+    yamlLines.push(`jira-parent: ${formatYamlValue(frontmatter['jira-parent'])}`);
+    yamlLines.push(`jira-related: ${formatYamlValue(frontmatter['jira-related'])}`);
+    yamlLines.push(`jira-blocking: ${formatYamlValue(frontmatter['jira-blocking'])}`);
+    yamlLines.push(`jira-blockedBy: ${formatYamlValue(frontmatter['jira-blockedBy'])}`);
+    yamlLines.push(`jira-fixVersion: ${formatYamlValue(frontmatter['jira-fixVersion'])}`);
+    yamlLines.push(`jira-internalNotes: ${formatYamlValue(frontmatter['jira-internalNotes'])}`);
+    // Framework integration fields
+    yamlLines.push(`framework-documentation: ${formatYamlValue(frontmatter['framework-documentation'])}`);
+    yamlLines.push(`framework-milestone: ${formatYamlValue(frontmatter['framework-milestone'])}`);
+    yamlLines.push(`framework-technicalGuides: ${formatYamlValue(frontmatter['framework-technicalGuides'])}`);
+    yamlLines.push(`framework-relatedLocal: ${formatYamlValue(frontmatter['framework-relatedLocal'])}`);
+    const yaml = yamlLines.join('\n');
+    return `---\n${yaml}\n---\n\n${body}`;
+}
+//# sourceMappingURL=ticket-generator.js.map

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

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

package/dist/lib/backlog/ticket-processor.d.ts

@@ -0,0 +1,205 @@
+/**
+ * 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
+ */
+/**
+ * CSV ticket data from Jira export
+ */
+export interface CsvTicket {
+    /** Jira issue key (e.g., DAPM-1315) */
+    ticketId: string;
+    /** Ticket summary/title */
+    summary: string;
+    /** Jira issue type (Story, Task, Bug, Epic, Spike, Sub-task) */
+    issueType: string;
+    /** Current status */
+    status: string;
+    /** Priority level */
+    priority: string;
+    /** Description text (may include Jira wiki markup) */
+    description: string;
+    /** Assigned user */
+    assignee: string;
+    /** Story point estimate */
+    storyPoints?: number;
+    /** Parent ticket key (for epics) */
+    parentKey: string;
+    /** Parent ticket summary */
+    parentSummary: string;
+    /** Sprint field from Jira */
+    sprint: string;
+    /** Fix versions field */
+    fixVersions: string;
+    /** Labels (comma-separated or newline-separated) */
+    labels: string;
+    /** Acceptance criteria text */
+    acceptanceCriteria: string;
+    /** Created date */
+    created: string;
+    /** Updated date */
+    updated: string;
+}
+/**
+ * Processing options for ticket import
+ */
+export interface ProcessingOptions {
+    /** Base directory for backlog files */
+    basePath: string;
+    /** Import type: sprint or milestone */
+    importType: 'sprint' | 'milestone';
+    /** Sprint ID (for sprint imports) */
+    sprintId?: string;
+    /** Milestone ID (for milestone imports) */
+    milestoneId?: string;
+    /** Dry run mode - don't write files */
+    dryRun?: boolean;
+}
+/**
+ * Result of processing a ticket
+ */
+export interface ProcessedTicket {
+    /** Path to the ticket file */
+    filePath: string;
+    /** Generated markdown content */
+    content: string;
+    /** Whether file was newly created */
+    created: boolean;
+    /** Whether existing file was updated */
+    updated: boolean;
+}
+/**
+ * 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 declare function sanitizeFilename(text: string): string;
+/**
+ * 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 declare function convertJiraToMarkdown(jiraText: string | null | undefined): string;
+/**
+ * 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 declare function extractAcceptanceCriteria(acText: string | null | undefined): string[];
+/**
+ * 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 declare function parseJiraDate(jiraDateStr: string | null | undefined): string | 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 declare function generateTicketFrontmatter(ticket: CsvTicket, milestone?: string): Record<string, unknown>;
+/**
+ * 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 declare function generateTicketBody(ticket: CsvTicket, documentType: string): string;
+/**
+ * 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 declare function getTicketFilePath(ticket: CsvTicket, options: ProcessingOptions, documentType: string): string;
+/**
+ * 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 declare function processTicket(ticket: CsvTicket, options: ProcessingOptions): Promise<ProcessedTicket>;
+//# sourceMappingURL=ticket-processor.d.ts.map

package/dist/lib/backlog/ticket-processor.d.ts.map

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