@llm-dev-ops/agentics-cli 1.4.27 → 1.4.29

package/dist/pipeline/phase4/phases/schema-generator.js

@@ -0,0 +1,373 @@
+/**
+ * Phase 4 Pipeline — Stage 3: ERP-Native SQL Schema Generator
+ *
+ * Generates CREATE TABLE DDL statements in the SQL dialect of the detected
+ * ERP system's database engine. One .sql file is produced per bounded context
+ * per aggregate/entity. Workday (API-only) is skipped gracefully.
+ *
+ * Supported dialects:
+ *   hana-sql    — SAP HANA COLUMN TABLE syntax
+ *   tsql        — Microsoft SQL Server T-SQL syntax
+ *   oracle-sql  — Oracle Database syntax
+ *   db2-sql     — IBM Db2 syntax
+ *
+ * Error codes:
+ *   ECLI-P4-004  Schema file write failure
+ */
+// Generated by Phase 4 pipeline — do not edit manually
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createSpan, endSpan, emitSpan } from '../../phase2/telemetry.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DIR_MODE = 0o700;
+const FILE_MODE = 0o600;
+// ============================================================================
+// Name Helpers
+// ============================================================================
+/**
+ * Convert a PascalCase or mixed-case name to a lowercase snake_case slug
+ * suitable for table names and directory names. Strips common DDD suffixes
+ * ("Context", "Aggregate") to keep names concise.
+ */
+function toTableSlug(name) {
+    return name
+        .replace(/Context$/i, '')
+        .replace(/Aggregate$/i, '')
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/[^a-zA-Z0-9]+/g, '_')
+        .replace(/^_|_$/g, '')
+        .toLowerCase();
+}
+/**
+ * Convert a name to a filesystem-safe directory slug (uses underscores).
+ */
+function toDirSlug(name) {
+    return toTableSlug(name);
+}
+/** Standard auditing columns added to every table. */
+const AUDIT_COLUMNS = [
+    { name: 'correlation_id', typePlaceholder: 'VARCHAR(64)', nullable: false },
+    { name: 'created_by', typePlaceholder: 'VARCHAR(128)', nullable: false },
+    { name: 'updated_by', typePlaceholder: 'VARCHAR(128)', nullable: false },
+    { name: 'created_at', typePlaceholder: 'TIMESTAMP_DEFAULT', nullable: false },
+    { name: 'updated_at', typePlaceholder: 'TIMESTAMP_DEFAULT', nullable: false },
+];
+// ============================================================================
+// Dialect-specific DDL generators
+// ============================================================================
+/**
+ * Resolve a generic type placeholder to its SAP HANA equivalent.
+ */
+function resolveHanaType(placeholder) {
+    if (placeholder === 'TIMESTAMP_DEFAULT')
+        return 'TIMESTAMP DEFAULT CURRENT_UTCTIMESTAMP';
+    if (placeholder.startsWith('VARCHAR'))
+        return placeholder.replace('VARCHAR', 'NVARCHAR');
+    return placeholder;
+}
+/**
+ * Generate a SAP HANA COLUMN TABLE CREATE statement.
+ */
+function generateHanaSQL(tableName, columns) {
+    const colLines = columns.map((col) => {
+        const type = resolveHanaType(col.typePlaceholder);
+        const nullability = col.nullable ? '' : ' NOT NULL';
+        const pk = col.primaryKey ? ' PRIMARY KEY' : '';
+        return `  ${col.name} ${type}${nullability}${pk}`;
+    });
+    return [
+        `-- Generated by Phase 4 pipeline — do not edit manually`,
+        `CREATE COLUMN TABLE ${tableName} (`,
+        colLines.join(',\n'),
+        `);`,
+        '',
+    ].join('\n');
+}
+/**
+ * Resolve a generic type placeholder to its T-SQL (SQL Server) equivalent.
+ */
+function resolveTSQLType(placeholder) {
+    if (placeholder === 'TIMESTAMP_DEFAULT')
+        return 'DATETIME2 DEFAULT GETUTCDATE()';
+    if (placeholder.startsWith('VARCHAR'))
+        return placeholder.replace('VARCHAR', 'NVARCHAR');
+    return placeholder;
+}
+/**
+ * Generate a SQL Server T-SQL CREATE TABLE statement.
+ */
+function generateTSQL(tableName, columns) {
+    const colLines = columns.map((col) => {
+        const type = resolveTSQLType(col.typePlaceholder);
+        const nullability = col.nullable ? '' : ' NOT NULL';
+        const pk = col.primaryKey ? ' PRIMARY KEY' : '';
+        return `  [${col.name}] ${type}${nullability}${pk}`;
+    });
+    return [
+        `-- Generated by Phase 4 pipeline — do not edit manually`,
+        `CREATE TABLE [dbo].[${tableName}] (`,
+        colLines.join(',\n'),
+        `);`,
+        '',
+    ].join('\n');
+}
+/**
+ * Resolve a generic type placeholder to its Oracle Database equivalent.
+ */
+function resolveOracleType(placeholder) {
+    if (placeholder === 'TIMESTAMP_DEFAULT')
+        return 'TIMESTAMP DEFAULT SYSTIMESTAMP';
+    if (placeholder.startsWith('VARCHAR'))
+        return placeholder.replace('VARCHAR', 'VARCHAR2');
+    return placeholder;
+}
+/**
+ * Generate an Oracle Database CREATE TABLE statement.
+ */
+function generateOracleSQL(tableName, columns) {
+    const colLines = columns.map((col) => {
+        const type = resolveOracleType(col.typePlaceholder);
+        const nullability = col.nullable ? '' : ' NOT NULL';
+        const pk = col.primaryKey ? ' PRIMARY KEY' : '';
+        return `  ${col.name} ${type}${nullability}${pk}`;
+    });
+    return [
+        `-- Generated by Phase 4 pipeline — do not edit manually`,
+        `CREATE TABLE ${tableName} (`,
+        colLines.join(',\n'),
+        `);`,
+        '',
+    ].join('\n');
+}
+/**
+ * Resolve a generic type placeholder to its IBM Db2 equivalent.
+ */
+function resolveDb2Type(placeholder) {
+    if (placeholder === 'TIMESTAMP_DEFAULT')
+        return 'TIMESTAMP DEFAULT CURRENT TIMESTAMP';
+    return placeholder; // VARCHAR is already correct for Db2
+}
+/**
+ * Generate an IBM Db2 CREATE TABLE statement.
+ */
+function generateDb2SQL(tableName, columns) {
+    const colLines = columns.map((col) => {
+        const type = resolveDb2Type(col.typePlaceholder);
+        const nullability = col.nullable ? '' : ' NOT NULL';
+        const pk = col.primaryKey ? ' PRIMARY KEY' : '';
+        return `  ${col.name} ${type}${nullability}${pk}`;
+    });
+    return [
+        `-- Generated by Phase 4 pipeline — do not edit manually`,
+        `CREATE TABLE ${tableName} (`,
+        colLines.join(',\n'),
+        `);`,
+        '',
+    ].join('\n');
+}
+/**
+ * Dispatch to the correct dialect-specific DDL generator.
+ */
+function generateDDL(dialect, tableName, columns) {
+    switch (dialect) {
+        case 'hana-sql':
+            return generateHanaSQL(tableName, columns);
+        case 'tsql':
+            return generateTSQL(tableName, columns);
+        case 'oracle-sql':
+            return generateOracleSQL(tableName, columns);
+        case 'db2-sql':
+            return generateDb2SQL(tableName, columns);
+    }
+}
+// ============================================================================
+// Column Builder
+// ============================================================================
+/**
+ * Build column definitions for a table. Always includes the `id` primary key
+ * and standard audit columns. Additional domain field names are added as
+ * VARCHAR(255) columns.
+ */
+function buildColumns(fieldNames) {
+    const idColumn = {
+        name: 'id',
+        typePlaceholder: 'VARCHAR(64)',
+        nullable: false,
+        primaryKey: true,
+    };
+    const domainColumns = fieldNames.map((field) => ({
+        name: toTableSlug(field),
+        typePlaceholder: 'VARCHAR(255)',
+        nullable: true,
+    }));
+    return [idColumn, ...domainColumns, ...AUDIT_COLUMNS];
+}
+// ============================================================================
+// Main: generateSchemas
+// ============================================================================
+/**
+ * Stage 3: Generate ERP-native SQL schema files for all DDD bounded contexts.
+ *
+ * Reads the ERPResolution from the previous stage and the Phase 2 domain model
+ * from context.phase3Artifacts. For each bounded context, generates one .sql
+ * file per aggregate and standalone entity, using the detected SQL dialect.
+ *
+ * Workday (apiOnly=true) is skipped with a descriptive skip reason.
+ *
+ * @param context - The Phase 4 pipeline context
+ * @returns Stage output describing success, skip, or failure
+ */
+export function generateSchemas(context) {
+    const rootSpan = createSpan('schema-generation', 'generate-schemas', {
+        phase4Dir: context.phase4Dir,
+    });
+    try {
+        // -------------------------------------------------------------------------
+        // Step 1: Retrieve ERP resolution from previous stage
+        // -------------------------------------------------------------------------
+        const erpStage = context.stageOutputs.get('erp-target-resolution');
+        if (!erpStage || erpStage.status !== 'completed') {
+            throw new Error('ECLI-P4-004: ERP target resolution not available on context. ' +
+                'Ensure the erp-target-resolution stage completed successfully.');
+        }
+        const erpResolution = erpStage.data;
+        // -------------------------------------------------------------------------
+        // Step 2: Skip for API-only ERPs (e.g. Workday)
+        // -------------------------------------------------------------------------
+        if (erpResolution.apiOnly) {
+            const skippedSpan = endSpan(rootSpan, 'ok', { skipped: true, reason: 'api-only' });
+            emitSpan(skippedSpan);
+            context.telemetrySpans.push(skippedSpan);
+            const timing = skippedSpan.durationMs ?? 0;
+            const skipOutput = {
+                stage: 'schema-generation',
+                status: 'completed',
+                data: {
+                    skipped: true,
+                    skipReason: 'API-only ERP (Workday) — no database schema generation',
+                    dialect: null,
+                    files: [],
+                    tableCount: 0,
+                },
+                artifacts: [],
+                timing,
+                summary: `  [SKIP] Schema generation skipped: API-only ERP (${erpResolution.erpSystem}) in ${timing}ms`,
+            };
+            context.stageOutputs.set('schema-generation', skipOutput);
+            return skipOutput;
+        }
+        const dialect = erpResolution.sqlDialect;
+        // -------------------------------------------------------------------------
+        // Step 3: Retrieve Phase 2 domain model
+        // -------------------------------------------------------------------------
+        const domainModel = context.phase3Artifacts.phase2Artifacts.domainModel;
+        const generatedFiles = [];
+        const writtenPaths = [];
+        let totalTableCount = 0;
+        // -------------------------------------------------------------------------
+        // Step 4: Generate schema files per bounded context
+        // -------------------------------------------------------------------------
+        for (const ctx of domainModel.contexts) {
+            const ctxSlug = toDirSlug(ctx.name);
+            const ctxDir = join(context.phase4Dir, 'database', ctxSlug);
+            const ctxSpan = createSpan('schema-generation', `generate-context-${ctxSlug}`, { context: ctx.name, aggregates: ctx.aggregates.length }, rootSpan.spanId);
+            try {
+                mkdirSync(ctxDir, { recursive: true, mode: DIR_MODE });
+                // --- Aggregates (with embedded entities and value objects) ---
+                for (const agg of ctx.aggregates) {
+                    const tableName = toTableSlug(agg.name);
+                    // Collect field names: entity names + value object names
+                    const fieldNames = [
+                        ...agg.entities.map((e) => e.name),
+                        ...agg.valueObjects.map((vo) => vo.name),
+                    ];
+                    const columns = buildColumns(fieldNames);
+                    const ddl = generateDDL(dialect, tableName, columns);
+                    const tableCount = 1;
+                    totalTableCount += tableCount;
+                    const relPath = `database/${ctxSlug}/${tableName}.sql`;
+                    const absPath = join(ctxDir, `${tableName}.sql`);
+                    writeFileSync(absPath, ddl, { encoding: 'utf-8', mode: FILE_MODE });
+                    writtenPaths.push(absPath);
+                    generatedFiles.push({
+                        relativePath: relPath,
+                        content: ddl,
+                        kind: 'schema',
+                        dialect,
+                        boundedContext: ctx.name,
+                        tableCount,
+                    });
+                }
+                // --- Standalone entities ---
+                // Entity names already covered by aggregate tables above.
+                // TODO: if the domain model includes context-level standalone entities,
+                // generate additional tables here following the same pattern.
+                const finalCtxSpan = endSpan(ctxSpan, 'ok', {
+                    context: ctx.name,
+                    tablesGenerated: ctx.aggregates.length,
+                });
+                emitSpan(finalCtxSpan);
+                context.telemetrySpans.push(finalCtxSpan);
+            }
+            catch (err) {
+                const finalCtxSpan = endSpan(ctxSpan, 'error', {
+                    context: ctx.name,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                emitSpan(finalCtxSpan);
+                context.telemetrySpans.push(finalCtxSpan);
+                throw err;
+            }
+        }
+        // -------------------------------------------------------------------------
+        // Step 5: Build stage output
+        // -------------------------------------------------------------------------
+        const schemaGenOutput = {
+            dialect,
+            files: generatedFiles,
+            tableCount: totalTableCount,
+            skipped: false,
+        };
+        const finalRootSpan = endSpan(rootSpan, 'ok', {
+            dialect,
+            totalFiles: generatedFiles.length,
+            totalTables: totalTableCount,
+            contexts: domainModel.contexts.length,
+        });
+        emitSpan(finalRootSpan);
+        context.telemetrySpans.push(finalRootSpan);
+        const timing = finalRootSpan.durationMs ?? 0;
+        const output = {
+            stage: 'schema-generation',
+            status: 'completed',
+            data: schemaGenOutput,
+            artifacts: writtenPaths,
+            timing,
+            summary: `  [OK] Generated ${generatedFiles.length} SQL schema files ` +
+                `(${totalTableCount} tables, dialect=${dialect}) ` +
+                `across ${domainModel.contexts.length} bounded contexts in ${timing}ms`,
+        };
+        context.stageOutputs.set('schema-generation', output);
+        return output;
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const finalRootSpan = endSpan(rootSpan, 'error', { error: errorMessage });
+        emitSpan(finalRootSpan);
+        context.telemetrySpans.push(finalRootSpan);
+        const timing = finalRootSpan.durationMs ?? 0;
+        const output = {
+            stage: 'schema-generation',
+            status: 'failed',
+            data: { error: errorMessage },
+            artifacts: [],
+            timing,
+            summary: `  [FAIL] Schema generation failed: ${errorMessage}`,
+        };
+        context.stageOutputs.set('schema-generation', output);
+        return output;
+    }
+}
+//# sourceMappingURL=schema-generator.js.map

package/dist/pipeline/phase4/phases/schema-generator.js.map

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

package/dist/pipeline/phase4/schemas.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Phase 4 Pipeline Schemas
+ *
+ * Zod validation schemas for reading Phase 3 artifacts from disk and
+ * validating Phase 4 output structures.
+ *
+ * All "OnDisk" schemas use `.passthrough()` liberally so that Phase 3
+ * format evolution does not break Phase 4 ingestion. Phase 4 only
+ * validates the fields it actually reads; extra fields are preserved
+ * but ignored.
+ */
+import { z } from 'zod';
+export { SPARCOnDiskSchema, ADRIndexOnDiskSchema, DomainModelOnDiskSchema, TDDPlanOnDiskSchema, } from '../phase3/schemas.js';
+/**
+ * Schema for the phase3-manifest.json file written by Phase 3.
+ *
+ * Uses passthrough to tolerate extra fields and allow forward
+ * compatibility with future Phase 3 manifest additions such as
+ * additional metadata or new optional fields.
+ */
+export declare const Phase3ManifestOnDiskSchema: z.ZodObject<{
+    schema_version: z.ZodString;
+    trace_id: z.ZodString;
+    implementation_language: z.ZodEnum<{
+        rust: "rust";
+        typescript: "typescript";
+    }>;
+    mixed_mode: z.ZodBoolean;
+    ruflo_version: z.ZodString;
+    artifacts: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        size_bytes: z.ZodNumber;
+    }, z.core.$loose>>;
+    total_timing_ms: z.ZodNumber;
+    success: z.ZodBoolean;
+}, z.core.$loose>;
+/**
+ * Schema for the Phase 4 manifest written at the end of a successful run.
+ * This is a loose schema (with passthrough) to allow forward compatibility
+ * as Phase 4 output format evolves.
+ */
+export declare const Phase4ManifestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"4.0.0">;
+    trace_id: z.ZodString;
+    implementation_language: z.ZodEnum<{
+        rust: "rust";
+        typescript: "typescript";
+    }>;
+    erp_system: z.ZodString;
+    database_engine: z.ZodNullable<z.ZodString>;
+    api_only: z.ZodBoolean;
+    artifacts: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        size_bytes: z.ZodNumber;
+    }, z.core.$loose>>;
+    total_timing_ms: z.ZodNumber;
+    success: z.ZodBoolean;
+}, z.core.$loose>;
+export type ValidatedPhase3ManifestOnDisk = z.infer<typeof Phase3ManifestOnDiskSchema>;
+export type ValidatedPhase4Manifest = z.infer<typeof Phase4ManifestSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/pipeline/phase4/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAM9B;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;iBAavB,CAAC;AAMjB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;iBAcjB,CAAC;AAMjB,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/pipeline/phase4/schemas.js

