ruflo-graph-intelligence 0.1.0-alpha.1

package/dist/adapters/federation-trust-adapter.js

@@ -0,0 +1,82 @@
+/**
+ * Federation Trust Adapter (Wedge 3, ADR-123 Phase 3)
+ *
+ * `ruflo-federation` ships a peer trust mesh (ADR-097/104/105/111). This
+ * adapter exports the mesh as a SparseMatrix so `sublinear/page-rank-entry`
+ * computes transitive trust `(I − αT)τ = e` in O(log peers) instead of
+ * O(peers²) closure walks. Trust is one-way → the matrix is asymmetric
+ * (per upstream 2025 asymmetric-DD result, this is in-scope for sublinear).
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export const FEDERATION_TRUST_GRAPH_ID = 'ruflo-federation:trust-mesh';
+export class FederationTrustAdapter {
+    graphId = FEDERATION_TRUST_GRAPH_ID;
+    ownerPlugin = 'ruflo-federation';
+    requiresPreprocessing = false;
+    source;
+    freshnessMs;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.freshnessMs = options.freshnessMs ?? 7 * 24 * 60 * 60 * 1000;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+    }
+    async exportAsSparseMatrix(options) {
+        const allEdges = await this.source.listTrustEdges();
+        const now = Date.now();
+        const fresh = allEdges.filter((e) => now - Date.parse(e.updatedAt) <= this.freshnessMs);
+        const peerSet = new Set();
+        for (const e of fresh) {
+            peerSet.add(e.fromPeer);
+            peerSet.add(e.toPeer);
+        }
+        if (options?.nodeFilter) {
+            for (const p of [...peerSet])
+                if (!options.nodeFilter.has(p))
+                    peerSet.delete(p);
+        }
+        const peers = [...peerSet].sort();
+        const nodeIndex = {};
+        peers.forEach((p, i) => (nodeIndex[p] = i));
+        const entries = [];
+        const rowSums = new Array(peers.length).fill(0);
+        for (const edge of fresh) {
+            const r = nodeIndex[edge.fromPeer];
+            const c = nodeIndex[edge.toPeer];
+            if (r === undefined || c === undefined || r === c)
+                continue;
+            const w = Math.max(0, Math.min(1, edge.confidence));
+            if (w === 0)
+                continue;
+            entries.push({ row: r, col: c, value: w });
+            rowSums[r] += w;
+        }
+        // DD diagonal: |diag| ≥ Σ|off| + margin
+        for (let i = 0; i < peers.length; i++) {
+            entries.push({ row: i, col: i, value: rowSums[i] + this.ddSafetyMargin });
+        }
+        return {
+            graphId: this.graphId,
+            size: peers.length,
+            entries,
+            nodeIndex,
+            indexNode: peers,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+}
+export function registerFederationTrustAdapter(options) {
+    const adapter = new FederationTrustAdapter(options);
+    (options.registry ?? getRegistry()).register(adapter);
+    return adapter;
+}
+function hashContent(graphId, entries) {
+    const h = createHash('sha256');
+    h.update(graphId);
+    for (const e of entries)
+        h.update(`|${e.row},${e.col},${e.value.toFixed(8)}`);
+    return h.digest('hex');
+}
+//# sourceMappingURL=federation-trust-adapter.js.map

package/dist/adapters/federation-trust-adapter.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ruflo-graph-intelligence — Adapter barrel export
+ *
+ * Each adapter lives in its own file and is opted into by the owning plugin
+ * at init time. Phase-1 ships zero adapters; Phase 2+ adds them one at a time.
+ */
+export { BrowserCausalAdapter, browserCausalGraphId, registerBrowserCausalAdapter, type BreakEventSource, type BreakEventLike, type BrowserCausalAdapterOptions, } from './browser-causal-adapter.js';
+export { FederationTrustAdapter, FEDERATION_TRUST_GRAPH_ID, registerFederationTrustAdapter, type PeerTrustEdge, type PeerTrustSource, type FederationTrustAdapterOptions, } from './federation-trust-adapter.js';
+export { CostAttributionAdapter, costAttributionGraphId, registerCostAttributionAdapter, type CostCausationEdge, type CostCausationSource, type CostAttributionAdapterOptions, } from './cost-attribution-adapter.js';
+export { ObservabilitySpanAdapter, observabilityGraphId, registerObservabilitySpanAdapter, type SpanRecord, type ObservabilitySpanSource, type ObservabilitySpanAdapterOptions, } from './observability-span-adapter.js';
+export { KnowledgeGraphAdapter, KNOWLEDGE_GRAPH_ID, registerKnowledgeGraphAdapter, type KGEdge, type KnowledgeGraphSource, type KnowledgeGraphAdapterOptions, } from './knowledge-graph-adapter.js';
+export { RagMemoryAdapter, ragMemoryGraphId, registerRagMemoryAdapter, type ChunkEdge, type RagMemorySource, type RagMemoryAdapterOptions, } from './rag-memory-adapter.js';
+export { PortfolioCovarianceAdapter, portfolioGraphId, registerPortfolioCovarianceAdapter, type CovarianceEntry, type PortfolioSource, type PortfolioAdapterOptions, } from './portfolio-cg-adapter.js';
+export { AIDefenceSuspicionAdapter, AIDEFENCE_CALL_GRAPH_ID, registerAIDefenceSuspicionAdapter, type CallEdge, type AIDefenceSource, type AIDefenceAdapterOptions, } from './aidefence-suspicion-adapter.js';
+export { JujutsuBlastRadiusAdapter, JUJUTSU_IMPORT_GRAPH_ID, registerJujutsuBlastRadiusAdapter, type ImportEdge, type JujutsuSource, type JujutsuAdapterOptions, } from './jujutsu-blast-radius-adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,EAC9B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,6BAA6B,GACnC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,GACnC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,gCAAgC,EAChC,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,kCAAkC,EAClC,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,EACjC,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,EACjC,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,mCAAmC,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,16 @@
+/**
+ * ruflo-graph-intelligence — Adapter barrel export
+ *
+ * Each adapter lives in its own file and is opted into by the owning plugin
+ * at init time. Phase-1 ships zero adapters; Phase 2+ adds them one at a time.
+ */
+export { BrowserCausalAdapter, browserCausalGraphId, registerBrowserCausalAdapter, } from './browser-causal-adapter.js';
+export { FederationTrustAdapter, FEDERATION_TRUST_GRAPH_ID, registerFederationTrustAdapter, } from './federation-trust-adapter.js';
+export { CostAttributionAdapter, costAttributionGraphId, registerCostAttributionAdapter, } from './cost-attribution-adapter.js';
+export { ObservabilitySpanAdapter, observabilityGraphId, registerObservabilitySpanAdapter, } from './observability-span-adapter.js';
+export { KnowledgeGraphAdapter, KNOWLEDGE_GRAPH_ID, registerKnowledgeGraphAdapter, } from './knowledge-graph-adapter.js';
+export { RagMemoryAdapter, ragMemoryGraphId, registerRagMemoryAdapter, } from './rag-memory-adapter.js';
+export { PortfolioCovarianceAdapter, portfolioGraphId, registerPortfolioCovarianceAdapter, } from './portfolio-cg-adapter.js';
+export { AIDefenceSuspicionAdapter, AIDEFENCE_CALL_GRAPH_ID, registerAIDefenceSuspicionAdapter, } from './aidefence-suspicion-adapter.js';
+export { JujutsuBlastRadiusAdapter, JUJUTSU_IMPORT_GRAPH_ID, registerJujutsuBlastRadiusAdapter, } from './jujutsu-blast-radius-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,GAI7B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAI/B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,GAI/B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,gCAAgC,GAIjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,GAI9B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,GAIzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,kCAAkC,GAInC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,GAIlC,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,GAIlC,MAAM,mCAAmC,CAAC"}

