ruflo-graph-intelligence 0.1.0-alpha.1

package/.claude-flow/data/pending-insights.jsonl

@@ -0,0 +1,30 @@
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/mcp-tools.test.ts","timestamp":1779154995196}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/mcp-tools.test.ts","timestamp":1779155000177}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/mcp-tools.test.ts","timestamp":1779155004124}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/.github/workflows/v3-ci.yml","timestamp":1779155058730}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/.github/workflows/v3-ci.yml","timestamp":1779155073299}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/browser-causal-adapter.ts","timestamp":1779155171818}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/index.ts","timestamp":1779155174932}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/browser-causal-adapter.test.ts","timestamp":1779155203499}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/index.ts","timestamp":1779155205959}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/federation-trust-adapter.ts","timestamp":1779155250109}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/cost-attribution-adapter.ts","timestamp":1779155268574}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/observability-span-adapter.ts","timestamp":1779155285631}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/index.ts","timestamp":1779155291726}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/phase3-adapters.test.ts","timestamp":1779155320194}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/knowledge-graph-adapter.ts","timestamp":1779155358150}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/rag-memory-adapter.ts","timestamp":1779155374761}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/index.ts","timestamp":1779155379146}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/phase4-adapters.test.ts","timestamp":1779155401684}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/aidefence-suspicion-adapter.ts","timestamp":1779155607985}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/jujutsu-blast-radius-adapter.ts","timestamp":1779155622800}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/infrastructure/jl-embed.ts","timestamp":1779155641351}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/mcp-tools/index.ts","timestamp":1779155648400}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/mcp-tools/index.ts","timestamp":1779155664743}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/adapters/index.ts","timestamp":1779155669573}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/index.ts","timestamp":1779155672340}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/phase6-adapters.test.ts","timestamp":1779155710143}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/domain/signed-artifact.ts","timestamp":1779155976116}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/infrastructure/witness-signer.ts","timestamp":1779156003682}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/src/index.ts","timestamp":1779156008672}
+{"type":"edit","file":"/Users/cohen/Projects/ruflo/plugins/ruflo-graph-intelligence/tests/phase7-signed-artifact.test.ts","timestamp":1779156040832}

