@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-sprint-show.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * cmos_sprint_show Tool
+ *
+ * MCP tool for getting detailed sprint information.
+ * Returns sprint details with aggregated statistics and mission list.
+ *
+ * @module tools/cmos/cmos-sprint-show
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSprintShowToolDefinition = exports.cmosSprintShowSchema = void 0;
+exports.cmosSprintShow = cmosSprintShow;
+exports.formatSprintShowForLLM = formatSprintShowForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const decision_memory_1 = require("./decision-memory");
+/**
+ * Input parameters schema for cmos_sprint_show tool.
+ */
+exports.cmosSprintShowSchema = zod_1.z.object({
+    /** Sprint ID to retrieve */
+    sprintId: zod_1.z.string().min(1).describe('The sprint ID to retrieve (e.g., "sprint-14")'),
+    /** Optional: explicit project root to search from */
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+});
+/**
+ * MCP Tool Definition for cmos_sprint_show.
+ */
+exports.cmosSprintShowToolDefinition = {
+    name: 'cmos_sprint_show',
+    description: 'Get detailed information about a specific sprint including all associated missions. ' +
+        'Returns sprint metadata, mission counts, and a list of all missions in the sprint.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sprintId: {
+                type: 'string',
+                description: 'The sprint ID to retrieve (e.g., "sprint-14")',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['sprintId'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_sprint_show tool.
+ *
+ * @param params - Tool parameters (sprintId, projectRoot)
+ * @returns CmosToolResult with sprint details or actionable error
+ */
+async function cmosSprintShow(params) {
+    const { sprintId } = params;
+    if (!sprintId || sprintId.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('sprintId'));
+    }
+    return (0, client_1.withClient)((client) => {
+        // Get sprint from sprint_summary view
+        const sprintResult = client.getOne(`SELECT
+          sprint_id, title, status, focus, start_date, end_date,
+          total_missions, completed_missions, blocked_missions,
+          active_missions, decisions_count
+        FROM sprint_summary
+        WHERE sprint_id = ?`, [sprintId]);
+        if (!sprintResult.success) {
+            return (0, errors_1.createError)(sprintResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to query sprint' });
+        }
+        if (!sprintResult.data) {
+            return (0, errors_1.createError)(errors_1.CmosErrors.sprintNotFound(sprintId));
+        }
+        const sprint = sprintResult.data;
+        const decisionCounts = (0, decision_memory_1.getSprintDecisionCounts)(client, sprintId);
+        // Get missions for this sprint
+        const missionsResult = client.getMany(`SELECT id, name, status, objective
+        FROM missions
+        WHERE sprint_id = ?
+        ORDER BY
+          CASE status
+            WHEN 'In Progress' THEN 1
+            WHEN 'Current' THEN 2
+            WHEN 'Blocked' THEN 3
+            WHEN 'Queued' THEN 4
+            WHEN 'Completed' THEN 5
+            ELSE 6
+          END,
+          id ASC`, [sprintId]);
+        if (!missionsResult.success || !missionsResult.data) {
+            return (0, errors_1.createError)(missionsResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to query missions' });
+        }
+        // Build result
+        const result = {
+            id: sprint.sprint_id,
+            title: sprint.title,
+            focus: sprint.focus,
+            status: sprint.status,
+            startDate: sprint.start_date,
+            endDate: sprint.end_date,
+            totalMissions: sprint.total_missions ?? 0,
+            completedMissions: sprint.completed_missions ?? 0,
+            blockedMissions: sprint.blocked_missions ?? 0,
+            activeMissions: sprint.active_missions ?? 0,
+            decisionsCount: decisionCounts.strategicDecisionsCount,
+            sessionDecisionsCount: decisionCounts.sessionDecisionsCount,
+            totalDecisionsCount: decisionCounts.totalDecisionsCount,
+            missions: missionsResult.data.map((m) => ({
+                id: m.id,
+                name: m.name,
+                status: m.status,
+                objective: m.objective,
+            })),
+        };
+        return (0, errors_1.createSuccess)(result);
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format sprint show result for LLM readability.
+ *
+ * @param result - Sprint show result
+ * @returns Human-readable summary
+ */
+function formatSprintShowForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = [
+            '❌ Failed to get sprint details',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+        ];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const s = result.data;
+    const lines = [];
+    // Header
+    const statusIcon = getStatusIcon(s.status);
+    lines.push(`${statusIcon} **Sprint: ${s.id}**`);
+    lines.push(`   Title: ${s.title}`);
+    if (s.focus) {
+        lines.push(`   Focus: ${s.focus}`);
+    }
+    if (s.status) {
+        lines.push(`   Status: ${s.status}`);
+    }
+    // Dates
+    if (s.startDate || s.endDate) {
+        const dateRange = s.endDate ? `${s.startDate} → ${s.endDate}` : `Started: ${s.startDate}`;
+        lines.push(`   Dates: ${dateRange}`);
+    }
+    lines.push('');
+    // Statistics
+    lines.push('**Progress**');
+    lines.push(`   Completed: ${s.completedMissions}/${s.totalMissions} missions`);
+    if (s.activeMissions > 0) {
+        lines.push(`   Active: ${s.activeMissions}`);
+    }
+    if (s.blockedMissions > 0) {
+        lines.push(`   Blocked: ${s.blockedMissions}`);
+    }
+    if (s.totalDecisionsCount > 0) {
+        if (s.sessionDecisionsCount > 0) {
+            lines.push(`   Decisions: ${s.decisionsCount} strategic, ${s.sessionDecisionsCount} session-derived (${s.totalDecisionsCount} total)`);
+        }
+        else {
+            lines.push(`   Decisions: ${s.decisionsCount}`);
+        }
+    }
+    lines.push('');
+    // Missions
+    if (s.missions.length > 0) {
+        lines.push('**Missions**');
+        for (const m of s.missions) {
+            const missionIcon = getMissionStatusIcon(m.status);
+            lines.push(`   ${missionIcon} ${m.id}: ${m.name} [${m.status}]`);
+            if (m.objective) {
+                lines.push(`      └─ ${truncate(m.objective, 55)}`);
+            }
+        }
+    }
+    else {
+        lines.push('**Missions**: None');
+    }
+    return lines.join('\n');
+}
+/**
+ * Get a status icon for sprint display.
+ */
+function getStatusIcon(status) {
+    switch (status?.toLowerCase()) {
+        case 'active':
+        case 'current':
+            return '◉';
+        case 'completed':
+            return '✓';
+        case 'planned':
+        case 'queued':
+            return '○';
+        default:
+            return '•';
+    }
+}
+/**
+ * Get a status icon for mission display.
+ */
+function getMissionStatusIcon(status) {
+    switch (status) {
+        case 'Queued':
+            return '○';
+        case 'Current':
+            return '◉';
+        case 'In Progress':
+            return '◐';
+        case 'Completed':
+            return '✓';
+        case 'Blocked':
+            return '⊘';
+        default:
+            return '?';
+    }
+}
+/**
+ * Truncate a string to a maximum length.
+ */
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + '...';
+}
+//# sourceMappingURL=cmos-sprint-show.js.map

package/dist/tools/cmos/cmos-sprint-show.js.map

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

package/dist/tools/cmos/cmos-sprint-update.d.ts

@@ -0,0 +1,150 @@
+/**
+ * cmos_sprint_update Tool
+ *
+ * MCP tool for partially updating sprint fields in the CMOS database.
+ * Only provided fields are updated, others remain unchanged.
+ *
+ * @module tools/cmos/cmos-sprint-update
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+/**
+ * Fields that can be updated on a sprint.
+ */
+export interface SprintUpdateFields {
+    /** Sprint title */
+    title?: string;
+    /** Strategic focus of the sprint */
+    focus?: string;
+    /** Sprint status */
+    status?: string;
+    /** Start date in ISO format */
+    startDate?: string;
+    /** End date in ISO format */
+    endDate?: string;
+}
+/**
+ * Result of updating a sprint.
+ */
+export interface SprintUpdateResult {
+    /** The sprint ID that was updated */
+    sprintId: string;
+    /** Fields that were updated */
+    updatedFields: string[];
+    /** Human-readable message */
+    message: string;
+}
+/**
+ * Input parameters schema for cmos_sprint_update tool.
+ */
+export declare const cmosSprintUpdateSchema: z.ZodObject<{
+    /** The sprint ID to update */
+    sprintId: z.ZodString;
+    /** Fields to update (only provided fields are changed) */
+    fields: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }, {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sprintId: string;
+    fields: {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    };
+    projectRoot?: string | undefined;
+}, {
+    sprintId: string;
+    fields: {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    };
+    projectRoot?: string | undefined;
+}>;
+export type CmosSprintUpdateParams = z.infer<typeof cmosSprintUpdateSchema>;
+/**
+ * MCP Tool Definition for cmos_sprint_update.
+ */
+export declare const cmosSprintUpdateToolDefinition: {
+    readonly name: "cmos_sprint_update";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "The sprint ID to update (e.g., \"sprint-14\")";
+            };
+            readonly fields: {
+                readonly type: "object";
+                readonly description: "Fields to update (only provided fields are changed)";
+                readonly properties: {
+                    readonly title: {
+                        readonly type: "string";
+                        readonly description: "Sprint title";
+                    };
+                    readonly focus: {
+                        readonly type: "string";
+                        readonly description: "Strategic focus or theme of the sprint";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly description: "Sprint status (e.g., \"Active\", \"Completed\")";
+                    };
+                    readonly startDate: {
+                        readonly type: "string";
+                        readonly description: "Start date in ISO format (e.g., \"2025-01-01\")";
+                    };
+                    readonly endDate: {
+                        readonly type: "string";
+                        readonly description: "End date in ISO format (e.g., \"2025-01-15\")";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["sprintId", "fields"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_sprint_update tool.
+ *
+ * @param params - Tool parameters (sprintId, fields, projectRoot)
+ * @returns CmosToolResult with update result or actionable error
+ */
+export declare function cmosSprintUpdate(params: CmosSprintUpdateParams): Promise<CmosToolResult<SprintUpdateResult>>;
+/**
+ * Format sprint update result for LLM readability.
+ *
+ * @param result - Sprint update result
+ * @returns Human-readable formatted result
+ */
+export declare function formatSprintUpdateForLLM(result: CmosToolResult<SprintUpdateResult>): string;
+//# sourceMappingURL=cmos-sprint-update.d.ts.map

package/dist/tools/cmos/cmos-sprint-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-sprint-update.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-sprint-update.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,SAAS,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,8BAA8B;;IAG9B,0DAA0D;;;;;;;;;;;;;;;;;;;;IAW1D,qDAAqD;;;;;;;;;;;;;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDjC,CAAC;AAEX;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CA+F7C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAqB3F"}

package/dist/tools/cmos/cmos-sprint-update.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * cmos_sprint_update Tool
+ *
+ * MCP tool for partially updating sprint fields in the CMOS database.
+ * Only provided fields are updated, others remain unchanged.
+ *
+ * @module tools/cmos/cmos-sprint-update
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSprintUpdateToolDefinition = exports.cmosSprintUpdateSchema = void 0;
+exports.cmosSprintUpdate = cmosSprintUpdate;
+exports.formatSprintUpdateForLLM = formatSprintUpdateForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+/**
+ * Input parameters schema for cmos_sprint_update tool.
+ */
+exports.cmosSprintUpdateSchema = zod_1.z.object({
+    /** The sprint ID to update */
+    sprintId: zod_1.z.string().min(1).describe('The sprint ID to update (e.g., "sprint-14")'),
+    /** Fields to update (only provided fields are changed) */
+    fields: zod_1.z
+        .object({
+        title: zod_1.z.string().optional().describe('Sprint title'),
+        focus: zod_1.z.string().optional().describe('Strategic focus or theme of the sprint'),
+        status: zod_1.z.string().optional().describe('Sprint status (e.g., "Active", "Completed")'),
+        startDate: zod_1.z.string().optional().describe('Start date in ISO format (e.g., "2025-01-01")'),
+        endDate: zod_1.z.string().optional().describe('End date in ISO format (e.g., "2025-01-15")'),
+    })
+        .describe('Fields to update (only provided fields are changed)'),
+    /** Optional: explicit project root to search from */
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+});
+/**
+ * MCP Tool Definition for cmos_sprint_update.
+ */
+exports.cmosSprintUpdateToolDefinition = {
+    name: 'cmos_sprint_update',
+    description: 'Update specific fields of a sprint without replacing the entire record. ' +
+        'Only provided fields are updated, others remain unchanged. ' +
+        'Use this to modify sprint title, focus, status, or date range.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sprintId: {
+                type: 'string',
+                description: 'The sprint ID to update (e.g., "sprint-14")',
+            },
+            fields: {
+                type: 'object',
+                description: 'Fields to update (only provided fields are changed)',
+                properties: {
+                    title: {
+                        type: 'string',
+                        description: 'Sprint title',
+                    },
+                    focus: {
+                        type: 'string',
+                        description: 'Strategic focus or theme of the sprint',
+                    },
+                    status: {
+                        type: 'string',
+                        description: 'Sprint status (e.g., "Active", "Completed")',
+                    },
+                    startDate: {
+                        type: 'string',
+                        description: 'Start date in ISO format (e.g., "2025-01-01")',
+                    },
+                    endDate: {
+                        type: 'string',
+                        description: 'End date in ISO format (e.g., "2025-01-15")',
+                    },
+                },
+                additionalProperties: false,
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['sprintId', 'fields'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_sprint_update tool.
+ *
+ * @param params - Tool parameters (sprintId, fields, projectRoot)
+ * @returns CmosToolResult with update result or actionable error
+ */
+async function cmosSprintUpdate(params) {
+    // Validate required parameter
+    if (!params.sprintId || params.sprintId.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('sprintId'));
+    }
+    const sprintId = params.sprintId.trim();
+    const fields = params.fields;
+    // Check if any fields are provided
+    const fieldKeys = Object.keys(fields).filter((k) => fields[k] !== undefined);
+    if (fieldKeys.length === 0) {
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER,
+            message: 'No fields provided to update',
+            suggestion: 'Provide at least one field to update (e.g., title, focus, status, startDate, endDate)',
+        });
+    }
+    return (0, client_1.withClientValidated)((client) => {
+        // Check if sprint exists
+        const sprintResult = client.getOne('SELECT id FROM sprints WHERE id = ?', [sprintId]);
+        if (!sprintResult.success) {
+            return (0, errors_1.createError)(sprintResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to query sprint' });
+        }
+        if (!sprintResult.data) {
+            return (0, errors_1.createError)(errors_1.CmosErrors.sprintNotFound(sprintId));
+        }
+        // Build dynamic UPDATE query
+        const setClauses = [];
+        const queryParams = [];
+        // Map of TypeScript field names to database column names
+        const fieldMapping = {
+            title: 'title',
+            focus: 'focus',
+            status: 'status',
+            startDate: 'start_date',
+            endDate: 'end_date',
+        };
+        for (const key of fieldKeys) {
+            const dbColumn = fieldMapping[key];
+            if (!dbColumn)
+                continue;
+            const value = fields[key];
+            if (value === undefined)
+                continue;
+            setClauses.push(`${dbColumn} = ?`);
+            queryParams.push(value.trim() || null);
+        }
+        // Add sprintId as the last parameter for WHERE clause
+        queryParams.push(sprintId);
+        const updateQuery = `
+        UPDATE sprints
+        SET ${setClauses.join(', ')}
+        WHERE id = ?
+      `;
+        const updateResult = client.execute(updateQuery, queryParams);
+        if (!updateResult.success) {
+            return (0, errors_1.createError)(updateResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to update sprint' });
+        }
+        if (updateResult.data?.changes === 0) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to update sprint '${sprintId}'`,
+                suggestion: 'The sprint may have been modified by another process',
+            });
+        }
+        return (0, errors_1.createSuccess)({
+            sprintId,
+            updatedFields: fieldKeys,
+            message: `Sprint '${sprintId}' updated successfully (${fieldKeys.length} field${fieldKeys.length === 1 ? '' : 's'})`,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format sprint update result for LLM readability.
+ *
+ * @param result - Sprint update result
+ * @returns Human-readable formatted result
+ */
+function formatSprintUpdateForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['❌ Failed to update sprint', '', `Error: ${error?.message ?? 'Unknown error'}`];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    const lines = [
+        `✓ Sprint '${data.sprintId}' updated`,
+        '',
+        `Updated fields: ${data.updatedFields.join(', ')}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-sprint-update.js.map

package/dist/tools/cmos/cmos-sprint-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-sprint-update.js","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-sprint-update.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA+HH,4CAiGC;AAQD,4DAqBC;AA3PD,6BAAwB;AACxB,qCAA+C;AAE/C,qCAAoF;AAoCpF;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,8BAA8B;IAC9B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAEnF,0DAA0D;IAC1D,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACrD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QAC/E,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACrF,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC1F,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KACvF,CAAC;SACD,QAAQ,CAAC,qDAAqD,CAAC;IAElE,qDAAqD;IACrD,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;CACpF,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,8BAA8B,GAAG;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,0EAA0E;QAC1E,6DAA6D;QAC7D,gEAAgE;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;gBAClE,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,cAAc;qBAC5B;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wCAAwC;qBACtD;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,6CAA6C;qBAC3D;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,+CAA+C;qBAC7D;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,6CAA6C;qBAC3D;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;QAChC,oBAAoB,EAAE,KAAK;KAC5B;CACO,CAAC;AAEX;;;;;GAKG;AACI,KAAK,UAAU,gBAAgB,CACpC,MAA8B;IAE9B,8BAA8B;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,OAAO,IAAA,oBAAW,EAAC,mBAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,mCAAmC;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAA6B,CAAC,KAAK,SAAS,CAC3D,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAA,oBAAW,EAAC;YACjB,IAAI,EAAE,yBAAgB,CAAC,iBAAiB;YACxC,OAAO,EAAE,8BAA8B;YACvC,UAAU,EACR,uFAAuF;SAC1F,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAA,4BAAmB,EACxB,CAAC,MAAM,EAAE,EAAE;QACT,yBAAyB;QACzB,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAS,qCAAqC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE9F,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAA,oBAAW,EAChB,YAAY,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,wBAAwB,EAAE,CACrF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,IAAA,oBAAW,EAAqB,mBAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,WAAW,GAAsB,EAAE,CAAC;QAE1C,yDAAyD;QACzD,MAAM,YAAY,GAA2B;YAC3C,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,YAAY;YACvB,OAAO,EAAE,UAAU;SACpB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,MAAM,KAAK,GAAG,MAAM,CAAC,GAA+B,CAAC,CAAC;YACtD,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAElC,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,MAAM,CAAC,CAAC;YACnC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,sDAAsD;QACtD,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE3B,MAAM,WAAW,GAAG;;cAEZ,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;OAE5B,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAE9D,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAA,oBAAW,EAChB,YAAY,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,yBAAyB,EAAE,CACtF,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,IAAA,oBAAW,EAAqB;gBACrC,IAAI,EAAE,yBAAgB,CAAC,eAAe;gBACtC,OAAO,EAAE,4BAA4B,QAAQ,GAAG;gBAChD,UAAU,EAAE,sDAAsD;aACnE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAA,sBAAa,EAAC;YACnB,QAAQ;YACR,aAAa,EAAE,SAAS;YACxB,OAAO,EAAE,WAAW,QAAQ,2BAA2B,SAAS,CAAC,MAAM,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;SACrH,CAAC,CAAC;IACL,CAAC,EACD,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,MAA0C;IACjF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,2BAA2B,EAAE,EAAE,EAAE,UAAU,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QAE/F,IAAI,KAAK,EAAE,UAAU,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,KAAK,GAAa;QACtB,aAAa,IAAI,CAAC,QAAQ,WAAW;QACrC,EAAE;QACF,mBAAmB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACnD,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}