@cloudpftc/opencode-orchestrator 3.5.15

package/v3/@claude-flow/guidance/dist/wasm-kernel.js

@@ -0,0 +1,158 @@
+/**
+ * WASM Kernel Host Bridge
+ *
+ * Layer B: Node host runtime that calls into the Rust WASM kernel (Layer A).
+ * All WASM calls go through this bridge. If the WASM module fails to load,
+ * the bridge transparently falls back to the JavaScript implementations.
+ *
+ * Key rule: The host calls the kernel once per event with a batch payload,
+ * not thousands of tiny calls.
+ *
+ * @module @claude-flow/guidance/wasm-kernel
+ */
+import { createHash, createHmac } from 'node:crypto';
+// ============================================================================
+// WASM Loader
+// ============================================================================
+let wasmModule = null;
+let loadAttempted = false;
+function tryLoadWasm() {
+    if (loadAttempted)
+        return wasmModule;
+    loadAttempted = true;
+    try {
+        // Dynamic require — works in Node.js, gracefully fails elsewhere
+        const path = new URL('../wasm-pkg/guidance_kernel.js', import.meta.url);
+        // Use createRequire for ESM compatibility
+        const { createRequire } = require('node:module');
+        const requireFn = createRequire(import.meta.url);
+        wasmModule = requireFn(path.pathname);
+        // Initialize kernel
+        if (wasmModule && typeof wasmModule.kernel_init === 'function') {
+            wasmModule.kernel_init();
+        }
+    }
+    catch {
+        // WASM not available — fall back to JS
+        wasmModule = null;
+    }
+    return wasmModule;
+}
+// ============================================================================
+// JS Fallback Implementations
+// ============================================================================
+function jsSha256(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+function jsHmacSha256(key, input) {
+    return createHmac('sha256', key).update(input).digest('hex');
+}
+function jsContentHash(jsonInput) {
+    try {
+        const parsed = JSON.parse(jsonInput);
+        const sorted = sortKeys(parsed);
+        return jsSha256(JSON.stringify(sorted));
+    }
+    catch {
+        return jsSha256(jsonInput);
+    }
+}
+function sortKeys(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+        sorted[key] = sortKeys(value[key]);
+    }
+    return sorted;
+}
+// ============================================================================
+// Kernel singleton
+// ============================================================================
+let kernelInstance = null;
+/**
+ * Get the WASM kernel instance. Automatically falls back to JS if WASM is
+ * unavailable. Thread-safe (single initialization).
+ */
+export function getKernel() {
+    if (kernelInstance)
+        return kernelInstance;
+    const wasm = tryLoadWasm();
+    if (wasm) {
+        kernelInstance = {
+            available: true,
+            version: wasm.kernel_init(),
+            sha256: (input) => wasm.sha256(input),
+            hmacSha256: (key, input) => wasm.hmac_sha256(key, input),
+            contentHash: (jsonInput) => wasm.content_hash(jsonInput),
+            signEnvelope: (key, envelopeJson) => wasm.sign_envelope(key, envelopeJson),
+            verifyChain: (chainJson, key) => wasm.verify_chain(chainJson, key),
+            scanSecrets: (content) => {
+                const json = wasm.scan_secrets(content);
+                try {
+                    return JSON.parse(json);
+                }
+                catch {
+                    return [];
+                }
+            },
+            detectDestructive: (command) => {
+                const result = wasm.detect_destructive(command);
+                return result === '' ? null : result;
+            },
+            batchProcess: (ops) => {
+                const json = wasm.batch_process(JSON.stringify(ops));
+                try {
+                    return JSON.parse(json);
+                }
+                catch {
+                    return [];
+                }
+            },
+        };
+    }
+    else {
+        // JS fallback — identical outputs, just slower
+        kernelInstance = {
+            available: false,
+            version: 'js-fallback',
+            sha256: jsSha256,
+            hmacSha256: jsHmacSha256,
+            contentHash: jsContentHash,
+            signEnvelope: jsHmacSha256,
+            verifyChain: () => {
+                // Chain verification requires full envelope parsing — not implemented
+                // in JS fallback because the ProofChain class already does it.
+                throw new Error('verifyChain not available in JS fallback; use ProofChain.verifyChain()');
+            },
+            scanSecrets: () => {
+                // Gate scanning in JS fallback defers to EnforcementGates class
+                throw new Error('scanSecrets not available in JS fallback; use EnforcementGates');
+            },
+            detectDestructive: () => {
+                throw new Error('detectDestructive not available in JS fallback; use EnforcementGates');
+            },
+            batchProcess: () => {
+                throw new Error('batchProcess requires WASM kernel');
+            },
+        };
+    }
+    return kernelInstance;
+}
+/**
+ * Check if the WASM kernel is available without initializing it.
+ */
+export function isWasmAvailable() {
+    return getKernel().available;
+}
+/**
+ * Reset the kernel instance (for testing).
+ */
+export function resetKernel() {
+    kernelInstance = null;
+    wasmModule = null;
+    loadAttempted = false;
+}
+//# sourceMappingURL=wasm-kernel.js.map

