@zbigniewsobiecki/squint 1.0.0

package/dist/db/repositories/interaction-analysis.js

@@ -0,0 +1,340 @@
+import { ensureInteractionsTables, ensureModulesTables } from '../schema-manager.js';
+/**
+ * Service for interaction analysis — relationship coverage, validation, and diagnostics.
+ * Extracted from InteractionRepository to separate analysis from CRUD.
+ */
+export class InteractionAnalysis {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Get relationship-to-interaction coverage statistics.
+     */
+    getRelationshipCoverage() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        const totalStmt = this.db.prepare('SELECT COUNT(*) as count FROM relationship_annotations');
+        const totalRelationships = totalStmt.get().count;
+        const crossModuleStmt = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM relationship_annotations ra
+      JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+      WHERE mm1.module_id != mm2.module_id
+    `);
+        const crossModuleRelationships = crossModuleStmt.get().count;
+        const sameModuleStmt = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM relationship_annotations ra
+      JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+      WHERE mm1.module_id = mm2.module_id
+    `);
+        const sameModuleCount = sameModuleStmt.get().count;
+        const withModulesStmt = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM relationship_annotations ra
+      JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+    `);
+        const relationshipsWithModules = withModulesStmt.get().count;
+        const contributingStmt = this.db.prepare(`
+      SELECT COUNT(DISTINCT ra.id) as count
+      FROM relationship_annotations ra
+      JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+      JOIN interactions i ON i.from_module_id = mm1.module_id
+                         AND i.to_module_id = mm2.module_id
+      WHERE mm1.module_id != mm2.module_id
+    `);
+        const contributing = contributingStmt.get().count;
+        return {
+            totalRelationships,
+            crossModuleRelationships,
+            relationshipsContributingToInteractions: contributing,
+            sameModuleCount,
+            orphanedCount: totalRelationships - relationshipsWithModules,
+            coveragePercent: crossModuleRelationships > 0 ? (contributing / crossModuleRelationships) * 100 : 100,
+        };
+    }
+    /**
+     * Get detailed breakdown of relationship coverage for diagnostics.
+     */
+    getRelationshipCoverageBreakdown() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT
+        ra.relationship_type,
+        CASE
+          WHEN mm1.module_id IS NULL OR mm2.module_id IS NULL THEN 'orphaned'
+          WHEN mm1.module_id = mm2.module_id THEN 'same_module'
+          WHEN EXISTS (
+            SELECT 1 FROM interactions i
+            WHERE i.from_module_id = mm1.module_id
+              AND i.to_module_id = mm2.module_id
+          ) THEN 'covered'
+          ELSE 'no_call_edge'
+        END as reason,
+        COUNT(*) as count
+      FROM relationship_annotations ra
+      LEFT JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      LEFT JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+      GROUP BY ra.relationship_type, reason
+    `);
+        const rows = stmt.all();
+        const result = {
+            covered: 0,
+            sameModule: 0,
+            noCallEdge: 0,
+            orphaned: 0,
+            byType: {
+                uses: 0,
+                extends: 0,
+                implements: 0,
+            },
+        };
+        for (const row of rows) {
+            switch (row.reason) {
+                case 'covered':
+                    result.covered += row.count;
+                    break;
+                case 'same_module':
+                    result.sameModule += row.count;
+                    break;
+                case 'no_call_edge':
+                    result.noCallEdge += row.count;
+                    break;
+                case 'orphaned':
+                    result.orphaned += row.count;
+                    break;
+            }
+            if (row.reason !== 'orphaned') {
+                switch (row.relationship_type) {
+                    case 'uses':
+                        result.byType.uses += row.count;
+                        break;
+                    case 'extends':
+                        result.byType.extends += row.count;
+                        break;
+                    case 'implements':
+                        result.byType.implements += row.count;
+                        break;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Get cross-module relationship pairs that have no corresponding interaction.
+     */
+    getUncoveredModulePairs() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT mm1.module_id as fromModuleId, mm2.module_id as toModuleId,
+             m1.full_path as fromPath, m2.full_path as toPath,
+             COUNT(*) as relationshipCount
+      FROM relationship_annotations ra
+      JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+      JOIN modules m1 ON mm1.module_id = m1.id
+      JOIN modules m2 ON mm2.module_id = m2.id
+      WHERE mm1.module_id != mm2.module_id
+        AND NOT EXISTS (
+          SELECT 1 FROM interactions i
+          WHERE i.from_module_id = mm1.module_id AND i.to_module_id = mm2.module_id
+        )
+      GROUP BY mm1.module_id, mm2.module_id
+      ORDER BY relationshipCount DESC
+    `);
+        return stmt.all();
+    }
+    /**
+     * Create interaction edges for inheritance relationships (extends/implements).
+     */
+    syncInheritanceInteractions() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO interactions (from_module_id, to_module_id, direction, weight, pattern)
+      SELECT DISTINCT
+        mm1.module_id,
+        mm2.module_id,
+        'uni',
+        1,
+        'inheritance'
+      FROM relationship_annotations ra
+      JOIN module_members mm1 ON ra.from_definition_id = mm1.definition_id
+      JOIN module_members mm2 ON ra.to_definition_id = mm2.definition_id
+      WHERE ra.relationship_type IN ('extends', 'implements')
+        AND mm1.module_id != mm2.module_id
+        AND NOT EXISTS (
+          SELECT 1 FROM interactions i
+          WHERE i.from_module_id = mm1.module_id
+            AND i.to_module_id = mm2.module_id
+        )
+    `);
+        const result = stmt.run();
+        return { created: result.changes };
+    }
+    /**
+     * Validate all llm-inferred interactions.
+     */
+    validateInferredInteractions(interactionRepo, isSameProcess) {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        const inferred = interactionRepo.getBySource('llm-inferred');
+        const issues = [];
+        for (const interaction of inferred) {
+            const reverseInteraction = interactionRepo.getByModules(interaction.toModuleId, interaction.fromModuleId);
+            if (reverseInteraction && reverseInteraction.source === 'ast') {
+                issues.push({
+                    interactionId: interaction.id,
+                    fromModuleId: interaction.fromModuleId,
+                    toModuleId: interaction.toModuleId,
+                    fromPath: interaction.fromModulePath,
+                    toPath: interaction.toModulePath,
+                    issue: `REVERSED: AST interaction exists in reverse direction (${interaction.toModulePath} → ${interaction.fromModulePath})`,
+                });
+                continue;
+            }
+            const sameProcess = isSameProcess ? isSameProcess(interaction.fromModuleId, interaction.toModuleId) : true;
+            if (!sameProcess)
+                continue;
+            const hasImports = interactionRepo.hasModuleImportPath(interaction.fromModuleId, interaction.toModuleId);
+            if (!hasImports) {
+                const hasReverseImports = interactionRepo.hasModuleImportPath(interaction.toModuleId, interaction.fromModuleId);
+                if (hasReverseImports) {
+                    issues.push({
+                        interactionId: interaction.id,
+                        fromModuleId: interaction.fromModuleId,
+                        toModuleId: interaction.toModuleId,
+                        fromPath: interaction.fromModulePath,
+                        toPath: interaction.toModulePath,
+                        issue: `DIRECTION_CONFUSED: No forward imports, but reverse imports exist (${interaction.toModulePath} imports from ${interaction.fromModulePath})`,
+                    });
+                }
+                else {
+                    issues.push({
+                        interactionId: interaction.id,
+                        fromModuleId: interaction.fromModuleId,
+                        toModuleId: interaction.toModuleId,
+                        fromPath: interaction.fromModulePath,
+                        toPath: interaction.toModulePath,
+                        issue: 'NO_IMPORTS: No import path exists in either direction between these modules',
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * Get detailed relationship annotation rows between two modules' members.
+     */
+    getRelationshipDetailsForModulePair(fromModuleId, toModuleId) {
+        ensureModulesTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT
+        from_d.name as fromName,
+        from_d.kind as fromKind,
+        to_d.name as toName,
+        to_d.kind as toKind,
+        ra.semantic,
+        ra.relationship_type as relationshipType
+      FROM relationship_annotations ra
+      JOIN module_members from_mm ON ra.from_definition_id = from_mm.definition_id
+      JOIN module_members to_mm ON ra.to_definition_id = to_mm.definition_id
+      JOIN definitions from_d ON ra.from_definition_id = from_d.id
+      JOIN definitions to_d ON ra.to_definition_id = to_d.id
+      WHERE from_mm.module_id = ? AND to_mm.module_id = ?
+      ORDER BY ra.relationship_type, from_d.name
+    `);
+        return stmt.all(fromModuleId, toModuleId);
+    }
+    /**
+     * Check if an interaction exists in the reverse direction (toModuleId → fromModuleId).
+     */
+    hasReverseInteraction(fromModuleId, toModuleId) {
+        ensureInteractionsTables(this.db);
+        const stmt = this.db.prepare(`
+      SELECT EXISTS (
+        SELECT 1 FROM interactions
+        WHERE from_module_id = ? AND to_module_id = ?
+      ) as has_reverse
+    `);
+        const row = stmt.get(toModuleId, fromModuleId);
+        return row.has_reverse === 1;
+    }
+    /**
+     * Detect fan-in anomalies: modules with unusually high llm-inferred inbound
+     * connections but zero AST inbound connections (hallucination pattern).
+     *
+     * Uses Tukey's far-outlier fence (Q3 + 3*IQR) with an absolute minimum of 8.
+     */
+    detectFanInAnomalies() {
+        ensureInteractionsTables(this.db);
+        ensureModulesTables(this.db);
+        // Query llm-inferred fan-in per target module
+        const llmFanInRows = this.db
+            .prepare(`
+      SELECT to_module_id as moduleId, COUNT(*) as fanIn
+      FROM interactions
+      WHERE source = 'llm-inferred'
+      GROUP BY to_module_id
+    `)
+            .all();
+        if (llmFanInRows.length === 0)
+            return [];
+        // Query AST fan-in per target module
+        const astFanInRows = this.db
+            .prepare(`
+      SELECT to_module_id as moduleId, COUNT(*) as fanIn
+      FROM interactions
+      WHERE source IN ('ast', 'ast-import')
+      GROUP BY to_module_id
+    `)
+            .all();
+        const astFanInMap = new Map(astFanInRows.map((r) => [r.moduleId, r.fanIn]));
+        // Compute distribution statistics for llm fan-in values
+        const fanInValues = llmFanInRows.map((r) => r.fanIn).sort((a, b) => a - b);
+        const n = fanInValues.length;
+        const q1 = fanInValues[Math.floor(n * 0.25)];
+        const q3 = fanInValues[Math.floor(n * 0.75)];
+        const iqr = q3 - q1;
+        const farFence = q3 + 3 * iqr;
+        // Get module paths for reporting
+        const modulePathRows = this.db
+            .prepare(`
+      SELECT id, full_path as fullPath FROM modules
+    `)
+            .all();
+        const modulePathMap = new Map(modulePathRows.map((r) => [r.id, r.fullPath]));
+        const anomalies = [];
+        for (const row of llmFanInRows) {
+            const astFanIn = astFanInMap.get(row.moduleId) ?? 0;
+            if (row.fanIn > farFence && row.fanIn >= 8 && astFanIn === 0) {
+                anomalies.push({
+                    moduleId: row.moduleId,
+                    modulePath: modulePathMap.get(row.moduleId) ?? `module#${row.moduleId}`,
+                    llmFanIn: row.fanIn,
+                    astFanIn,
+                });
+            }
+        }
+        return anomalies;
+    }
+    /**
+     * Get symbols from relationship annotations for a module pair.
+     */
+    getRelationshipSymbolsForPair(fromModuleId, toModuleId) {
+        const details = this.getRelationshipDetailsForModulePair(fromModuleId, toModuleId);
+        const symbols = new Set();
+        for (const d of details) {
+            symbols.add(d.toName);
+        }
+        return Array.from(symbols);
+    }
+}
+//# sourceMappingURL=interaction-analysis.js.map

package/dist/db/repositories/interaction-analysis.js.map

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

package/dist/db/repositories/interaction-repository.d.ts

@@ -0,0 +1,145 @@
+import type Database from 'better-sqlite3';
+import type { CallGraphEdge, Interaction, InteractionSource, InteractionWithPaths } from '../schema.js';
+export interface InteractionInsertOptions {
+    direction?: 'uni' | 'bi';
+    weight?: number;
+    pattern?: 'utility' | 'business' | 'test-internal';
+    symbols?: string[];
+    semantic?: string;
+    source?: InteractionSource;
+    confidence?: 'high' | 'medium';
+}
+export interface InteractionUpdateOptions {
+    direction?: 'uni' | 'bi';
+    pattern?: 'utility' | 'business' | 'test-internal';
+    symbols?: string[];
+    semantic?: string;
+}
+export interface InteractionStats {
+    totalCount: number;
+    businessCount: number;
+    utilityCount: number;
+    biDirectionalCount: number;
+}
+/**
+ * Repository for interaction (module-to-module edge) operations.
+ */
+export declare class InteractionRepository {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Insert a new interaction.
+     * Throws if an interaction between these modules already exists.
+     */
+    insert(fromModuleId: number, toModuleId: number, options?: InteractionInsertOptions): number;
+    /**
+     * Upsert an interaction (insert or update on conflict).
+     */
+    upsert(fromModuleId: number, toModuleId: number, options?: InteractionInsertOptions): number;
+    /**
+     * Get interaction by ID.
+     */
+    getById(id: number): Interaction | null;
+    /**
+     * Get interaction by module pair.
+     */
+    getByModules(fromModuleId: number, toModuleId: number): Interaction | null;
+    /**
+     * Get all interactions with module paths.
+     */
+    getAll(): InteractionWithPaths[];
+    /**
+     * Get interactions by pattern.
+     */
+    getByPattern(pattern: 'utility' | 'business'): InteractionWithPaths[];
+    /**
+     * Get interactions from a specific module.
+     */
+    getFromModule(moduleId: number): InteractionWithPaths[];
+    /**
+     * Get interactions to a specific module.
+     */
+    getToModule(moduleId: number): InteractionWithPaths[];
+    /**
+     * Update an interaction.
+     */
+    update(id: number, updates: InteractionUpdateOptions): boolean;
+    /**
+     * Delete an interaction.
+     */
+    delete(id: number): boolean;
+    /**
+     * Delete all interactions.
+     */
+    clear(): number;
+    /**
+     * Get count of interactions.
+     */
+    getCount(): number;
+    /**
+     * Get interaction statistics.
+     */
+    getStats(): InteractionStats;
+    /**
+     * Get interactions by source type.
+     */
+    getBySource(source: InteractionSource): InteractionWithPaths[];
+    /**
+     * Get count of interactions by source type.
+     */
+    getCountBySource(source: InteractionSource): number;
+    /**
+     * Remove all llm-inferred interactions targeting a specific module.
+     * Used by fan-in anomaly detection to bulk-remove hallucinated connections.
+     */
+    removeInferredToModule(targetModuleId: number): number;
+    /**
+     * Get the definition-level call graph (not aggregated to modules).
+     * Returns edges from caller definition to called definition.
+     */
+    getDefinitionCallGraph(): CallGraphEdge[];
+    /**
+     * Get the definition-level call graph as a Map for efficient lookups.
+     * Maps from_definition_id to array of to_definition_ids.
+     */
+    getDefinitionCallGraphMap(): Map<number, number[]>;
+    /**
+     * Get all non-type-only, internal file import edges.
+     * Used to build the import graph for process group detection.
+     */
+    getRuntimeImportEdges(): Array<{
+        fromFileId: number;
+        toFileId: number;
+    }>;
+    /**
+     * Get file-to-module mapping via module_members → definitions → files.
+     * Returns a Map from fileId to moduleId.
+     */
+    getFileToModuleMap(): Map<number, number>;
+    /**
+     * Get module pairs connected by imports but with no existing interaction.
+     * Fills the gap between call-graph detection (calls only) and the full import graph.
+     */
+    getImportOnlyModulePairs(): Array<{
+        fromModuleId: number;
+        toModuleId: number;
+        symbols: string[];
+        weight: number;
+        isTypeOnly: boolean;
+    }>;
+    /**
+     * Check if any file in fromModule imports from any file in toModule.
+     * Join: module_members → definitions → files → imports → files → definitions → module_members
+     */
+    hasModuleImportPath(fromModuleId: number, toModuleId: number): boolean;
+    /**
+     * Get actual symbols that fromModule imports from toModule.
+     * Returns symbol names and kinds for enriching prompts and deriving `symbols` field.
+     */
+    getModuleImportedSymbols(fromModuleId: number, toModuleId: number): Array<{
+        name: string;
+        kind: string;
+    }>;
+    private getCallGraphInternal;
+}
+//# sourceMappingURL=interaction-repository.d.ts.map

package/dist/db/repositories/interaction-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-repository.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/interaction-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGxG,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAyCD;;GAEG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC;;;OAGG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM;IAuB5F;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM;IAyB5F;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQvC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU1E;;OAEG;IACH,MAAM,IAAI,oBAAoB,EAAE;IAMhC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,oBAAoB,EAAE;IAQrE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAQvD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAQrD;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO;IA+B9D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B;;OAEG;IACH,KAAK,IAAI,MAAM;IAOf;;OAEG;IACH,QAAQ,IAAI,MAAM;IAOlB;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAc5B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,oBAAoB,EAAE;IAQ9D;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAOnD;;;OAGG;IACH,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAWtD;;;OAGG;IACH,sBAAsB,IAAI,aAAa,EAAE;IAIzC;;;OAGG;IACH,yBAAyB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAiBlD;;;OAGG;IACH,qBAAqB,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAUxE;;;OAGG;IACH,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBzC;;;OAGG;IACH,wBAAwB,IAAI,KAAK,CAAC;QAChC,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IAuCF;;;OAGG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAqBtE;;;OAGG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAuBzG,OAAO,CAAC,oBAAoB;CAG7B"}