odd-flow 1.0.0

package/v3/@claude-flow/cli/dist/src/suggest.d.ts

@@ -0,0 +1,51 @@
+/**
+ * V3 CLI Smart Error Suggestions
+ * Levenshtein distance and command suggestions
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Calculate similarity score (0-1) between two strings
+ */
+export declare function similarityScore(a: string, b: string): number;
+/**
+ * Find similar strings from a list
+ */
+export declare function findSimilar(input: string, candidates: string[], options?: {
+    maxSuggestions?: number;
+    minSimilarity?: number;
+    maxDistance?: number;
+}): string[];
+/**
+ * Format suggestion message for CLI errors
+ */
+export declare function formatSuggestion(invalidInput: string, suggestions: string[], context?: 'command' | 'subcommand' | 'option' | 'value'): string;
+/**
+ * Common typos and their corrections
+ */
+export declare const COMMON_TYPOS: Record<string, string>;
+/**
+ * Get corrected command if it's a common typo
+ */
+export declare function getTypoCorrection(input: string): string | undefined;
+/**
+ * Smart command suggestion for unknown commands
+ */
+export declare function suggestCommand(unknownCommand: string, availableCommands: string[]): {
+    correction?: string;
+    suggestions: string[];
+    message: string;
+};
+declare const _default: {
+    levenshteinDistance: typeof levenshteinDistance;
+    similarityScore: typeof similarityScore;
+    findSimilar: typeof findSimilar;
+    formatSuggestion: typeof formatSuggestion;
+    suggestCommand: typeof suggestCommand;
+    getTypoCorrection: typeof getTypoCorrection;
+    COMMON_TYPOS: Record<string, string>;
+};
+export default _default;
+//# sourceMappingURL=suggest.d.ts.map

package/v3/@claude-flow/cli/dist/src/suggest.js

