@claude-flow/plugin-legal-contracts 3.0.0-alpha.1

package/dist/bridges/attention-bridge.js

@@ -0,0 +1,348 @@
+/**
+ * Flash Attention Bridge for Legal Contract Analysis
+ *
+ * Provides cross-attention computation for clause alignment and similarity
+ * using ruvector-attention-wasm for high-performance attention operations.
+ *
+ * Features:
+ * - Cross-attention for contract comparison
+ * - Clause alignment between documents
+ * - Semantic similarity scoring
+ * - Memory-efficient attention patterns
+ *
+ * Based on ADR-034: Legal Contract Analysis Plugin
+ *
+ * @module v3/plugins/legal-contracts/bridges/attention-bridge
+ */
+/**
+ * Flash Attention Bridge Implementation
+ */
+export class AttentionBridge {
+    wasmModule = null;
+    initialized = false;
+    embeddingDim;
+    constructor(embeddingDim = 384) {
+        this.embeddingDim = embeddingDim;
+    }
+    /**
+     * Initialize the WASM module
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Dynamic import of WASM module
+            // In production, this would load from @claude-flow/ruvector-upstream
+            const wasmModule = await this.loadWasmModule();
+            this.wasmModule = wasmModule;
+            this.initialized = true;
+        }
+        catch (error) {
+            // Fallback to pure JS implementation if WASM not available
+            console.warn('WASM attention module not available, using JS fallback');
+            this.wasmModule = null;
+            this.initialized = true;
+        }
+    }
+    /**
+     * Check if initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Compute cross-attention between clause embeddings
+     */
+    async computeCrossAttention(queryEmbeddings, keyEmbeddings, mask) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        const queryLen = queryEmbeddings.length;
+        const keyLen = keyEmbeddings.length;
+        if (queryLen === 0 || keyLen === 0) {
+            return [];
+        }
+        // Flatten embeddings for WASM
+        const dim = queryEmbeddings[0]?.length ?? this.embeddingDim;
+        const flatQuery = this.flattenEmbeddings(queryEmbeddings, dim);
+        const flatKey = this.flattenEmbeddings(keyEmbeddings, dim);
+        // Create mask if provided
+        let maskArray = null;
+        if (mask) {
+            maskArray = new Uint8Array(queryLen * keyLen);
+            for (let i = 0; i < queryLen; i++) {
+                for (let j = 0; j < keyLen; j++) {
+                    maskArray[i * keyLen + j] = mask[i]?.[j] ? 1 : 0;
+                }
+            }
+        }
+        // Compute attention scores
+        let scores;
+        if (this.wasmModule) {
+            scores = this.wasmModule.attention_scores(flatQuery, flatKey, queryLen, keyLen, dim);
+        }
+        else {
+            scores = this.computeAttentionScoresJS(flatQuery, flatKey, queryLen, keyLen, dim);
+        }
+        // Apply mask if provided
+        if (maskArray) {
+            for (let i = 0; i < scores.length; i++) {
+                if (maskArray[i] === 0) {
+                    scores[i] = -Infinity;
+                }
+            }
+        }
+        // Apply softmax row-wise
+        const result = [];
+        for (let i = 0; i < queryLen; i++) {
+            const row = [];
+            const rowStart = i * keyLen;
+            const rowEnd = rowStart + keyLen;
+            const rowScores = scores.slice(rowStart, rowEnd);
+            const softmaxed = this.softmax(rowScores);
+            for (let j = 0; j < keyLen; j++) {
+                row.push(new Float32Array([softmaxed[j] ?? 0]));
+            }
+            result.push(row);
+        }
+        return result;
+    }
+    /**
+     * Align clauses between two documents using attention
+     */
+    async alignClauses(baseClauses, compareClauses) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        if (baseClauses.length === 0 || compareClauses.length === 0) {
+            return [];
+        }
+        // Get or compute embeddings
+        const baseEmbeddings = await this.getOrComputeEmbeddings(baseClauses);
+        const compareEmbeddings = await this.getOrComputeEmbeddings(compareClauses);
+        // Compute similarity matrix using attention
+        const similarities = await this.computeCrossAttention(baseEmbeddings, compareEmbeddings);
+        // Create alignments based on similarity scores
+        const alignments = [];
+        const usedCompare = new Set();
+        // For each base clause, find best matching compare clause
+        for (let i = 0; i < baseClauses.length; i++) {
+            const baseClause = baseClauses[i];
+            if (!baseClause)
+                continue;
+            const row = similarities[i];
+            if (!row)
+                continue;
+            // Find best match not already used
+            let bestJ = -1;
+            let bestScore = 0;
+            for (let j = 0; j < compareClauses.length; j++) {
+                if (usedCompare.has(j))
+                    continue;
+                const score = row[j]?.[0] ?? 0;
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestJ = j;
+                }
+            }
+            const compareClause = bestJ >= 0 ? compareClauses[bestJ] : undefined;
+            // Determine alignment type based on score
+            let alignmentType;
+            if (bestScore > 0.95) {
+                alignmentType = 'exact';
+            }
+            else if (bestScore > 0.8) {
+                alignmentType = 'similar';
+            }
+            else if (bestScore > 0.5) {
+                alignmentType = 'related';
+            }
+            else {
+                alignmentType = 'no_match';
+            }
+            const differences = this.computeDifferences(baseClause, compareClause);
+            alignments.push({
+                baseClauseId: baseClause.id,
+                compareClauseId: compareClause?.id ?? '',
+                similarity: bestScore,
+                alignmentType,
+                differences,
+            });
+            if (bestJ >= 0) {
+                usedCompare.add(bestJ);
+            }
+        }
+        return alignments;
+    }
+    /**
+     * Find most relevant clauses for a given query
+     */
+    async findRelevantClauses(query, clauses, topK) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        if (clauses.length === 0) {
+            return [];
+        }
+        // Convert query to embedding if string
+        const queryEmbedding = typeof query === 'string'
+            ? await this.embedText(query)
+            : query;
+        // Get clause embeddings
+        const clauseEmbeddings = await this.getOrComputeEmbeddings(clauses);
+        // Compute similarities
+        const similarities = await this.computeCrossAttention([queryEmbedding], clauseEmbeddings);
+        const scores = similarities[0] ?? [];
+        // Create scored results
+        const scoredClauses = clauses.map((clause, i) => ({
+            clause,
+            score: scores[i]?.[0] ?? 0,
+        }));
+        // Sort by score and take top K
+        scoredClauses.sort((a, b) => b.score - a.score);
+        return scoredClauses.slice(0, topK);
+    }
+    // ============================================================================
+    // Private Helper Methods
+    // ============================================================================
+    /**
+     * Load WASM module dynamically
+     */
+    async loadWasmModule() {
+        // In production, this would load from @claude-flow/ruvector-upstream
+        // For now, throw to trigger JS fallback
+        throw new Error('WASM module loading not implemented');
+    }
+    /**
+     * Flatten array of embeddings into single Float32Array
+     */
+    flattenEmbeddings(embeddings, dim) {
+        const flat = new Float32Array(embeddings.length * dim);
+        for (let i = 0; i < embeddings.length; i++) {
+            const emb = embeddings[i];
+            if (emb) {
+                flat.set(emb.slice(0, dim), i * dim);
+            }
+        }
+        return flat;
+    }
+    /**
+     * Compute attention scores in pure JavaScript (fallback)
+     */
+    computeAttentionScoresJS(query, key, queryLen, keyLen, dim) {
+        const scores = new Float32Array(queryLen * keyLen);
+        const scale = 1 / Math.sqrt(dim);
+        for (let i = 0; i < queryLen; i++) {
+            for (let j = 0; j < keyLen; j++) {
+                let dot = 0;
+                for (let k = 0; k < dim; k++) {
+                    const qVal = query[i * dim + k] ?? 0;
+                    const kVal = key[j * dim + k] ?? 0;
+                    dot += qVal * kVal;
+                }
+                scores[i * keyLen + j] = dot * scale;
+            }
+        }
+        return scores;
+    }
+    /**
+     * Compute softmax over array
+     */
+    softmax(arr) {
+        const max = Math.max(...arr);
+        const exps = new Float32Array(arr.length);
+        let sum = 0;
+        for (let i = 0; i < arr.length; i++) {
+            const val = arr[i] ?? 0;
+            const exp = Math.exp(val - max);
+            exps[i] = exp;
+            sum += exp;
+        }
+        for (let i = 0; i < exps.length; i++) {
+            exps[i] = (exps[i] ?? 0) / sum;
+        }
+        return exps;
+    }
+    /**
+     * Get embeddings from clauses or compute them
+     */
+    async getOrComputeEmbeddings(clauses) {
+        const embeddings = [];
+        for (const clause of clauses) {
+            if (clause.embedding) {
+                embeddings.push(clause.embedding);
+            }
+            else {
+                // Compute embedding from text
+                const embedding = await this.embedText(clause.text);
+                embeddings.push(embedding);
+            }
+        }
+        return embeddings;
+    }
+    /**
+     * Embed text to vector (placeholder - would use embedding model)
+     */
+    async embedText(text) {
+        // In production, this would use an embedding model
+        // For now, create a simple hash-based embedding
+        const embedding = new Float32Array(this.embeddingDim);
+        // Simple hash-based embedding (placeholder)
+        for (let i = 0; i < text.length && i < this.embeddingDim; i++) {
+            const charCode = text.charCodeAt(i);
+            const idx = i % this.embeddingDim;
+            embedding[idx] = (embedding[idx] ?? 0) + charCode / 1000;
+        }
+        // Normalize
+        let norm = 0;
+        for (let i = 0; i < embedding.length; i++) {
+            norm += (embedding[i] ?? 0) * (embedding[i] ?? 0);
+        }
+        norm = Math.sqrt(norm);
+        if (norm > 0) {
+            for (let i = 0; i < embedding.length; i++) {
+                embedding[i] = (embedding[i] ?? 0) / norm;
+            }
+        }
+        return embedding;
+    }
+    /**
+     * Compute differences between two clauses
+     */
+    computeDifferences(baseClause, compareClause) {
+        const differences = [];
+        if (compareClause === undefined) {
+            differences.push('No matching clause found in comparison document');
+            return differences;
+        }
+        // Type difference
+        if (baseClause.type !== compareClause.type) {
+            differences.push(`Type changed: ${baseClause.type} -> ${compareClause.type}`);
+        }
+        // Length difference
+        const lengthDiff = Math.abs(baseClause.text.length - compareClause.text.length);
+        if (lengthDiff > 100) {
+            differences.push(`Significant length difference: ${lengthDiff} characters`);
+        }
+        // Key terms difference
+        const baseTerms = new Set(baseClause.keyTerms);
+        const compareTerms = new Set(compareClause.keyTerms);
+        const addedTerms = [...compareTerms].filter(t => !baseTerms.has(t));
+        const removedTerms = [...baseTerms].filter(t => !compareTerms.has(t));
+        if (addedTerms.length > 0) {
+            differences.push(`Added terms: ${addedTerms.join(', ')}`);
+        }
+        if (removedTerms.length > 0) {
+            differences.push(`Removed terms: ${removedTerms.join(', ')}`);
+        }
+        return differences;
+    }
+}
+/**
+ * Create and export default bridge instance
+ */
+export function createAttentionBridge(embeddingDim = 384) {
+    return new AttentionBridge(embeddingDim);
+}
+export default AttentionBridge;
+//# sourceMappingURL=attention-bridge.js.map

