society-protocol 1.0.0

package/dist/cache.js

@@ -0,0 +1,257 @@
+/**
+ * Society Protocol - Caching Layer
+ *
+ * LRU cache with TTL support for frequently accessed data.
+ * Reduces database load and improves response times.
+ */
+import { EventEmitter } from 'events';
+/**
+ * LRU Cache with TTL support
+ */
+export class LRUCache extends EventEmitter {
+    cache;
+    maxSize;
+    defaultTtlMs;
+    cleanupInterval;
+    stats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+        expirations: 0,
+    };
+    constructor(options = {}) {
+        super();
+        this.cache = new Map();
+        this.maxSize = options.maxSize ?? 1000;
+        this.defaultTtlMs = options.defaultTtlMs ?? 60000; // 1 minute default
+        // Start cleanup interval
+        const checkInterval = options.checkIntervalMs ?? 60000;
+        this.cleanupInterval = setInterval(() => this.cleanup(), checkInterval);
+    }
+    /**
+     * Get value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return undefined;
+        }
+        // Check expiration
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            this.stats.expirations++;
+            this.emit('expire', key);
+            return undefined;
+        }
+        // Move to end (LRU)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        entry.hits++;
+        this.stats.hits++;
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value, ttlMs) {
+        const expiresAt = Date.now() + (ttlMs ?? this.defaultTtlMs);
+        // Evict oldest if at capacity
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+                this.stats.evictions++;
+                this.emit('evict', oldestKey);
+            }
+        }
+        this.cache.set(key, {
+            value,
+            expiresAt,
+            hits: 0,
+        });
+        this.emit('set', key);
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete key from cache
+     */
+    delete(key) {
+        const existed = this.cache.delete(key);
+        if (existed) {
+            this.emit('delete', key);
+        }
+        return existed;
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+        this.emit('clear');
+    }
+    /**
+     * Get all keys
+     */
+    keys() {
+        return this.cache.keys();
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const total = this.stats.hits + this.stats.misses;
+        const hitRate = total > 0 ? this.stats.hits / total : 0;
+        return {
+            ...this.stats,
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            hitRate: Math.round(hitRate * 100) / 100,
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            expirations: 0,
+        };
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let expired = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                expired++;
+                this.emit('expire', key);
+            }
+        }
+        if (expired > 0) {
+            this.stats.expirations += expired;
+            this.emit('cleanup', expired);
+        }
+    }
+    /**
+     * Destroy cache and stop cleanup interval
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.clear();
+        this.removeAllListeners();
+    }
+}
+/**
+ * Knowledge-specific cache with space invalidation
+ */
+export class KnowledgeCache extends LRUCache {
+    spaceIndex = new Map();
+    constructor(options = {}) {
+        super(options);
+    }
+    /**
+     * Cache card with space tracking
+     */
+    setCard(cardId, card, spaceId, ttlMs) {
+        this.set(`card:${cardId}`, card, ttlMs);
+        // Track in space index
+        if (!this.spaceIndex.has(spaceId)) {
+            this.spaceIndex.set(spaceId, new Set());
+        }
+        this.spaceIndex.get(spaceId).add(cardId);
+    }
+    /**
+     * Get cached card
+     */
+    getCard(cardId) {
+        return this.get(`card:${cardId}`);
+    }
+    /**
+     * Invalidate all cards in a space
+     */
+    invalidateSpace(spaceId) {
+        const cardIds = this.spaceIndex.get(spaceId);
+        if (!cardIds)
+            return 0;
+        let count = 0;
+        for (const cardId of cardIds) {
+            if (this.delete(`card:${cardId}`)) {
+                count++;
+            }
+        }
+        this.spaceIndex.delete(spaceId);
+        return count;
+    }
+    /**
+     * Cache space metadata
+     */
+    setSpace(spaceId, space, ttlMs) {
+        this.set(`space:${spaceId}`, space, ttlMs);
+    }
+    /**
+     * Get cached space
+     */
+    getSpace(spaceId) {
+        return this.get(`space:${spaceId}`);
+    }
+}
+/**
+ * Federation cache with policy caching
+ */
+export class FederationCache extends LRUCache {
+    constructor(options = {}) {
+        super({ ...options, defaultTtlMs: 300000 }); // 5 min default for policies
+    }
+    /**
+     * Cache federation
+     */
+    setFederation(fedId, federation) {
+        this.set(`fed:${fedId}`, federation);
+    }
+    /**
+     * Get cached federation
+     */
+    getFederation(fedId) {
+        return this.get(`fed:${fedId}`);
+    }
+    /**
+     * Cache policy check result
+     */
+    setPolicyCheck(action, actor, result) {
+        this.set(`policy:${action}:${actor}`, result, 60000); // 1 min TTL
+    }
+    /**
+     * Get cached policy check
+     */
+    getPolicyCheck(action, actor) {
+        return this.get(`policy:${action}:${actor}`);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/capsules.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Society Protocol — Capsules Module
+ *
+ * A Capsule is an immutable, exported snapshot of a CoC Chain.
+ * It contains the DAG, assignment history, and all generated artifacts packaged
+ * into a single archive (a `.society` zip file) for sharing and auditing.
+ */
+import { type CocEngine } from './coc.js';
+import { type Storage } from './storage.js';
+export declare class CapsuleExporter {
+    private coc;
+    private storage;
+    constructor(coc: CocEngine, storage: Storage);
+    /**
+     * Exports a chain to a .society archive file.
+     * @param chainId The ID of the chain to export.
+     * @param outputDirectory Where to save the file.
+     * @returns The absolute path to the generated .society file.
+     */
+    export(chainId: string, outputDirectory: string): Promise<string>;
+    private guessExtension;
+}
+//# sourceMappingURL=capsules.d.ts.map

package/dist/capsules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsules.d.ts","sourceRoot":"","sources":["../src/capsules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAa,eAAe;IAEpB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,OAAO;gBADP,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO;IAG5B;;;;;OAKG;IACU,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgD9E,OAAO,CAAC,cAAc;CASzB"}

package/dist/capsules.js

@@ -0,0 +1,75 @@
+/**
+ * Society Protocol — Capsules Module
+ *
+ * A Capsule is an immutable, exported snapshot of a CoC Chain.
+ * It contains the DAG, assignment history, and all generated artifacts packaged
+ * into a single archive (a `.society` zip file) for sharing and auditing.
+ */
+import archiver from 'archiver';
+import fs from 'fs';
+import path from 'path';
+export class CapsuleExporter {
+    coc;
+    storage;
+    constructor(coc, storage) {
+        this.coc = coc;
+        this.storage = storage;
+    }
+    /**
+     * Exports a chain to a .society archive file.
+     * @param chainId The ID of the chain to export.
+     * @param outputDirectory Where to save the file.
+     * @returns The absolute path to the generated .society file.
+     */
+    async export(chainId, outputDirectory) {
+        return new Promise((resolve, reject) => {
+            const chain = this.coc.getChain(chainId);
+            if (!chain) {
+                return reject(new Error(`Cannot export: Chain ${chainId} not found.`));
+            }
+            // Also get all raw events for auditing
+            const events = this.storage.db.prepare('SELECT * FROM coc_events WHERE chain_id = ? ORDER BY ts ASC').all(chainId);
+            const filename = `capsule_${chainId}.society`;
+            const outputPath = path.join(outputDirectory, filename);
+            const output = fs.createWriteStream(outputPath);
+            const archive = archiver('zip', { zlib: { level: 9 } });
+            output.on('close', () => {
+                resolve(outputPath);
+            });
+            archive.on('error', (err) => {
+                reject(err);
+            });
+            archive.pipe(output);
+            // 1. Write the main manifesto (chain.json)
+            archive.append(JSON.stringify(chain, null, 2), { name: 'manifest.json' });
+            // 2. Write the audit log
+            archive.append(JSON.stringify(events, null, 2), { name: 'audit_log.json' });
+            // 3. Extract and write individual artifacts into a folder hierarchy
+            for (const step of chain.steps) {
+                if (step.artifacts && step.artifacts.length > 0) {
+                    for (let i = 0; i < step.artifacts.length; i++) {
+                        const artifact = step.artifacts[i];
+                        // If artifact is a string containing code/text, we save it directly
+                        const content = typeof artifact === 'string' ? artifact : JSON.stringify(artifact, null, 2);
+                        const extension = this.guessExtension(content);
+                        archive.append(content, { name: `artifacts/${step.step_id}/artifact_${i}${extension}` });
+                    }
+                }
+            }
+            void archive.finalize();
+        });
+    }
+    guessExtension(content) {
+        if (content.startsWith('{') || content.startsWith('['))
+            return '.json';
+        if (content.includes('import ') || content.includes('function ')) {
+            if (content.includes('React') || content.includes('JSX'))
+                return '.tsx';
+            return '.ts';
+        }
+        if (content.startsWith('# '))
+            return '.md';
+        return '.txt';
+    }
+}
+//# sourceMappingURL=capsules.js.map

package/dist/capsules.js.map

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

package/dist/cli/commands.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Society Protocol - Enhanced CLI Commands
+ */
+import { Command } from 'commander';
+declare const program: Command;
+export { program };
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAiS9B,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli/commands.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+/**
+ * Society Protocol - Enhanced CLI Commands
+ */
+import { Command } from 'commander';
+import { Storage } from '../storage.js';
+import { generateIdentity } from '../identity.js';
+import { SecurityManager } from '../security.js';
+import { FederationEngine } from '../federation.js';
+import { initializeWasm, WasmCryptoEngine } from '../crypto-wasm.js';
+import { globalMetrics } from '../metrics.js';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { mkdirSync, rmSync } from 'fs';
+const program = new Command();
+program
+    .name('society')
+    .description('Society Protocol - P2P Multi-Agent Collaboration')
+    .version('1.0.0');
+// ═══════════════════════════════════════════════════════════════════════════
+// TEST COMMANDS
+// ═══════════════════════════════════════════════════════════════════════════
+program
+    .command('test')
+    .description('Run test suite')
+    .option('--unit', 'Run unit tests only')
+    .option('--integration', 'Run integration tests only')
+    .option('--coverage', 'Generate coverage report')
+    .option('--watch', 'Watch mode')
+    .action(async (options) => {
+    console.log('🧪 Running tests...\n');
+    const { execSync } = await import('child_process');
+    let cmd = 'npx vitest run';
+    if (options.unit)
+        cmd += ' test/unit';
+    if (options.integration)
+        cmd += ' test/integration';
+    if (options.coverage)
+        cmd += ' --coverage';
+    if (options.watch)
+        cmd = cmd.replace('run', '');
+    try {
+        execSync(cmd, { stdio: 'inherit' });
+    }
+    catch (e) {
+        process.exit(1);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// BENCHMARK COMMANDS
+// ═══════════════════════════════════════════════════════════════════════════
+program
+    .command('benchmark')
+    .description('Run performance benchmarks')
+    .option('--crypto', 'Benchmark cryptography only')
+    .option('--storage', 'Benchmark storage only')
+    .option('--all', 'Run all benchmarks')
+    .action(async (options) => {
+    console.log('🚀 Running benchmarks...\n');
+    const testDir = join(tmpdir(), `society-benchmark-cli-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+    const results = {};
+    try {
+        // Crypto Benchmarks
+        if (options.crypto || options.all || (!options.crypto && !options.storage)) {
+            console.log('📊 Crypto Benchmarks');
+            console.log('─'.repeat(50));
+            const storage = new Storage({ dbPath: join(testDir, 'bench-crypto.db') });
+            const identity = await generateIdentity(storage, 'Benchmark');
+            const security = new SecurityManager(identity);
+            // Sign benchmark
+            const message = new TextEncoder().encode('Benchmark');
+            let signStart = Date.now();
+            for (let i = 0; i < 1000; i++) {
+                await security.sign(message);
+            }
+            results.cryptoSign = {
+                ops: 1000,
+                time: Date.now() - signStart,
+                opsPerSec: Math.round(1000 / ((Date.now() - signStart) / 1000)),
+            };
+            console.log(`  Sign: ${results.cryptoSign.opsPerSec} ops/sec`);
+            // Verify benchmark
+            const signature = await security.sign(message);
+            let verifyStart = Date.now();
+            for (let i = 0; i < 1000; i++) {
+                await security.verify(message, signature, identity.publicKey);
+            }
+            results.cryptoVerify = {
+                ops: 1000,
+                time: Date.now() - verifyStart,
+                opsPerSec: Math.round(1000 / ((Date.now() - verifyStart) / 1000)),
+            };
+            console.log(`  Verify: ${results.cryptoVerify.opsPerSec} ops/sec`);
+            console.log('');
+        }
+        // Storage Benchmarks
+        if (options.storage || options.all || (!options.crypto && !options.storage)) {
+            console.log('📊 Storage Benchmarks');
+            console.log('─'.repeat(50));
+            const storage = new Storage({ dbPath: join(testDir, 'bench-storage.db') });
+            // Write benchmark
+            let writeStart = Date.now();
+            storage.transaction(() => {
+                for (let i = 0; i < 10000; i++) {
+                    storage.set(`key-${i}`, { index: i, data: 'x'.repeat(100) });
+                }
+            });
+            results.storageWrite = {
+                ops: 10000,
+                time: Date.now() - writeStart,
+                opsPerSec: Math.round(10000 / ((Date.now() - writeStart) / 1000)),
+            };
+            console.log(`  Write: ${results.storageWrite.opsPerSec} ops/sec`);
+            // Read benchmark
+            let readStart = Date.now();
+            for (let i = 0; i < 10000; i++) {
+                storage.get(`key-${i}`);
+            }
+            results.storageRead = {
+                ops: 10000,
+                time: Date.now() - readStart,
+                opsPerSec: Math.round(10000 / ((Date.now() - readStart) / 1000)),
+            };
+            console.log(`  Read: ${results.storageRead.opsPerSec} ops/sec`);
+            console.log('');
+        }
+        // Summary
+        console.log('✅ Benchmark Complete');
+        console.log('─'.repeat(50));
+        console.log(JSON.stringify(results, null, 2));
+    }
+    finally {
+        rmSync(testDir, { recursive: true, force: true });
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// WASM COMMANDS
+// ═══════════════════════════════════════════════════════════════════════════
+program
+    .command('wasm')
+    .description('WASM crypto operations')
+    .option('--init', 'Initialize WASM module')
+    .option('--benchmark', 'Benchmark WASM vs JS')
+    .option('--status', 'Check WASM status')
+    .action(async (options) => {
+    if (options.status) {
+        try {
+            await initializeWasm();
+            console.log('✅ WASM module loaded');
+        }
+        catch (e) {
+            console.log('❌ WASM not available:', e);
+        }
+        return;
+    }
+    if (options.init) {
+        console.log('🔧 Initializing WASM...');
+        try {
+            await initializeWasm();
+            console.log('✅ WASM initialized successfully');
+        }
+        catch (e) {
+            console.error('❌ Failed to initialize WASM:', e);
+            process.exit(1);
+        }
+        return;
+    }
+    if (options.benchmark) {
+        console.log('🚀 Benchmarking WASM vs JS...\n');
+        try {
+            await initializeWasm();
+            console.log('WASM Benchmarks:');
+            console.log('─'.repeat(50));
+            // WASM sign benchmark
+            const wasmKeypair = WasmCryptoEngine.generateKeypair();
+            const message = new TextEncoder().encode('Benchmark');
+            let wasmStart = Date.now();
+            for (let i = 0; i < 1000; i++) {
+                WasmCryptoEngine.sign(message, wasmKeypair.privateKey);
+            }
+            const wasmTime = Date.now() - wasmStart;
+            console.log(`  WASM Sign: ${wasmTime}ms (${Math.round(1000 / (wasmTime / 1000))} ops/sec)`);
+            // Compare with JS
+            const testDir = join(tmpdir(), `society-wasm-bench-${Date.now()}`);
+            mkdirSync(testDir, { recursive: true });
+            const storage = new Storage({ dbPath: join(testDir, 'bench.db') });
+            const identity = await generateIdentity(storage, 'Benchmark');
+            const security = new SecurityManager(identity);
+            let jsStart = Date.now();
+            for (let i = 0; i < 1000; i++) {
+                await security.sign(message);
+            }
+            const jsTime = Date.now() - jsStart;
+            console.log(`  JS Sign: ${jsTime}ms (${Math.round(1000 / (jsTime / 1000))} ops/sec)`);
+            const speedup = (jsTime / wasmTime).toFixed(1);
+            console.log(`\n📈 WASM is ${speedup}x faster than JS`);
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        catch (e) {
+            console.error('❌ Benchmark failed:', e);
+            process.exit(1);
+        }
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// METRICS COMMANDS
+// ═══════════════════════════════════════════════════════════════════════════
+program
+    .command('metrics')
+    .description('Start metrics server')
+    .option('-p, --port <port>', 'Server port', '9090')
+    .option('--once', 'Print metrics once and exit')
+    .action(async (options) => {
+    if (options.once) {
+        console.log(globalMetrics.exportPrometheus());
+        return;
+    }
+    const port = parseInt(options.port);
+    globalMetrics.startServer(port);
+    console.log(`📊 Metrics server started on port ${port}`);
+    console.log(`  Prometheus: http://localhost:${port}/metrics`);
+    console.log(`  JSON: http://localhost:${port}/metrics.json`);
+    console.log(`  Health: http://localhost:${port}/health`);
+    console.log('\nPress Ctrl+C to stop');
+    // Keep process alive
+    process.on('SIGINT', () => {
+        console.log('\n\n🛑 Stopping metrics server...');
+        globalMetrics.stopServer();
+        process.exit(0);
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// FEDERATION COMMANDS
+// ═══════════════════════════════════════════════════════════════════════════
+program
+    .command('federation')
+    .description('Federation management')
+    .option('--create <name>', 'Create new federation')
+    .option('--list', 'List all federations')
+    .option('--db <path>', 'Database path', '~/.society/society.db')
+    .action(async (options) => {
+    const storage = new Storage({ dbPath: options.db });
+    const identity = await generateIdentity(storage, 'CLI User');
+    const federation = new FederationEngine(storage, identity);
+    if (options.create) {
+        const fed = await federation.createFederation(options.create, 'Created via CLI', 'public');
+        console.log('✅ Federation created:');
+        console.log(`  ID: ${fed.id}`);
+        console.log(`  Name: ${fed.name}`);
+        console.log(`  DID: ${fed.did}`);
+    }
+    if (options.list) {
+        const feds = federation.getFederations();
+        console.log(`📋 ${feds.length} Federations:`);
+        console.log('─'.repeat(60));
+        for (const fed of feds) {
+            console.log(`  ${fed.id} - ${fed.name} (${fed.visibility})`);
+        }
+    }
+});
+export { program };
+//# sourceMappingURL=commands.js.map