package/v3/@claude-flow/guidance/package.json

@@ -0,0 +1,197 @@
+{
+  "name": "@claude-flow/guidance",
+  "version": "3.0.0-alpha.1",
+  "description": "Guidance Control Plane - Compiles, retrieves, enforces, and evolves guidance rules for Claude Code sessions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./compiler": {
+      "types": "./dist/compiler.d.ts",
+      "import": "./dist/compiler.js"
+    },
+    "./retriever": {
+      "types": "./dist/retriever.d.ts",
+      "import": "./dist/retriever.js"
+    },
+    "./gates": {
+      "types": "./dist/gates.d.ts",
+      "import": "./dist/gates.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.js"
+    },
+    "./ledger": {
+      "types": "./dist/ledger.d.ts",
+      "import": "./dist/ledger.js"
+    },
+    "./optimizer": {
+      "types": "./dist/optimizer.d.ts",
+      "import": "./dist/optimizer.js"
+    },
+    "./headless": {
+      "types": "./dist/headless.d.ts",
+      "import": "./dist/headless.js"
+    },
+    "./persistence": {
+      "types": "./dist/persistence.d.ts",
+      "import": "./dist/persistence.js"
+    },
+    "./gateway": {
+      "types": "./dist/gateway.d.ts",
+      "import": "./dist/gateway.js"
+    },
+    "./manifest-validator": {
+      "types": "./dist/manifest-validator.d.ts",
+      "import": "./dist/manifest-validator.js"
+    },
+    "./proof": {
+      "types": "./dist/proof.d.ts",
+      "import": "./dist/proof.js"
+    },
+    "./memory-gate": {
+      "types": "./dist/memory-gate.d.ts",
+      "import": "./dist/memory-gate.js"
+    },
+    "./coherence": {
+      "types": "./dist/coherence.d.ts",
+      "import": "./dist/coherence.js"
+    },
+    "./artifacts": {
+      "types": "./dist/artifacts.d.ts",
+      "import": "./dist/artifacts.js"
+    },
+    "./capabilities": {
+      "types": "./dist/capabilities.d.ts",
+      "import": "./dist/capabilities.js"
+    },
+    "./evolution": {
+      "types": "./dist/evolution.d.ts",
+      "import": "./dist/evolution.js"
+    },
+    "./conformance-kit": {
+      "types": "./dist/conformance-kit.d.ts",
+      "import": "./dist/conformance-kit.js"
+    },
+    "./ruvbot-integration": {
+      "types": "./dist/ruvbot-integration.d.ts",
+      "import": "./dist/ruvbot-integration.js"
+    },
+    "./trust": {
+      "types": "./dist/trust.d.ts",
+      "import": "./dist/trust.js"
+    },
+    "./truth-anchors": {
+      "types": "./dist/truth-anchors.d.ts",
+      "import": "./dist/truth-anchors.js"
+    },
+    "./uncertainty": {
+      "types": "./dist/uncertainty.d.ts",
+      "import": "./dist/uncertainty.js"
+    },
+    "./temporal": {
+      "types": "./dist/temporal.d.ts",
+      "import": "./dist/temporal.js"
+    },
+    "./authority": {
+      "types": "./dist/authority.d.ts",
+      "import": "./dist/authority.js"
+    },
+    "./adversarial": {
+      "types": "./dist/adversarial.d.ts",
+      "import": "./dist/adversarial.js"
+    },
+    "./meta-governance": {
+      "types": "./dist/meta-governance.d.ts",
+      "import": "./dist/meta-governance.js"
+    },
+    "./continue-gate": {
+      "types": "./dist/continue-gate.d.ts",
+      "import": "./dist/continue-gate.js"
+    },
+    "./wasm-kernel": {
+      "types": "./dist/wasm-kernel.d.ts",
+      "import": "./dist/wasm-kernel.js"
+    },
+    "./generators": {
+      "types": "./dist/generators.d.ts",
+      "import": "./dist/generators.js"
+    },
+    "./analyzer": {
+      "types": "./dist/analyzer.d.ts",
+      "import": "./dist/analyzer.js"
+    }
+  },
+  "files": [
+    "dist",
+    "wasm-pkg"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@claude-flow/hooks": "^3.0.0-alpha.7",
+    "@claude-flow/memory": "^3.0.0-alpha.2",
+    "@claude-flow/shared": "^3.0.0-alpha.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "claude-flow",
+    "claude",
+    "anthropic",
+    "ai-agent",
+    "ai-governance",
+    "agent-governance",
+    "guidance",
+    "control-plane",
+    "policy-enforcement",
+    "enforcement-gates",
+    "proof-chain",
+    "trust-system",
+    "long-horizon",
+    "autonomous-agent",
+    "claude-md",
+    "CLAUDE.md",
+    "memory-governance",
+    "adversarial-defense",
+    "prompt-injection",
+    "wasm",
+    "ruvbot",
+    "ruv",
+    "ai-safety",
+    "agent-orchestration",
+    "multi-agent",
+    "code-generation",
+    "llm-governance",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "author": "Claude Flow Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/claude-flow.git",
+    "directory": "v3/@claude-flow/guidance"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "v3alpha"
+  }
+}