package/dist/adapters/aidefence-suspicion-adapter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * AIDefence Suspicion Adapter (Wedge 10, ADR-123 Phase 6)
+ *
+ * `ruflo-aidefence` flags syscalls / agent actions as suspicious. This
+ * adapter exports the call-graph so suspicion propagates from the flagged
+ * leaf node back through callers via single-entry PR. `α=0.95` (high
+ * decay — suspicion travels far) by convention.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface CallEdge {
+    callerId: string;
+    calleeId: string;
+    /** Optional weight — calls per session. Default 1. */
+    weight?: number;
+}
+export interface AIDefenceSource {
+    listCallEdges(): Promise<readonly CallEdge[]>;
+}
+export interface AIDefenceAdapterOptions {
+    source: AIDefenceSource;
+    /** DD safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare const AIDEFENCE_CALL_GRAPH_ID = "ruflo-aidefence:call-graph";
+export declare class AIDefenceSuspicionAdapter implements SublinearAdapter {
+    readonly graphId = "ruflo-aidefence:call-graph";
+    readonly ownerPlugin = "ruflo-aidefence";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly ddSafetyMargin;
+    constructor(options: AIDefenceAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerAIDefenceSuspicionAdapter(options: AIDefenceAdapterOptions & {
+    registry?: AdapterRegistry;
+}): AIDefenceSuspicionAdapter;
+//# sourceMappingURL=aidefence-suspicion-adapter.d.ts.map

package/dist/adapters/aidefence-suspicion-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aidefence-suspicion-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/aidefence-suspicion-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,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,IAAI,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,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,qBAAqB;IACzC,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,uBAAuB;IAKtC,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAwClG;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,uBAAuB,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GAChE,yBAAyB,CAI3B"}

package/dist/adapters/aidefence-suspicion-adapter.js

@@ -0,0 +1,77 @@
+/**
+ * AIDefence Suspicion Adapter (Wedge 10, ADR-123 Phase 6)
+ *
+ * `ruflo-aidefence` flags syscalls / agent actions as suspicious. This
+ * adapter exports the call-graph so suspicion propagates from the flagged
+ * leaf node back through callers via single-entry PR. `α=0.95` (high
+ * decay — suspicion travels far) by convention.
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export const AIDEFENCE_CALL_GRAPH_ID = 'ruflo-aidefence:call-graph';
+export class AIDefenceSuspicionAdapter {
+    graphId = AIDEFENCE_CALL_GRAPH_ID;
+    ownerPlugin = 'ruflo-aidefence';
+    requiresPreprocessing = false;
+    source;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+    }
+    async exportAsSparseMatrix(options) {
+        const edges = await this.source.listCallEdges();
+        const idSet = new Set();
+        for (const e of edges) {
+            idSet.add(e.callerId);
+            idSet.add(e.calleeId);
+        }
+        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));
+        // Suspicion flows from callee BACK to caller, so edges are reversed:
+        // a callee that's flagged should bump suspicion on its caller.
+        const entries = [];
+        const rowSums = new Array(nodes.length).fill(0);
+        for (const e of edges) {
+            // Reverse direction: from callee → caller
+            const r = nodeIndex[e.calleeId];
+            const c = nodeIndex[e.callerId];
+            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 < 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 registerAIDefenceSuspicionAdapter(options) {
+    const adapter = new AIDefenceSuspicionAdapter(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=aidefence-suspicion-adapter.js.map

package/dist/adapters/aidefence-suspicion-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aidefence-suspicion-adapter.js","sourceRoot":"","sources":["../../src/adapters/aidefence-suspicion-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAmBnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAEpE,MAAM,OAAO,yBAAyB;IAC3B,OAAO,GAAG,uBAAuB,CAAC;IAClC,WAAW,GAAG,iBAAiB,CAAC;IAChC,qBAAqB,GAAG,KAAK,CAAC;IAEtB,MAAM,CAAkB;IACxB,cAAc,CAAS;IAExC,YAAY,OAAgC;QAC1C,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,aAAa,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,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,qEAAqE;QACrE,+DAA+D;QAC/D,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,0CAA0C;YAC1C,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,OAAiE;IAEjE,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/browser-causal-adapter.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Browser Causal-Recovery Adapter (Wedge 1, ADR-123 Phase 2)
+ *
+ * Exports the ADR-122 Phase 2 selector-break events as a SparseMatrix so
+ * `sublinear/page-rank-entry` can score a single element-ref's causal
+ * brittleness in O(log N) instead of the current O(N) `breakCount / attempts`
+ * ratio.
+ *
+ * The matrix `M` is built per-origin: rows + columns are union of
+ *   - all element-refs that have ever appeared
+ *   - all selector strings that have ever been retried
+ * Off-diagonal entry M[i,j] = number of times row-event preceded column-event
+ * on the same DOM mutation lineage (weight ≥ 1). Diagonal entry M[i,i] = 1 + Σ
+ * |off-diagonals on row i|, so the matrix is strictly diagonally-dominant.
+ *
+ * The adapter is **dependency-injection-friendly**: callers pass a
+ * `BreakEventSource` (a structural type matching the slice of ADR-122's
+ * CausalRecoveryService surface we actually need) so this plugin does NOT
+ * hard-import @claude-flow/browser. Phase 2 of *this* plugin ships the
+ * adapter; the browser package only needs to call `registerBrowserCausalAdapter()`
+ * at its plugin-init time.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter } from '../domain/adapter.js';
+/**
+ * The slice of @claude-flow/browser's CausalRecoveryService surface we depend on.
+ * Defined structurally so we don't need a hard import.
+ */
+export interface BreakEventSource {
+    /** All recorded break events for an origin, in chronological order. */
+    listBreaks(origin: string): Promise<readonly BreakEventLike[]>;
+}
+/** Minimal break-event shape we read. Compatible with ADR-122 Phase 2. */
+export interface BreakEventLike {
+    id: string;
+    origin: string;
+    selector: string;
+    /** Optional last-known role+name fuzzy-match keys (Phase 2 records both). */
+    lastKnownRole?: string;
+    lastKnownName?: string;
+    /** When the break was first observed (ISO). */
+    timestamp: string;
+}
+export interface BrowserCausalAdapterOptions {
+    /** Origin (e.g. `https://example.com`) — one adapter instance per origin. */
+    origin: string;
+    /** Event source. */
+    source: BreakEventSource;
+    /** Adjacency-weighting half-life in milliseconds. Default 24h. */
+    halfLifeMs?: number;
+    /** Diagonal-dominance margin to keep DD even under heavy noise. Default 0.5. */
+    ddSafetyMargin?: number;
+}
+/**
+ * Identifier convention so consumers can address per-origin graphs:
+ *   `browser:causal:<origin>` — e.g. `browser:causal:https://example.com`
+ */
+export declare function browserCausalGraphId(origin: string): string;
+export declare class BrowserCausalAdapter implements SublinearAdapter {
+    readonly graphId: string;
+    readonly ownerPlugin = "@claude-flow/browser";
+    private readonly origin;
+    private readonly source;
+    private readonly halfLifeMs;
+    private readonly ddSafetyMargin;
+    constructor(options: BrowserCausalAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        since?: string;
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+    readonly requiresPreprocessing = false;
+}
+/**
+ * Convenience entry point — instantiate + register in one call.
+ *
+ * Intended to be invoked from @claude-flow/browser's init code:
+ *   import { registerBrowserCausalAdapter } from 'ruflo-graph-intelligence/adapters';
+ *   registerBrowserCausalAdapter({ origin: 'https://example.com', source: causalService });
+ */
+export declare function registerBrowserCausalAdapter(options: BrowserCausalAdapterOptions & {
+    registry?: import('../domain/adapter.js').AdapterRegistry;
+}): BrowserCausalAdapter;
+//# sourceMappingURL=browser-causal-adapter.d.ts.map

package/dist/adapters/browser-causal-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-causal-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/browser-causal-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;CAChE;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,0BAA0B;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,2BAA2B;IAQ1C,oBAAoB,CAAC,OAAO,CAAC,EAAE;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KAClC,GAAG,OAAO,CAAC,YAAY,CAAC;IA6DzB,QAAQ,CAAC,qBAAqB,SAAS;CACxC;AAwBD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,2BAA2B,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,sBAAsB,EAAE,eAAe,CAAA;CAAE,GACnG,oBAAoB,CAUtB"}

package/dist/adapters/browser-causal-adapter.js

@@ -0,0 +1,146 @@
+/**
+ * Browser Causal-Recovery Adapter (Wedge 1, ADR-123 Phase 2)
+ *
+ * Exports the ADR-122 Phase 2 selector-break events as a SparseMatrix so
+ * `sublinear/page-rank-entry` can score a single element-ref's causal
+ * brittleness in O(log N) instead of the current O(N) `breakCount / attempts`
+ * ratio.
+ *
+ * The matrix `M` is built per-origin: rows + columns are union of
+ *   - all element-refs that have ever appeared
+ *   - all selector strings that have ever been retried
+ * Off-diagonal entry M[i,j] = number of times row-event preceded column-event
+ * on the same DOM mutation lineage (weight ≥ 1). Diagonal entry M[i,i] = 1 + Σ
+ * |off-diagonals on row i|, so the matrix is strictly diagonally-dominant.
+ *
+ * The adapter is **dependency-injection-friendly**: callers pass a
+ * `BreakEventSource` (a structural type matching the slice of ADR-122's
+ * CausalRecoveryService surface we actually need) so this plugin does NOT
+ * hard-import @claude-flow/browser. Phase 2 of *this* plugin ships the
+ * adapter; the browser package only needs to call `registerBrowserCausalAdapter()`
+ * at its plugin-init time.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Identifier convention so consumers can address per-origin graphs:
+ *   `browser:causal:<origin>` — e.g. `browser:causal:https://example.com`
+ */
+export function browserCausalGraphId(origin) {
+    return `browser:causal:${origin}`;
+}
+export class BrowserCausalAdapter {
+    graphId;
+    ownerPlugin = '@claude-flow/browser';
+    origin;
+    source;
+    halfLifeMs;
+    ddSafetyMargin;
+    constructor(options) {
+        this.origin = options.origin;
+        this.source = options.source;
+        this.halfLifeMs = options.halfLifeMs ?? 24 * 60 * 60 * 1000;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.5;
+        this.graphId = browserCausalGraphId(this.origin);
+    }
+    async exportAsSparseMatrix(options) {
+        const events = await this.source.listBreaks(this.origin);
+        const cutoff = options?.since ? Date.parse(options.since) : -Infinity;
+        const filtered = events.filter((e) => Date.parse(e.timestamp) >= cutoff);
+        // Node set: union of selectors + (role:name) fuzzy keys
+        const nodeIds = new Set();
+        for (const e of filtered) {
+            nodeIds.add(e.selector);
+            if (e.lastKnownRole && e.lastKnownName) {
+                nodeIds.add(`role:${e.lastKnownRole}:${e.lastKnownName}`);
+            }
+        }
+        if (options?.nodeFilter) {
+            for (const n of [...nodeIds])
+                if (!options.nodeFilter.has(n))
+                    nodeIds.delete(n);
+        }
+        const nodes = [...nodeIds].sort();
+        const nodeIndex = {};
+        nodes.forEach((n, i) => (nodeIndex[n] = i));
+        // Build adjacency: row = source event's selector, col = "next" event's selector
+        // within the same chronological neighbourhood. Time-decayed weight.
+        const weights = new Map(); // key = "row:col"
+        const now = Date.now();
+        for (let i = 0; i < filtered.length - 1; i++) {
+            const a = filtered[i];
+            const b = filtered[i + 1];
+            const decay = Math.exp(-(now - Date.parse(a.timestamp)) / this.halfLifeMs);
+            const keys = pairKeys(a, b);
+            for (const k of keys)
+                weights.set(k, (weights.get(k) ?? 0) + decay);
+        }
+        // Emit off-diagonal entries, then add a diagonal that guarantees DD.
+        const entries = [];
+        const rowSums = new Array(nodes.length).fill(0);
+        for (const [key, w] of weights) {
+            const [from, to] = key.split('::');
+            const rIdx = nodeIndex[from];
+            const cIdx = nodeIndex[to];
+            if (rIdx === undefined || cIdx === undefined)
+                continue;
+            if (rIdx === cIdx)
+                continue;
+            entries.push({ row: rIdx, col: cIdx, value: w });
+            rowSums[rIdx] += Math.abs(w);
+        }
+        for (let i = 0; i < nodes.length; i++) {
+            const diag = rowSums[i] + this.ddSafetyMargin;
+            entries.push({ row: i, col: i, value: Math.max(1, diag) });
+        }
+        return {
+            graphId: this.graphId,
+            size: nodes.length,
+            entries,
+            nodeIndex,
+            indexNode: nodes,
+            capturedAt: new Date().toISOString(),
+            contentHash: hashContent(this.graphId, entries),
+        };
+    }
+    requiresPreprocessing = false;
+}
+function pairKeys(a, b) {
+    const keys = [`${a.selector}::${b.selector}`];
+    if (a.lastKnownRole && a.lastKnownName) {
+        const key = `role:${a.lastKnownRole}:${a.lastKnownName}`;
+        keys.push(`${key}::${b.selector}`);
+    }
+    if (b.lastKnownRole && b.lastKnownName) {
+        const key = `role:${b.lastKnownRole}:${b.lastKnownName}`;
+        keys.push(`${a.selector}::${key}`);
+    }
+    return keys;
+}
+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');
+}
+/**
+ * Convenience entry point — instantiate + register in one call.
+ *
+ * Intended to be invoked from @claude-flow/browser's init code:
+ *   import { registerBrowserCausalAdapter } from 'ruflo-graph-intelligence/adapters';
+ *   registerBrowserCausalAdapter({ origin: 'https://example.com', source: causalService });
+ */
+export function registerBrowserCausalAdapter(options) {
+    const adapter = new BrowserCausalAdapter(options);
+    const registry = options.registry ?? import('../domain/adapter.js').then((m) => m.getRegistry());
+    // Synchronous registration when registry is supplied; lazy fallback otherwise.
+    if (typeof registry.register === 'function') {
+        registry.register(adapter);
+    }
+    else {
+        registry.then((r) => r.register(adapter));
+    }
+    return adapter;
+}
+//# sourceMappingURL=browser-causal-adapter.js.map

package/dist/adapters/browser-causal-adapter.js.map

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

package/dist/adapters/cost-attribution-adapter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cost Attribution Adapter (Wedge 6, ADR-123 Phase 3)
+ *
+ * `ruflo-cost-tracker` records token usage per session in a causation graph:
+ *   user-prompt → spawned-agent → MCP-call → model-invocation → tokens-USD
+ *
+ * This adapter exports that graph so `sublinear/page-rank-entry` answers
+ * "which root prompt caused the most downstream spend" in O(log traces)
+ * rather than O(traces) walks. Costs are one-way edges → asymmetric matrix.
+ */
+import type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface CostCausationEdge {
+    /** Parent node — typically a prompt id or upstream agent id. */
+    parentId: string;
+    /** Child node — typically a spawned agent / MCP call / model invocation id. */
+    childId: string;
+    /** USD cost attributed to the child as caused by this parent. */
+    costUsd: number;
+}
+export interface CostCausationSource {
+    /** All causation edges for a session (or globally). */
+    listCausationEdges(sessionId?: string): Promise<readonly CostCausationEdge[]>;
+}
+export interface CostAttributionAdapterOptions {
+    source: CostCausationSource;
+    /** Restrict to a specific session id. */
+    sessionId?: string;
+    /** DD safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare function costAttributionGraphId(sessionId?: string): string;
+export declare class CostAttributionAdapter implements SublinearAdapter {
+    readonly graphId: string;
+    readonly ownerPlugin = "ruflo-cost-tracker";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly sessionId?;
+    private readonly ddSafetyMargin;
+    constructor(options: CostAttributionAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerCostAttributionAdapter(options: CostAttributionAdapterOptions & {
+    registry?: AdapterRegistry;
+}): CostAttributionAdapter;
+//# sourceMappingURL=cost-attribution-adapter.d.ts.map

package/dist/adapters/cost-attribution-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-attribution-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/cost-attribution-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,6BAA6B;IAO5C,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAiDlG;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,6BAA6B,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACtE,sBAAsB,CAIxB"}

package/dist/adapters/cost-attribution-adapter.js

@@ -0,0 +1,95 @@
+/**
+ * Cost Attribution Adapter (Wedge 6, ADR-123 Phase 3)
+ *
+ * `ruflo-cost-tracker` records token usage per session in a causation graph:
+ *   user-prompt → spawned-agent → MCP-call → model-invocation → tokens-USD
+ *
+ * This adapter exports that graph so `sublinear/page-rank-entry` answers
+ * "which root prompt caused the most downstream spend" in O(log traces)
+ * rather than O(traces) walks. Costs are one-way edges → asymmetric matrix.
+ */
+import { createHash } from 'node:crypto';
+import { getRegistry } from '../domain/adapter.js';
+export function costAttributionGraphId(sessionId) {
+    return sessionId ? `ruflo-cost-tracker:causation:${sessionId}` : 'ruflo-cost-tracker:causation:global';
+}
+export class CostAttributionAdapter {
+    graphId;
+    ownerPlugin = 'ruflo-cost-tracker';
+    requiresPreprocessing = false;
+    source;
+    sessionId;
+    ddSafetyMargin;
+    constructor(options) {
+        this.source = options.source;
+        this.sessionId = options.sessionId;
+        this.ddSafetyMargin = options.ddSafetyMargin ?? 0.25;
+        this.graphId = costAttributionGraphId(this.sessionId);
+    }
+    async exportAsSparseMatrix(options) {
+        const edges = await this.source.listCausationEdges(this.sessionId);
+        const nodeSet = new Set();
+        for (const e of edges) {
+            nodeSet.add(e.parentId);
+            nodeSet.add(e.childId);
+        }
+        if (options?.nodeFilter) {
+            for (const n of [...nodeSet])
+                if (!options.nodeFilter.has(n))
+                    nodeSet.delete(n);
+        }
+        const nodes = [...nodeSet].sort();
+        const nodeIndex = {};
+        nodes.forEach((n, i) => (nodeIndex[n] = i));
+        // Normalise costs into [0, 1] per row so PageRank semantics make sense
+        // (we're after the *share of blame*, not the raw dollar amount).
+        const rawRowSums = new Array(nodes.length).fill(0);
+        for (const e of edges) {
+            const r = nodeIndex[e.parentId];
+            if (r === undefined)
+                continue;
+            rawRowSums[r] += Math.max(0, e.costUsd);
+        }
+        const entries = [];
+        const rowSums = new Array(nodes.length).fill(0);
+        for (const e of edges) {
+            const r = nodeIndex[e.parentId];
+            const c = nodeIndex[e.childId];
+            if (r === undefined || c === undefined || r === c)
+                continue;
+            const denom = rawRowSums[r];
+            if (denom === 0)
+                continue;
+            const w = Math.max(0, e.costUsd) / denom;
+            if (w === 0)
+                continue;
+            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 registerCostAttributionAdapter(options) {
+    const adapter = new CostAttributionAdapter(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=cost-attribution-adapter.js.map

package/dist/adapters/cost-attribution-adapter.js.map

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

package/dist/adapters/federation-trust-adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 type { SparseMatrix } from '../domain/types.js';
+import type { SublinearAdapter, AdapterRegistry } from '../domain/adapter.js';
+export interface PeerTrustEdge {
+    /** Peer the trust comes from. */
+    fromPeer: string;
+    /** Peer the trust is directed at. */
+    toPeer: string;
+    /** Confidence in [0, 1] — typically derived from signed-message hit rate. */
+    confidence: number;
+    /** When the edge was last updated. */
+    updatedAt: string;
+}
+export interface PeerTrustSource {
+    /** All trust edges currently in the local view of the mesh. */
+    listTrustEdges(): Promise<readonly PeerTrustEdge[]>;
+}
+export interface FederationTrustAdapterOptions {
+    source: PeerTrustSource;
+    /** Edge-staleness cutoff in milliseconds. Default 7 days. */
+    freshnessMs?: number;
+    /** Diagonal-dominance safety margin. Default 0.25. */
+    ddSafetyMargin?: number;
+}
+export declare const FEDERATION_TRUST_GRAPH_ID = "ruflo-federation:trust-mesh";
+export declare class FederationTrustAdapter implements SublinearAdapter {
+    readonly graphId = "ruflo-federation:trust-mesh";
+    readonly ownerPlugin = "ruflo-federation";
+    readonly requiresPreprocessing = false;
+    private readonly source;
+    private readonly freshnessMs;
+    private readonly ddSafetyMargin;
+    constructor(options: FederationTrustAdapterOptions);
+    exportAsSparseMatrix(options?: {
+        nodeFilter?: ReadonlySet<string>;
+    }): Promise<SparseMatrix>;
+}
+export declare function registerFederationTrustAdapter(options: FederationTrustAdapterOptions & {
+    registry?: AdapterRegistry;
+}): FederationTrustAdapter;
+//# sourceMappingURL=federation-trust-adapter.d.ts.map

package/dist/adapters/federation-trust-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-trust-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/federation-trust-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,cAAc,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,OAAO,iCAA6B;IAC7C,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,qBAAqB,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,6BAA6B;IAM5C,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CA4ClG;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,6BAA6B,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACtE,sBAAsB,CAIxB"}