mcard-js 2.1.41 → 2.1.43

package/dist/ptr/Bridgelet.js

@@ -1,296 +0,0 @@
-/**
- * Bridgelet Universal Vehicle - Cross-Language Execution Abstraction
- *
- * The Bridgelet provides a universal interface for executing CLM logic across
- * different language runtimes, enabling polyglot composition of PCards.
- *
- * ## Conceptual Foundation
- *
- * Bridgelet = Universal Vehicle for Cross-Language Execution
- *
- * Just as a physical bridge connects two lands, a Bridgelet connects two
- * language runtimes, enabling data and control flow across the boundary.
- *
- * ## Architecture
- *
- * ```
- * ┌─────────────────────────────────────────────────────────────────────┐
- * │                        Bridgelet Interface                          │
- * │  invoke(pcard_hash, input_vcard) → output_vcard                    │
- * └───────────────────────────┬─────────────────────────────────────────┘
- *                             │
- *         ┌───────────────────┼───────────────────────┐
- *         ▼                   ▼                       ▼
- *     ┌────────┐         ┌────────┐             ┌────────┐
- *     │  JS    │         │ Python │             │ WASM   │
- *     │Runtime │         │(HTTP)  │             │Runtime │
- *     └────────┘         └────────┘             └────────┘
- * ```
- *
- * ## Protocol
- *
- * 1. Serialize input VCard to content-addressable format (MCard)
- * 2. Invoke target runtime with PCard hash and input MCard hash
- * 3. Receive output MCard hash
- * 4. Deserialize output MCard to VCard
- *
- * All data crosses the bridge as immutable MCards (content-addressed),
- * ensuring EOS (Experimental-Operational Symmetry).
- *
- * @see CLM_MCard_REPL_Implementation.md §10: Bridgelet Universal Vehicle
- * @see PTR_MCard_CLM_Recent_Developments_Jan2026.md §5.3: Polyglot Execution
- */
-import { parse } from 'yaml';
-/**
- * Supported runtime types for Bridgelet execution
- */
-export var RuntimeType;
-(function (RuntimeType) {
-    RuntimeType["JAVASCRIPT"] = "javascript";
-    RuntimeType["TYPESCRIPT"] = "typescript";
-    RuntimeType["PYTHON"] = "python";
-    RuntimeType["WASM"] = "wasm";
-    RuntimeType["LEAN"] = "lean";
-    RuntimeType["UNKNOWN"] = "unknown";
-})(RuntimeType || (RuntimeType = {}));
-/**
- * JavaScript/TypeScript Bridgelet adapter.
- *
- * Executes PCards using the local JavaScript CLM runner.
- */
-export class JavaScriptBridgeletAdapter {
-    collection;
-    constructor(collection) {
-        this.collection = collection;
-    }
-    getRuntimeType() {
-        return RuntimeType.JAVASCRIPT;
-    }
-    isAvailable() {
-        return true; // JS is always available in JS runtime
-    }
-    async invoke(invocation) {
-        const startTime = Date.now();
-        try {
-            // For JavaScript runtime, we execute via CLMRunner
-            // Note: Bridgelet operates on content hashes, but CLMRunner 
-            // primarily works with file paths. This adapter bridges the gap.
-            // If we have a collection, we can try to resolve the PCard
-            if (this.collection) {
-                const pcard = await this.collection.get(invocation.pcardHash);
-                if (pcard) {
-                    // Parse the CLM content
-                    const { parse } = await import('yaml');
-                    const content = typeof pcard.content === 'string'
-                        ? pcard.content
-                        : new TextDecoder().decode(pcard.content);
-                    const clm = parse(content);
-                    // Execute via CLMRunner
-                    const { CLMRunner } = await import('./node/CLMRunner.js');
-                    const runner = new CLMRunner(process.cwd(), 5000, this.collection);
-                    // Build execution context with input VCard hash
-                    const input = {
-                        ...invocation.context,
-                        input_vcard_hash: invocation.inputVCardHash
-                    };
-                    // Execute the CLM
-                    const result = await runner.executeCLM(clm, process.cwd(), input);
-                    const executionTimeMs = Date.now() - startTime;
-                    if (result.success) {
-                        // ExecutionResult uses 'result' not 'output'
-                        // Generate a hash from the result for output tracking
-                        const resultStr = JSON.stringify(result.result);
-                        const outputHash = `result:${resultStr.length}:${Date.now()}`;
-                        return {
-                            success: true,
-                            outputVCardHash: outputHash,
-                            executionTimeMs,
-                            executedBy: RuntimeType.JAVASCRIPT,
-                            metadata: {
-                                outputType: typeof result.result,
-                                chapter: result.clm?.chapter
-                            }
-                        };
-                    }
-                    else {
-                        return {
-                            success: false,
-                            error: result.error || 'Execution failed',
-                            executionTimeMs,
-                            executedBy: RuntimeType.JAVASCRIPT,
-                            metadata: {}
-                        };
-                    }
-                }
-            }
-            // Fallback: No collection or PCard not found
-            const executionTimeMs = Date.now() - startTime;
-            return {
-                success: false,
-                error: `PCard not found in collection: ${invocation.pcardHash}`,
-                executionTimeMs,
-                executedBy: RuntimeType.JAVASCRIPT,
-                metadata: {}
-            };
-        }
-        catch (e) {
-            const executionTimeMs = Date.now() - startTime;
-            console.error(`JavaScript Bridgelet invocation failed: ${e.message}`);
-            return {
-                success: false,
-                error: e.message,
-                executionTimeMs,
-                executedBy: RuntimeType.JAVASCRIPT,
-                metadata: {}
-            };
-        }
-    }
-}
-/**
- * Universal Vehicle for Cross-Language Execution.
- *
- * The Bridgelet manages a registry of runtime adapters and routes
- * PCard execution requests to the appropriate runtime based on
- * the PCard's declared runtime requirement.
- *
- * ## Usage
- *
- * ```typescript
- * const bridgelet = new Bridgelet(collection);
- * bridgelet.registerAdapter(new JavaScriptBridgeletAdapter());
- * bridgelet.registerAdapter(new PythonHTTPBridgeletAdapter('http://localhost:8000'));
- *
- * const result = await bridgelet.invoke({
- *     pcardHash: "abc123",
- *     inputVCardHash: "def456",
- *     context: { param: "value" }
- * });
- * ```
- *
- * ## Cross-Language Composition
- *
- * The Bridgelet enables polyglot PCard composition:
- *
- * ```typescript
- * jsPCard.andThen(pythonPCard).andThen(wasmPCard)
- * ```
- *
- * Each transition crosses a runtime bridge, with data flowing
- * as content-addressed MCards.
- */
-export class Bridgelet {
-    collection;
-    adapters = new Map();
-    traceCounter = 0;
-    constructor(collection) {
-        this.collection = collection;
-        // Auto-register JavaScript adapter
-        this.registerAdapter(new JavaScriptBridgeletAdapter(collection));
-    }
-    /**
-     * Register a runtime adapter
-     */
-    registerAdapter(adapter) {
-        const runtimeType = adapter.getRuntimeType();
-        this.adapters.set(runtimeType, adapter);
-        console.log(`Registered Bridgelet adapter for ${runtimeType}`);
-    }
-    /**
-     * Get list of available runtimes
-     */
-    getAvailableRuntimes() {
-        return Array.from(this.adapters.entries())
-            .filter(([_, adapter]) => adapter.isAvailable())
-            .map(([rt, _]) => rt);
-    }
-    /**
-     * Generate a unique trace ID for observability
-     */
-    generateTraceId() {
-        this.traceCounter++;
-        return `bridgelet-${Date.now()}-${this.traceCounter}`;
-    }
-    /**
-     * Detect the required runtime for a PCard
-     */
-    async detectRuntime(pcardHash) {
-        if (!this.collection) {
-            return RuntimeType.JAVASCRIPT; // Default
-        }
-        try {
-            const pcard = await this.collection.get(pcardHash);
-            if (!pcard) {
-                return RuntimeType.JAVASCRIPT;
-            }
-            // Parse CLM content
-            const content = typeof pcard.content === 'string'
-                ? pcard.content
-                : new TextDecoder().decode(pcard.content);
-            const clm = parse(content);
-            // Extract runtime from CLM
-            const runtimeStr = clm?.clm?.concrete?.runtime ||
-                clm?.concrete?.runtime ||
-                'javascript';
-            // Map string to RuntimeType
-            const runtimeMap = {
-                'python': RuntimeType.PYTHON,
-                'javascript': RuntimeType.JAVASCRIPT,
-                'typescript': RuntimeType.TYPESCRIPT,
-                'js': RuntimeType.JAVASCRIPT,
-                'ts': RuntimeType.TYPESCRIPT,
-                'wasm': RuntimeType.WASM,
-                'lean': RuntimeType.LEAN
-            };
-            return runtimeMap[runtimeStr.toLowerCase()] ?? RuntimeType.JAVASCRIPT;
-        }
-        catch (e) {
-            console.warn(`Failed to detect runtime for ${pcardHash}: ${e}`);
-            return RuntimeType.JAVASCRIPT;
-        }
-    }
-    /**
-     * Invoke a PCard across the appropriate runtime bridge
-     */
-    async invoke(options) {
-        const { pcardHash, inputVCardHash, context = {}, targetRuntime } = options;
-        const traceId = this.generateTraceId();
-        // Detect or use specified runtime
-        const runtime = targetRuntime ?? await this.detectRuntime(pcardHash);
-        // Check if adapter is available
-        if (!this.adapters.has(runtime)) {
-            return {
-                success: false,
-                error: `No adapter registered for runtime: ${runtime}`,
-                executionTimeMs: 0,
-                executedBy: RuntimeType.UNKNOWN,
-                metadata: {}
-            };
-        }
-        const adapter = this.adapters.get(runtime);
-        if (!adapter.isAvailable()) {
-            return {
-                success: false,
-                error: `Runtime not available: ${runtime}`,
-                executionTimeMs: 0,
-                executedBy: RuntimeType.UNKNOWN,
-                metadata: {}
-            };
-        }
-        // Create invocation
-        const invocation = {
-            pcardHash,
-            inputVCardHash,
-            targetRuntime: runtime,
-            context,
-            traceId
-        };
-        console.log(`Bridgelet invoking ${pcardHash.substring(0, 8)}... via ${runtime} ` +
-            `(trace: ${traceId})`);
-        // Invoke through adapter
-        const result = await adapter.invoke(invocation);
-        console.log(`Bridgelet invocation complete: ${result.success ? 'success' : 'failed'} ` +
-            `(${result.executionTimeMs}ms)`);
-        return result;
-    }
-}
-//# sourceMappingURL=Bridgelet.js.map