@@ -0,0 +1,198 @@
+/**
+ * V3 CLI Smart Error Suggestions
+ * Levenshtein distance and command suggestions
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+export function levenshteinDistance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    // Early termination for empty strings
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    // Create distance matrix
+    const d = Array(m + 1).fill(null).map(() => Array(n + 1).fill(0));
+    // Initialize first column
+    for (let i = 0; i <= m; i++) {
+        d[i][0] = i;
+    }
+    // Initialize first row
+    for (let j = 0; j <= n; j++) {
+        d[0][j] = j;
+    }
+    // Fill in the rest of the matrix
+    for (let j = 1; j <= n; j++) {
+        for (let i = 1; i <= m; i++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            d[i][j] = Math.min(d[i - 1][j] + 1, // deletion
+            d[i][j - 1] + 1, // insertion
+            d[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return d[m][n];
+}
+/**
+ * Calculate similarity score (0-1) between two strings
+ */
+export function similarityScore(a, b) {
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1;
+    const distance = levenshteinDistance(a.toLowerCase(), b.toLowerCase());
+    return 1 - distance / maxLen;
+}
+/**
+ * Find similar strings from a list
+ */
+export function findSimilar(input, candidates, options = {}) {
+    const { maxSuggestions = 3, minSimilarity = 0.4, maxDistance = 3 } = options;
+    const inputLower = input.toLowerCase();
+    // Score all candidates
+    const scored = candidates
+        .map(candidate => ({
+        candidate,
+        distance: levenshteinDistance(inputLower, candidate.toLowerCase()),
+        similarity: similarityScore(inputLower, candidate),
+        // Boost prefix matches
+        prefixBoost: candidate.toLowerCase().startsWith(inputLower) ? 0.3 : 0
+    }))
+        .filter(s => s.distance <= maxDistance || s.similarity >= minSimilarity)
+        .map(s => ({
+        ...s,
+        score: s.similarity + s.prefixBoost
+    }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxSuggestions);
+    return scored.map(s => s.candidate);
+}
+/**
+ * Format suggestion message for CLI errors
+ */
+export function formatSuggestion(invalidInput, suggestions, context = 'command') {
+    if (suggestions.length === 0) {
+        return '';
+    }
+    const contextMap = {
+        command: 'Did you mean',
+        subcommand: 'Available subcommands',
+        option: 'Did you mean',
+        value: 'Valid values'
+    };
+    const prefix = contextMap[context];
+    if (suggestions.length === 1) {
+        return `\n  ${prefix}: ${suggestions[0]}`;
+    }
+    return `\n  ${prefix}:\n${suggestions.map(s => `    - ${s}`).join('\n')}`;
+}
+/**
+ * Common typos and their corrections
+ */
+export const COMMON_TYPOS = {
+    'init': 'init',
+    'initi': 'init',
+    'inizialize': 'init',
+    'staus': 'status',
+    'stauts': 'status',
+    'stats': 'stats',
+    'stat': 'status',
+    'swarrm': 'swarm',
+    'swarn': 'swarm',
+    'agnet': 'agent',
+    'agen': 'agent',
+    'memroy': 'memory',
+    'mem': 'memory',
+    'memmory': 'memory',
+    'confg': 'config',
+    'conf': 'config',
+    'configu': 'config',
+    'hook': 'hooks',
+    'hoks': 'hooks',
+    'hive': 'hive-mind',
+    'hivemind': 'hive-mind',
+    'hive_mind': 'hive-mind',
+    'neurl': 'neural',
+    'nueral': 'neural',
+    'securty': 'security',
+    'sec': 'security',
+    'perf': 'performance',
+    'performace': 'performance',
+    'provider': 'providers',
+    'plugin': 'plugins',
+    'dep': 'deployment',
+    'depoly': 'deployment',
+    'deploy': 'deployment',
+    'claim': 'claims',
+    'embed': 'embeddings',
+    'embeding': 'embeddings',
+    'daemon': 'daemon',
+    'deamon': 'daemon',
+    'doc': 'doctor',
+    'docter': 'doctor',
+    'complete': 'completions',
+    'completion': 'completions',
+    'comp': 'completions',
+    'task': 'task',
+    'taks': 'task',
+    'sessio': 'session',
+    'sess': 'session',
+    'sesssion': 'session',
+    'workflow': 'workflow',
+    'wf': 'workflow',
+    'wokflow': 'workflow'
+};
+/**
+ * Get corrected command if it's a common typo
+ */
+export function getTypoCorrection(input) {
+    return COMMON_TYPOS[input.toLowerCase()];
+}
+/**
+ * Smart command suggestion for unknown commands
+ */
+export function suggestCommand(unknownCommand, availableCommands) {
+    // Check for common typo first
+    const correction = getTypoCorrection(unknownCommand);
+    if (correction && availableCommands.includes(correction)) {
+        return {
+            correction,
+            suggestions: [correction],
+            message: `Did you mean "${correction}"?`
+        };
+    }
+    // Find similar commands
+    const suggestions = findSimilar(unknownCommand, availableCommands, {
+        maxSuggestions: 3,
+        minSimilarity: 0.3,
+        maxDistance: 4
+    });
+    if (suggestions.length === 0) {
+        return {
+            suggestions: [],
+            message: 'Run "claude-flow --help" to see available commands.'
+        };
+    }
+    if (suggestions.length === 1) {
+        return {
+            suggestions,
+            message: `Did you mean "${suggestions[0]}"?`
+        };
+    }
+    return {
+        suggestions,
+        message: `Did you mean one of these?\n${suggestions.map(s => `  - ${s}`).join('\n')}`
+    };
+}
+export default {
+    levenshteinDistance,
+    similarityScore,
+    findSimilar,
+    formatSuggestion,
+    suggestCommand,
+    getTypoCorrection,
+    COMMON_TYPOS
+};
+//# sourceMappingURL=suggest.js.map

package/v3/@claude-flow/cli/dist/src/transfer/anonymization/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Anonymization Pipeline
+ * PII detection and redaction for pattern export
+ */
+import type { CFPFormat, AnonymizationLevel, PIIDetectionResult } from '../types.js';
+/**
+ * Detect PII in a string
+ */
+export declare function detectPII(content: string): PIIDetectionResult;
+/**
+ * Redact PII from a string
+ */
+export declare function redactPII(content: string): string;
+/**
+ * Apply anonymization to CFP document
+ */
+export declare function anonymizeCFP(cfp: CFPFormat, level: AnonymizationLevel): {
+    cfp: CFPFormat;
+    transforms: string[];
+};
+/**
+ * Scan CFP for PII without modification
+ */
+export declare function scanCFPForPII(cfp: CFPFormat): PIIDetectionResult;
+//# sourceMappingURL=index.d.ts.map

package/v3/@claude-flow/cli/dist/src/transfer/anonymization/index.js

@@ -0,0 +1,175 @@
+/**
+ * Anonymization Pipeline
+ * PII detection and redaction for pattern export
+ */
+import * as crypto from 'crypto';
+/**
+ * PII detection patterns
+ */
+const PII_PATTERNS = {
+    email: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g,
+    phone: /\b(\+?\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g,
+    ipv4: /\b(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\b/g,
+    ipv6: /\b(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\b/g,
+    apiKey: /\b(sk-|pk-|api[_-]?key[_-]?)[a-zA-Z0-9]{20,}\b/gi,
+    jwt: /\beyJ[a-zA-Z0-9_-]*\.eyJ[a-zA-Z0-9_-]*\.[a-zA-Z0-9_-]*\b/g,
+    homePath: /\/(Users|home|Documents)\/[a-zA-Z0-9_.-]+/g,
+    windowsPath: /[A-Z]:\\Users\\[a-zA-Z0-9_.-]+/g,
+};
+/**
+ * Redaction replacements
+ */
+const REDACTIONS = {
+    email: (match) => `user_${hash(match).slice(0, 8)}@example.com`,
+    phone: '[REDACTED_PHONE]',
+    ipv4: '0.0.0.0',
+    ipv6: '::1',
+    apiKey: '[REDACTED_API_KEY]',
+    jwt: '[REDACTED_JWT]',
+    homePath: '/user/anonymous',
+    windowsPath: 'C:\\Users\\anonymous',
+};
+/**
+ * Hash a string for consistent pseudonymization
+ */
+function hash(input) {
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+/**
+ * Detect PII in a string
+ */
+export function detectPII(content) {
+    const result = {
+        found: false,
+        count: 0,
+        types: {},
+        locations: [],
+    };
+    for (const [type, pattern] of Object.entries(PII_PATTERNS)) {
+        const matches = content.match(pattern);
+        if (matches) {
+            result.found = true;
+            result.count += matches.length;
+            result.types[type] = matches.length;
+            for (const match of matches.slice(0, 5)) { // Limit to first 5 samples
+                result.locations.push({
+                    type,
+                    path: 'content',
+                    sample: match.slice(0, 20) + (match.length > 20 ? '...' : ''),
+                    severity: getSeverity(type),
+                });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Get severity for PII type
+ */
+function getSeverity(type) {
+    switch (type) {
+        case 'apiKey':
+        case 'jwt':
+            return 'critical';
+        case 'email':
+        case 'phone':
+            return 'high';
+        case 'ipv4':
+        case 'ipv6':
+            return 'medium';
+        default:
+            return 'low';
+    }
+}
+/**
+ * Redact PII from a string
+ */
+export function redactPII(content) {
+    let result = content;
+    for (const [type, pattern] of Object.entries(PII_PATTERNS)) {
+        const replacement = REDACTIONS[type];
+        if (typeof replacement === 'function') {
+            result = result.replace(pattern, replacement);
+        }
+        else {
+            result = result.replace(pattern, replacement);
+        }
+    }
+    return result;
+}
+/**
+ * Apply anonymization to CFP document
+ */
+export function anonymizeCFP(cfp, level) {
+    const transforms = [];
+    const anonymized = JSON.parse(JSON.stringify(cfp));
+    // Level: Minimal
+    if (['minimal', 'standard', 'strict', 'paranoid'].includes(level)) {
+        // Redact author display name
+        if (anonymized.metadata.author?.displayName) {
+            anonymized.metadata.author.displayName = undefined;
+            transforms.push('author-name-removed');
+        }
+    }
+    // Level: Standard
+    if (['standard', 'strict', 'paranoid'].includes(level)) {
+        // Redact PII from all string fields
+        const jsonStr = JSON.stringify(anonymized.patterns);
+        const redacted = redactPII(jsonStr);
+        anonymized.patterns = JSON.parse(redacted);
+        transforms.push('pii-redacted');
+        // Generalize timestamps
+        anonymized.anonymization.timestampsGeneralized = true;
+        transforms.push('timestamps-generalized');
+    }
+    // Level: Strict
+    if (['strict', 'paranoid'].includes(level)) {
+        // Hash all IDs
+        for (const pattern of anonymized.patterns.routing) {
+            pattern.id = `pattern_${hash(pattern.id).slice(0, 12)}`;
+        }
+        transforms.push('ids-hashed');
+        // Remove context details
+        for (const pattern of anonymized.patterns.routing) {
+            pattern.context = undefined;
+        }
+        transforms.push('context-removed');
+        anonymized.anonymization.pathsStripped = true;
+        transforms.push('paths-stripped');
+    }
+    // Level: Paranoid
+    if (level === 'paranoid') {
+        // Add noise to numeric values (differential privacy)
+        for (const pattern of anonymized.patterns.routing) {
+            pattern.usageCount = Math.round(pattern.usageCount * (0.9 + Math.random() * 0.2));
+            pattern.successRate = Math.min(1, Math.max(0, pattern.successRate + (Math.random() - 0.5) * 0.1));
+        }
+        transforms.push('differential-privacy-noise');
+        // Remove all trajectory learnings
+        for (const traj of anonymized.patterns.trajectory) {
+            traj.learnings = [];
+        }
+        transforms.push('learnings-removed');
+    }
+    // Update anonymization record
+    anonymized.anonymization.level = level;
+    anonymized.anonymization.appliedTransforms = transforms;
+    anonymized.anonymization.piiRedacted = level !== 'minimal';
+    // Recalculate checksum
+    const content = JSON.stringify({
+        magic: anonymized.magic,
+        version: anonymized.version,
+        metadata: anonymized.metadata,
+        patterns: anonymized.patterns,
+    });
+    anonymized.anonymization.checksum = hash(content);
+    return { cfp: anonymized, transforms };
+}
+/**
+ * Scan CFP for PII without modification
+ */
+export function scanCFPForPII(cfp) {
+    const content = JSON.stringify(cfp.patterns);
+    return detectPII(content);
+}
+//# sourceMappingURL=index.js.map

package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env npx tsx
+/**
+ * Deploy Seraphine Genesis Model
+ * Exports and uploads the first Claude Flow 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/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env npx tsx
+/**
+ * Deploy Seraphine Genesis Model
+ * Exports and uploads the first Claude Flow 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 Claude Flow 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 Claude Flow 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 Claude Flow 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/v3/@claude-flow/cli/dist/src/transfer/export.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pattern Export Pipeline
+ * Export patterns with anonymization and optional IPFS upload
+ */
+import type { CFPFormat, ExportOptions, ExportResult } from './types.js';
+/**
+ * Export patterns to file or IPFS
+ */
+export declare function exportPatterns(cfp: CFPFormat, options?: ExportOptions): Promise<ExportResult>;
+/**
+ * Export Seraphine genesis model
+ */
+export declare function exportSeraphine(options?: ExportOptions): Promise<ExportResult>;
+/**
+ * Quick export to file
+ */
+export declare function quickExport(cfp: CFPFormat, outputPath: string): Promise<ExportResult>;
+/**
+ * Quick export to IPFS
+ */
+export declare function quickExportToIPFS(cfp: CFPFormat, options?: {
+    gateway?: string;
+    pin?: boolean;
+}): Promise<ExportResult>;
+//# sourceMappingURL=export.d.ts.map