@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-next-steps.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Next-Step Lifecycle Handler
+ *
+ * Manages structured next-steps with status tracking:
+ * - list: View pending/all next-steps
+ * - complete: Mark a next-step as completed
+ * - carry: Carry pending next-steps to a new sprint
+ * - drop: Drop a next-step (no longer relevant)
+ *
+ * Wired into cmos_context(action="next_steps").
+ *
+ * @module tools/cmos/cmos-next-steps
+ */
+import type { CmosToolResult } from './types';
+import { type NextStepStatus } from './schema-migrations';
+/**
+ * A next-step record from the database.
+ */
+export interface NextStepRecord {
+    id: number;
+    content: string;
+    status: NextStepStatus;
+    sessionId: string | null;
+    sprintId: string | null;
+    missionId: string | null;
+    createdAt: string;
+    resolvedAt: string | null;
+    carriedToSprint: string | null;
+}
+export interface NextStepsResult {
+    /** The sub-action that was performed */
+    nextStepAction: string;
+    /** Next-steps returned (for list) */
+    items?: NextStepRecord[];
+    /** Count of items affected */
+    affected: number;
+    /** Message */
+    message: string;
+}
+export interface CmosNextStepsParams {
+    /** Sub-action: list | complete | carry | drop */
+    nextStepAction: 'list' | 'complete' | 'carry' | 'drop';
+    /** Filter by status (for list, default: pending) */
+    nextStepStatus?: NextStepStatus;
+    /** Next-step ID(s) to act on (for complete/carry/drop) */
+    nextStepIds?: number[];
+    /** Target sprint for carry action */
+    carryToSprint?: string;
+    /** Optional project root */
+    projectRoot?: string;
+}
+export declare function cmosNextSteps(params: CmosNextStepsParams): Promise<CmosToolResult<NextStepsResult>>;
+/**
+ * Format next-steps result for LLM readability.
+ */
+export declare function formatNextStepsForLLM(result: CmosToolResult<NextStepsResult>): string;
+//# sourceMappingURL=cmos-next-steps.d.ts.map

package/dist/tools/cmos/cmos-next-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-next-steps.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-next-steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,cAAc,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACvD,oDAAoD;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAkC1C;AA0ID;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,GAAG,MAAM,CAsBrF"}

