cc-agentic-framework 1.14.1

package/dist/lib/backlog/sprint-creator.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Sprint Creator Module
+ *
+ * Ported from Python: modules/backlog/src/backlog/sprint_creator.py
+ *
+ * Creates sprint planning files from ticket lists. Used by backlog management
+ * workflows when creating new sprints.
+ *
+ * Features:
+ * - Sprint directory creation
+ * - Sprint index file generation with frontmatter
+ * - Automatic date calculation from sprint ID (YYYY-WNN format)
+ * - Story point tracking and capacity utilization
+ * - Ticket grouping by type (stories, tasks, bugs, spikes)
+ *
+ * @module sprint-creator
+ */
+/**
+ * Sprint configuration
+ */
+export interface SprintConfig {
+    /** Sprint ID in YYYY-WNN format (e.g., 2026-W03) */
+    sprintId: string;
+    /** Milestone code (e.g., Mar2026) */
+    milestone: string;
+    /** Sprint start date (YYYY-MM-DD), auto-calculated if not provided */
+    startDate?: string;
+    /** Sprint end date (YYYY-MM-DD), auto-calculated if not provided */
+    endDate?: string;
+    /** Team capacity in story points (default: 40) */
+    capacity?: number;
+    /** Sprint goal description */
+    goal?: string;
+}
+/**
+ * Ticket to include in sprint
+ */
+export interface SprintTicket {
+    /** Ticket type: stories, tasks, bugs, spikes */
+    type: 'stories' | 'tasks' | 'bugs' | 'spikes';
+    /** Ticket title */
+    title: string;
+    /** Relative path to ticket file */
+    path: string;
+    /** Story points (0 for tasks/bugs typically) */
+    storyPoints: number;
+}
+/**
+ * Result of sprint date calculation
+ */
+interface SprintDates {
+    startDate: string;
+    endDate: string;
+}
+/**
+ * Calculate sprint start and end dates from sprint ID in YYYY-WNN format.
+ *
+ * Sprint ID follows ISO week numbering. A 2-week sprint starts on the Monday
+ * of the specified week and ends 13 days later (Sunday of the following week).
+ *
+ * @param sprintId - Sprint ID in YYYY-WNN format (e.g., "2026-W03")
+ * @returns Object with startDate and endDate in YYYY-MM-DD format, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * const dates = calculateSprintDates('2026-W03');
+ * // Returns: { startDate: '2026-01-12', endDate: '2026-01-25' }
+ * ```
+ */
+export declare function calculateSprintDates(sprintId: string): SprintDates | null;
+/**
+ * Create a new sprint directory and index file.
+ *
+ * Creates a sprints/{sprintId} directory and generates the sprint index file
+ * with frontmatter and initial structure.
+ *
+ * @param config - Sprint configuration
+ * @param basePath - Base directory for sprints (typically backlog root)
+ * @returns Path to created sprint directory
+ * @throws {Error} If sprint directory already exists
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   sprintId: '2026-W03',
+ *   milestone: 'Mar2026',
+ *   capacity: 40
+ * };
+ *
+ * const sprintPath = await createSprintDirectory(config, '/path/to/backlog');
+ * // Creates: /path/to/backlog/sprints/2026-W03/2026-W03.md
+ * ```
+ */
+export declare function createSprintDirectory(config: SprintConfig, basePath: string): Promise<string>;
+/**
+ * Generate or regenerate sprint index file.
+ *
+ * Creates the sprint index markdown file with frontmatter containing
+ * all sprint metadata and a formatted list of tickets.
+ *
+ * @param sprintPath - Path to sprint directory
+ * @param sprintId - Sprint ID
+ * @param config - Sprint configuration
+ * @param tickets - List of tickets to include
+ *
+ * @example
+ * ```typescript
+ * const tickets = [
+ *   {
+ *     type: 'stories',
+ *     title: 'User Authentication',
+ *     path: '../tickets/stories/STORY-123.md',
+ *     storyPoints: 5
+ *   }
+ * ];
+ *
+ * await generateSprintIndex(sprintPath, '2026-W03', config, tickets);
+ * ```
+ */
+export declare function generateSprintIndex(sprintPath: string, sprintId: string, config: SprintConfig, tickets: SprintTicket[]): Promise<void>;
+/**
+ * Update existing sprint index with new ticket list.
+ *
+ * Reads the existing sprint index, preserves the configuration (dates, capacity, etc.),
+ * and regenerates the file with the updated ticket list.
+ *
+ * @param sprintPath - Path to sprint directory
+ * @param sprintId - Sprint ID
+ * @param tickets - Updated list of tickets
+ * @throws {Error} If sprint index file does not exist
+ *
+ * @example
+ * ```typescript
+ * // Add a new ticket to existing sprint
+ * const updatedTickets = [
+ *   ...existingTickets,
+ *   { type: 'stories', title: 'New Story', path: '../tickets/STORY-999.md', storyPoints: 8 }
+ * ];
+ *
+ * await updateSprintIndex(sprintPath, '2026-W03', updatedTickets);
+ * ```
+ */
+export declare function updateSprintIndex(sprintPath: string, sprintId: string, tickets: SprintTicket[]): Promise<void>;
+export {};
+//# sourceMappingURL=sprint-creator.d.ts.map