package/v3/@claude-flow/shared/README.md

@@ -0,0 +1,323 @@
+# @claude-flow/shared
+
+[![npm version](https://img.shields.io/npm/v/@claude-flow/shared.svg)](https://www.npmjs.com/package/@claude-flow/shared)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/shared.svg)](https://www.npmjs.com/package/@claude-flow/shared)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Core](https://img.shields.io/badge/Module-Core-blue.svg)](https://github.com/ruvnet/claude-flow)
+
+> Shared utilities, types, and core infrastructure for Claude Flow V3 - the foundation module used by all other @claude-flow packages.
+
+## Features
+
+- **Core Types** - Agent, Task, Memory, MCP, and Swarm type definitions
+- **Core Interfaces** - Agent, Task, Memory, Event, and Coordinator interfaces
+- **Configuration** - Schema validation, loading, and default values
+- **Event System** - Event bus, coordinator, and handler utilities
+- **Hooks System** - Pre/post execution hooks for extensibility
+- **MCP Infrastructure** - Server, transport, connection pool, and tool registry
+- **Health Monitoring** - Health checks and monitoring utilities
+
+## Installation
+
+```bash
+npm install @claude-flow/shared
+```
+
+## Quick Start
+
+```typescript
+import {
+  AgentState,
+  TaskDefinition,
+  MemoryEntry,
+  EventBus,
+  ConfigLoader
+} from '@claude-flow/shared';
+
+// Use shared types
+const agent: AgentState = {
+  id: { id: 'agent-1', swarmId: 'swarm-1', type: 'coder' },
+  name: 'Code Agent',
+  type: 'coder',
+  status: 'idle'
+};
+
+// Use configuration
+const config = await ConfigLoader.load('./config.json');
+
+// Use event system
+const eventBus = new EventBus();
+eventBus.on('task.completed', (event) => {
+  console.log(`Task ${event.taskId} completed`);
+});
+```
+
+## Package Exports
+
+```typescript
+// Main entry (recommended - includes all modules)
+import { ... } from '@claude-flow/shared';
+
+// Submodule exports (for tree-shaking or specific imports)
+import { ... } from '@claude-flow/shared/types';      // Type definitions
+import { ... } from '@claude-flow/shared/core';       // Config, interfaces, orchestrator
+import { ... } from '@claude-flow/shared/events';     // Event sourcing (ADR-007)
+import { ... } from '@claude-flow/shared/hooks';      // Hooks system
+import { ... } from '@claude-flow/shared/mcp';        // MCP server infrastructure
+import { ... } from '@claude-flow/shared/security';   // Security utilities
+import { ... } from '@claude-flow/shared/resilience'; // Retry, circuit breaker, rate limiter
+```
+
+## API Reference
+
+### Types
+
+```typescript
+import type {
+  // Agent types
+  AgentId,
+  AgentState,
+  AgentType,
+  AgentStatus,
+  AgentCapabilities,
+  AgentMetrics,
+
+  // Task types
+  TaskId,
+  TaskDefinition,
+  TaskType,
+  TaskStatus,
+  TaskPriority,
+
+  // Memory types
+  MemoryEntry,
+  MemoryType,
+  SearchResult,
+
+  // Swarm types
+  SwarmId,
+  SwarmStatus,
+  SwarmEvent,
+  CoordinatorConfig,
+
+  // MCP types
+  MCPTool,
+  MCPRequest,
+  MCPResponse
+} from '@claude-flow/shared/types';
+```
+
+### Core Interfaces
+
+```typescript
+import type {
+  IAgent,
+  ITask,
+  IMemory,
+  ICoordinator,
+  IEventHandler
+} from '@claude-flow/shared/core';
+
+// Agent interface
+interface IAgent {
+  getId(): AgentId;
+  getState(): AgentState;
+  execute(task: TaskDefinition): Promise<TaskResult>;
+  handleMessage(message: Message): Promise<void>;
+}
+
+// Memory interface
+interface IMemory {
+  store(entry: MemoryEntry): Promise<string>;
+  retrieve(id: string): Promise<MemoryEntry | null>;
+  search(query: SearchQuery): Promise<SearchResult[]>;
+  delete(id: string): Promise<boolean>;
+}
+
+// Coordinator interface
+interface ICoordinator {
+  initialize(): Promise<void>;
+  shutdown(): Promise<void>;
+  registerAgent(agent: IAgent): Promise<string>;
+  submitTask(task: TaskDefinition): Promise<string>;
+}
+```
+
+### Configuration
+
+```typescript
+import {
+  ConfigLoader,
+  ConfigValidator,
+  defaultConfig,
+  ConfigSchema
+} from '@claude-flow/shared/core';
+
+// Load configuration
+const config = await ConfigLoader.load('./config.json');
+const config2 = await ConfigLoader.loadFromEnv();
+
+// Validate configuration
+const errors = ConfigValidator.validate(config);
+if (errors.length > 0) {
+  console.error('Invalid config:', errors);
+}
+
+// Default configuration
+const defaults = defaultConfig();
+```
+
+### Event System
+
+```typescript
+import { EventBus, EventCoordinator } from '@claude-flow/shared/events';
+
+const eventBus = new EventBus();
+
+// Subscribe to events
+eventBus.on('agent.joined', (event) => {
+  console.log(`Agent ${event.agentId} joined`);
+});
+
+eventBus.on('task.*', (event) => {
+  console.log(`Task event: ${event.type}`);
+});
+
+// Emit events
+eventBus.emit({
+  type: 'task.completed',
+  taskId: 'task-1',
+  result: { success: true }
+});
+
+// Event coordinator for complex workflows
+const coordinator = new EventCoordinator();
+coordinator.orchestrate([
+  { event: 'step1.done', handler: () => startStep2() },
+  { event: 'step2.done', handler: () => startStep3() }
+]);
+```
+
+### Hooks System
+
+```typescript
+import { HooksManager, Hook } from '@claude-flow/shared/hooks';
+
+const hooks = new HooksManager();
+
+// Register pre-execution hook
+hooks.register('pre:task', async (context) => {
+  console.log(`Starting task: ${context.taskId}`);
+  return { ...context, startTime: Date.now() };
+});
+
+// Register post-execution hook
+hooks.register('post:task', async (context, result) => {
+  const duration = Date.now() - context.startTime;
+  console.log(`Task completed in ${duration}ms`);
+});
+
+// Execute with hooks
+const result = await hooks.execute('task', context, async (ctx) => {
+  return await runTask(ctx);
+});
+```
+
+### MCP Infrastructure
+
+```typescript
+import {
+  createMCPServer,
+  createToolRegistry,
+  createConnectionPool,
+  createSessionManager,
+  defineTool,
+  quickStart,
+} from '@claude-flow/shared/mcp';
+
+// Quick start - simplest way to create an MCP server
+const server = await quickStart({
+  transport: 'stdio',
+  name: 'My MCP Server',
+});
+
+// Tool registry
+const registry = createToolRegistry();
+registry.register(defineTool({
+  name: 'swarm_init',
+  description: 'Initialize a swarm',
+  inputSchema: { type: 'object', properties: { topology: { type: 'string' } } },
+  handler: async (params) => ({ result: 'initialized' }),
+}));
+
+// Connection pool
+const pool = createConnectionPool({
+  maxConnections: 10,
+  acquireTimeoutMs: 30000,
+});
+
+// Session manager
+const sessions = createSessionManager({ timeoutMs: 3600000 });
+const session = await sessions.create({ clientInfo: { name: 'client' } });
+```
+
+### Health Monitor
+
+```typescript
+import { HealthMonitor, HealthCheck } from '@claude-flow/shared/core';
+
+const monitor = new HealthMonitor();
+
+// Register health checks
+monitor.register('database', async () => {
+  const connected = await db.ping();
+  return { healthy: connected, latency: pingTime };
+});
+
+monitor.register('memory', async () => {
+  const usage = process.memoryUsage();
+  return { healthy: usage.heapUsed < MAX_HEAP, usage };
+});
+
+// Run health checks
+const report = await monitor.check();
+// { overall: 'healthy', checks: { database: {...}, memory: {...} } }
+```
+
+## TypeScript Types
+
+All types are fully exported and documented:
+
+```typescript
+// Re-export all types
+export * from './types/agent.types';
+export * from './types/task.types';
+export * from './types/memory.types';
+export * from './types/swarm.types';
+export * from './types/mcp.types';
+```
+
+## Dependencies
+
+- `sql.js` - SQLite WASM for cross-platform persistence
+
+## Used By
+
+This package is a dependency of all other @claude-flow modules:
+
+- [@claude-flow/cli](../cli) - CLI module
+- [@claude-flow/security](../security) - Security & validation
+- [@claude-flow/memory](../memory) - AgentDB & HNSW indexing
+- [@claude-flow/neural](../neural) - SONA learning & RL algorithms
+- [@claude-flow/performance](../performance) - Benchmarking & optimization
+- [@claude-flow/swarm](../swarm) - 15-agent coordination
+- [@claude-flow/integration](../integration) - agentic-flow@alpha bridge
+- [@claude-flow/testing](../testing) - TDD framework & fixtures
+- [@claude-flow/deployment](../deployment) - Release management
+- [@claude-flow/embeddings](../embeddings) - Embedding service
+- [@claude-flow/hooks](../hooks) - Hooks system
+
+## License
+
+MIT