package/dist/ptr/Bridgelet.js.map

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

package/dist/ptr/CLMIntrospection.d.ts

@@ -1,169 +0,0 @@
-/**
- * CLM Introspection - Recursive CLM Hierarchy Analysis
- *
- * This module provides introspection capabilities for CLM (Cubical Logic Model)
- * hierarchies, enabling formal inspection of recursive CLM composition.
- *
- * ## Recursive CLM Composition
- *
- * CLMs can compose recursively, creating hierarchies of specifications:
- *
- * ```
- * Root CLM (Chapter)
- * ├── Sub-CLM A (referenced PCard)
- * │   ├── Leaf CLM X
- * │   └── Leaf CLM Y
- * └── Sub-CLM B (referenced PCard)
- *     └── Leaf CLM Z
- * ```
- *
- * This module enables:
- * - Traversal of CLM dependency graphs
- * - Detection of circular dependencies
- * - Extraction of CLM metadata at any level
- * - Composition path tracing
- *
- * ## SMC Structure Preservation
- *
- * The introspection respects the Symmetric Monoidal Category structure:
- * - Composition paths preserve associativity
- * - Parallel compositions are correctly identified
- * - Identity CLMs are recognized
- *
- * @see CLM_MCard_REPL_Implementation.md §8: Recursive CLM Composition
- * @see PTR_MCard_CLM_Recent_Developments_Jan2026.md §4.2: Recursive Structure
- */
-/**
- * Type classification for CLM nodes
- */
-export declare enum CLMType {
-    CHAPTER = "chapter",// Has chapter metadata
-    PCARD = "pcard",// Pure PCard (no chapter wrapper)
-    COMPOSED = "composed",// Sequential composition (andThen)
-    PARALLEL = "parallel",// Tensor product (andAlso)
-    REFERENCE = "reference",// Reference to another CLM by hash
-    UNKNOWN = "unknown"
-}
-/**
- * Type of composition between CLMs
- */
-export declare enum CompositionType {
-    SEQUENTIAL = "sequential",// A ; B (Coend composition)
-    PARALLEL = "parallel",// A ⊗ B (Tensor product)
-    NONE = "none"
-}
-/**
- * Represents a node in the CLM hierarchy tree
- */
-export interface CLMNode {
-    /** Content hash (MCard identity) */
-    hash: string;
-    /** Node classification */
-    clmType: CLMType;
-    /** CLM dimensions */
-    abstract?: Record<string, any>;
-    concrete?: Record<string, any>;
-    balanced?: Record<string, any>;
-    /** Chapter metadata (if present) */
-    chapter?: Record<string, any>;
-    /** Composition metadata */
-    compositionType: CompositionType;
-    /** Children nodes (for composed CLMs) */
-    children: CLMNode[];
-    /** Parent hash (for traversal) */
-    parentHash?: string;
-    /** Depth in the hierarchy (root = 0) */
-    depth: number;
-    /** Declared runtime */
-    runtime: string;
-}
-/**
- * Result of CLM hierarchy introspection
- */
-export interface CLMIntrospectionResult {
-    /** Root node of the hierarchy */
-    root: CLMNode;
-    /** All nodes indexed by hash */
-    nodes: Map<string, CLMNode>;
-    /** Maximum depth of the hierarchy */
-    maxDepth: number;
-    /** Total node count */
-    nodeCount: number;
-    /** Detected circular dependencies */
-    cycles: string[][];
-    /** Runtime distribution */
-    runtimes: Map<string, number>;
-    /** Composition statistics */
-    sequentialCount: number;
-    parallelCount: number;
-    leafCount: number;
-}
-/**
- * Recursive CLM Hierarchy Introspector
- *
- * Analyzes CLM composition graphs, extracting structure and metadata
- * from arbitrarily nested CLM hierarchies.
- *
- * ## Usage
- *
- * ```typescript
- * const introspector = new CLMIntrospector(collection);
- * const result = await introspector.introspect("root_pcard_hash");
- *
- * // Access hierarchy
- * console.log(result.root.chapter);
- * for (const child of result.root.children) {
- *     console.log(`  - ${child.hash}: ${child.clmType}`);
- * }
- *
- * // Check for cycles
- * if (result.cycles.length > 0) {
- *     console.log(`Circular dependencies detected: ${result.cycles}`);
- * }
- * ```
- */
-export declare class CLMIntrospector {
-    private collection;
-    private maxDepth;
-    private visited;
-    private nodes;
-    private cycles;
-    constructor(collection?: any, maxDepth?: number);
-    /**
-     * Introspect a CLM hierarchy starting from the given root
-     */
-    introspect(pcardHash: string): Promise<CLMIntrospectionResult>;
-    /**
-     * Recursively build the CLM tree from a PCard hash
-     */
-    private buildTree;
-    /**
-     * Get CLM data from a PCard hash
-     */
-    private getCLMData;
-    /**
-     * Create a CLMNode from parsed CLM data
-     */
-    private createNode;
-    /**
-     * Classify the CLM by its structure
-     */
-    private classifyCLM;
-    /**
-     * Count nodes by runtime
-     */
-    private countRuntimes;
-    /**
-     * Count sequential, parallel, and leaf compositions
-     */
-    private countCompositions;
-    /**
-     * Generate a tree visualization of the CLM hierarchy
-     */
-    toTreeString(result: CLMIntrospectionResult): string;
-    /**
-     * Recursive helper for tree visualization
-     */
-    private treeToString;
-}
-//# sourceMappingURL=CLMIntrospection.d.ts.map