package/dist/bridges/attention-bridge.js.map

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

package/dist/bridges/dag-bridge.d.ts

@@ -0,0 +1,75 @@
+/**
+ * DAG Bridge for Obligation Tracking
+ *
+ * Provides directed acyclic graph operations for obligation dependency
+ * tracking using ruvector-dag-wasm for high-performance graph algorithms.
+ *
+ * Features:
+ * - Obligation dependency graph construction
+ * - Critical path analysis
+ * - Topological sorting
+ * - Cycle detection
+ * - Float/slack calculation
+ *
+ * Based on ADR-034: Legal Contract Analysis Plugin
+ *
+ * @module v3/plugins/legal-contracts/bridges/dag-bridge
+ */
+import type { IDAGBridge, Obligation, ObligationTrackingResult } from '../types.js';
+/**
+ * DAG Bridge Implementation
+ */
+export declare class DAGBridge implements IDAGBridge {
+    private wasmModule;
+    private initialized;
+    /**
+     * Initialize the WASM module
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Build obligation dependency graph
+     */
+    buildDependencyGraph(obligations: Obligation[]): Promise<ObligationTrackingResult['graph']>;
+    /**
+     * Find critical path through obligations
+     */
+    findCriticalPath(graph: ObligationTrackingResult['graph']): Promise<string[]>;
+    /**
+     * Perform topological sort of obligations
+     */
+    topologicalSort(obligations: Obligation[]): Promise<Obligation[]>;
+    /**
+     * Detect cycles in dependency graph
+     */
+    detectCycles(graph: ObligationTrackingResult['graph']): Promise<string[][]>;
+    /**
+     * Calculate slack/float for each obligation
+     */
+    calculateFloat(graph: ObligationTrackingResult['graph'], projectEnd: Date): Promise<Map<string, number>>;
+    /**
+     * Load WASM module dynamically
+     */
+    private loadWasmModule;
+    /**
+     * Find critical path internally
+     */
+    private findCriticalPathInternal;
+    /**
+     * Calculate schedule (earliest start, latest finish, float)
+     */
+    private calculateSchedule;
+    /**
+     * Estimate duration in days for an obligation
+     */
+    private estimateDuration;
+}
+/**
+ * Create and export default bridge instance
+ */
+export declare function createDAGBridge(): IDAGBridge;
+export default DAGBridge;
+//# sourceMappingURL=dag-bridge.d.ts.map

package/dist/bridges/dag-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-bridge.d.ts","sourceRoot":"","sources":["../../src/bridges/dag-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,wBAAwB,EAEzB,MAAM,aAAa,CAAC;AAyCrB;;GAEG;AACH,qBAAa,SAAU,YAAW,UAAU;IAE1C,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,oBAAoB,CACxB,WAAW,EAAE,UAAU,EAAE,GACxB,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAwE7C;;OAEG;IACG,gBAAgB,CACpB,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC;IAyBpB;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkEvE;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACvC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IA+DtB;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,EACxC,UAAU,EAAE,IAAI,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyB/B;;OAEG;YACW,cAAc;IAM5B;;OAEG;YACW,wBAAwB;IAyEtC;;OAEG;YACW,iBAAiB;IAyF/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoBzB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,eAAe,SAAS,CAAC"}