cc-agentic-framework 1.14.1

package/dist/lib/backlog/epic-handler.js

@@ -0,0 +1,222 @@
+/**
+ * Epic Handler Module
+ *
+ * Handles epic file generation with:
+ * - Business Value and Goals sections
+ * - Child Stories listing with story point totals
+ * - Epic-specific body structure
+ *
+ * @module epic-handler
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { convertJiraToMarkdown } from './csv-extractor.js';
+import { mapPriority } from './ticket-generator.js';
+/**
+ * Find child tickets for an epic.
+ *
+ * @param tickets - All tickets to search
+ * @param epicKey - Epic ticket ID (e.g., 'DAPM-100')
+ * @returns Array of tickets with parentKey matching epicKey
+ */
+export function findChildTickets(tickets, epicKey) {
+    return tickets.filter(ticket => ticket.parentKey === epicKey);
+}
+/**
+ * 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
+    const needsQuotes = /[:#[\]{}|>&*!?,\n]/.test(str) ||
+        str.startsWith('-') ||
+        str.startsWith('@') ||
+        str === 'true' ||
+        str === 'false' ||
+        str === 'null' ||
+        /^\d/.test(str);
+    if (needsQuotes) {
+        const escaped = str.replace(/"/g, '\\"');
+        return `"${escaped}"`;
+    }
+    return str;
+}
+/**
+ * Generate epic file content with frontmatter and body.
+ *
+ * Epic structure:
+ * - YAML frontmatter
+ * - H1 title
+ * - ## Description
+ *   - Business Value
+ *   - Goals
+ * - ## Child Stories
+ *   - Grouped by type with story points
+ *
+ * @param epic - Epic ticket data
+ * @param children - Child tickets belonging to this epic
+ * @returns Complete markdown file content
+ */
+export function generateEpicContent(epic, children) {
+    // Generate YAML frontmatter
+    const jiraBaseUrl = 'https://wencosupport.atlassian.net/browse';
+    const jiraUrl = `${jiraBaseUrl}/${epic.ticketId}`;
+    const yamlLines = [];
+    yamlLines.push(`documentType: ${formatYamlValue(epic.documentType)}`);
+    yamlLines.push(`version: ${formatYamlValue('1.0')}`);
+    yamlLines.push(`title: ${formatYamlValue(epic.summary)}`);
+    yamlLines.push(`description: ${formatYamlValue(epic.summary.substring(0, 150))}`);
+    yamlLines.push(`priority: ${formatYamlValue(mapPriority(epic.priority))}`);
+    // Calculate total story points
+    const totalSp = children.reduce((sum, t) => sum + (t.storyPoints || 0), 0);
+    yamlLines.push(`totalStoryPoints: ${formatYamlValue(totalSp)}`);
+    yamlLines.push(`childCount: ${formatYamlValue(children.length)}`);
+    if (epic.milestone) {
+        yamlLines.push(`milestone: ${formatYamlValue(epic.milestone)}`);
+    }
+    if (epic.labels && epic.labels.length > 0) {
+        yamlLines.push(`labels: ${formatYamlValue(epic.labels)}`);
+    }
+    if (epic.createdDate) {
+        yamlLines.push(`createdDate: ${formatYamlValue(epic.createdDate)}`);
+    }
+    yamlLines.push(`exportedDate: null`);
+    yamlLines.push(`jira-ticketId: ${formatYamlValue(epic.ticketId)}`);
+    yamlLines.push(`jira-url: ${formatYamlValue(jiraUrl)}`);
+    yamlLines.push(`jira-fixVersion: ${formatYamlValue(epic.fixVersions || null)}`);
+    const yaml = yamlLines.join('\n');
+    // Generate body content
+    const bodyLines = [];
+    // H1 Title
+    bodyLines.push(`# ${epic.summary}`);
+    bodyLines.push('');
+    bodyLines.push('---');
+    bodyLines.push('');
+    // Description section
+    bodyLines.push('## Description');
+    bodyLines.push('');
+    if (epic.description) {
+        const markdownDescription = convertJiraToMarkdown(epic.description);
+        bodyLines.push(markdownDescription);
+        bodyLines.push('');
+    }
+    // Business Value
+    bodyLines.push('**Business Value:**');
+    bodyLines.push('');
+    bodyLines.push('*Define the business value this epic delivers.*');
+    bodyLines.push('');
+    // Goals
+    bodyLines.push('**Goals:**');
+    bodyLines.push('');
+    bodyLines.push('- Goal 1');
+    bodyLines.push('- Goal 2');
+    bodyLines.push('');
+    bodyLines.push('---');
+    bodyLines.push('');
+    // Child Stories section
+    bodyLines.push('## Child Stories');
+    bodyLines.push('');
+    if (children.length === 0) {
+        bodyLines.push('*No child stories yet*');
+        bodyLines.push('');
+    }
+    else {
+        // Summary stats
+        const stories = children.filter(t => t.documentType === 'story');
+        const tasks = children.filter(t => t.documentType === 'task');
+        const bugs = children.filter(t => t.documentType === 'bug');
+        const spikes = children.filter(t => t.documentType === 'spike');
+        bodyLines.push(`**Total:** ${children.length} tickets | ${totalSp} SP`);
+        bodyLines.push('');
+        // List by type
+        if (stories.length > 0) {
+            bodyLines.push('### Stories');
+            bodyLines.push('');
+            for (const t of stories) {
+                const sp = t.storyPoints ? ` - ${t.storyPoints} SP` : '';
+                const relPath = `../tickets/${t.filename}`;
+                bodyLines.push(`- [${t.ticketId}](${relPath}) - ${t.summary}${sp}`);
+            }
+            bodyLines.push('');
+        }
+        if (tasks.length > 0) {
+            bodyLines.push('### Tasks');
+            bodyLines.push('');
+            for (const t of tasks) {
+                const sp = t.storyPoints ? ` - ${t.storyPoints} SP` : '';
+                const relPath = `../tickets/${t.filename}`;
+                bodyLines.push(`- [${t.ticketId}](${relPath}) - ${t.summary}${sp}`);
+            }
+            bodyLines.push('');
+        }
+        if (bugs.length > 0) {
+            bodyLines.push('### Bugs');
+            bodyLines.push('');
+            for (const t of bugs) {
+                const relPath = `../tickets/${t.filename}`;
+                bodyLines.push(`- [${t.ticketId}](${relPath}) - ${t.summary}`);
+            }
+            bodyLines.push('');
+        }
+        if (spikes.length > 0) {
+            bodyLines.push('### Spikes');
+            bodyLines.push('');
+            for (const t of spikes) {
+                const sp = t.storyPoints ? ` - ${t.storyPoints} SP` : '';
+                const relPath = `../tickets/${t.filename}`;
+                bodyLines.push(`- [${t.ticketId}](${relPath}) - ${t.summary}${sp}`);
+            }
+            bodyLines.push('');
+        }
+    }
+    bodyLines.push('---');
+    bodyLines.push('');
+    bodyLines.push(`*Generated from Jira export on ${new Date().toISOString().split('T')[0]}*`);
+    bodyLines.push('');
+    const body = bodyLines.join('\n');
+    return `---\n${yaml}\n---\n\n${body}`;
+}
+/**
+ * Write epic file to backlog/epics/ directory.
+ *
+ * @param epic - Epic ticket data
+ * @param basePath - Base path to backlog directory
+ * @param children - Child tickets for this epic
+ * @param dryRun - If true, don't write the file
+ * @returns Write result with status and paths
+ */
+export async function writeEpicFile(epic, basePath, children, dryRun = false) {
+    const epicsDir = path.join(basePath, 'epics');
+    const filePath = path.join(epicsDir, epic.filename);
+    let fileExists = false;
+    if (!dryRun) {
+        await fs.ensureDir(epicsDir);
+        fileExists = await fs.pathExists(filePath);
+    }
+    // Generate content
+    const content = generateEpicContent(epic, children);
+    if (!dryRun) {
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    return {
+        status: fileExists ? 'updated' : 'created',
+        filename: epic.filename,
+        filePath,
+    };
+}
+//# sourceMappingURL=epic-handler.js.map

package/dist/lib/backlog/epic-handler.js.map

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

package/dist/lib/backlog/field-updater.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Field Updater
+ *
+ * Ported from Python:
+ * - modules/backlog/src/backlog/update_milestones_remove_field.py
+ * - modules/backlog/src/backlog/update_tickets_remove_milestone_field.py
+ *
+ * Utilities for adding, removing, and updating frontmatter fields in markdown files.
+ *
+ * Key operations:
+ * - Remove fields from frontmatter
+ * - Add fields to frontmatter
+ * - Update existing fields
+ * - Bulk operations with dry-run support
+ *
+ * Example:
+ * ```typescript
+ * // Remove a field
+ * const result = removeField(content, 'milestone');
+ *
+ * // Add a field
+ * const result = addField(content, 'status', 'active');
+ *
+ * // Update a field (add if not exists)
+ * const result = updateField(content, 'version', '2.0');
+ *
+ * // Bulk update files
+ * const results = await bulkUpdateFiles(
+ *   ['file1.md', 'file2.md'],
+ *   { remove: ['milestone'], add: { status: 'active' } },
+ *   { dryRun: true }
+ * );
+ * ```
+ */
+/**
+ * Result of a field update operation
+ */
+export interface FieldUpdateResult {
+    /** Updated content */
+    content: string;
+    /** Whether the content was modified */
+    modified: boolean;
+}
+/**
+ * Result of a bulk update operation
+ */
+export interface BulkUpdateResults {
+    /** Total files processed */
+    totalFiles: number;
+    /** Number of files modified */
+    modifiedFiles: number;
+    /** Number of files skipped (no changes needed) */
+    skippedFiles: number;
+    /** List of errors encountered */
+    errors: string[];
+    /** Detailed changes per file */
+    changes: FileChange[];
+}
+/**
+ * Details about changes made to a file
+ */
+export interface FileChange {
+    /** File path */
+    file: string;
+    /** Whether the file was modified */
+    modified: boolean;
+    /** Operations performed */
+    operations: string[];
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Options for bulk update operations
+ */
+export interface BulkUpdateOptions {
+    /** Dry run mode - don't write files */
+    dryRun?: boolean;
+    /** Verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Field operations to perform
+ */
+export interface FieldOperations {
+    /** Fields to remove */
+    remove?: string[];
+    /** Fields to add (only if not exists) */
+    add?: Record<string, unknown>;
+    /** Fields to update (add if not exists) */
+    update?: Record<string, unknown>;
+}
+/**
+ * Remove a field from frontmatter
+ *
+ * Removes the specified field while preserving all other fields and content.
+ * Returns the updated content and whether it was modified.
+ *
+ * @param content - Markdown content with frontmatter
+ * @param fieldName - Name of field to remove
+ * @returns Updated content and modification status
+ *
+ * @example
+ * ```typescript
+ * const content = `---
+ * title: Test
+ * milestone: UC1
+ * ---
+ * Content`;
+ *
+ * const result = removeField(content, 'milestone');
+ * console.log(result.modified); // true
+ * console.log(result.content); // frontmatter without milestone field
+ * ```
+ */
+export declare function removeField(content: string, fieldName: string): FieldUpdateResult;
+/**
+ * Add a field to frontmatter
+ *
+ * Adds a new field to frontmatter. By default, does not overwrite existing fields
+ * unless force=true.
+ *
+ * @param content - Markdown content with frontmatter
+ * @param fieldName - Name of field to add
+ * @param value - Value for the field
+ * @param force - If true, overwrite existing field (default: false)
+ * @returns Updated content and modification status
+ *
+ * @example
+ * ```typescript
+ * const result = addField(content, 'status', 'active');
+ * const resultForce = addField(content, 'status', 'active', true);
+ * ```
+ */
+export declare function addField(content: string, fieldName: string, value: unknown, force?: boolean): FieldUpdateResult;
+/**
+ * Update a field in frontmatter
+ *
+ * Updates an existing field or adds it if it doesn't exist.
+ * This is equivalent to addField with force=true.
+ *
+ * @param content - Markdown content with frontmatter
+ * @param fieldName - Name of field to update
+ * @param value - New value for the field
+ * @returns Updated content and modification status
+ *
+ * @example
+ * ```typescript
+ * const result = updateField(content, 'status', 'completed');
+ * ```
+ */
+export declare function updateField(content: string, fieldName: string, value: unknown): FieldUpdateResult;
+/**
+ * Perform bulk field updates on multiple files
+ *
+ * Applies field operations (remove/add/update) to a list of files.
+ * Supports dry-run mode for previewing changes.
+ *
+ * @param files - Array of file paths to process
+ * @param operations - Field operations to perform
+ * @param options - Options for bulk update (dryRun, verbose)
+ * @returns Results summary with modified files, errors, and changes
+ *
+ * @example
+ * ```typescript
+ * const results = await bulkUpdateFiles(
+ *   ['ticket1.md', 'ticket2.md'],
+ *   {
+ *     remove: ['milestone'],
+ *     add: { status: 'active' },
+ *     update: { version: '2.0' }
+ *   },
+ *   { dryRun: true }
+ * );
+ *
+ * console.log(`Modified: ${results.modifiedFiles}/${results.totalFiles}`);
+ * ```
+ */
+export declare function bulkUpdateFiles(files: string[], operations: FieldOperations, options?: BulkUpdateOptions): Promise<BulkUpdateResults>;
+/**
+ * Find files matching glob pattern(s)
+ *
+ * Helper function to find files for bulk operations.
+ *
+ * @param patterns - Glob pattern(s) to match
+ * @param cwd - Working directory (default: process.cwd())
+ * @returns Array of absolute file paths
+ *
+ * @example
+ * ```typescript
+ * const files = await findFiles('backlog/tickets/**\/*.md');
+ * const results = await bulkUpdateFiles(files, operations);
+ * ```
+ */
+export declare function findFiles(patterns: string | string[], cwd?: string): Promise<string[]>;
+//# sourceMappingURL=field-updater.d.ts.map

package/dist/lib/backlog/field-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-updater.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/field-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CA8BjF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,KAAK,UAAQ,GACZ,iBAAiB,CAmCnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAEjG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAqF5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB"}