@@ -0,0 +1,64 @@
+/**
+ * Phase 4 Pipeline Schemas
+ *
+ * Zod validation schemas for reading Phase 3 artifacts from disk and
+ * validating Phase 4 output structures.
+ *
+ * All "OnDisk" schemas use `.passthrough()` liberally so that Phase 3
+ * format evolution does not break Phase 4 ingestion. Phase 4 only
+ * validates the fields it actually reads; extra fields are preserved
+ * but ignored.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Phase 2 Schema Re-exports (from phase3/schemas.ts)
+// ============================================================================
+export { SPARCOnDiskSchema, ADRIndexOnDiskSchema, DomainModelOnDiskSchema, TDDPlanOnDiskSchema, } from '../phase3/schemas.js';
+// ============================================================================
+// Phase 3 Manifest (on-disk format from phase3-manifest.json)
+// ============================================================================
+/**
+ * Schema for the phase3-manifest.json file written by Phase 3.
+ *
+ * Uses passthrough to tolerate extra fields and allow forward
+ * compatibility with future Phase 3 manifest additions such as
+ * additional metadata or new optional fields.
+ */
+export const Phase3ManifestOnDiskSchema = z.object({
+    schema_version: z.string(),
+    trace_id: z.string(),
+    implementation_language: z.enum(['rust', 'typescript']),
+    mixed_mode: z.boolean(),
+    ruflo_version: z.string(),
+    artifacts: z.array(z.object({
+        path: z.string(),
+        sha256: z.string(),
+        size_bytes: z.number(),
+    }).passthrough()),
+    total_timing_ms: z.number(),
+    success: z.boolean(),
+}).passthrough();
+// ============================================================================
+// Phase 4 Manifest (output format for phase4-manifest.json)
+// ============================================================================
+/**
+ * Schema for the Phase 4 manifest written at the end of a successful run.
+ * This is a loose schema (with passthrough) to allow forward compatibility
+ * as Phase 4 output format evolves.
+ */
+export const Phase4ManifestSchema = z.object({
+    schema_version: z.literal('4.0.0'),
+    trace_id: z.string(),
+    implementation_language: z.enum(['rust', 'typescript']),
+    erp_system: z.string(),
+    database_engine: z.string().nullable(),
+    api_only: z.boolean(),
+    artifacts: z.array(z.object({
+        path: z.string(),
+        sha256: z.string(),
+        size_bytes: z.number(),
+    }).passthrough()),
+    total_timing_ms: z.number(),
+    success: z.boolean(),
+}).passthrough();
+//# sourceMappingURL=schemas.js.map

package/dist/pipeline/phase4/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/pipeline/phase4/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,qDAAqD;AACrD,+EAA+E;AAE/E,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,+EAA+E;AAC/E,8DAA8D;AAC9D,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,uBAAuB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC,CAAC,WAAW,EAAE,CAAC;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB,+EAA+E;AAC/E,4DAA4D;AAC5D,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,uBAAuB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC,CAAC,WAAW,EAAE,CAAC;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC,WAAW,EAAE,CAAC"}