@cleocode/core 2.0.0

package/dist/validation/operation-verification-gates.js

@@ -0,0 +1,532 @@
+/**
+ * Operation Verification Gate System for CLEO
+ *
+ * Implements 4-layer validation gate system for MCP/dispatch operations:
+ * Layer 1: Schema Validation (JSON Schema compliance)
+ * Layer 2: Semantic Validation (Business rules)
+ * Layer 3: Referential Validation (Cross-entity integrity)
+ * Layer 4: Protocol Validation (RCASD-IVTR+C lifecycle)
+ *
+ * Moved from src/mcp/lib/verification-gates.ts to core for proper layering.
+ *
+ * @task T2936
+ * @task T5707
+ * @epic T2908
+ */
+import { ProtocolEnforcer } from '../compliance/protocol-enforcement.js';
+import { ErrorCategory, ErrorSeverity, ProtocolExitCode } from '../compliance/protocol-types.js';
+import { validateLayer1Schema, validateLayer2Semantic, validateLayer3Referential, validateLayer4Protocol, } from './operation-gate-validators.js';
+/**
+ * Gate layer enumeration
+ */
+export var GateLayer;
+(function (GateLayer) {
+    GateLayer[GateLayer["SCHEMA"] = 1] = "SCHEMA";
+    GateLayer[GateLayer["SEMANTIC"] = 2] = "SEMANTIC";
+    GateLayer[GateLayer["REFERENTIAL"] = 3] = "REFERENTIAL";
+    GateLayer[GateLayer["PROTOCOL"] = 4] = "PROTOCOL";
+})(GateLayer || (GateLayer = {}));
+/**
+ * Gate status for each layer
+ */
+export var GateStatus;
+(function (GateStatus) {
+    GateStatus["PENDING"] = "pending";
+    GateStatus["PASSED"] = "passed";
+    GateStatus["FAILED"] = "failed";
+    GateStatus["BLOCKED"] = "blocked";
+    GateStatus["SKIPPED"] = "skipped";
+})(GateStatus || (GateStatus = {}));
+/**
+ * Main Verification Gate class
+ *
+ * Orchestrates 4-layer validation and determines pass/fail status.
+ * Each layer must pass before proceeding to the next.
+ */
+export class VerificationGate {
+    protocolEnforcer;
+    strictMode;
+    constructor(strictMode = true) {
+        this.protocolEnforcer = new ProtocolEnforcer(strictMode);
+        this.strictMode = strictMode;
+    }
+    /**
+     * Execute all 4 gate layers sequentially
+     *
+     * Stops at first failure unless in advisory mode.
+     */
+    async verifyOperation(context) {
+        const layers = {};
+        // Layer 1: Schema Validation
+        const schemaResult = await this.runLayer(GateLayer.SCHEMA, () => validateLayer1Schema(context));
+        layers[GateLayer.SCHEMA] = schemaResult;
+        if (!schemaResult.passed && this.strictMode) {
+            return this.buildFailureResult(layers, GateLayer.SCHEMA);
+        }
+        // Layer 2: Semantic Validation
+        const semanticResult = await this.runLayer(GateLayer.SEMANTIC, () => validateLayer2Semantic(context));
+        layers[GateLayer.SEMANTIC] = semanticResult;
+        if (!semanticResult.passed && this.strictMode) {
+            return this.buildFailureResult(layers, GateLayer.SEMANTIC);
+        }
+        // Layer 3: Referential Validation
+        const referentialResult = await this.runLayer(GateLayer.REFERENTIAL, () => validateLayer3Referential(context));
+        layers[GateLayer.REFERENTIAL] = referentialResult;
+        if (!referentialResult.passed && this.strictMode) {
+            return this.buildFailureResult(layers, GateLayer.REFERENTIAL);
+        }
+        // Layer 4: Protocol Validation
+        const protocolResult = await this.runLayer(GateLayer.PROTOCOL, () => validateLayer4Protocol(context, this.protocolEnforcer));
+        layers[GateLayer.PROTOCOL] = protocolResult;
+        if (!protocolResult.passed && this.strictMode) {
+            return this.buildFailureResult(layers, GateLayer.PROTOCOL);
+        }
+        // All gates passed
+        return this.buildSuccessResult(layers);
+    }
+    /**
+     * Run a single validation layer with timing
+     */
+    async runLayer(layer, validator) {
+        const startTime = Date.now();
+        try {
+            const result = await validator();
+            result.duration_ms = Date.now() - startTime;
+            return result;
+        }
+        catch (error) {
+            // Convert exceptions to layer failures
+            return {
+                layer,
+                status: GateStatus.FAILED,
+                passed: false,
+                violations: [
+                    {
+                        layer,
+                        severity: ErrorSeverity.ERROR,
+                        code: 'E_VALIDATION_ERROR',
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                ],
+                duration_ms: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Build success result when all gates pass
+     */
+    buildSuccessResult(layers) {
+        return {
+            passed: true,
+            layers,
+            totalViolations: 0,
+            exitCode: ProtocolExitCode.SUCCESS,
+            category: ErrorCategory.GENERAL,
+            summary: 'All verification gates passed',
+        };
+    }
+    /**
+     * Build failure result when a gate fails
+     */
+    buildFailureResult(layers, blockedAt) {
+        const failedLayer = layers[blockedAt];
+        const totalViolations = Object.values(layers).reduce((sum, layer) => sum + layer.violations.length, 0);
+        // Determine exit code based on layer and violation type
+        let exitCode = ProtocolExitCode.E_VALIDATION_ERROR;
+        let category = ErrorCategory.GENERAL;
+        if (blockedAt === GateLayer.SCHEMA) {
+            exitCode = ProtocolExitCode.E_VALIDATION_ERROR;
+            category = ErrorCategory.GENERAL;
+        }
+        else if (blockedAt === GateLayer.SEMANTIC) {
+            exitCode = this.determineSemanticExitCode(failedLayer.violations);
+            category = ErrorCategory.HIERARCHY;
+        }
+        else if (blockedAt === GateLayer.REFERENTIAL) {
+            exitCode = this.determineReferentialExitCode(failedLayer.violations);
+            category = ErrorCategory.HIERARCHY;
+        }
+        else if (blockedAt === GateLayer.PROTOCOL) {
+            exitCode = this.determineProtocolExitCode(failedLayer.violations);
+            category = ErrorCategory.PROTOCOL;
+        }
+        return {
+            passed: false,
+            layers,
+            totalViolations,
+            exitCode,
+            category,
+            summary: `Verification failed at layer ${blockedAt}: ${failedLayer.violations[0]?.message || 'Unknown error'}`,
+            blockedAt,
+        };
+    }
+    /**
+     * Determine semantic layer exit code from violations
+     */
+    determineSemanticExitCode(violations) {
+        for (const v of violations) {
+            if (v.code.includes('PARENT'))
+                return ProtocolExitCode.E_PARENT_NOT_FOUND;
+            if (v.code.includes('DEPTH'))
+                return ProtocolExitCode.E_DEPTH_EXCEEDED;
+            if (v.code.includes('SIBLING'))
+                return ProtocolExitCode.E_SIBLING_LIMIT;
+            if (v.code.includes('CIRCULAR'))
+                return ProtocolExitCode.E_CIRCULAR_REFERENCE;
+            if (v.code.includes('SESSION'))
+                return ProtocolExitCode.E_SESSION_REQUIRED;
+        }
+        return ProtocolExitCode.E_VALIDATION_ERROR;
+    }
+    /**
+     * Determine referential layer exit code from violations
+     */
+    determineReferentialExitCode(violations) {
+        for (const v of violations) {
+            if (v.code.includes('NOT_FOUND'))
+                return ProtocolExitCode.E_NOT_FOUND;
+            if (v.code.includes('PARENT'))
+                return ProtocolExitCode.E_PARENT_NOT_FOUND;
+            if (v.code.includes('DEPENDENCY'))
+                return ProtocolExitCode.E_DEPENDENCY_ERROR;
+        }
+        return ProtocolExitCode.E_NOT_FOUND;
+    }
+    /**
+     * Determine protocol layer exit code from violations
+     */
+    determineProtocolExitCode(violations) {
+        for (const v of violations) {
+            if (v.code.includes('RESEARCH'))
+                return ProtocolExitCode.E_PROTOCOL_RESEARCH;
+            if (v.code.includes('CONSENSUS'))
+                return ProtocolExitCode.E_PROTOCOL_CONSENSUS;
+            if (v.code.includes('SPECIFICATION'))
+                return ProtocolExitCode.E_PROTOCOL_SPECIFICATION;
+            if (v.code.includes('DECOMPOSITION'))
+                return ProtocolExitCode.E_PROTOCOL_DECOMPOSITION;
+            if (v.code.includes('IMPLEMENTATION'))
+                return ProtocolExitCode.E_PROTOCOL_IMPLEMENTATION;
+            if (v.code.includes('CONTRIBUTION'))
+                return ProtocolExitCode.E_PROTOCOL_CONTRIBUTION;
+            if (v.code.includes('RELEASE'))
+                return ProtocolExitCode.E_PROTOCOL_RELEASE;
+            if (v.code.includes('VALIDATION'))
+                return ProtocolExitCode.E_PROTOCOL_VALIDATION;
+            if (v.code.includes('TESTING'))
+                return ProtocolExitCode.E_TESTS_SKIPPED;
+            if (v.code.includes('LIFECYCLE'))
+                return ProtocolExitCode.E_LIFECYCLE_GATE_FAILED;
+        }
+        return ProtocolExitCode.E_PROTOCOL_GENERIC;
+    }
+    /**
+     * Check if an operation requires gate validation
+     *
+     * All mutate operations require validation.
+     * Query operations skip validation for performance.
+     */
+    static requiresValidation(context) {
+        if (context.gateway === 'mutate') {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get human-readable layer name
+     */
+    static getLayerName(layer) {
+        const names = {
+            [GateLayer.SCHEMA]: 'Schema Validation',
+            [GateLayer.SEMANTIC]: 'Semantic Validation',
+            [GateLayer.REFERENTIAL]: 'Referential Validation',
+            [GateLayer.PROTOCOL]: 'Protocol Validation',
+        };
+        return names[layer];
+    }
+}
+/**
+ * Factory function for creating verification gates
+ */
+export function createVerificationGate(strictMode = true) {
+    return new VerificationGate(strictMode);
+}
+/**
+ * Export gate layer sequence for external use
+ */
+export const GATE_SEQUENCE = [
+    GateLayer.SCHEMA,
+    GateLayer.SEMANTIC,
+    GateLayer.REFERENTIAL,
+    GateLayer.PROTOCOL,
+];
+// ============================================================================
+// Section 7: Workflow Verification Gates
+// ============================================================================
+/**
+ * Workflow gate names per MCP-SERVER-SPECIFICATION.md Section 7.1
+ *
+ * @task T3141
+ */
+export var WorkflowGateName;
+(function (WorkflowGateName) {
+    WorkflowGateName["IMPLEMENTED"] = "implemented";
+    WorkflowGateName["TESTS_PASSED"] = "testsPassed";
+    WorkflowGateName["QA_PASSED"] = "qaPassed";
+    WorkflowGateName["CLEANUP_DONE"] = "cleanupDone";
+    WorkflowGateName["SECURITY_PASSED"] = "securityPassed";
+    WorkflowGateName["DOCUMENTED"] = "documented";
+})(WorkflowGateName || (WorkflowGateName = {}));
+/**
+ * Complete workflow gate definitions per Section 7.2
+ */
+export const WORKFLOW_GATE_DEFINITIONS = [
+    {
+        name: WorkflowGateName.IMPLEMENTED,
+        agent: 'coder',
+        dependsOn: [],
+        description: 'Code implementation complete',
+    },
+    {
+        name: WorkflowGateName.TESTS_PASSED,
+        agent: 'testing',
+        dependsOn: [WorkflowGateName.IMPLEMENTED],
+        description: 'All tests passing',
+    },
+    {
+        name: WorkflowGateName.QA_PASSED,
+        agent: 'qa',
+        dependsOn: [WorkflowGateName.TESTS_PASSED],
+        description: 'QA review approved',
+    },
+    {
+        name: WorkflowGateName.CLEANUP_DONE,
+        agent: 'cleanup',
+        dependsOn: [WorkflowGateName.QA_PASSED],
+        description: 'Code cleanup finished',
+    },
+    {
+        name: WorkflowGateName.SECURITY_PASSED,
+        agent: 'security',
+        dependsOn: [WorkflowGateName.CLEANUP_DONE],
+        description: 'Security audit passed',
+    },
+    {
+        name: WorkflowGateName.DOCUMENTED,
+        agent: 'docs',
+        dependsOn: [WorkflowGateName.SECURITY_PASSED],
+        description: 'Documentation complete',
+    },
+];
+/**
+ * Ordered workflow gate sequence per Section 7.1
+ */
+export const WORKFLOW_GATE_SEQUENCE = [
+    WorkflowGateName.IMPLEMENTED,
+    WorkflowGateName.TESTS_PASSED,
+    WorkflowGateName.QA_PASSED,
+    WorkflowGateName.CLEANUP_DONE,
+    WorkflowGateName.SECURITY_PASSED,
+    WorkflowGateName.DOCUMENTED,
+];
+/**
+ * Map from gate name to definition for fast lookup
+ */
+const GATE_DEF_MAP = Object.fromEntries(WORKFLOW_GATE_DEFINITIONS.map((d) => [d.name, d]));
+/**
+ * WorkflowGateTracker
+ *
+ * Tracks the status of all 6 workflow verification gates for a task.
+ * Implements Section 7.4 failure cascade behavior: when a gate fails,
+ * all downstream gates reset to null.
+ *
+ * @task T3141
+ */
+export class WorkflowGateTracker {
+    gates;
+    constructor() {
+        this.gates = new Map();
+        for (const def of WORKFLOW_GATE_DEFINITIONS) {
+            this.gates.set(def.name, {
+                name: def.name,
+                status: null,
+                agent: def.agent,
+                updatedAt: null,
+            });
+        }
+    }
+    /**
+     * Get the status of a specific gate
+     */
+    getGateStatus(gateName) {
+        const gate = this.gates.get(gateName);
+        return gate ? gate.status : null;
+    }
+    /**
+     * Get the full state of a specific gate
+     */
+    getGateState(gateName) {
+        return this.gates.get(gateName);
+    }
+    /**
+     * Get all gate states
+     */
+    getAllGates() {
+        return WORKFLOW_GATE_SEQUENCE.map((name) => this.gates.get(name));
+    }
+    /**
+     * Check if a gate can be attempted (all dependencies passed)
+     */
+    canAttempt(gateName) {
+        const def = GATE_DEF_MAP[gateName];
+        if (!def)
+            return false;
+        for (const dep of def.dependsOn) {
+            const depState = this.gates.get(dep);
+            if (!depState || depState.status !== 'passed') {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Mark a gate as passed.
+     */
+    passGate(gateName, agent) {
+        if (!this.isValidGate(gateName))
+            return false;
+        if (!this.canAttempt(gateName))
+            return false;
+        const gate = this.gates.get(gateName);
+        const expectedAgent = GATE_DEF_MAP[gateName].agent;
+        if (agent && agent !== expectedAgent)
+            return false;
+        gate.status = 'passed';
+        gate.updatedAt = new Date().toISOString();
+        delete gate.failureReason;
+        return true;
+    }
+    /**
+     * Mark a gate as failed.
+     *
+     * Per Section 7.4: When a gate fails, all downstream gates reset to null.
+     */
+    failGate(gateName, reason) {
+        if (!this.isValidGate(gateName))
+            return false;
+        const gate = this.gates.get(gateName);
+        gate.status = 'failed';
+        gate.updatedAt = new Date().toISOString();
+        if (reason)
+            gate.failureReason = reason;
+        // Section 7.4 failure cascade: reset all downstream gates to null
+        this.cascadeReset(gateName);
+        return true;
+    }
+    /**
+     * Reset a gate and all downstream gates to null.
+     */
+    cascadeReset(failedGateName) {
+        const failedIndex = WORKFLOW_GATE_SEQUENCE.indexOf(failedGateName);
+        if (failedIndex === -1)
+            return;
+        for (let i = failedIndex + 1; i < WORKFLOW_GATE_SEQUENCE.length; i++) {
+            const downstreamName = WORKFLOW_GATE_SEQUENCE[i];
+            const downstreamGate = this.gates.get(downstreamName);
+            downstreamGate.status = null;
+            downstreamGate.updatedAt = null;
+            delete downstreamGate.failureReason;
+        }
+    }
+    /**
+     * Update blocked status for all gates based on current state.
+     */
+    updateBlockedStatus() {
+        for (const name of WORKFLOW_GATE_SEQUENCE) {
+            const gate = this.gates.get(name);
+            if (gate.status === null && !this.canAttempt(name)) {
+                gate.status = 'blocked';
+            }
+            if (gate.status === 'blocked' && this.canAttempt(name)) {
+                gate.status = null;
+            }
+        }
+    }
+    /**
+     * Check if all gates have passed
+     */
+    allPassed() {
+        for (const name of WORKFLOW_GATE_SEQUENCE) {
+            if (this.gates.get(name).status !== 'passed')
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Get all gates that are currently blocked or have null status
+     */
+    getPendingGates() {
+        return this.getAllGates().filter((g) => g.status === null || g.status === 'blocked');
+    }
+    /**
+     * Get the next gate that can be attempted
+     */
+    getNextAttemptable() {
+        for (const name of WORKFLOW_GATE_SEQUENCE) {
+            const gate = this.gates.get(name);
+            if (gate.status !== 'passed' && this.canAttempt(name)) {
+                return name;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get downstream gates of a given gate (not including the gate itself)
+     */
+    getDownstreamGates(gateName) {
+        const index = WORKFLOW_GATE_SEQUENCE.indexOf(gateName);
+        if (index === -1)
+            return [];
+        return WORKFLOW_GATE_SEQUENCE.slice(index + 1);
+    }
+    /**
+     * Serialize gate states to a plain record
+     */
+    toRecord() {
+        const record = {};
+        for (const name of WORKFLOW_GATE_SEQUENCE) {
+            record[name] = this.gates.get(name).status;
+        }
+        return record;
+    }
+    /**
+     * Restore gate states from a record
+     */
+    fromRecord(record) {
+        for (const [name, status] of Object.entries(record)) {
+            const gate = this.gates.get(name);
+            if (gate) {
+                gate.status = status;
+            }
+        }
+    }
+    /**
+     * Check if a gate name is valid
+     */
+    isValidGate(gateName) {
+        return this.gates.has(gateName);
+    }
+}
+/**
+ * Validate a workflow gate name string
+ */
+export function isValidWorkflowGateName(name) {
+    return WORKFLOW_GATE_SEQUENCE.includes(name);
+}
+/**
+ * Get the definition for a workflow gate
+ */
+export function getWorkflowGateDefinition(name) {
+    return GATE_DEF_MAP[name];
+}
+//# sourceMappingURL=operation-verification-gates.js.map

package/dist/validation/operation-verification-gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-verification-gates.js","sourceRoot":"","sources":["../../src/validation/operation-verification-gates.ts"],"names":[],"mappings":"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"}

package/dist/validation/param-utils.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Param derivation utilities (Core).
+ *
+ * Converts operation parameter definitions into the shapes required by:
+ *  - Commander.js (CLI adapter): positionals + option strings
+ *  - MCP JSON Schema (MCP adapter): input_schema object
+ *
+ * Canonical location: src/core/validation/param-utils.ts
+ * Re-exported from: src/dispatch/lib/param-utils.ts (backward compat)
+ *
+ * @task T4894
+ * @task T4900
+ * @task T5706
+ */
+interface OperationDef {
+    gateway: string;
+    domain: string;
+    operation: string;
+    description: string;
+    tier: number;
+    params?: ParamDef[];
+    [key: string]: unknown;
+}
+type ParamType = 'string' | 'number' | 'boolean' | 'array' | 'object';
+interface ParamCliDef {
+    positional?: boolean;
+    variadic?: boolean;
+    alias?: string;
+    flag?: string;
+    short?: string;
+    hidden?: boolean;
+    [key: string]: unknown;
+}
+interface ParamMcpDef {
+    name?: string;
+    description?: string;
+    enum?: string[];
+    hidden?: boolean;
+    [key: string]: unknown;
+}
+interface ParamDef {
+    name: string;
+    type: ParamType;
+    required: boolean;
+    description: string;
+    default?: unknown;
+    enum?: string[];
+    items?: {
+        type: ParamType;
+    };
+    cli?: ParamCliDef;
+    mcp?: ParamMcpDef;
+}
+export type JsonSchemaType = 'string' | 'number' | 'boolean' | 'array' | 'object';
+export interface JsonSchemaProperty {
+    type: JsonSchemaType;
+    description: string;
+    enum?: readonly string[];
+    items?: {
+        type: JsonSchemaType;
+    };
+}
+export interface JSONSchemaObject {
+    type: 'object';
+    properties: Record<string, JsonSchemaProperty>;
+    required: string[];
+}
+/**
+ * Build a JSON Schema `input_schema` object from an `OperationDef`.
+ *
+ * Algorithm:
+ *  1. Iterate `def.params`
+ *  2. Skip params where `mcp.hidden === true`
+ *  3. Map ParamType → JSON Schema type
+ *  4. Collect names where `required === true` into `required[]`
+ *  5. Return { type: 'object', properties, required }
+ */
+export declare function buildMcpInputSchema(def: OperationDef): JSONSchemaObject;
+export interface CommanderArgSplit {
+    /** Params that map to `.argument('<name>')` or `.argument('[name]')`. */
+    positionals: ParamDef[];
+    /** Params that map to `.option(...)` calls. */
+    options: ParamDef[];
+}
+/**
+ * Split `OperationDef.params` into positional arguments and option flags,
+ * suitable for Commander.js registration.
+ *
+ * - `cli.positional === true` → goes into `positionals[]`
+ * - everything else with a `cli` key → goes into `options[]`
+ * - Params with no `cli` key → MCP-only; excluded from both arrays
+ */
+export declare function buildCommanderArgs(def: OperationDef): CommanderArgSplit;
+/**
+ * Build the Commander option string for a single non-positional ParamDef.
+ *
+ * Examples:
+ *   { name:'taskId', type:'string', cli:{} }
+ *     → '--taskId <taskId>'
+ *   { name:'status', type:'string', cli:{short:'-s', flag:'status'} }
+ *     → '-s, --status <status>'
+ *   { name:'dryRun', type:'boolean', cli:{flag:'dry-run'} }
+ *     → '--dry-run'
+ *   { name:'limit', type:'number', cli:{} }
+ *     → '--limit <limit>'
+ */
+export declare function buildCommanderOptionString(param: ParamDef): string;
+/**
+ * Convert a camelCase string to kebab-case.
+ * e.g. 'includeArchive' → 'include-archive'
+ */
+export declare function camelToKebab(s: string): string;
+/**
+ * Validates that all required parameters are present in the request.
+ * Returns an array of missing parameter names.
+ *
+ * Replaces the old `requiredParams: string[]` check in registry.ts.
+ */
+export declare function validateRequiredParamsDef(def: OperationDef, params?: Record<string, unknown>): string[];
+export {};
+//# sourceMappingURL=param-utils.d.ts.map

package/dist/validation/param-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-utils.d.ts","sourceRoot":"","sources":["../../src/validation/param-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC;IAC5B,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAMD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CA6BvE;AAqBD,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,+CAA+C;IAC/C,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAgBvE;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAWlE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,YAAY,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,EAAE,CASV"}