ruflo-graph-intelligence 0.1.0-alpha.1

package/dist/adapters/portfolio-cg-adapter.js

@@ -0,0 +1,102 @@
+/**
+ * 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 { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export function portfolioGraphId(portfolioId) {
+    return `ruflo-neural-trader:covariance:${portfolioId}`;
+}
+export class PortfolioCovarianceAdapter {
+    graphId;
+    ownerPlugin = 'ruflo-neural-trader';
+    requiresPreprocessing = false;
+    source;
+    portfolioId;
+    ridge;
+    constructor(options) {
+        this.source = options.source;
+        this.portfolioId = options.portfolioId;
+        this.ridge = options.ridge ?? 1e-6;
+        this.graphId = portfolioGraphId(this.portfolioId);
+    }
+    async exportAsSparseMatrix(options) {
+        const covEntries = await this.source.listCovarianceEntries(this.portfolioId);
+        const assetSet = new Set();
+        for (const e of covEntries) {
+            assetSet.add(e.assetA);
+            assetSet.add(e.assetB);
+        }
+        if (options?.nodeFilter) {
+            for (const a of [...assetSet])
+                if (!options.nodeFilter.has(a))
+                    assetSet.delete(a);
+        }
+        const assets = [...assetSet].sort();
+        const nodeIndex = {};
+        assets.forEach((a, i) => (nodeIndex[a] = i));
+        // Symmetrise. If only Σ[A,B] is provided, also emit Σ[B,A] with the same value.
+        const sym = new Map();
+        for (const e of covEntries) {
+            const r = nodeIndex[e.assetA];
+            const c = nodeIndex[e.assetB];
+            if (r === undefined || c === undefined)
+                continue;
+            const k1 = `${r},${c}`;
+            const k2 = `${c},${r}`;
+            sym.set(k1, e.covariance);
+            sym.set(k2, e.covariance);
+        }
+        const entries = [];
+        for (const [key, v] of sym) {
+            const [rStr, cStr] = key.split(',');
+            const r = Number(rStr);
+            const c = Number(cStr);
+            if (r === c)
+                continue;
+            entries.push({ row: r, col: c, value: v });
+        }
+        // Diagonal: existing variance value (if provided) PLUS ridge — keeps SPD
+        // even when the empirical Σ is rank-deficient.
+        for (let i = 0; i < assets.length; i++) {
+            const provided = sym.get(`${i},${i}`) ?? 0;
+            entries.push({ row: i, col: i, value: provided + this.ridge });
+        }
+        return {
+            graphId: this.graphId,
+            size: assets.length,
+            entries,
+            nodeIndex,
+            indexNode: assets,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+    /** Fetch expected returns aligned with the matrix's node order. */
+    async expectedReturnsVector(matrix) {
+        const expected = await this.source.listExpectedReturns(this.portfolioId);
+        return matrix.indexNode.map((a) => expected[a] ?? 0);
+    }
+}
+export function registerPortfolioCovarianceAdapter(options) {
+    const adapter = new PortfolioCovarianceAdapter(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=portfolio-cg-adapter.js.map

package/dist/adapters/portfolio-cg-adapter.js.map

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

package/dist/adapters/rag-memory-adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * RAG Memory Adapter (Wedge 5, ADR-123 Phase 4)
+ *
+ * `ruflo-rag-memory` ships Graph-RAG multi-hop retrieval. This adapter
+ * exports the chunk-connectivity graph so personalized PR seeded by the
+ * query embedding ranks candidate chunks globally — graph-aware retrieval
+ * beyond flat top-k MMR rerank.
+ *
+ * The seedNodes for personalized PR come from the caller's query side
+ * (`sublinear/page-rank-entry` already accepts seedNodes). This adapter
+ * just exposes the underlying chunk graph.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface ChunkEdge {
+    fromChunkId: string;
+    toChunkId: string;
+    /** Similarity weight in [0, 1] — typically cosine similarity of chunk embeddings. */
+    similarity: number;
+}
+export interface RagMemorySource {
+    listChunkEdges(namespace?: string): Promise<readonly ChunkEdge[]>;
+}
+export interface RagMemoryAdapterOptions {
+    source: RagMemorySource;
+    namespace?: string;
+    /** Minimum similarity to include an edge. Default 0.5. */
+    similarityFloor?: number;
+    /** DD safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare function ragMemoryGraphId(namespace?: string): string;
+export declare class RagMemoryAdapter implements SublinearAdapter {
+    readonly graphId: string;
+    readonly ownerPlugin = "ruflo-rag-memory";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly namespace?;
+    private readonly similarityFloor;
+    private readonly ddSafetyMargin;
+    constructor(options: RagMemoryAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerRagMemoryAdapter(options: RagMemoryAdapterOptions & {
+    registry?: AdapterRegistry;
+}): RagMemoryAdapter;
+//# sourceMappingURL=rag-memory-adapter.d.ts.map

package/dist/adapters/rag-memory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-memory-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/rag-memory-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,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,uBAAuB;IAQtC,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAuClG;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GAChE,gBAAgB,CAIlB"}

package/dist/adapters/rag-memory-adapter.js

@@ -0,0 +1,86 @@
+/**
+ * RAG Memory Adapter (Wedge 5, ADR-123 Phase 4)
+ *
+ * `ruflo-rag-memory` ships Graph-RAG multi-hop retrieval. This adapter
+ * exports the chunk-connectivity graph so personalized PR seeded by the
+ * query embedding ranks candidate chunks globally — graph-aware retrieval
+ * beyond flat top-k MMR rerank.
+ *
+ * The seedNodes for personalized PR come from the caller's query side
+ * (`sublinear/page-rank-entry` already accepts seedNodes). This adapter
+ * just exposes the underlying chunk graph.
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export function ragMemoryGraphId(namespace) {
+    return namespace
+        ? `ruflo-rag-memory:chunks:${namespace}`
+        : 'ruflo-rag-memory:chunks:default';
+}
+export class RagMemoryAdapter {
+    graphId;
+    ownerPlugin = 'ruflo-rag-memory';
+    requiresPreprocessing = false;
+    source;
+    namespace;
+    similarityFloor;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.namespace = options.namespace;
+        this.similarityFloor = options.similarityFloor ?? 0.5;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+        this.graphId = ragMemoryGraphId(this.namespace);
+    }
+    async exportAsSparseMatrix(options) {
+        const edges = (await this.source.listChunkEdges(this.namespace)).filter((e) => e.similarity >= this.similarityFloor);
+        const chunkSet = new Set();
+        for (const e of edges) {
+            chunkSet.add(e.fromChunkId);
+            chunkSet.add(e.toChunkId);
+        }
+        if (options?.nodeFilter) {
+            for (const n of [...chunkSet])
+                if (!options.nodeFilter.has(n))
+                    chunkSet.delete(n);
+        }
+        const chunks = [...chunkSet].sort();
+        const nodeIndex = {};
+        chunks.forEach((n, i) => (nodeIndex[n] = i));
+        const entries = [];
+        const rowSums = new Array(chunks.length).fill(0);
+        for (const e of edges) {
+            const r = nodeIndex[e.fromChunkId];
+            const c = nodeIndex[e.toChunkId];
+            if (r === undefined || c === undefined || r === c)
+                continue;
+            entries.push({ row: r, col: c, value: e.similarity });
+            rowSums[r] += e.similarity;
+        }
+        for (let i = 0; i < chunks.length; i++) {
+            entries.push({ row: i, col: i, value: rowSums[i] + this.ddSafetyMargin });
+        }
+        return {
+            graphId: this.graphId,
+            size: chunks.length,
+            entries,
+            nodeIndex,
+            indexNode: chunks,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+}
+export function registerRagMemoryAdapter(options) {
+    const adapter = new RagMemoryAdapter(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=rag-memory-adapter.js.map

package/dist/adapters/rag-memory-adapter.js.map

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

package/dist/application/federation-client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Federation Client for PR Artifacts (Phase 8 — beyond-SOTA, ADR-123)
+ *
+ * Sends `pr_artifact_request` to peers, verifies inbound `pr_artifact_response`
+ * envelopes via Phase 7 verifier with the consumer's trust list, falls back
+ * to local recompute on stale/untrusted responses.
+ */
+import type { FederationMessage, FederationTransport } from '../domain/federation-protocol.js';
+import type { ArtifactVerificationResult } from '../domain/signed-artifact.js';
+import type { PageRankResult } from '../domain/types.js';
+export interface FederationClientOptions {
+    installationId: string;
+    transport: FederationTransport;
+    /** Public keys we trust. Empty = trust any valid signature. */
+    trustedPublicKeys?: string[];
+}
+export interface FetchPrResult {
+    /** How the result was obtained. */
+    origin: 'peer' | 'local-fallback' | 'stale-fallback' | 'untrusted-fallback';
+    result: PageRankResult;
+    /** If origin === 'peer', the verification report. */
+    verification?: ArtifactVerificationResult;
+    /** Optional reason when we fell back. */
+    fallbackReason?: string;
+}
+export declare class FederationClient {
+    private readonly installationId;
+    private readonly transport;
+    private readonly trustedPublicKeys;
+    constructor(options: FederationClientOptions);
+    /**
+     * Fetch a single-entry PR score for `nodeId` over `graphId`. Tries the
+     * peer first; on stale/untrusted/missing, falls back to local recompute.
+     */
+    fetchPageRank(input: {
+        peer: string;
+        graphId: string;
+        nodeId: string;
+        alpha?: number;
+        epsilon?: number;
+        seedNodes?: string[];
+        lastKnownGraphHash?: string;
+        lastKnownResultHash?: string;
+    }): Promise<FetchPrResult>;
+    private localCompute;
+}
+/**
+ * Helper: an in-process transport stitching a client to a server. Useful for
+ * testing the Phase 8 round-trip without spinning up real ADR-104 wiring.
+ */
+export declare function inProcessTransport(server: {
+    handle: (msg: FederationMessage) => Promise<FederationMessage | null>;
+}): FederationTransport;
+//# sourceMappingURL=federation-client.d.ts.map

package/dist/application/federation-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-client.d.ts","sourceRoot":"","sources":["../../src/application/federation-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAIpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;IAC5E,MAAM,EAAE,cAAc,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAW;gBAEjC,OAAO,EAAE,uBAAuB;IAM5C;;;OAGG;IACG,aAAa,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,OAAO,CAAC,aAAa,CAAC;YA8CZ,YAAY;CAsB3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;CAAE,GAAG,mBAAmB,CAUzI"}

package/dist/application/federation-client.js

@@ -0,0 +1,101 @@
+/**
+ * Federation Client for PR Artifacts (Phase 8 — beyond-SOTA, ADR-123)
+ *
+ * Sends `pr_artifact_request` to peers, verifies inbound `pr_artifact_response`
+ * envelopes via Phase 7 verifier with the consumer's trust list, falls back
+ * to local recompute on stale/untrusted responses.
+ */
+import { verifyArtifact } from '../infrastructure/witness-signer.js';
+import { runPageRank } from '../infrastructure/solver-bridge.js';
+import { getRegistry } from '../domain/adapter.js';
+export class FederationClient {
+    installationId;
+    transport;
+    trustedPublicKeys;
+    constructor(options) {
+        this.installationId = options.installationId;
+        this.transport = options.transport;
+        this.trustedPublicKeys = options.trustedPublicKeys ?? [];
+    }
+    /**
+     * Fetch a single-entry PR score for `nodeId` over `graphId`. Tries the
+     * peer first; on stale/untrusted/missing, falls back to local recompute.
+     */
+    async fetchPageRank(input) {
+        const request = {
+            type: 'pr_artifact_request',
+            fromInstallation: this.installationId,
+            graphId: input.graphId,
+            queryNode: input.nodeId,
+            alpha: input.alpha ?? 0.85,
+            epsilon: input.epsilon ?? 1e-3,
+            seedNodes: input.seedNodes ?? [],
+            lastKnownGraphHash: input.lastKnownGraphHash,
+            lastKnownResultHash: input.lastKnownResultHash,
+        };
+        const response = await this.transport.send(input.peer, request);
+        if (response && response.type === 'pr_artifact_response') {
+            const verification = verifyArtifact(response.envelope, {
+                trustedPublicKeys: this.trustedPublicKeys.length > 0 ? this.trustedPublicKeys : undefined,
+            });
+            if (verification.valid) {
+                return {
+                    origin: 'peer',
+                    result: response.envelope.payload.result,
+                    verification,
+                };
+            }
+            return {
+                origin: 'untrusted-fallback',
+                result: await this.localCompute(input),
+                verification,
+                fallbackReason: verification.reason ?? 'verification failed',
+            };
+        }
+        if (response && response.type === 'pr_artifact_stale') {
+            return {
+                origin: 'stale-fallback',
+                result: await this.localCompute(input),
+                fallbackReason: response.reason,
+            };
+        }
+        // No usable response
+        return {
+            origin: 'local-fallback',
+            result: await this.localCompute(input),
+            fallbackReason: 'no usable response from peer',
+        };
+    }
+    async localCompute(input) {
+        const adapter = getRegistry().get(input.graphId);
+        if (!adapter) {
+            throw new Error(`localCompute: no adapter for graphId=${input.graphId}`);
+        }
+        const matrix = await adapter.exportAsSparseMatrix();
+        return runPageRank(matrix, {
+            graphId: input.graphId,
+            nodeId: input.nodeId,
+            alpha: input.alpha ?? 0.85,
+            epsilon: input.epsilon ?? 1e-3,
+            seedNodes: input.seedNodes ?? [],
+            maxComplexityClass: 'polynomial',
+            coherenceThreshold: 0,
+        });
+    }
+}
+/**
+ * Helper: an in-process transport stitching a client to a server. Useful for
+ * testing the Phase 8 round-trip without spinning up real ADR-104 wiring.
+ */
+export function inProcessTransport(server) {
+    return {
+        async send(_to, msg) {
+            return server.handle(msg);
+        },
+        onMessage() {
+            // not used in the in-process variant
+            return () => { };
+        },
+    };
+}
+//# sourceMappingURL=federation-client.js.map

package/dist/application/federation-client.js.map

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

package/dist/application/federation-server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Federation Server for PR Artifacts (Phase 8 — beyond-SOTA, ADR-123)
+ *
+ * Receives `pr_artifact_request` messages and serves either a fresh signed
+ * artifact (if the holder has one cached or computes one on demand) or a
+ * stale-rejection. The server uses Phase 7's sealArtifact for signing and
+ * Phase 2-6 adapters for graph access.
+ *
+ * Pluggable via FederationTransport so ADR-104's real wire layer fits in
+ * unchanged.
+ */
+import { type WitnessKey } from '../infrastructure/witness-signer.js';
+import type { FederationMessage, FederationTransport } from '../domain/federation-protocol.js';
+export interface FederationServerOptions {
+    installationId: string;
+    witnessKey: WitnessKey;
+    witnessKeyId: string;
+    transport: FederationTransport;
+    /** Per-graph rate-limit budget — requests per peer per minute. */
+    rateLimitPerPeerPerMinute?: number;
+}
+export declare class FederationServer {
+    private readonly installationId;
+    private readonly witnessKey;
+    private readonly witnessKeyId;
+    private readonly transport;
+    private readonly rateLimit;
+    private rateBuckets;
+    private unsubscribe?;
+    constructor(options: FederationServerOptions);
+    start(): void;
+    stop(): void;
+    /** Public test seam — handles a single inbound message. */
+    handle(msg: FederationMessage): Promise<FederationMessage | null>;
+    private handleRequest;
+    private checkRate;
+}
+//# sourceMappingURL=federation-server.d.ts.map

package/dist/application/federation-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-server.d.ts","sourceRoot":"","sources":["../../src/application/federation-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAGpF,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAIpB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,kEAAkE;IAClE,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAOD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,WAAW,CAAC,CAAa;gBAErB,OAAO,EAAE,uBAAuB;IAQ5C,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,2DAA2D;IACrD,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAKzD,aAAa;IA8E3B,OAAO,CAAC,SAAS;CAWlB"}

package/dist/application/federation-server.js

@@ -0,0 +1,127 @@
+/**
+ * Federation Server for PR Artifacts (Phase 8 — beyond-SOTA, ADR-123)
+ *
+ * Receives `pr_artifact_request` messages and serves either a fresh signed
+ * artifact (if the holder has one cached or computes one on demand) or a
+ * stale-rejection. The server uses Phase 7's sealArtifact for signing and
+ * Phase 2-6 adapters for graph access.
+ *
+ * Pluggable via FederationTransport so ADR-104's real wire layer fits in
+ * unchanged.
+ */
+import { sealArtifact } from '../infrastructure/witness-signer.js';
+import { runPageRank } from '../infrastructure/solver-bridge.js';
+import { getRegistry } from '../domain/adapter.js';
+export class FederationServer {
+    installationId;
+    witnessKey;
+    witnessKeyId;
+    transport;
+    rateLimit;
+    rateBuckets = new Map();
+    unsubscribe;
+    constructor(options) {
+        this.installationId = options.installationId;
+        this.witnessKey = options.witnessKey;
+        this.witnessKeyId = options.witnessKeyId;
+        this.transport = options.transport;
+        this.rateLimit = options.rateLimitPerPeerPerMinute ?? 60;
+    }
+    start() {
+        this.unsubscribe = this.transport.onMessage((m) => this.handle(m));
+    }
+    stop() {
+        this.unsubscribe?.();
+    }
+    /** Public test seam — handles a single inbound message. */
+    async handle(msg) {
+        if (msg.type !== 'pr_artifact_request')
+            return null;
+        return this.handleRequest(msg);
+    }
+    async handleRequest(req) {
+        // Rate-limit per peer
+        if (!this.checkRate(req.fromInstallation)) {
+            return {
+                type: 'pr_artifact_stale',
+                fromInstallation: this.installationId,
+                graphId: req.graphId,
+                currentGraphHash: 'rate-limited'.padEnd(64, '0'),
+                reason: 'rate limit exceeded',
+            };
+        }
+        const adapter = getRegistry().get(req.graphId);
+        if (!adapter) {
+            return {
+                type: 'pr_artifact_stale',
+                fromInstallation: this.installationId,
+                graphId: req.graphId,
+                currentGraphHash: '0'.repeat(64),
+                reason: `no adapter for graphId=${req.graphId}`,
+            };
+        }
+        const matrix = await adapter.exportAsSparseMatrix();
+        const currentGraphHash = matrix.contentHash ?? '0'.repeat(64);
+        // Stale-check: if the requester's lastKnownGraphHash differs, send stale
+        if (req.lastKnownGraphHash && req.lastKnownGraphHash !== currentGraphHash) {
+            return {
+                type: 'pr_artifact_stale',
+                fromInstallation: this.installationId,
+                graphId: req.graphId,
+                currentGraphHash,
+                reason: 'graph has changed since requester last cached',
+            };
+        }
+        if (!req.queryNode) {
+            return {
+                type: 'pr_artifact_stale',
+                fromInstallation: this.installationId,
+                graphId: req.graphId,
+                currentGraphHash,
+                reason: 'full-vector requests not yet supported (Phase 8 only)',
+            };
+        }
+        // Compute and seal
+        const prResult = runPageRank(matrix, {
+            graphId: req.graphId,
+            nodeId: req.queryNode,
+            alpha: req.alpha,
+            epsilon: req.epsilon,
+            seedNodes: req.seedNodes,
+            maxComplexityClass: 'polynomial',
+            coherenceThreshold: 0,
+        });
+        const { envelope } = sealArtifact({
+            installationId: this.installationId,
+            witnessKeyId: this.witnessKeyId,
+            graphId: req.graphId,
+            graphHash: currentGraphHash,
+            graphTimestamp: matrix.capturedAt,
+            algorithm: 'forward-push',
+            alpha: req.alpha,
+            epsilon: req.epsilon,
+            queryNode: req.queryNode,
+            seedNodes: req.seedNodes,
+            result: prResult,
+            witnessKey: this.witnessKey,
+        });
+        return {
+            type: 'pr_artifact_response',
+            fromInstallation: this.installationId,
+            envelope,
+        };
+    }
+    checkRate(peer) {
+        const now = Date.now();
+        const bucket = this.rateBuckets.get(peer);
+        if (!bucket || now >= bucket.resetAt) {
+            this.rateBuckets.set(peer, { count: 1, resetAt: now + 60_000 });
+            return true;
+        }
+        if (bucket.count >= this.rateLimit)
+            return false;
+        bucket.count++;
+        return true;
+    }
+}
+//# sourceMappingURL=federation-server.js.map

package/dist/application/federation-server.js.map

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