package/dist/tools/cmos/cmos-next-steps.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Next-Step Lifecycle Handler
+ *
+ * Manages structured next-steps with status tracking:
+ * - list: View pending/all next-steps
+ * - complete: Mark a next-step as completed
+ * - carry: Carry pending next-steps to a new sprint
+ * - drop: Drop a next-step (no longer relevant)
+ *
+ * Wired into cmos_context(action="next_steps").
+ *
+ * @module tools/cmos/cmos-next-steps
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosNextSteps = cmosNextSteps;
+exports.formatNextStepsForLLM = formatNextStepsForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+async function cmosNextSteps(params) {
+    const action = params.nextStepAction;
+    if (!action || !['list', 'complete', 'carry', 'drop'].includes(action)) {
+        return (0, errors_1.createError)({
+            code: 'INVALID_ACTION',
+            message: `Invalid next_step action: '${action}'`,
+            suggestion: 'Use nextStepAction: list | complete | carry | drop',
+            validValues: ['list', 'complete', 'carry', 'drop'],
+        });
+    }
+    return (0, client_1.withClient)((client) => {
+        (0, schema_migrations_1.ensureNextStepsTable)(client);
+        switch (action) {
+            case 'list':
+                return listNextSteps(client, params.nextStepStatus ?? 'pending');
+            case 'complete':
+                return transitionNextSteps(client, params.nextStepIds ?? [], 'completed');
+            case 'carry':
+                return carryNextSteps(client, params.nextStepIds, params.carryToSprint ?? null);
+            case 'drop':
+                return transitionNextSteps(client, params.nextStepIds ?? [], 'dropped');
+            default:
+                return (0, errors_1.createError)({
+                    code: 'INVALID_ACTION',
+                    message: `Unknown next_step action: '${action}'`,
+                });
+        }
+    }, { projectRoot: params.projectRoot });
+}
+function listNextSteps(client, status) {
+    const query = status === 'pending'
+        ? `SELECT id, content, status, session_id, sprint_id, mission_id, created_at, resolved_at, carried_to_sprint
+         FROM next_steps WHERE status = 'pending' ORDER BY created_at ASC`
+        : `SELECT id, content, status, session_id, sprint_id, mission_id, created_at, resolved_at, carried_to_sprint
+         FROM next_steps WHERE status = ? ORDER BY created_at ASC`;
+    const result = status === 'pending'
+        ? client.getMany(query)
+        : client.getMany(query, [status]);
+    if (!result.success || !result.data) {
+        return (0, errors_1.createError)({
+            code: 'DB_QUERY_FAILED',
+            message: 'Failed to query next-steps',
+        });
+    }
+    const items = result.data.map((row) => ({
+        id: row.id,
+        content: row.content,
+        status: row.status,
+        sessionId: row.session_id,
+        sprintId: row.sprint_id,
+        missionId: row.mission_id,
+        createdAt: row.created_at,
+        resolvedAt: row.resolved_at,
+        carriedToSprint: row.carried_to_sprint,
+    }));
+    return (0, errors_1.createSuccess)({
+        nextStepAction: 'list',
+        items,
+        affected: items.length,
+        message: `Found ${items.length} next-step(s) with status '${status}'`,
+    });
+}
+function transitionNextSteps(client, ids, targetStatus) {
+    if (ids.length === 0) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('nextStepIds'));
+    }
+    const now = new Date().toISOString();
+    let affected = 0;
+    for (const id of ids) {
+        const result = client.execute(`UPDATE next_steps SET status = ?, resolved_at = ? WHERE id = ? AND status = 'pending'`, [targetStatus, now, id]);
+        if (result.success && result.data?.changes && result.data.changes > 0) {
+            affected++;
+        }
+    }
+    return (0, errors_1.createSuccess)({
+        nextStepAction: targetStatus === 'completed' ? 'complete' : 'drop',
+        affected,
+        message: `${affected} next-step(s) marked as ${targetStatus}`,
+    });
+}
+function carryNextSteps(client, ids, targetSprint) {
+    // If no IDs provided, carry ALL pending next-steps
+    const now = new Date().toISOString();
+    if (!ids || ids.length === 0) {
+        // Carry all pending
+        const result = client.execute(`UPDATE next_steps SET status = 'carried', resolved_at = ?, carried_to_sprint = ? WHERE status = 'pending'`, [now, targetSprint]);
+        const affected = result.success && result.data?.changes ? result.data.changes : 0;
+        return (0, errors_1.createSuccess)({
+            nextStepAction: 'carry',
+            affected,
+            message: targetSprint
+                ? `${affected} pending next-step(s) carried to ${targetSprint}`
+                : `${affected} pending next-step(s) marked as carried`,
+        });
+    }
+    let affected = 0;
+    for (const id of ids) {
+        const result = client.execute(`UPDATE next_steps SET status = 'carried', resolved_at = ?, carried_to_sprint = ? WHERE id = ? AND status = 'pending'`, [now, targetSprint, id]);
+        if (result.success && result.data?.changes && result.data.changes > 0) {
+            affected++;
+        }
+    }
+    return (0, errors_1.createSuccess)({
+        nextStepAction: 'carry',
+        affected,
+        message: targetSprint
+            ? `${affected} next-step(s) carried to ${targetSprint}`
+            : `${affected} next-step(s) marked as carried`,
+    });
+}
+/**
+ * Format next-steps result for LLM readability.
+ */
+function formatNextStepsForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return `Failed to manage next-steps: ${error?.message ?? 'Unknown error'}`;
+    }
+    const d = result.data;
+    if (d.nextStepAction === 'list' && d.items) {
+        if (d.items.length === 0) {
+            return 'No pending next-steps found.';
+        }
+        const lines = [`**Next Steps (${d.items.length})**`, ''];
+        for (const item of d.items) {
+            const sprint = item.sprintId ? ` [${item.sprintId}]` : '';
+            const mission = item.missionId ? ` (${item.missionId})` : '';
+            lines.push(`  #${item.id} [${item.status}]${sprint}${mission}: ${item.content}`);
+        }
+        return lines.join('\n');
+    }
+    return d.message;
+}
+//# sourceMappingURL=cmos-next-steps.js.map

