monomind 1.11.12 → 1.11.13

package/packages/@monomind/cli/dist/src/swarm/flow-enforcer.d.ts

@@ -1,31 +0,0 @@
-/**
- * FlowEnforcer (Task 40)
- *
- * Checks messages against the communication graph and records violations.
- * No database dependency — violations stored in memory.
- */
-import type { FlowViolation } from '../../../shared/src/types/communication-flow.js';
-import type { CommunicationGraph } from './communication-graph.js';
-export declare class FlowEnforcer {
-    private readonly graph;
-    private readonly swarmId;
-    private readonly enforce;
-    private readonly violations;
-    private static readonly MAX_VIOLATIONS;
-    constructor(graph: CommunicationGraph, swarmId: string, enforceMode: boolean);
-    /**
-     * Check whether a message is authorized and record any violation.
-     *
-     * Returns BOTH `authorized` (the policy decision) and `enforced` (whether the
-     * decision is actually applied). Callers must read both — taking action based
-     * solely on `authorized` would let `enforce=false` silently bypass the policy.
-     */
-    checkAndRecord(fromSlug: string, toSlug: string, messageContent: string): {
-        authorized: boolean;
-        enforced: boolean;
-        violation?: FlowViolation;
-    };
-    /** Return all recorded violations */
-    getViolations(): FlowViolation[];
-}
-//# sourceMappingURL=flow-enforcer.d.ts.map

package/packages/@monomind/cli/dist/src/swarm/flow-enforcer.js

@@ -1,61 +0,0 @@
-/**
- * FlowEnforcer (Task 40)
- *
- * Checks messages against the communication graph and records violations.
- * No database dependency — violations stored in memory.
- */
-import { randomUUID } from 'crypto';
-export class FlowEnforcer {
-    graph;
-    swarmId;
-    enforce;
-    violations = [];
-    static MAX_VIOLATIONS = 1000;
-    constructor(graph, swarmId, enforceMode) {
-        this.graph = graph;
-        this.swarmId = swarmId;
-        this.enforce = enforceMode;
-    }
-    /**
-     * Check whether a message is authorized and record any violation.
-     *
-     * Returns BOTH `authorized` (the policy decision) and `enforced` (whether the
-     * decision is actually applied). Callers must read both — taking action based
-     * solely on `authorized` would let `enforce=false` silently bypass the policy.
-     */
-    checkAndRecord(fromSlug, toSlug, messageContent) {
-        if (this.graph.isAuthorized(fromSlug, toSlug)) {
-            return { authorized: true, enforced: this.enforce };
-        }
-        const violation = {
-            violationId: randomUUID(),
-            swarmId: this.swarmId,
-            fromAgentSlug: fromSlug,
-            toAgentSlug: toSlug,
-            // Truncated preview only; for sensitive traffic, redact via a hook before
-            // it reaches this enforcer. Cap means an attacker can't fill memory with
-            // long messages either.
-            messagePreview: messageContent.slice(0, 120),
-            detectedAt: new Date().toISOString(),
-            action: this.enforce ? 'blocked' : 'logged',
-        };
-        // FIFO eviction so a sustained attack can't grow violations to GB-scale.
-        if (this.violations.length >= FlowEnforcer.MAX_VIOLATIONS) {
-            this.violations.shift();
-        }
-        this.violations.push(violation);
-        return {
-            // Policy decision: NOT authorized. Whether the caller blocks the send is
-            // governed by `enforced`, which is exposed separately so callers cannot
-            // accidentally treat audit-mode as "permitted".
-            authorized: false,
-            enforced: this.enforce,
-            violation,
-        };
-    }
-    /** Return all recorded violations */
-    getViolations() {
-        return [...this.violations];
-    }
-}
-//# sourceMappingURL=flow-enforcer.js.map

package/packages/@monomind/cli/dist/src/swarm/flow-visualizer.d.ts

@@ -1,19 +0,0 @@
-/**
- * Flow Visualizer (Task 40)
- *
- * ASCII and DOT (Graphviz) renderers for communication flow edges.
- */
-import type { FlowEdge } from '../../../shared/src/types/communication-flow.js';
-/**
- * Render edges as human-readable ASCII art.
- * Empty edges produce a single-line "unrestricted" notice.
- */
-export declare function toAscii(edges: FlowEdge[], title?: string): string;
-/**
- * Render edges as a DOT language digraph (Graphviz compatible).
- * Slugs are escaped so a malicious slug cannot inject DOT attributes
- * (e.g., URL="javascript:..." would be rendered as a clickable link
- * by Graphviz's SVG output without escaping).
- */
-export declare function toDOT(edges: FlowEdge[], graphName?: string): string;
-//# sourceMappingURL=flow-visualizer.d.ts.map

