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

package/dist/index.js

@@ -0,0 +1,149 @@
+/**
+ * Legal Contracts Plugin for Claude Flow V3
+ *
+ * A comprehensive legal contract analysis plugin combining hyperbolic embeddings
+ * for legal ontology navigation with fast vector search for clause similarity.
+ *
+ * Features:
+ * - Clause extraction and classification
+ * - Risk assessment with severity scoring
+ * - Contract comparison with attention-based alignment
+ * - Obligation tracking with DAG analysis
+ * - Playbook matching for negotiation support
+ *
+ * Based on ADR-034: Legal Contract Analysis Plugin
+ *
+ * @module @claude-flow/plugin-legal-contracts
+ */
+// Export types
+export * from './types.js';
+// Export bridges
+export { AttentionBridge, createAttentionBridge } from './bridges/attention-bridge.js';
+export { DAGBridge, createDAGBridge } from './bridges/dag-bridge.js';
+// Export MCP tools
+export { clauseExtractTool, riskAssessTool, contractCompareTool, obligationTrackTool, playbookMatchTool, legalContractsTools, toolHandlers, createToolContext, } from './mcp-tools.js';
+// Import for plugin creation
+import { legalContractsTools } from './mcp-tools.js';
+import { createAttentionBridge } from './bridges/attention-bridge.js';
+import { createDAGBridge } from './bridges/dag-bridge.js';
+import { DEFAULT_CONFIG } from './types.js';
+/**
+ * Plugin metadata
+ */
+export const pluginMetadata = {
+    name: '@claude-flow/plugin-legal-contracts',
+    version: '3.0.0-alpha.1',
+    description: 'Legal contract analysis plugin for clause extraction, risk assessment, and comparison',
+    author: 'Claude Flow Team',
+    category: 'legal',
+    keywords: ['legal', 'contracts', 'clause', 'risk', 'compliance'],
+    homepage: 'https://github.com/ruvnet/claude-flow',
+    repository: 'https://github.com/ruvnet/claude-flow.git',
+};
+/**
+ * Legal Contracts Plugin Class
+ */
+export class LegalContractsPlugin {
+    state = 'uninitialized';
+    config;
+    attentionBridge = null;
+    dagBridge = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Get plugin metadata
+     */
+    getMetadata() {
+        return pluginMetadata;
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Initialize the plugin
+     */
+    async initialize() {
+        if (this.state === 'ready')
+            return;
+        this.state = 'initializing';
+        try {
+            // Initialize WASM bridges
+            this.attentionBridge = createAttentionBridge(this.config.extraction.embeddingDimension);
+            this.dagBridge = createDAGBridge();
+            await Promise.all([
+                this.attentionBridge.initialize(),
+                this.dagBridge.initialize(),
+            ]);
+            this.state = 'ready';
+        }
+        catch (error) {
+            this.state = 'error';
+            throw error;
+        }
+    }
+    /**
+     * Shutdown the plugin
+     */
+    async shutdown() {
+        this.state = 'shutdown';
+        this.attentionBridge = null;
+        this.dagBridge = null;
+    }
+    /**
+     * Get MCP tools provided by this plugin
+     */
+    getMCPTools() {
+        return legalContractsTools;
+    }
+    /**
+     * Get tool context for execution
+     */
+    getToolContext() {
+        if (!this.attentionBridge || !this.dagBridge) {
+            throw new Error('Plugin not initialized');
+        }
+        const store = new Map();
+        return {
+            get: (key) => store.get(key),
+            set: (key, value) => { store.set(key, value); },
+            bridges: {
+                attention: this.attentionBridge,
+                dag: this.dagBridge,
+            },
+        };
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = {
+            ...this.config,
+            ...config,
+            extraction: { ...this.config.extraction, ...config.extraction },
+            risk: { ...this.config.risk, ...config.risk },
+            comparison: { ...this.config.comparison, ...config.comparison },
+            security: { ...this.config.security, ...config.security },
+        };
+    }
+}
+/**
+ * Create plugin instance
+ */
+export function createPlugin(config) {
+    return new LegalContractsPlugin(config);
+}
+/**
+ * Default export
+ */
+export default LegalContractsPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp-tools.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Legal Contracts Plugin - MCP Tools
+ *
+ * Implements 5 MCP tools for legal contract analysis:
+ * 1. legal/clause-extract - Extract and classify clauses
+ * 2. legal/risk-assess - Identify and score contractual risks
+ * 3. legal/contract-compare - Compare contracts with attention-based alignment
+ * 4. legal/obligation-track - Extract obligations with DAG analysis
+ * 5. legal/playbook-match - Match clauses against negotiation playbook
+ *
+ * Based on ADR-034: Legal Contract Analysis Plugin
+ *
+ * @module v3/plugins/legal-contracts/mcp-tools
+ */
+import { z } from 'zod';
+import type { ClauseExtractionResult, RiskAssessmentResult, ContractComparisonResult, ObligationTrackingResult, PlaybookMatchResult, IAttentionBridge, IDAGBridge } from './types.js';
+import { ClauseExtractInputSchema, RiskAssessInputSchema, ContractCompareInputSchema, ObligationTrackInputSchema, PlaybookMatchInputSchema } from './types.js';
+/**
+ * MCP Tool definition
+ */
+export interface MCPTool<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    category: string;
+    version: string;
+    inputSchema: z.ZodType<TInput, z.ZodTypeDef, any>;
+    handler: (input: TInput, context: ToolContext) => Promise<MCPToolResult<TOutput>>;
+}
+/**
+ * Tool execution context
+ */
+export interface ToolContext {
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T): void;
+    bridges: {
+        attention: IAttentionBridge;
+        dag: IDAGBridge;
+    };
+}
+/**
+ * MCP Tool result format
+ */
+export interface MCPToolResult<T = unknown> {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    data?: T;
+}
+/**
+ * MCP Tool: legal/clause-extract
+ *
+ * Extract and classify clauses from legal documents
+ */
+export declare const clauseExtractTool: MCPTool<z.infer<typeof ClauseExtractInputSchema>, ClauseExtractionResult>;
+/**
+ * MCP Tool: legal/risk-assess
+ *
+ * Assess contractual risks with severity scoring
+ */
+export declare const riskAssessTool: MCPTool<z.infer<typeof RiskAssessInputSchema>, RiskAssessmentResult>;
+/**
+ * MCP Tool: legal/contract-compare
+ *
+ * Compare two contracts with detailed diff and semantic alignment
+ */
+export declare const contractCompareTool: MCPTool<z.infer<typeof ContractCompareInputSchema>, ContractComparisonResult>;
+/**
+ * MCP Tool: legal/obligation-track
+ *
+ * Extract obligations, deadlines, and dependencies using DAG analysis
+ */
+export declare const obligationTrackTool: MCPTool<z.infer<typeof ObligationTrackInputSchema>, ObligationTrackingResult>;
+/**
+ * MCP Tool: legal/playbook-match
+ *
+ * Compare contract clauses against negotiation playbook
+ */
+export declare const playbookMatchTool: MCPTool<z.infer<typeof PlaybookMatchInputSchema>, PlaybookMatchResult>;
+/**
+ * All Legal Contracts MCP Tools
+ */
+export declare const legalContractsTools: MCPTool[];
+/**
+ * Tool name to handler map
+ */
+export declare const toolHandlers: Map<string, (input: unknown, context: ToolContext) => Promise<MCPToolResult<unknown>>>;
+/**
+ * Create tool context with bridges
+ */
+export declare function createToolContext(): ToolContext;
+export default legalContractsTools;
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EAMnB,gBAAgB,EAChB,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EAIzB,MAAM,YAAY,CAAC;AAQpB;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE;QACP,SAAS,EAAE,gBAAgB,CAAC;QAC5B,GAAG,EAAE,UAAU,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAMD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CACrC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EACxC,sBAAsB,CA4DvB,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAClC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,EACrC,oBAAoB,CAmErB,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAC1C,wBAAwB,CA8EzB,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAC1C,wBAAwB,CAmFzB,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CACrC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EACxC,mBAAmB,CAkFpB,CAAC;AA6qBF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAMxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,wCAnoCW,WAAW,qCAyoC7C,CAAC;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAW/C;AAED,eAAe,mBAAmB,CAAC"}