package/dist/tools/cmos/cmos-next-steps.js.map

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

package/dist/tools/cmos/cmos-project-init.d.ts

@@ -0,0 +1,283 @@
+/**
+ * cmos_project_init Tool
+ *
+ * MCP tool for initializing a new CMOS project structure.
+ * Copies the full cmos-seed directory and creates a fresh SQLite database.
+ *
+ * Features:
+ * - Copies full seed structure (docs, templates, foundational-docs, context, tiers)
+ * - Creates fresh SQLite database from schema.sql
+ * - Sets project metadata (name, id, tracelab link)
+ * - Optionally creates initial sprint and missions
+ * - Idempotent - safe to call on existing project (won't overwrite existing files)
+ *
+ * @module tools/cmos/cmos-project-init
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+/**
+ * Resolve the path to the cmos-seed directory.
+ * Looks relative to the package root (one level up from dist/ or src/).
+ */
+export declare function resolveSeedPath(): string | null;
+/**
+ * Initial sprint definition for project setup.
+ */
+export interface InitialSprint {
+    id: string;
+    title: string;
+    focus?: string;
+    status?: string;
+}
+/**
+ * Initial mission definition for project setup.
+ */
+export interface InitialMission {
+    id: string;
+    name: string;
+    sprintId: string;
+    objective?: string;
+    successCriteria?: string[];
+    deliverables?: string[];
+    status?: 'Queued' | 'Current';
+}
+/**
+ * Input parameters schema for cmos_project_init tool.
+ */
+export declare const cmosProjectInitSchema: z.ZodObject<{
+    /** Root directory where cmos/ will be created (required) */
+    projectRoot: z.ZodString;
+    /** Human-readable project name */
+    projectName: z.ZodOptional<z.ZodString>;
+    /** Unique project identifier (auto-generated if not provided) */
+    projectId: z.ZodOptional<z.ZodString>;
+    /** Linked TraceLab project UUID for cross-referencing */
+    tracelabProjectId: z.ZodOptional<z.ZodString>;
+    /** Optional initial sprint to create */
+    initialSprint: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        focus: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        title: string;
+        focus?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        status?: string | undefined;
+        focus?: string | undefined;
+    }>>;
+    /** Optional initial missions to create */
+    initialMissions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        sprintId: z.ZodString;
+        objective: z.ZodOptional<z.ZodString>;
+        successCriteria: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deliverables: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        status: z.ZodDefault<z.ZodOptional<z.ZodEnum<["Queued", "Current"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: "Queued" | "Current";
+        sprintId: string;
+        id: string;
+        objective?: string | undefined;
+        deliverables?: string[] | undefined;
+        successCriteria?: string[] | undefined;
+    }, {
+        name: string;
+        sprintId: string;
+        id: string;
+        status?: "Queued" | "Current" | undefined;
+        objective?: string | undefined;
+        deliverables?: string[] | undefined;
+        successCriteria?: string[] | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot: string;
+    projectName?: string | undefined;
+    projectId?: string | undefined;
+    tracelabProjectId?: string | undefined;
+    initialSprint?: {
+        status: string;
+        id: string;
+        title: string;
+        focus?: string | undefined;
+    } | undefined;
+    initialMissions?: {
+        name: string;
+        status: "Queued" | "Current";
+        sprintId: string;
+        id: string;
+        objective?: string | undefined;
+        deliverables?: string[] | undefined;
+        successCriteria?: string[] | undefined;
+    }[] | undefined;
+}, {
+    projectRoot: string;
+    projectName?: string | undefined;
+    projectId?: string | undefined;
+    tracelabProjectId?: string | undefined;
+    initialSprint?: {
+        id: string;
+        title: string;
+        status?: string | undefined;
+        focus?: string | undefined;
+    } | undefined;
+    initialMissions?: {
+        name: string;
+        sprintId: string;
+        id: string;
+        status?: "Queued" | "Current" | undefined;
+        objective?: string | undefined;
+        deliverables?: string[] | undefined;
+        successCriteria?: string[] | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Input type (before defaults applied) - use this for function parameters.
+ */
+export type CmosProjectInitInput = z.input<typeof cmosProjectInitSchema>;
+/**
+ * Output type (after defaults applied) - use this internally.
+ */
+export type CmosProjectInitParams = z.infer<typeof cmosProjectInitSchema>;
+/**
+ * Result of project initialization.
+ */
+export interface CmosProjectInitResult {
+    /** Path to the created cmos/ directory */
+    cmosDirectory: string;
+    /** Path to the created database */
+    databasePath: string;
+    /** Whether this was a new initialization or update to existing */
+    isNewProject: boolean;
+    /** Project ID (generated or provided) */
+    projectId: string;
+    /** Project name */
+    projectName: string;
+    /** Schema version applied */
+    schemaVersion: string;
+    /** Files and directories created */
+    created: {
+        directories: string[];
+        files: string[];
+    };
+    /** Sprint created (if any) */
+    sprintCreated?: string;
+    /** Missions created (if any) */
+    missionsCreated?: string[];
+}
+/**
+ * MCP Tool Definition for cmos_project_init.
+ */
+export declare const cmosProjectInitToolDefinition: {
+    readonly name: "cmos_project_init";
+    readonly description: "Initialize a new CMOS project structure. Copies the full cmos-seed (tiers, docs, templates, foundational-docs, context, schema) and creates a fresh SQLite database. Safe to call on existing projects (idempotent - won't overwrite existing files).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Root directory where cmos/ will be created";
+            };
+            readonly projectName: {
+                readonly type: "string";
+                readonly description: "Human-readable project name";
+            };
+            readonly projectId: {
+                readonly type: "string";
+                readonly description: "Unique project identifier (UUID or slug, auto-generated if not provided)";
+            };
+            readonly tracelabProjectId: {
+                readonly type: "string";
+                readonly description: "Linked TraceLab project UUID for cross-referencing";
+            };
+            readonly initialSprint: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly description: "Sprint ID (e.g., \"sprint-01\")";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly description: "Sprint title";
+                    };
+                    readonly focus: {
+                        readonly type: "string";
+                        readonly description: "Sprint focus/theme";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly description: "Sprint status (default: Active)";
+                    };
+                };
+                readonly required: readonly ["id", "title"];
+                readonly description: "Optional initial sprint to create";
+            };
+            readonly initialMissions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                            readonly description: "Mission ID";
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                            readonly description: "Mission name";
+                        };
+                        readonly sprintId: {
+                            readonly type: "string";
+                            readonly description: "Sprint ID";
+                        };
+                        readonly objective: {
+                            readonly type: "string";
+                            readonly description: "Mission objective";
+                        };
+                        readonly successCriteria: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Success criteria";
+                        };
+                        readonly deliverables: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Expected deliverables";
+                        };
+                        readonly status: {
+                            readonly type: "string";
+                            readonly enum: readonly ["Queued", "Current"];
+                            readonly description: "Initial status";
+                        };
+                    };
+                    readonly required: readonly ["id", "name", "sprintId"];
+                };
+                readonly description: "Optional initial missions to create";
+            };
+        };
+        readonly required: readonly ["projectRoot"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_project_init tool.
+ *
+ * Copies the full cmos-seed directory to <projectRoot>/cmos/ and creates
+ * a fresh SQLite database with project metadata.
+ */
+export declare function cmosProjectInit(input: CmosProjectInitInput): Promise<CmosToolResult<CmosProjectInitResult>>;
+/**
+ * Format initialization result for LLM readability.
+ */
+export declare function formatProjectInitForLLM(result: CmosToolResult<CmosProjectInitResult>): string;
+//# sourceMappingURL=cmos-project-init.d.ts.map

package/dist/tools/cmos/cmos-project-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-project-init.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-project-init.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAgB/C;AA+ED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,4DAA4D;;IAG5D,kCAAkC;;IAGlC,iEAAiE;;IAMjE,yDAAyD;;IAMzD,wCAAwC;;;;;;;;;;;;;;;;;IAWxC,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe1C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IAEF,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEhC,CAAC;AAEX;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAwPhD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAkD7F"}