package/packages/@monomind/cli/dist/src/swarm/flow-visualizer.js

@@ -1,68 +0,0 @@
-/**
- * Flow Visualizer (Task 40)
- *
- * ASCII and DOT (Graphviz) renderers for communication flow edges.
- */
-/** Escape a slug for safe DOT identifier interpolation. */
-function dotEscape(s) {
-    return String(s ?? '').replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-}
-/** Strip newlines/CR for safe ASCII line emission (log-injection defense). */
-function asciiSafe(s) {
-    return String(s ?? '').replace(/[\r\n\x00-\x1f\x7f]/g, '?');
-}
-/** Restrict graph names to a safe DOT identifier — graph_name must be an ID. */
-function safeGraphName(name) {
-    return /^[a-zA-Z_][a-zA-Z0-9_]{0,63}$/.test(name) ? name : 'swarm_flow';
-}
-const MAX_DISPLAY_EDGES = 500;
-/**
- * Render edges as human-readable ASCII art.
- * Empty edges produce a single-line "unrestricted" notice.
- */
-export function toAscii(edges, title) {
-    const lines = [];
-    if (title) {
-        lines.push(`=== ${asciiSafe(title)} ===`);
-        lines.push('');
-    }
-    if (edges.length === 0) {
-        lines.push('(unrestricted — all agents may communicate freely)');
-        return lines.join('\n');
-    }
-    const capped = edges.slice(0, MAX_DISPLAY_EDGES);
-    for (const [from, to] of capped) {
-        lines.push(`  ${asciiSafe(from)} --> ${asciiSafe(to)}`);
-    }
-    if (edges.length > MAX_DISPLAY_EDGES) {
-        lines.push(`  ... (${edges.length - MAX_DISPLAY_EDGES} more edges omitted)`);
-    }
-    return lines.join('\n');
-}
-/**
- * Render edges as a DOT language digraph (Graphviz compatible).
- * Slugs are escaped so a malicious slug cannot inject DOT attributes
- * (e.g., URL="javascript:..." would be rendered as a clickable link
- * by Graphviz's SVG output without escaping).
- */
-export function toDOT(edges, graphName) {
-    const name = safeGraphName(graphName ?? 'swarm_flow');
-    const lines = [];
-    lines.push(`digraph ${name} {`);
-    lines.push('  rankdir=LR;');
-    if (edges.length === 0) {
-        lines.push('  // unrestricted — no explicit edges');
-    }
-    else {
-        const capped = edges.slice(0, MAX_DISPLAY_EDGES);
-        for (const [from, to] of capped) {
-            lines.push(`  "${dotEscape(from)}" -> "${dotEscape(to)}";`);
-        }
-        if (edges.length > MAX_DISPLAY_EDGES) {
-            lines.push(`  // ... (${edges.length - MAX_DISPLAY_EDGES} more edges omitted)`);
-        }
-    }
-    lines.push('}');
-    return lines.join('\n');
-}
-//# sourceMappingURL=flow-visualizer.js.map

package/packages/@monomind/cli/dist/src/transfer/deploy-seraphine.d.ts

@@ -1,13 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Deploy Seraphine Genesis Model
- * Exports and uploads the first Monomind pattern model to IPFS
- *
- * Usage:
- *   npx tsx deploy-seraphine.ts
- *   npx tsx deploy-seraphine.ts --output ./patterns/
- *   npx tsx deploy-seraphine.ts --to-ipfs
- *   npx tsx deploy-seraphine.ts --to-ipfs --anonymize strict
- */
-export {};
-//# sourceMappingURL=deploy-seraphine.d.ts.map

package/packages/@monomind/cli/dist/src/transfer/deploy-seraphine.js

