@llm-dev-ops/agentics-cli 1.0.0

package/dist/commands/simulate.js

@@ -0,0 +1,97 @@
+/**
+ * Simulate Command
+ *
+ * SPARC Pseudocode Reference: §2.2
+ *
+ * FLOW:
+ * 1. Parse arguments → CommandObject
+ * 2. Execute simulation via agentics-simulation-runner
+ * 3. Record audit entry
+ * 4. Return SimulationReference
+ */
+import { RunnerAdapter } from '../adapters/base-adapter.js';
+import { createOrchestrationEngine, } from '../modules/orchestration-engine.js';
+import { createArtifactHandoff } from '../modules/artifact-handoff.js';
+import { createAuditTrail } from '../audit/audit-trail.js';
+import { failFast } from '../errors/index.js';
+import { loadEndpointConfig } from '../config/endpoints.js';
+// ============================================================================
+// Simulate Command Implementation
+// ============================================================================
+export async function executeSimulateCommand(input, options) {
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    const startTime = Date.now();
+    // Initialize components
+    const engine = createOrchestrationEngine(correlationId);
+    const handoff = createArtifactHandoff();
+    const audit = createAuditTrail();
+    // Create adapter
+    const runnerConfig = loadEndpointConfig('agentics-simulation-runner');
+    const runnerAdapter = new RunnerAdapter(runnerConfig, correlationId);
+    // Define orchestration stages
+    const stages = [
+        {
+            name: 'execute-simulation',
+            adapter: runnerAdapter,
+            request: {
+                endpoint: '/api/v1/simulations/execute',
+                method: 'POST',
+                buildBody: () => ({
+                    plan_ref: handoff.passthrough(input.planRef),
+                    config: input.config ?? {},
+                    iterations: input.iterations ?? 1,
+                }),
+            },
+        },
+    ];
+    try {
+        // Execute orchestration
+        const result = await engine.execute(stages, options);
+        if (!result.success) {
+            const failedStage = result.stages.find(s => s.status === 'failed');
+            throw new Error(failedStage?.error?.message ?? 'Simulation failed');
+        }
+        // Extract simulation reference
+        const simStage = result.stages.find(s => s.name === 'execute-simulation');
+        const simRef = handoff.extractReference(simStage?.response);
+        // Record audit entry
+        audit.record({
+            command: 'simulate',
+            inputs: { planRef: input.planRef.id, config: input.config, iterations: input.iterations },
+            outputs: simRef,
+            dependencies: [
+                { service: 'agentics-simulation-runner', method: 'execute', timestamp: new Date().toISOString(), duration_ms: result.timing.total, success: true },
+            ],
+            duration_ms: result.timing.total,
+            status: 'SUCCESS',
+            trace_id: correlationId,
+        });
+        return {
+            reference: simRef,
+            timing: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        // Record failure in audit
+        audit.record({
+            command: 'simulate',
+            inputs: { planRef: input.planRef.id, config: input.config },
+            outputs: null,
+            dependencies: [],
+            duration_ms: Date.now() - startTime,
+            status: 'FAILED',
+            error_code: error instanceof Error ? error.name : 'UNKNOWN',
+            error_message: error instanceof Error ? error.message : 'Unknown error',
+            trace_id: correlationId,
+        });
+        // Fail fast
+        failFast({
+            command: 'simulate',
+            phase: 'execution',
+            upstreamError: error instanceof Error ? error : new Error(String(error)),
+            inputs: input,
+            correlationId,
+        });
+    }
+}
+//# sourceMappingURL=simulate.js.map

package/dist/commands/simulate.js.map

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

package/dist/config/endpoints.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Endpoint Configuration
+ *
+ * SPARC Architecture Reference: §2.4
+ *
+ * PURPOSE: Define downstream service endpoints
+ *
+ * FORBIDDEN:
+ * - Business Logic
+ * - Dynamic endpoint construction based on data
+ */
+import type { EndpointRegistry, EndpointConfig } from '../types/index.js';
+export declare const DEFAULT_ENDPOINTS: EndpointRegistry;
+export declare function loadEndpointConfig(serviceName: keyof EndpointRegistry, overrides?: Partial<EndpointConfig>): EndpointConfig;
+export declare function loadAllEndpoints(overrides?: Partial<EndpointRegistry>): EndpointRegistry;
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/config/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM1E,eAAO,MAAM,iBAAiB,EAAE,gBAyC/B,CAAC;AAMF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,gBAAgB,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAKlB"}

package/dist/config/endpoints.js

@@ -0,0 +1,73 @@
+/**
+ * Endpoint Configuration
+ *
+ * SPARC Architecture Reference: §2.4
+ *
+ * PURPOSE: Define downstream service endpoints
+ *
+ * FORBIDDEN:
+ * - Business Logic
+ * - Dynamic endpoint construction based on data
+ */
+// ============================================================================
+// Default Endpoint Configuration
+// ============================================================================
+export const DEFAULT_ENDPOINTS = {
+    'agentics-org-manifests': {
+        baseUrl: process.env['AGENTICS_MANIFESTS_URL'] ?? 'https://manifests.agentics.org',
+        version: 'v1',
+        timeout: 30000,
+    },
+    'agentics-simulation-planner': {
+        baseUrl: process.env['AGENTICS_PLANNER_URL'] ?? 'https://planner.agentics.org',
+        version: 'v1',
+        timeout: 60000,
+    },
+    'agentics-simulation-runner': {
+        baseUrl: process.env['AGENTICS_RUNNER_URL'] ?? 'https://runner.agentics.org',
+        version: 'v1',
+        timeout: 300000, // 5 minutes for simulations
+    },
+    'agentics-simulation-engine': {
+        baseUrl: process.env['AGENTICS_SIMULATION_ENGINE_URL'] ?? 'https://simulation-engine.agentics.org',
+        version: 'v1',
+        timeout: 120000, // 2 minutes for artifact retrieval
+    },
+    'enterprise-roi-engine': {
+        baseUrl: process.env['ENTERPRISE_ROI_ENGINE_URL'] ?? 'https://roi-engine.agentics.org',
+        version: 'v1',
+        timeout: 180000, // 3 minutes for ROI calculations
+    },
+    'agentics-deployment-intent': {
+        baseUrl: process.env['AGENTICS_INTENT_URL'] ?? 'https://intent.agentics.org',
+        version: 'v1',
+        timeout: 60000,
+    },
+    'agentics-deployment-exporters': {
+        baseUrl: process.env['AGENTICS_EXPORTERS_URL'] ?? 'https://exporters.agentics.org',
+        version: 'v1',
+        timeout: 120000,
+    },
+    'diligence-artifacts': {
+        baseUrl: process.env['DILIGENCE_URL'] ?? 'https://diligence.agentics.org',
+        version: 'v1',
+        timeout: 180000,
+    },
+};
+// ============================================================================
+// Configuration Loader
+// ============================================================================
+export function loadEndpointConfig(serviceName, overrides) {
+    const defaults = DEFAULT_ENDPOINTS[serviceName];
+    return {
+        ...defaults,
+        ...overrides,
+    };
+}
+export function loadAllEndpoints(overrides) {
+    return {
+        ...DEFAULT_ENDPOINTS,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=endpoints.js.map

package/dist/config/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,wBAAwB,EAAE;QACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,gCAAgC;QAClF,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,6BAA6B,EAAE;QAC7B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,8BAA8B;QAC9E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,6BAA6B;QAC5E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,4BAA4B;KAC9C;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,wCAAwC;QAClG,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,mCAAmC;KACrD;IACD,uBAAuB,EAAE;QACvB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,IAAI,iCAAiC;QACtF,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,iCAAiC;KACnD;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,6BAA6B;QAC5E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,+BAA+B,EAAE;QAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,gCAAgC;QAClF,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM;KAChB;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,gCAAgC;QACzE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM;KAChB;CACF,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAChC,WAAmC,EACnC,SAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAAqC;IAErC,OAAO;QACL,GAAG,iBAAiB;QACpB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Error Handling Module (Module F)
+ *
+ * SPARC Architecture Reference: §2.7
+ *
+ * PURPOSE: Surface errors with context (no recovery)
+ *
+ * FORBIDDEN:
+ * - Error Recovery (NO retry logic)
+ * - Error Suppression (NO swallowing errors)
+ * - Error Transformation (NO changing error semantics)
+ * - Fallback Logic (NO alternative paths on error)
+ */
+import type { ErrorInfo, ErrorCategory, ContractViolation, ViolationType, ExitCode } from '../types/index.js';
+export declare class CLIError extends Error {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly details?: Record<string, unknown>;
+    readonly timestamp: string;
+    readonly module: string;
+    readonly correlationId?: string;
+    readonly recoverable: boolean;
+    readonly exitCode: ExitCode;
+    constructor(options: {
+        code: string;
+        category: ErrorCategory;
+        message: string;
+        details?: Record<string, unknown>;
+        module: string;
+        correlationId?: string;
+        recoverable?: boolean;
+        exitCode?: ExitCode;
+        cause?: Error;
+    });
+    toErrorInfo(): ErrorInfo;
+}
+export declare class ValidationError extends CLIError {
+    constructor(options: {
+        message: string;
+        field?: string;
+        expected?: string;
+        actual?: string;
+        correlationId?: string;
+    });
+}
+export declare class ReferenceValidationError extends CLIError {
+    constructor(options: {
+        refId: string;
+        refType: string;
+        repository: string;
+        reason: string;
+        correlationId?: string;
+    });
+}
+export declare class ServiceError extends CLIError {
+    constructor(options: {
+        service: string;
+        operation: string;
+        type: 'unavailable' | 'timeout' | 'internal_error';
+        statusCode?: number;
+        upstreamMessage?: string;
+        correlationId?: string;
+    });
+}
+export declare class ContractViolationError extends CLIError {
+    readonly violation: ContractViolation;
+    constructor(options: {
+        service: string;
+        expectedContract: string;
+        actualResponse: unknown;
+        violationType: ViolationType;
+        correlationId?: string;
+    });
+}
+export declare class ConfigError extends CLIError {
+    constructor(options: {
+        message: string;
+        configPath?: string;
+        missingKey?: string;
+        correlationId?: string;
+    });
+}
+export declare class AuthError extends CLIError {
+    constructor(options: {
+        type: 'missing' | 'invalid' | 'expired' | 'insufficient';
+        message: string;
+        correlationId?: string;
+    });
+}
+export interface IErrorHandler {
+    handle(error: Error, context: ErrorContext): ErrorInfo;
+    format(info: ErrorInfo, options: FormatOptions): string;
+}
+export interface ErrorContext {
+    command?: string;
+    phase?: string;
+    inputs?: unknown;
+    correlationId?: string;
+}
+export interface FormatOptions {
+    format: 'json' | 'text';
+    pretty?: boolean;
+    includeStack?: boolean;
+}
+export declare class ErrorHandler implements IErrorHandler {
+    handle(error: Error, context: ErrorContext): ErrorInfo;
+    format(info: ErrorInfo, options: FormatOptions): string;
+}
+export declare function failFast(options: {
+    command: string;
+    phase: string;
+    upstreamError: Error;
+    inputs: unknown;
+    partialRefs?: {
+        id: string;
+    }[];
+    correlationId?: string;
+}): never;
+export declare const errorHandler: ErrorHandler;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.js

@@ -0,0 +1,281 @@
+/**
+ * Error Handling Module (Module F)
+ *
+ * SPARC Architecture Reference: §2.7
+ *
+ * PURPOSE: Surface errors with context (no recovery)
+ *
+ * FORBIDDEN:
+ * - Error Recovery (NO retry logic)
+ * - Error Suppression (NO swallowing errors)
+ * - Error Transformation (NO changing error semantics)
+ * - Fallback Logic (NO alternative paths on error)
+ */
+import * as crypto from 'node:crypto';
+// ============================================================================
+// Base CLI Error Class
+// ============================================================================
+export class CLIError extends Error {
+    code;
+    category;
+    details;
+    timestamp;
+    module;
+    correlationId;
+    recoverable;
+    exitCode;
+    constructor(options) {
+        super(options.message);
+        this.name = 'CLIError';
+        this.code = options.code;
+        this.category = options.category;
+        this.details = options.details;
+        this.timestamp = new Date().toISOString();
+        this.module = options.module;
+        this.correlationId = options.correlationId;
+        this.recoverable = options.recoverable ?? false;
+        this.exitCode = options.exitCode ?? 1;
+        if (options.cause) {
+            this.cause = options.cause;
+        }
+    }
+    toErrorInfo() {
+        return {
+            code: this.code,
+            category: this.category,
+            message: this.message,
+            details: this.details,
+            stack: this.stack,
+            timestamp: this.timestamp,
+            module: this.module,
+            correlationId: this.correlationId,
+        };
+    }
+}
+// ============================================================================
+// Specific Error Classes (SPARC_PSEUDOCODE §4.1)
+// ============================================================================
+export class ValidationError extends CLIError {
+    constructor(options) {
+        super({
+            code: 'ECLI-ARG-002',
+            category: 'INPUT_ERROR',
+            message: options.message,
+            details: {
+                field: options.field,
+                expected: options.expected,
+                actual: options.actual,
+            },
+            module: 'validation',
+            correlationId: options.correlationId,
+            recoverable: false,
+            exitCode: 100,
+        });
+        this.name = 'ValidationError';
+    }
+}
+export class ReferenceValidationError extends CLIError {
+    constructor(options) {
+        super({
+            code: 'ECLI-ARG-003',
+            category: 'INPUT_ERROR',
+            message: `Reference validation failed: ${options.reason}`,
+            details: {
+                ref_id: options.refId,
+                ref_type: options.refType,
+                repository: options.repository,
+            },
+            module: 'validation',
+            correlationId: options.correlationId,
+            recoverable: false,
+            exitCode: 100,
+        });
+        this.name = 'ReferenceValidationError';
+    }
+}
+export class ServiceError extends CLIError {
+    constructor(options) {
+        const exitCodes = {
+            unavailable: 69,
+            timeout: 75,
+            internal_error: 140,
+        };
+        super({
+            code: options.type === 'unavailable'
+                ? 'ECLI-SVC-001'
+                : options.type === 'timeout'
+                    ? 'ECLI-NET-002'
+                    : 'ECLI-SVC-002',
+            category: options.type === 'timeout' ? 'NETWORK_ERROR' : 'DOWNSTREAM_ERROR',
+            message: `Service '${options.service}' ${options.type}: ${options.upstreamMessage ?? 'unknown error'}`,
+            details: {
+                service: options.service,
+                operation: options.operation,
+                status_code: options.statusCode,
+            },
+            module: 'adapter',
+            correlationId: options.correlationId,
+            recoverable: options.type !== 'internal_error',
+            exitCode: exitCodes[options.type] ?? 140,
+        });
+        this.name = 'ServiceError';
+    }
+}
+export class ContractViolationError extends CLIError {
+    violation;
+    constructor(options) {
+        super({
+            code: 'ECLI-SVC-003',
+            category: 'DOWNSTREAM_ERROR',
+            message: `Contract violation from service '${options.service}': ${options.violationType}`,
+            details: {
+                service: options.service,
+                expected_contract: options.expectedContract,
+                violation_type: options.violationType,
+            },
+            module: 'adapter',
+            correlationId: options.correlationId,
+            recoverable: false,
+            exitCode: 140,
+        });
+        this.name = 'ContractViolationError';
+        this.violation = {
+            service: options.service,
+            expected_contract: options.expectedContract,
+            actual_response: options.actualResponse,
+            violation_type: options.violationType,
+        };
+    }
+}
+export class ConfigError extends CLIError {
+    constructor(options) {
+        super({
+            code: options.missingKey ? 'ECLI-CFG-003' : 'ECLI-CFG-002',
+            category: 'CONFIG_ERROR',
+            message: options.message,
+            details: {
+                config_path: options.configPath,
+                missing_key: options.missingKey,
+            },
+            module: 'config',
+            correlationId: options.correlationId,
+            recoverable: false,
+            exitCode: 78,
+        });
+        this.name = 'ConfigError';
+    }
+}
+export class AuthError extends CLIError {
+    constructor(options) {
+        const codes = {
+            missing: 'ECLI-AUTH-001',
+            invalid: 'ECLI-AUTH-002',
+            expired: 'ECLI-AUTH-002',
+            insufficient: 'ECLI-AUTH-003',
+        };
+        super({
+            code: codes[options.type] ?? 'ECLI-AUTH-001',
+            category: 'AUTH_ERROR',
+            message: options.message,
+            details: {
+                type: options.type,
+            },
+            module: 'auth',
+            correlationId: options.correlationId,
+            recoverable: false,
+            exitCode: 77,
+        });
+        this.name = 'AuthError';
+    }
+}
+// ============================================================================
+// Error Handler Implementation
+// ============================================================================
+export class ErrorHandler {
+    handle(error, context) {
+        if (error instanceof CLIError) {
+            return error.toErrorInfo();
+        }
+        // Normalize unknown errors
+        return {
+            code: 'ECLI-INT-001',
+            category: 'INTERNAL_ERROR',
+            message: error.message || 'An unexpected error occurred',
+            details: {
+                command: context.command,
+                phase: context.phase,
+            },
+            stack: error.stack,
+            timestamp: new Date().toISOString(),
+            module: 'unknown',
+            correlationId: context.correlationId,
+        };
+    }
+    format(info, options) {
+        if (options.format === 'json') {
+            const output = options.includeStack
+                ? info
+                : { ...info, stack: undefined };
+            return options.pretty
+                ? JSON.stringify(output, null, 2)
+                : JSON.stringify(output);
+        }
+        // Text format
+        let output = `Error [${info.code}]: ${info.message}`;
+        if (info.details && Object.keys(info.details).length > 0) {
+            output += `\n  Details: ${JSON.stringify(info.details)}`;
+        }
+        if (options.includeStack && info.stack) {
+            output += `\n  Stack: ${info.stack}`;
+        }
+        return output;
+    }
+}
+// ============================================================================
+// Fail-Fast Implementation (SPARC_PSEUDOCODE §4.4)
+// ============================================================================
+export function failFast(options) {
+    const errorContext = {
+        command: options.command,
+        phase: options.phase,
+        inputs_hash: hashInputs(options.inputs),
+        upstream_error_code: options.upstreamError instanceof CLIError
+            ? options.upstreamError.code
+            : 'UNKNOWN',
+        upstream_error_message: options.upstreamError.message,
+        partial_refs: options.partialRefs?.map(r => r.id) ?? [],
+        timestamp: new Date().toISOString(),
+        trace_id: options.correlationId,
+    };
+    // Log failure for observability
+    console.error(JSON.stringify({
+        level: 'ERROR',
+        category: 'COMMAND_FAILURE',
+        context: errorContext,
+    }));
+    // Throw wrapped error
+    throw new CLIError({
+        code: 'COMMAND_FAILED',
+        category: options.upstreamError instanceof CLIError
+            ? options.upstreamError.category
+            : 'INTERNAL_ERROR',
+        message: `Command '${options.command}' failed at phase '${options.phase}': ${options.upstreamError.message}`,
+        details: errorContext,
+        module: 'orchestration',
+        correlationId: options.correlationId,
+        recoverable: options.upstreamError instanceof CLIError
+            ? options.upstreamError.recoverable
+            : false,
+        cause: options.upstreamError,
+    });
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+function hashInputs(inputs) {
+    const canonical = JSON.stringify(inputs, Object.keys(inputs).sort());
+    return crypto.createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+}
+// Singleton handler instance
+export const errorHandler = new ErrorHandler();
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAStC,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,QAAQ,CAAgB;IACxB,OAAO,CAA2B;IAClC,SAAS,CAAS;IAClB,MAAM,CAAS;IACf,aAAa,CAAU;IACvB,WAAW,CAAU;IACrB,QAAQ,CAAW;IAE5B,YAAY,OAUX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,WAAW;QACT,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAMX;QACC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE;gBACP,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB;YACD,MAAM,EAAE,YAAY;YACpB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,GAAG;SACd,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IACpD,YAAY,OAMX;QACC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,gCAAgC,OAAO,CAAC,MAAM,EAAE;YACzD,OAAO,EAAE;gBACP,MAAM,EAAE,OAAO,CAAC,KAAK;gBACrB,QAAQ,EAAE,OAAO,CAAC,OAAO;gBACzB,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B;YACD,MAAM,EAAE,YAAY;YACpB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,GAAG;SACd,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAOX;QACC,MAAM,SAAS,GAA6B;YAC1C,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,EAAE;YACX,cAAc,EAAE,GAAG;SACpB,CAAC;QAEF,KAAK,CAAC;YACJ,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,aAAa;gBAClC,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;oBAC1B,CAAC,CAAC,cAAc;oBAChB,CAAC,CAAC,cAAc;YACpB,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,kBAAkB;YAC3E,OAAO,EAAE,YAAY,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,eAAe,IAAI,eAAe,EAAE;YACtG,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,WAAW,EAAE,OAAO,CAAC,UAAU;aAChC;YACD,MAAM,EAAE,SAAS;YACjB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,OAAO,CAAC,IAAI,KAAK,gBAAgB;YAC9C,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG;SACzC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IACzC,SAAS,CAAoB;IAEtC,YAAY,OAMX;QACC,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,kBAAkB;YAC5B,OAAO,EAAE,oCAAoC,OAAO,CAAC,OAAO,MAAM,OAAO,CAAC,aAAa,EAAE;YACzF,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,iBAAiB,EAAE,OAAO,CAAC,gBAAgB;gBAC3C,cAAc,EAAE,OAAO,CAAC,aAAa;aACtC;YACD,MAAM,EAAE,SAAS;YACjB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,GAAG;SACd,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,iBAAiB,EAAE,OAAO,CAAC,gBAAgB;YAC3C,eAAe,EAAE,OAAO,CAAC,cAAc;YACvC,cAAc,EAAE,OAAO,CAAC,aAAa;SACtC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,YAAY,OAKX;QACC,KAAK,CAAC;YACJ,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc;YAC1D,QAAQ,EAAE,cAAc;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE;gBACP,WAAW,EAAE,OAAO,CAAC,UAAU;gBAC/B,WAAW,EAAE,OAAO,CAAC,UAAU;aAChC;YACD,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,QAAQ;IACrC,YAAY,OAIX;QACC,MAAM,KAAK,GAA2B;YACpC,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,eAAe;YACxB,YAAY,EAAE,eAAe;SAC9B,CAAC;QAEF,KAAK,CAAC;YACJ,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,eAAe;YAC5C,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB;YACD,MAAM,EAAE,MAAM;YACd,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAwBD,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,KAAY,EAAE,OAAqB;QACxC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;QAED,2BAA2B;QAC3B,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,gBAAgB;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,8BAA8B;YACxD,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB;YACD,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,SAAS;YACjB,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAe,EAAE,OAAsB;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY;gBACjC,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAClC,OAAO,OAAO,CAAC,MAAM;gBACnB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,cAAc;QACd,IAAI,MAAM,GAAG,UAAU,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrD,IAAI,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,MAAM,IAAI,cAAc,IAAI,CAAC,KAAK,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,mDAAmD;AACnD,+EAA+E;AAE/E,MAAM,UAAU,QAAQ,CAAC,OAOxB;IACC,MAAM,YAAY,GAAG;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QACvC,mBAAmB,EAAE,OAAO,CAAC,aAAa,YAAY,QAAQ;YAC5D,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI;YAC5B,CAAC,CAAC,SAAS;QACb,sBAAsB,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO;QACrD,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE;QACvD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,OAAO,CAAC,aAAa;KAChC,CAAC;IAEF,gCAAgC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3B,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC,CAAC;IAEJ,sBAAsB;IACtB,MAAM,IAAI,QAAQ,CAAC;QACjB,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,OAAO,CAAC,aAAa,YAAY,QAAQ;YACjD,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ;YAChC,CAAC,CAAC,gBAAgB;QACpB,OAAO,EAAE,YAAY,OAAO,CAAC,OAAO,sBAAsB,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE;QAC5G,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,eAAe;QACvB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,aAAa,YAAY,QAAQ;YACpD,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW;YACnC,CAAC,CAAC,KAAK;QACT,KAAK,EAAE,OAAO,CAAC,aAAa;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,SAAS,UAAU,CAAC,MAAe;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}