package/dist/ptr/CLMIntrospection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CLMIntrospection.d.ts","sourceRoot":"","sources":["../../src/ptr/CLMIntrospection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH;;GAEG;AACH,oBAAY,OAAO;IACf,OAAO,YAAY,CAAS,uBAAuB;IACnD,KAAK,UAAU,CAAa,kCAAkC;IAC9D,QAAQ,aAAa,CAAO,mCAAmC;IAC/D,QAAQ,aAAa,CAAO,2BAA2B;IACvD,SAAS,cAAc,CAAK,mCAAmC;IAC/D,OAAO,YAAY;CACtB;AAED;;GAEG;AACH,oBAAY,eAAe;IACvB,UAAU,eAAe,CAAG,4BAA4B;IACxD,QAAQ,aAAa,CAAO,yBAAyB;IACrD,IAAI,SAAS;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IAEjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,2BAA2B;IAC3B,eAAe,EAAE,eAAe,CAAC;IAEjC,yCAAyC;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IAEd,gCAAgC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IAEnB,2BAA2B;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,MAAM,CAAkB;gBAEpB,UAAU,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAY;IAKpD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoCpE;;OAEG;YACW,SAAS;IAsEvB;;OAEG;YACW,UAAU;IAsBxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiDlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM;IAMpD;;OAEG;IACH,OAAO,CAAC,YAAY;CA0BvB"}