package/dist/adapters/jujutsu-blast-radius-adapter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Jujutsu Blast-Radius Adapter (Wedge 11, ADR-123 Phase 6)
+ *
+ * `ruflo-jujutsu` runs diff-analyze. This adapter exports the file-import
+ * graph so "if I change `foo.ts`, which files are downstream-affected" is a
+ * single-entry PR query — O(log files) instead of O(LOC × imports).
+ *
+ * The graph is directed: A imports B → A is downstream of B (B's change
+ * propagates upward to A). For blast-radius FROM a changed file, the matrix
+ * keeps natural orientation (changed file is the seed; downstream files
+ * receive the PR mass).
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface ImportEdge {
+    /** File that does the importing. */
+    importer: string;
+    /** File being imported. */
+    importee: string;
+    /** Optional weight — number of distinct symbols imported. Default 1. */
+    weight?: number;
+}
+export interface JujutsuSource {
+    listImportEdges(): Promise<readonly ImportEdge[]>;
+}
+export interface JujutsuAdapterOptions {
+    source: JujutsuSource;
+    /** DD safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare const JUJUTSU_IMPORT_GRAPH_ID = "ruflo-jujutsu:import-graph";
+export declare class JujutsuBlastRadiusAdapter implements SublinearAdapter {
+    readonly graphId = "ruflo-jujutsu:import-graph";
+    readonly ownerPlugin = "ruflo-jujutsu";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly ddSafetyMargin;
+    constructor(options: JujutsuAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerJujutsuBlastRadiusAdapter(options: JujutsuAdapterOptions & {
+    registry?: AdapterRegistry;
+}): JujutsuBlastRadiusAdapter;
+//# sourceMappingURL=jujutsu-blast-radius-adapter.d.ts.map

package/dist/adapters/jujutsu-blast-radius-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jujutsu-blast-radius-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/jujutsu-blast-radius-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAEpE,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,QAAQ,CAAC,OAAO,gCAA2B;IAC3C,QAAQ,CAAC,WAAW,mBAAmB;IACvC,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,qBAAqB;IAKpC,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAuClG;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GAC9D,yBAAyB,CAI3B"}

package/dist/adapters/jujutsu-blast-radius-adapter.js

@@ -0,0 +1,80 @@
+/**
+ * Jujutsu Blast-Radius Adapter (Wedge 11, ADR-123 Phase 6)
+ *
+ * `ruflo-jujutsu` runs diff-analyze. This adapter exports the file-import
+ * graph so "if I change `foo.ts`, which files are downstream-affected" is a
+ * single-entry PR query — O(log files) instead of O(LOC × imports).
+ *
+ * The graph is directed: A imports B → A is downstream of B (B's change
+ * propagates upward to A). For blast-radius FROM a changed file, the matrix
+ * keeps natural orientation (changed file is the seed; downstream files
+ * receive the PR mass).
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export const JUJUTSU_IMPORT_GRAPH_ID = 'ruflo-jujutsu:import-graph';
+export class JujutsuBlastRadiusAdapter {
+    graphId = JUJUTSU_IMPORT_GRAPH_ID;
+    ownerPlugin = 'ruflo-jujutsu';
+    requiresPreprocessing = false;
+    source;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+    }
+    async exportAsSparseMatrix(options) {
+        const edges = await this.source.listImportEdges();
+        const fileSet = new Set();
+        for (const e of edges) {
+            fileSet.add(e.importer);
+            fileSet.add(e.importee);
+        }
+        if (options?.nodeFilter) {
+            for (const n of [...fileSet])
+                if (!options.nodeFilter.has(n))
+                    fileSet.delete(n);
+        }
+        const files = [...fileSet].sort();
+        const nodeIndex = {};
+        files.forEach((f, i) => (nodeIndex[f] = i));
+        // For blast-radius PR seeded at the changed file: we want change to flow
+        // from `importee` → `importer`. So row = importee, col = importer.
+        const entries = [];
+        const rowSums = new Array(files.length).fill(0);
+        for (const e of edges) {
+            const r = nodeIndex[e.importee];
+            const c = nodeIndex[e.importer];
+            if (r === undefined || c === undefined || r === c)
+                continue;
+            const w = Math.max(0, e.weight ?? 1);
+            entries.push({ row: r, col: c, value: w });
+            rowSums[r] += w;
+        }
+        for (let i = 0; i < files.length; i++) {
+            entries.push({ row: i, col: i, value: rowSums[i] + this.ddSafetyMargin });
+        }
+        return {
+            graphId: this.graphId,
+            size: files.length,
+            entries,
+            nodeIndex,
+            indexNode: files,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+}
+export function registerJujutsuBlastRadiusAdapter(options) {
+    const adapter = new JujutsuBlastRadiusAdapter(options);
+    (options.registry ?? getRegistry()).register(adapter);
+    return adapter;
+}
+function hashContent(graphId, entries) {
+    const h = createHash('sha256');
+    h.update(graphId);
+    for (const e of entries)
+        h.update(`|${e.row},${e.col},${e.value.toFixed(8)}`);
+    return h.digest('hex');
+}
+//# sourceMappingURL=jujutsu-blast-radius-adapter.js.map

package/dist/adapters/jujutsu-blast-radius-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jujutsu-blast-radius-adapter.js","sourceRoot":"","sources":["../../src/adapters/jujutsu-blast-radius-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAqBnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAEpE,MAAM,OAAO,yBAAyB;IAC3B,OAAO,GAAG,uBAAuB,CAAC;IAClC,WAAW,GAAG,eAAe,CAAC;IAC9B,qBAAqB,GAAG,KAAK,CAAC;IAEtB,MAAM,CAAgB;IACtB,cAAc,CAAS;IAExC,YAAY,OAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,OAA8C;QACvE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,SAAS,GAA2B,EAAE,CAAC;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAE5C,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAS,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,KAAK,CAAC,MAAM;YAClB,OAAO;YACP,SAAS;YACT,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;SAChD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAA+D;IAE/D,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC,OAAO,CAAC,QAAQ,IAAI,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,OAA+B;IACnE,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/adapters/knowledge-graph-adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Knowledge Graph Adapter (Wedge 4, ADR-123 Phase 4)
+ *
+ * `ruflo-knowledge-graph` builds an entity-relation graph via kg-extract.
+ * This adapter exports it as a SparseMatrix so kg-importance(entity) becomes
+ * a single-entry PR query — answering "which entity is most central" in
+ * sub-millisecond on a 10k-node graph.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface KGEdge {
+    fromEntity: string;
+    toEntity: string;
+    relation: string;
+    /** Edge confidence in [0,1]. Default 1.0. */
+    confidence?: number;
+}
+export interface KnowledgeGraphSource {
+    listEdges(): Promise<readonly KGEdge[]>;
+}
+export interface KnowledgeGraphAdapterOptions {
+    source: KnowledgeGraphSource;
+    /** DD safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare const KNOWLEDGE_GRAPH_ID = "ruflo-knowledge-graph:entities";
+export declare class KnowledgeGraphAdapter implements SublinearAdapter {
+    readonly graphId = "ruflo-knowledge-graph:entities";
+    readonly ownerPlugin = "ruflo-knowledge-graph";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly ddSafetyMargin;
+    constructor(options: KnowledgeGraphAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerKnowledgeGraphAdapter(options: KnowledgeGraphAdapterOptions & {
+    registry?: AdapterRegistry;
+}): KnowledgeGraphAdapter;
+//# sourceMappingURL=knowledge-graph-adapter.d.ts.map

package/dist/adapters/knowledge-graph-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/knowledge-graph-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AAEnE,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,QAAQ,CAAC,OAAO,oCAAsB;IACtC,QAAQ,CAAC,WAAW,2BAA2B;IAC/C,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,4BAA4B;IAK3C,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CA+ClG;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,4BAA4B,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACrE,qBAAqB,CAIvB"}

package/dist/adapters/knowledge-graph-adapter.js

@@ -0,0 +1,83 @@
+/**
+ * Knowledge Graph Adapter (Wedge 4, ADR-123 Phase 4)
+ *
+ * `ruflo-knowledge-graph` builds an entity-relation graph via kg-extract.
+ * This adapter exports it as a SparseMatrix so kg-importance(entity) becomes
+ * a single-entry PR query — answering "which entity is most central" in
+ * sub-millisecond on a 10k-node graph.
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export const KNOWLEDGE_GRAPH_ID = 'ruflo-knowledge-graph:entities';
+export class KnowledgeGraphAdapter {
+    graphId = KNOWLEDGE_GRAPH_ID;
+    ownerPlugin = 'ruflo-knowledge-graph';
+    requiresPreprocessing = false;
+    source;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+    }
+    async exportAsSparseMatrix(options) {
+        const edges = await this.source.listEdges();
+        const entitySet = new Set();
+        for (const e of edges) {
+            entitySet.add(e.fromEntity);
+            entitySet.add(e.toEntity);
+        }
+        if (options?.nodeFilter) {
+            for (const n of [...entitySet])
+                if (!options.nodeFilter.has(n))
+                    entitySet.delete(n);
+        }
+        const entities = [...entitySet].sort();
+        const nodeIndex = {};
+        entities.forEach((n, i) => (nodeIndex[n] = i));
+        // Weight edges by confidence; if multiple relations exist between two
+        // entities, sum confidences (cap at 1).
+        const weights = new Map();
+        for (const e of edges) {
+            const r = nodeIndex[e.fromEntity];
+            const c = nodeIndex[e.toEntity];
+            if (r === undefined || c === undefined || r === c)
+                continue;
+            const key = `${r},${c}`;
+            weights.set(key, Math.min(1, (weights.get(key) ?? 0) + (e.confidence ?? 1)));
+        }
+        const entries = [];
+        const rowSums = new Array(entities.length).fill(0);
+        for (const [key, w] of weights) {
+            const [rStr, cStr] = key.split(',');
+            const r = Number(rStr);
+            const c = Number(cStr);
+            entries.push({ row: r, col: c, value: w });
+            rowSums[r] += w;
+        }
+        for (let i = 0; i < entities.length; i++) {
+            entries.push({ row: i, col: i, value: rowSums[i] + this.ddSafetyMargin });
+        }
+        return {
+            graphId: this.graphId,
+            size: entities.length,
+            entries,
+            nodeIndex,
+            indexNode: entities,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+}
+export function registerKnowledgeGraphAdapter(options) {
+    const adapter = new KnowledgeGraphAdapter(options);
+    (options.registry ?? getRegistry()).register(adapter);
+    return adapter;
+}
+function hashContent(graphId, entries) {
+    const h = createHash('sha256');
+    h.update(graphId);
+    for (const e of entries)
+        h.update(`|${e.row},${e.col},${e.value.toFixed(8)}`);
+    return h.digest('hex');
+}
+//# sourceMappingURL=knowledge-graph-adapter.js.map

package/dist/adapters/knowledge-graph-adapter.js.map

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

package/dist/adapters/observability-span-adapter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Observability Span Adapter (Wedge 7, ADR-123 Phase 3)
+ *
+ * `ruflo-observability` records spans (OpenTelemetry-style) with parent links
+ * + cross-trace causality. This adapter exports the span graph so the user
+ * can ask "which span most contributed to this slow/failed request" in
+ * O(log spans) instead of full-trace walks.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface SpanRecord {
+    spanId: string;
+    parentSpanId?: string;
+    traceId: string;
+    /** Self-time in microseconds — used as edge weight. */
+    selfTimeUs: number;
+    /** Optional cross-trace causality link (e.g. an event triggered this trace). */
+    causedBySpanId?: string;
+}
+export interface ObservabilitySpanSource {
+    listSpans(traceId: string): Promise<readonly SpanRecord[]>;
+}
+export interface ObservabilitySpanAdapterOptions {
+    source: ObservabilitySpanSource;
+    traceId: string;
+    /** DD safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare function observabilityGraphId(traceId: string): string;
+export declare class ObservabilitySpanAdapter implements SublinearAdapter {
+    readonly graphId: string;
+    readonly ownerPlugin = "ruflo-observability";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly traceId;
+    private readonly ddSafetyMargin;
+    constructor(options: ObservabilitySpanAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerObservabilitySpanAdapter(options: ObservabilitySpanAdapterOptions & {
+    registry?: AdapterRegistry;
+}): ObservabilitySpanAdapter;
+//# sourceMappingURL=observability-span-adapter.d.ts.map

package/dist/adapters/observability-span-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-span-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/observability-span-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,+BAA+B;IAO9C,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAoDlG;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,+BAA+B,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACxE,wBAAwB,CAI1B"}

package/dist/adapters/observability-span-adapter.js

@@ -0,0 +1,97 @@
+/**
+ * Observability Span Adapter (Wedge 7, ADR-123 Phase 3)
+ *
+ * `ruflo-observability` records spans (OpenTelemetry-style) with parent links
+ * + cross-trace causality. This adapter exports the span graph so the user
+ * can ask "which span most contributed to this slow/failed request" in
+ * O(log spans) instead of full-trace walks.
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export function observabilityGraphId(traceId) {
+    return `ruflo-observability:trace:${traceId}`;
+}
+export class ObservabilitySpanAdapter {
+    graphId;
+    ownerPlugin = 'ruflo-observability';
+    requiresPreprocessing = false;
+    source;
+    traceId;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.traceId = options.traceId;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+        this.graphId = observabilityGraphId(this.traceId);
+    }
+    async exportAsSparseMatrix(options) {
+        const spans = await this.source.listSpans(this.traceId);
+        const idSet = new Set();
+        for (const s of spans) {
+            idSet.add(s.spanId);
+            if (s.parentSpanId)
+                idSet.add(s.parentSpanId);
+            if (s.causedBySpanId)
+                idSet.add(s.causedBySpanId);
+        }
+        if (options?.nodeFilter) {
+            for (const n of [...idSet])
+                if (!options.nodeFilter.has(n))
+                    idSet.delete(n);
+        }
+        const nodes = [...idSet].sort();
+        const nodeIndex = {};
+        nodes.forEach((n, i) => (nodeIndex[n] = i));
+        // Normalise self-time per parent: each parent's outbound weights sum to ≤1.
+        const childrenByParent = new Map();
+        for (const s of spans) {
+            const p = s.parentSpanId ?? s.causedBySpanId;
+            if (!p)
+                continue;
+            if (!childrenByParent.has(p))
+                childrenByParent.set(p, []);
+            childrenByParent.get(p).push(s);
+        }
+        const entries = [];
+        const rowSums = new Array(nodes.length).fill(0);
+        for (const [parent, children] of childrenByParent) {
+            const r = nodeIndex[parent];
+            if (r === undefined)
+                continue;
+            const total = children.reduce((s, c) => s + Math.max(1, c.selfTimeUs), 0);
+            for (const child of children) {
+                const c = nodeIndex[child.spanId];
+                if (c === undefined || c === r)
+                    continue;
+                const w = Math.max(1, child.selfTimeUs) / total;
+                entries.push({ row: r, col: c, value: w });
+                rowSums[r] += w;
+            }
+        }
+        for (let i = 0; i < nodes.length; i++) {
+            entries.push({ row: i, col: i, value: rowSums[i] + this.ddSafetyMargin });
+        }
+        return {
+            graphId: this.graphId,
+            size: nodes.length,
+            entries,
+            nodeIndex,
+            indexNode: nodes,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+}
+export function registerObservabilitySpanAdapter(options) {
+    const adapter = new ObservabilitySpanAdapter(options);
+    (options.registry ?? getRegistry()).register(adapter);
+    return adapter;
+}
+function hashContent(graphId, entries) {
+    const h = createHash('sha256');
+    h.update(graphId);
+    for (const e of entries)
+        h.update(`|${e.row},${e.col},${e.value.toFixed(8)}`);
+    return h.digest('hex');
+}
+//# sourceMappingURL=observability-span-adapter.js.map

package/dist/adapters/observability-span-adapter.js.map

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

package/dist/adapters/portfolio-cg-adapter.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Portfolio Covariance Adapter (Wedge 8, ADR-123 Phase 5)
+ *
+ * `ruflo-neural-trader` does mean-variance optimisation: solve `Σ x = μ`
+ * where `Σ` is the symmetric positive-definite asset-covariance matrix and
+ * `μ` is the vector of expected returns. CG is the ideal target — upstream
+ * 1.7.0 benchmarks: **816 ns at n=256, 40-60× faster than Neumann**.
+ *
+ * This adapter exports the covariance matrix as a SparseMatrix so callers
+ * use `sublinear/solve` with `algorithm: 'cg'` and get the optimal weights.
+ * Unlike the PageRank wedges, this graph IS symmetric (Σ = Σᵀ) and SPD by
+ * construction.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface CovarianceEntry {
+    /** Asset symbol on the row side. */
+    assetA: string;
+    /** Asset symbol on the column side. */
+    assetB: string;
+    /** Covariance value. Σ[A,B] = Σ[B,A] by SPD construction. */
+    covariance: number;
+}
+export interface PortfolioSource {
+    /**
+     * Dense or sparse covariance entries. Adapter symmetrises automatically
+     * if only one of (A,B) or (B,A) is provided.
+     */
+    listCovarianceEntries(portfolioId: string): Promise<readonly CovarianceEntry[]>;
+    /** Expected returns vector — same keys as covariance assets. */
+    listExpectedReturns(portfolioId: string): Promise<Record<string, number>>;
+}
+export interface PortfolioAdapterOptions {
+    source: PortfolioSource;
+    portfolioId: string;
+    /**
+     * Ridge regularisation added to the diagonal to ensure SPD even when the
+     * empirical covariance is rank-deficient. Default 1e-6.
+     */
+    ridge?: number;
+}
+export declare function portfolioGraphId(portfolioId: string): string;
+export declare class PortfolioCovarianceAdapter implements SublinearAdapter {
+    readonly graphId: string;
+    readonly ownerPlugin = "ruflo-neural-trader";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly portfolioId;
+    private readonly ridge;
+    constructor(options: PortfolioAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+    /** Fetch expected returns aligned with the matrix's node order. */
+    expectedReturnsVector(matrix: SparseMatrix): Promise<number[]>;
+}
+export declare function registerPortfolioCovarianceAdapter(options: PortfolioAdapterOptions & {
+    registry?: AdapterRegistry;
+}): PortfolioCovarianceAdapter;
+//# sourceMappingURL=portfolio-cg-adapter.d.ts.map

package/dist/adapters/portfolio-cg-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio-cg-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/portfolio-cg-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IAChF,gEAAgE;IAChE,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,uBAAuB;IAOtC,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAmDjG,mEAAmE;IAC7D,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAIrE;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,uBAAuB,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GAChE,0BAA0B,CAI5B"}