package/dist/lib/backlog/sprint-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-creator.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/sprint-creator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC9C,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA+CzE;AAkID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/lib/backlog/sprint-creator.js

@@ -0,0 +1,295 @@
+/**
+ * Sprint Creator Module
+ *
+ * Ported from Python: modules/backlog/src/backlog/sprint_creator.py
+ *
+ * Creates sprint planning files from ticket lists. Used by backlog management
+ * workflows when creating new sprints.
+ *
+ * Features:
+ * - Sprint directory creation
+ * - Sprint index file generation with frontmatter
+ * - Automatic date calculation from sprint ID (YYYY-WNN format)
+ * - Story point tracking and capacity utilization
+ * - Ticket grouping by type (stories, tasks, bugs, spikes)
+ *
+ * @module sprint-creator
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { parseFrontmatter, stringifyFrontmatter } from '../common/yaml-frontmatter.js';
+import { ensureDirectory, fileExists } from '../common/file-utils.js';
+/**
+ * Calculate sprint start and end dates from sprint ID in YYYY-WNN format.
+ *
+ * Sprint ID follows ISO week numbering. A 2-week sprint starts on the Monday
+ * of the specified week and ends 13 days later (Sunday of the following week).
+ *
+ * @param sprintId - Sprint ID in YYYY-WNN format (e.g., "2026-W03")
+ * @returns Object with startDate and endDate in YYYY-MM-DD format, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * const dates = calculateSprintDates('2026-W03');
+ * // Returns: { startDate: '2026-01-12', endDate: '2026-01-25' }
+ * ```
+ */
+export function calculateSprintDates(sprintId) {
+    try {
+        if (!sprintId || !sprintId.includes('-W')) {
+            return null;
+        }
+        const [yearStr, weekStr] = sprintId.split('-W');
+        const year = parseInt(yearStr, 10);
+        const week = parseInt(weekStr, 10);
+        if (isNaN(year) || isNaN(week)) {
+            return null;
+        }
+        // Calculate date from ISO week (matches Python implementation)
+        // Python's weekday(): Monday=0, Sunday=6
+        // JavaScript's getDay(): Sunday=0, Monday=1
+        const jan1 = new Date(year, 0, 1);
+        const jan1DayJS = jan1.getDay(); // 0=Sunday, 1=Monday, ..., 6=Saturday
+        const jan1DayPy = jan1DayJS === 0 ? 6 : jan1DayJS - 1; // Convert to Python's 0=Monday
+        // Find Monday of week 1 (same as Python: jan_1 - timedelta(days=jan_1.weekday()))
+        const week1Monday = new Date(jan1);
+        week1Monday.setDate(jan1.getDate() - jan1DayPy);
+        // Calculate sprint start (Monday of specified week)
+        const sprintStart = new Date(week1Monday);
+        sprintStart.setDate(week1Monday.getDate() + (week - 1) * 7);
+        // Calculate sprint end (13 days later for 2-week sprint)
+        const sprintEnd = new Date(sprintStart);
+        sprintEnd.setDate(sprintStart.getDate() + 13);
+        const formatDate = (date) => {
+            const yyyy = date.getFullYear();
+            const mm = String(date.getMonth() + 1).padStart(2, '0');
+            const dd = String(date.getDate()).padStart(2, '0');
+            return `${yyyy}-${mm}-${dd}`;
+        };
+        return {
+            startDate: formatDate(sprintStart),
+            endDate: formatDate(sprintEnd),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Generate sprint index file content.
+ *
+ * Creates a markdown file with YAML frontmatter containing sprint metadata
+ * and a formatted list of committed tickets grouped by type.
+ *
+ * @param sprintId - Sprint ID
+ * @param config - Sprint configuration
+ * @param tickets - List of tickets to include
+ * @returns Markdown content with frontmatter
+ */
+function generateSprintContent(sprintId, config, tickets) {
+    // Calculate total story points
+    const totalSp = tickets.reduce((sum, t) => sum + (t.storyPoints || 0), 0);
+    // Get dates (auto-calculate or use provided)
+    let startDate = config.startDate;
+    let endDate = config.endDate;
+    if (!startDate || !endDate) {
+        const dates = calculateSprintDates(sprintId);
+        if (dates) {
+            startDate = startDate || dates.startDate;
+            endDate = endDate || dates.endDate;
+        }
+        else {
+            // Fallback to current date + 2 weeks
+            const now = new Date();
+            const twoWeeksLater = new Date(now);
+            twoWeeksLater.setDate(twoWeeksLater.getDate() + 14);
+            startDate = now.toISOString().split('T')[0];
+            endDate = twoWeeksLater.toISOString().split('T')[0];
+        }
+    }
+    const capacity = config.capacity || 40;
+    // Build frontmatter
+    const frontmatter = {
+        sprintId,
+        sprintName: `Sprint ${sprintId}`,
+        startDate,
+        endDate,
+        milestone: config.milestone,
+        capacity,
+        committed: totalSp,
+    };
+    // Group tickets by type
+    const stories = tickets.filter((t) => t.type === 'stories');
+    const tasks = tickets.filter((t) => t.type === 'tasks');
+    const bugs = tickets.filter((t) => t.type === 'bugs');
+    const spikes = tickets.filter((t) => t.type === 'spikes');
+    // Build markdown content
+    const lines = [];
+    lines.push(`# Sprint ${sprintId}`);
+    lines.push('');
+    lines.push('## Sprint Info');
+    lines.push('');
+    lines.push(`- **Duration:** ${startDate} to ${endDate}`);
+    lines.push(`- **Milestone:** ${config.milestone}`);
+    lines.push(`- **Team Capacity:** ${capacity} SP`);
+    if (capacity > 0) {
+        const percentage = Math.round((totalSp / capacity) * 100);
+        lines.push(`- **Committed:** ${totalSp} SP (${percentage}% capacity)`);
+    }
+    else {
+        lines.push(`- **Committed:** ${totalSp} SP`);
+    }
+    lines.push('');
+    // Add committed tickets section
+    if (tickets.length > 0) {
+        lines.push('## Committed Tickets');
+        lines.push('');
+        let ticketNum = 1;
+        // Stories
+        for (const story of stories) {
+            const sp = story.storyPoints ? ` - ${story.storyPoints} SP` : '';
+            lines.push(`${ticketNum}. [${story.title}](${story.path})${sp}`);
+            ticketNum++;
+        }
+        // Tasks
+        for (const task of tasks) {
+            lines.push(`${ticketNum}. [${task.title}](${task.path})`);
+            ticketNum++;
+        }
+        // Bugs
+        for (const bug of bugs) {
+            lines.push(`${ticketNum}. [${bug.title}](${bug.path})`);
+            ticketNum++;
+        }
+        // Spikes
+        for (const spike of spikes) {
+            lines.push(`${ticketNum}. [${spike.title}](${spike.path})`);
+            ticketNum++;
+        }
+        lines.push('');
+        lines.push(`**Total Committed:** ${totalSp} SP across ${tickets.length} tickets`);
+        lines.push('');
+    }
+    // Retrospective placeholder
+    lines.push('## Sprint Retrospective');
+    lines.push('');
+    lines.push('*(Add after sprint completion)*');
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    lines.push(`**Created:** ${new Date().toISOString().split('T')[0]} ${new Date().toTimeString().split(' ')[0]}`);
+    const content = lines.join('\n');
+    return stringifyFrontmatter(frontmatter, content);
+}
+/**
+ * Create a new sprint directory and index file.
+ *
+ * Creates a sprints/{sprintId} directory and generates the sprint index file
+ * with frontmatter and initial structure.
+ *
+ * @param config - Sprint configuration
+ * @param basePath - Base directory for sprints (typically backlog root)
+ * @returns Path to created sprint directory
+ * @throws {Error} If sprint directory already exists
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   sprintId: '2026-W03',
+ *   milestone: 'Mar2026',
+ *   capacity: 40
+ * };
+ *
+ * const sprintPath = await createSprintDirectory(config, '/path/to/backlog');
+ * // Creates: /path/to/backlog/sprints/2026-W03/2026-W03.md
+ * ```
+ */
+export async function createSprintDirectory(config, basePath) {
+    const sprintsDir = path.join(basePath, 'sprints');
+    const sprintPath = path.join(sprintsDir, config.sprintId);
+    const indexPath = path.join(sprintPath, `${config.sprintId}.md`);
+    // Check if already exists
+    if (await fileExists(indexPath)) {
+        throw new Error(`Sprint ${config.sprintId} already exists at ${indexPath}`);
+    }
+    // Create directory
+    await ensureDirectory(sprintPath);
+    // Generate initial index with no tickets
+    const content = generateSprintContent(config.sprintId, config, []);
+    // Write index file
+    await fs.writeFile(indexPath, content, 'utf-8');
+    return sprintPath;
+}
+/**
+ * Generate or regenerate sprint index file.
+ *
+ * Creates the sprint index markdown file with frontmatter containing
+ * all sprint metadata and a formatted list of tickets.
+ *
+ * @param sprintPath - Path to sprint directory
+ * @param sprintId - Sprint ID
+ * @param config - Sprint configuration
+ * @param tickets - List of tickets to include
+ *
+ * @example
+ * ```typescript
+ * const tickets = [
+ *   {
+ *     type: 'stories',
+ *     title: 'User Authentication',
+ *     path: '../tickets/stories/STORY-123.md',
+ *     storyPoints: 5
+ *   }
+ * ];
+ *
+ * await generateSprintIndex(sprintPath, '2026-W03', config, tickets);
+ * ```
+ */
+export async function generateSprintIndex(sprintPath, sprintId, config, tickets) {
+    const indexPath = path.join(sprintPath, `${sprintId}.md`);
+    const content = generateSprintContent(sprintId, config, tickets);
+    await fs.writeFile(indexPath, content, 'utf-8');
+}
+/**
+ * Update existing sprint index with new ticket list.
+ *
+ * Reads the existing sprint index, preserves the configuration (dates, capacity, etc.),
+ * and regenerates the file with the updated ticket list.
+ *
+ * @param sprintPath - Path to sprint directory
+ * @param sprintId - Sprint ID
+ * @param tickets - Updated list of tickets
+ * @throws {Error} If sprint index file does not exist
+ *
+ * @example
+ * ```typescript
+ * // Add a new ticket to existing sprint
+ * const updatedTickets = [
+ *   ...existingTickets,
+ *   { type: 'stories', title: 'New Story', path: '../tickets/STORY-999.md', storyPoints: 8 }
+ * ];
+ *
+ * await updateSprintIndex(sprintPath, '2026-W03', updatedTickets);
+ * ```
+ */
+export async function updateSprintIndex(sprintPath, sprintId, tickets) {
+    const indexPath = path.join(sprintPath, `${sprintId}.md`);
+    if (!(await fileExists(indexPath))) {
+        throw new Error(`Sprint index not found: ${indexPath}`);
+    }
+    // Read existing file to preserve configuration
+    const existingContent = await fs.readFile(indexPath, 'utf-8');
+    const { data } = parseFrontmatter(existingContent);
+    // Build config from existing frontmatter
+    const config = {
+        sprintId: data.sprintId,
+        milestone: data.milestone,
+        capacity: data.capacity,
+        startDate: data.startDate,
+        endDate: data.endDate,
+    };
+    // Regenerate with new tickets
+    const content = generateSprintContent(sprintId, config, tickets);
+    await fs.writeFile(indexPath, content, 'utf-8');
+}
+//# sourceMappingURL=sprint-creator.js.map

package/dist/lib/backlog/sprint-creator.js.map

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

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

@@ -0,0 +1,79 @@
+/**
+ * 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 { CsvTicket } from './types.js';
+/**
+ * Frontmatter structure for v10.1.1 tickets
+ */
+export interface TicketFrontmatter {
+    documentType: string;
+    title: string;
+    description: string;
+    priority: string;
+    storyPoints?: number;
+    milestone?: string;
+    labels?: string[];
+    sprint?: string;
+    assignee?: string;
+    createdDate?: string;
+    updatedDate?: string;
+    exportedDate: null;
+    'jira-ticketId': string;
+    'jira-url': string;
+    'jira-parent': string | null;
+    'jira-related': string[];
+    'jira-blocking': string[];
+    'jira-blockedBy': string[];
+    'jira-fixVersion': string | null;
+    'jira-internalNotes': string | null;
+    'framework-documentation': string | null;
+    'framework-milestone': string | null;
+    'framework-technicalGuides': string[];
+    'framework-relatedLocal': string[];
+}
+/**
+ * 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 declare function mapPriority(jiraPriority: string | undefined): string;
+/**
+ * Generate v10.1.1 compliant YAML frontmatter.
+ *
+ * @param ticket - CSV ticket data
+ * @returns Frontmatter object
+ */
+export declare function generateFrontmatter(ticket: CsvTicket): TicketFrontmatter;
+/**
+ * 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 declare function generateBodyContent(ticket: CsvTicket): string;
+/**
+ * Generate complete ticket content with frontmatter and body.
+ *
+ * @param ticket - CSV ticket data
+ * @returns Complete markdown file content
+ */
+export declare function generateTicketContent(ticket: CsvTicket): string;
+//# sourceMappingURL=ticket-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-generator.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/ticket-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,IAAI,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,2BAA2B,EAAE,MAAM,EAAE,CAAC;IACtC,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAgBpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAuDxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAiG7D;AA6CD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA+D/D"}