@@ -1,205 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Deploy Seraphine Genesis Model
- * Exports and uploads the first Monomind pattern model to IPFS
- *
- * Usage:
- *   npx tsx deploy-seraphine.ts
- *   npx tsx deploy-seraphine.ts --output ./patterns/
- *   npx tsx deploy-seraphine.ts --to-ipfs
- *   npx tsx deploy-seraphine.ts --to-ipfs --anonymize strict
- */
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-import { createSeraphineGenesis, getSeraphineInfo } from './models/seraphine.js';
-import { exportPatterns } from './export.js';
-import { validateCFP } from './serialization/cfp.js';
-import { scanCFPForPII } from './anonymization/index.js';
-/**
- * Parse CLI arguments
- */
-function parseArgs() {
-    const args = process.argv.slice(2);
-    const options = {
-        toIpfs: false,
-        anonymize: 'standard',
-        pin: true,
-        gateway: 'https://w3s.link',
-        validate: true,
-        verbose: false,
-    };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        switch (arg) {
-            case '--output':
-            case '-o':
-                options.output = args[++i];
-                break;
-            case '--to-ipfs':
-            case '--ipfs':
-                options.toIpfs = true;
-                break;
-            case '--anonymize':
-            case '-a':
-                options.anonymize = args[++i];
-                break;
-            case '--no-pin':
-                options.pin = false;
-                break;
-            case '--gateway':
-            case '-g':
-                options.gateway = args[++i];
-                break;
-            case '--no-validate':
-                options.validate = false;
-                break;
-            case '--verbose':
-            case '-v':
-                options.verbose = true;
-                break;
-            case '--help':
-            case '-h':
-                printHelp();
-                process.exit(0);
-        }
-    }
-    return options;
-}
-/**
- * Print help message
- */
-function printHelp() {
-    console.log(`
-Seraphine Genesis Deployer
-==========================
-
-Deploy the foundational Monomind pattern model.
-
-Usage:
-  npx ts-node deploy-seraphine.ts [options]
-
-Options:
-  --output, -o <path>     Output file path
-  --to-ipfs, --ipfs       Upload to IPFS
-  --anonymize, -a <level> Anonymization level (minimal|standard|strict|paranoid)
-  --gateway, -g <url>     IPFS gateway URL
-  --no-pin                Don't pin to pinning service
-  --no-validate           Skip validation
-  --verbose, -v           Verbose output
-  --help, -h              Show this help
-
-Examples:
-  npx ts-node deploy-seraphine.ts --output ./seraphine-genesis.cfp.json
-  npx ts-node deploy-seraphine.ts --to-ipfs --anonymize strict
-  npx ts-node deploy-seraphine.ts --to-ipfs --gateway https://dweb.link
-`);
-}
-/**
- * Main deploy function
- */
-async function deploy() {
-    const options = parseArgs();
-    console.log('');
-    console.log('╔══════════════════════════════════════════════════════════╗');
-    console.log('║        SERAPHINE GENESIS MODEL DEPLOYMENT                 ║');
-    console.log('║        The First Monomind Pattern Model                ║');
-    console.log('╚══════════════════════════════════════════════════════════╝');
-    console.log('');
-    // Step 1: Create Seraphine Genesis
-    console.log('📦 Creating Seraphine Genesis Model...');
-    const genesis = createSeraphineGenesis();
-    const info = getSeraphineInfo();
-    console.log(`   Name: ${info.name}`);
-    console.log(`   Version: ${info.version}`);
-    console.log(`   Description: ${info.description.slice(0, 60)}...`);
-    console.log('');
-    console.log('   Pattern Counts:');
-    for (const [type, count] of Object.entries(info.patternCounts)) {
-        console.log(`     - ${type}: ${count}`);
-    }
-    console.log('');
-    // Step 2: Validate
-    if (options.validate) {
-        console.log('✅ Validating CFP format...');
-        const validation = validateCFP(genesis);
-        if (!validation.valid) {
-            console.error('❌ Validation failed:');
-            for (const error of validation.errors) {
-                console.error(`   - ${error}`);
-            }
-            process.exit(1);
-        }
-        console.log('   Format is valid!');
-        console.log('');
-    }
-    // Step 3: Scan for PII
-    console.log('🔍 Scanning for PII...');
-    const piiScan = scanCFPForPII(genesis);
-    if (piiScan.found) {
-        console.log(`   Found ${piiScan.count} PII items:`);
-        for (const [type, count] of Object.entries(piiScan.types)) {
-            console.log(`     - ${type}: ${count}`);
-        }
-        console.log('   Will be redacted during export.');
-    }
-    else {
-        console.log('   No PII detected!');
-    }
-    console.log('');
-    // Step 4: Export
-    console.log(`📤 Exporting with ${options.anonymize} anonymization...`);
-    const exportOptions = {
-        output: options.output,
-        toIpfs: options.toIpfs,
-        anonymize: options.anonymize,
-        pin: options.pin,
-        gateway: options.gateway,
-        format: 'json',
-        redactPii: true,
-    };
-    // If no output specified and not uploading to IPFS, create default output
-    if (!options.output && !options.toIpfs) {
-        const defaultOutput = path.join(process.cwd(), 'seraphine-genesis.cfp.json');
-        exportOptions.output = defaultOutput;
-    }
-    const result = await exportPatterns(genesis, exportOptions);
-    console.log('');
-    console.log('═══════════════════════════════════════════════════════════');
-    console.log('                    DEPLOYMENT COMPLETE                     ');
-    console.log('═══════════════════════════════════════════════════════════');
-    console.log('');
-    if (result.success) {
-        console.log('✅ Successfully deployed Seraphine Genesis!');
-        console.log('');
-        console.log('   📊 Export Summary:');
-        console.log(`      Patterns: ${result.patternCount}`);
-        console.log(`      Size: ${result.size} bytes`);
-        console.log(`      Anonymization: ${result.anonymizationLevel}`);
-        if (result.outputPath) {
-            console.log('');
-            console.log(`   📁 File: ${result.outputPath}`);
-        }
-        if (result.cid) {
-            console.log('');
-            console.log('   🌐 IPFS:');
-            console.log(`      CID: ${result.cid}`);
-            console.log(`      Gateway URL: ${result.gateway}/ipfs/${result.cid}`);
-        }
-        console.log('');
-        console.log('   🎉 Hello World! The genesis pattern has been deployed.');
-        console.log('   🌟 This is the first Monomind pattern ever shared.');
-        console.log('');
-    }
-    else {
-        console.error('❌ Deployment failed!');
-        process.exit(1);
-    }
-}
-// Run if executed directly
-deploy().catch(error => {
-    console.error('Fatal error:', error);
-    process.exit(1);
-});
-//# sourceMappingURL=deploy-seraphine.js.map

package/packages/@monomind/cli/dist/src/transfer/store/tests/standalone-test.d.ts

@@ -1,12 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Standalone Pattern Store Test
- * Run this in any environment to verify the IPFS-based pattern store works
- *
- * Usage:
- *   npx tsx standalone-test.ts
- *   # or
- *   npm run test:pattern-store
- */
-export {};
-//# sourceMappingURL=standalone-test.d.ts.map

package/packages/@monomind/cli/dist/src/transfer/store/tests/standalone-test.js

@@ -1,190 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Standalone Pattern Store Test
- * Run this in any environment to verify the IPFS-based pattern store works
- *
- * Usage:
- *   npx tsx standalone-test.ts
- *   # or
- *   npm run test:pattern-store
- */
-import { PatternStore, createDiscoveryService, searchPatterns, getFeaturedPatterns, getTrendingPatterns, getNewestPatterns, getCategoryStats, getTagCloud, getSearchSuggestions, } from '../index.js';
-async function main() {
-    console.log('');
-    console.log('╔══════════════════════════════════════════════════════════════╗');
-    console.log('║  MONOMIND - STANDALONE PATTERN STORE TEST                   ║');
-    console.log('║  IPFS-Based Decentralized Pattern Marketplace                ║');
-    console.log('╚══════════════════════════════════════════════════════════════╝');
-    console.log('');
-    let passed = 0;
-    let failed = 0;
-    // Test 1: Discovery Service Creation
-    console.log('▶ Test 1: Create Discovery Service');
-    try {
-        const discovery = createDiscoveryService();
-        const registries = discovery.listRegistries();
-        console.log(`  ✅ Created service with ${registries.length} bootstrap registries`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 2: Discover Registry
-    console.log('▶ Test 2: Discover Registry via IPNS');
-    let registry = null;
-    try {
-        const discovery = createDiscoveryService();
-        const result = await discovery.discoverRegistry();
-        if (result.success && result.registry) {
-            registry = result.registry;
-            console.log(`  ✅ Discovered ${result.registry.patterns.length} patterns from ${result.source}`);
-            passed++;
-        }
-        else {
-            throw new Error(result.error || 'No registry');
-        }
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    if (!registry) {
-        console.log('\n❌ Cannot continue without registry\n');
-        process.exit(1);
-    }
-    // Test 3: Search Patterns
-    console.log('▶ Test 3: Search for "agent"');
-    try {
-        const results = searchPatterns(registry, { query: 'agent' });
-        console.log(`  ✅ Found ${results.patterns.length} patterns matching "agent"`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 4: Get Featured Patterns
-    console.log('▶ Test 4: Get Featured Patterns');
-    try {
-        const featured = getFeaturedPatterns(registry);
-        console.log(`  ✅ Found ${featured.length} featured patterns`);
-        if (featured.length > 0) {
-            console.log(`     - ${featured[0].name} (${featured[0].id})`);
-        }
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 5: Get Trending Patterns
-    console.log('▶ Test 5: Get Trending Patterns');
-    try {
-        const trending = getTrendingPatterns(registry);
-        console.log(`  ✅ Found ${trending.length} trending patterns`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 6: Get Newest Patterns
-    console.log('▶ Test 6: Get Newest Patterns');
-    try {
-        const newest = getNewestPatterns(registry);
-        console.log(`  ✅ Found ${newest.length} newest patterns`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 7: Search with Filters
-    console.log('▶ Test 7: Search with Filters (verified only)');
-    try {
-        const results = searchPatterns(registry, { verified: true });
-        console.log(`  ✅ Found ${results.patterns.length} verified patterns`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 8: Category Stats
-    console.log('▶ Test 8: Get Category Statistics');
-    try {
-        const stats = getCategoryStats(registry);
-        const count = Array.isArray(stats) ? stats.length : Object.keys(stats).length;
-        console.log(`  ✅ Found ${count} categories with stats`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 9: Tag Cloud
-    console.log('▶ Test 9: Get Tag Cloud');
-    try {
-        const tags = getTagCloud(registry);
-        console.log(`  ✅ Found ${tags.size} unique tags`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 10: Search Suggestions
-    console.log('▶ Test 10: Get Search Suggestions');
-    try {
-        const suggestions = getSearchSuggestions(registry, 'pat');
-        console.log(`  ✅ Got ${suggestions.length} suggestions for "pat"`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Test 11: PatternStore Class
-    console.log('▶ Test 11: PatternStore Class API');
-    try {
-        const store = new PatternStore();
-        await store.initialize();
-        const stats = store.getStats();
-        console.log(`  ✅ PatternStore initialized:`);
-        console.log(`     Total Patterns: ${stats.totalPatterns}`);
-        console.log(`     Total Downloads: ${stats.totalDownloads.toLocaleString()}`);
-        console.log(`     Categories: ${stats.categories}`);
-        passed++;
-    }
-    catch (e) {
-        console.log(`  ❌ Failed: ${e.message}`);
-        failed++;
-    }
-    // Summary
-    console.log('');
-    console.log('═══════════════════════════════════════════════════════════════');
-    console.log('                        TEST RESULTS                            ');
-    console.log('═══════════════════════════════════════════════════════════════');
-    console.log('');
-    console.log(`  Total:  ${passed + failed}`);
-    console.log(`  ✅ Passed: ${passed}`);
-    console.log(`  ❌ Failed: ${failed}`);
-    console.log('');
-    if (failed === 0) {
-        console.log('  🎉 All tests passed! Pattern Store is working correctly.');
-        console.log('');
-        console.log('  Available CLI Commands:');
-        console.log('    npx @monoes/cli patterns list');
-        console.log('    npx @monoes/cli patterns list --featured');
-        console.log('    npx @monoes/cli patterns search -q "agent"');
-        console.log('    npx @monoes/cli patterns info -n <pattern-id>');
-        console.log('');
-    }
-    process.exit(failed > 0 ? 1 : 0);
-}
-main().catch(err => {
-    console.error('Fatal error:', err);
-    process.exit(1);
-});
-//# sourceMappingURL=standalone-test.js.map

package/packages/@monomind/cli/dist/src/transfer/test-seraphine.d.ts

@@ -1,6 +0,0 @@
-/**
- * Test Seraphine Genesis Model
- * Quick validation of the transfer pipeline
- */
-export {};
-//# sourceMappingURL=test-seraphine.d.ts.map