mcard-js 2.1.13 → 2.1.14

package/dist/model/vcard_vocabulary.js

@@ -0,0 +1,187 @@
+/**
+ * VCard Application Vocabulary - Data-driven patterns for side effects.
+ *
+ * Resource types are defined as DATA in vcard_ext/, making the system
+ * fully extensible without code changes.
+ */
+import { HashValidator } from '../hash/HashValidator.js';
+import { RESOURCE_REGISTRY, ResourceCategory } from './vcard_ext/index.js';
+export { ResourceCategory, RESOURCE_REGISTRY };
+// =============================================================================
+// Core Resource Factory
+// =============================================================================
+export class Resource {
+    static async create(resourceType, ...argsAndOptions) {
+        if (!(resourceType in RESOURCE_REGISTRY)) {
+            throw new Error(`Unknown resource type: ${resourceType}. Available: ${Object.keys(RESOURCE_REGISTRY).join(', ')}`);
+        }
+        const rtype = RESOURCE_REGISTRY[resourceType];
+        // Separate positional args from options
+        const positionalArgs = [];
+        let options = {};
+        for (const arg of argsAndOptions) {
+            if (typeof arg === 'object' && !Array.isArray(arg) && arg !== null) {
+                options = { ...options, ...arg };
+            }
+            else {
+                positionalArgs.push(arg);
+            }
+        }
+        options = { ...rtype.defaultOptions, ...options };
+        // Map positional args using type's argNames
+        const templateVars = { ...options };
+        for (let i = 0; i < positionalArgs.length && i < rtype.argNames.length; i++) {
+            templateVars[rtype.argNames[i]] = positionalArgs[i];
+        }
+        const uri = Resource._buildUri(rtype.uriTemplate, templateVars);
+        const hashContent = Resource._buildHashContent(rtype.hashTemplate, templateVars);
+        const contentHash = await HashValidator.computeHash(new TextEncoder().encode(hashContent), 'sha256');
+        const status = Resource._determineStatus(resourceType, templateVars, options);
+        const qosMetrics = { category: rtype.category };
+        for (const [k, v] of Object.entries(templateVars)) {
+            if (v !== undefined && v !== null && !k.startsWith('_')) {
+                qosMetrics[k] = v;
+            }
+        }
+        return { uri, contentHash, status, qosMetrics };
+    }
+    static _buildUri(template, vars) {
+        const preserveUri = vars._preserveUri || false;
+        let uri = template;
+        for (const [key, value] of Object.entries(vars)) {
+            if (value !== undefined && value !== null && !key.startsWith('_')) {
+                let strVal = String(value);
+                if (!preserveUri && (key === 'endpoint' || key === 'collectorUrl')) {
+                    strVal = strVal.replace('http://', '').replace('https://', '');
+                }
+                uri = uri.replace(`{${key}}`, strVal);
+            }
+        }
+        return uri;
+    }
+    static _buildHashContent(template, vars) {
+        let content = template;
+        for (const [key, value] of Object.entries(vars)) {
+            content = content.replace(`{${key}}`, value !== undefined ? String(value) : 'undefined');
+        }
+        return content;
+    }
+    static _determineStatus(resourceType, vars, options) {
+        const required = options.required !== false;
+        if (resourceType === 'env') {
+            const name = vars.name || '';
+            const actualValue = typeof process !== 'undefined' ? (process.env[name] ?? options.default) : undefined;
+            if (actualValue !== undefined)
+                return 'verified';
+            return required ? 'invalid' : 'pending';
+        }
+        return 'pending';
+    }
+    static types() { return Object.keys(RESOURCE_REGISTRY); }
+    static register(type) { RESOURCE_REGISTRY[type.name] = type; }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+export async function createLgtmStack(baseUrl, serviceName, options = {}) {
+    const { environment = 'production', ports = {} } = options;
+    const p = { grafana: 3000, prometheus: 9090, loki: 3100, tempo: 4317, ...ports };
+    return Promise.all([
+        Resource.create('grafana', `${baseUrl}:${p.grafana}`, { description: `Grafana for ${serviceName}` }),
+        Resource.create('prometheus', `${baseUrl}:${p.prometheus}`, { jobName: serviceName }),
+        Resource.create('loki', `${baseUrl}:${p.loki}`, { labels: { service: serviceName, environment } }),
+        Resource.create('tempo', `${baseUrl}:${p.tempo}`, { serviceName })
+    ]);
+}
+// =============================================================================
+// Convenience Wrappers
+// =============================================================================
+export var AccessMode;
+(function (AccessMode) {
+    AccessMode["READ"] = "read";
+    AccessMode["WRITE"] = "write";
+    AccessMode["READ_WRITE"] = "rw";
+    AccessMode["EXECUTE"] = "execute";
+})(AccessMode || (AccessMode = {}));
+export class EnvResource {
+    static async create(name, options = {}) {
+        return Resource.create('env', name, options);
+    }
+    static resolve(ref) {
+        if (!ref.uri.startsWith('env://'))
+            throw new Error(`Not an env:// URI: ${ref.uri}`);
+        return typeof process !== 'undefined' ? process.env[ref.uri.replace('env://', '')] : undefined;
+    }
+}
+export class FileResource {
+    static async create(path, options = {}) {
+        return Resource.create('file', path, { ...options, mode: options.mode || AccessMode.READ });
+    }
+    static async createDirectory(path, options = {}) {
+        return Resource.create('directory', path, options);
+    }
+}
+export class StorageResource {
+    static async createSqlite(path, options = {}) { return Resource.create('sqlite', path, options); }
+    static async createPostgres(conn, options = {}) { return Resource.create('postgres', conn, options); }
+    static async createS3(bucket, key, options = {}) { return Resource.create('s3', bucket, key, options); }
+    static async createLitefs(path, options = {}) { return Resource.create('litefs', path, options); }
+    static async createTurso(db, options = {}) { return Resource.create('turso', db, options); }
+}
+export class NetworkResource {
+    static async createApi(endpoint, options = {}) { return Resource.create('api', endpoint, options); }
+    static async createWebhook(endpoint, options = {}) { return Resource.create('webhook', endpoint, options); }
+}
+export class ObservabilityResource {
+    static async createGrafana(endpoint, options = {}) { return Resource.create('grafana', endpoint, { ...options, endpoint }); }
+    static async createPrometheus(endpoint, options = {}) { return Resource.create('prometheus', endpoint, { ...options, endpoint }); }
+    static async createLoki(endpoint, options = {}) { return Resource.create('loki', endpoint, { ...options, endpoint }); }
+    static async createTempo(endpoint, options = {}) { return Resource.create('tempo', endpoint, { ...options, endpoint }); }
+    static async createFaro(collectorUrl, appName, options = {}) { return Resource.create('faro', collectorUrl, appName, { ...options, collectorUrl }); }
+    static async createOtlp(endpoint, options = {}) { return Resource.create('otlp', endpoint, { ...options, endpoint }); }
+    static async createLgtmStack(baseUrl, serviceName, options) { return createLgtmStack(baseUrl, serviceName, options); }
+}
+// =============================================================================
+// Application Resources Manager
+// =============================================================================
+export class ApplicationResources {
+    resources = [];
+    async add(resourceType, ...argsAndOptions) {
+        this.resources.push(await Resource.create(resourceType, ...argsAndOptions));
+        return this;
+    }
+    async addEnv(name, options) { return this.add('env', name, options || {}); }
+    async addFile(path, options) { return this.add('file', path, options || {}); }
+    async addDirectory(path, options) { return this.add('directory', path, options || {}); }
+    async addSqlite(path, options) { return this.add('sqlite', path, options || {}); }
+    async addLitefs(path, options) { return this.add('litefs', path, options || {}); }
+    async addTurso(db, options) { return this.add('turso', db, options || {}); }
+    async addApi(endpoint, options) { return this.add('api', endpoint, options || {}); }
+    async addGrafana(endpoint, options) { return this.add('grafana', endpoint, options || {}); }
+    async addPrometheus(endpoint, options) { return this.add('prometheus', endpoint, options || {}); }
+    async addLoki(endpoint, options) { return this.add('loki', endpoint, options || {}); }
+    async addTempo(endpoint, options) { return this.add('tempo', endpoint, options || {}); }
+    async addFaro(url, app, options) { this.resources.push(await ObservabilityResource.createFaro(url, app, options)); return this; }
+    async addOtlp(endpoint, options) { return this.add('otlp', endpoint, options || {}); }
+    async addLgtmStack(baseUrl, serviceName, options) {
+        this.resources.push(...await createLgtmStack(baseUrl, serviceName, options));
+        return this;
+    }
+    getAll() { return this.resources; }
+    getByCategory(category) {
+        const cat = typeof category === 'string' ? category : category;
+        return this.resources.filter(r => r.qosMetrics?.category === cat);
+    }
+    getObservabilityResources() { return this.resources.filter(r => r.qosMetrics?.category === 'observability'); }
+    getInvalid() { return this.resources.filter(r => r.status === 'invalid'); }
+    validate() {
+        const invalid = this.getInvalid();
+        return {
+            valid: invalid.length === 0, total: this.resources.length,
+            verified: this.resources.filter(r => r.status === 'verified').length,
+            pending: this.resources.filter(r => r.status === 'pending').length,
+            invalid: invalid.length, invalidResources: invalid.map(r => r.uri)
+        };
+    }
+}
+//# sourceMappingURL=vcard_vocabulary.js.map

package/dist/model/vcard_vocabulary.js.map

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

package/dist/types/dots.d.ts

@@ -0,0 +1,206 @@
+/**
+ * DOTS Vocabulary Types
+ *
+ * From the Double Operadic Theory of Systems (DOTS), this module provides
+ * a minimal, domain-independent vocabulary for describing compositional systems.
+ *
+ * The MVP Cards architecture maps directly to DOTS:
+ * - MCard → Carrier (the actual data/systems)
+ * - PCard → Lens (tight) + Chart (loose)
+ * - VCard → Arena + Action
+ *
+ * Reference: docs/WorkingNotes/Hub/Theory/Integration/DOTS Vocabulary as Efficient Representation for ABC Curriculum.md
+ */
+/**
+ * DOTS Role enumeration
+ *
+ * These nine terms (seven structural + Action + Unit) form a complete,
+ * compositional language for describing any system, interface, or interaction.
+ */
+export declare enum DOTSRole {
+    /**
+     * CARRIER - Category Car(S) of all actual data/systems
+     *
+     * MCard is the Carrier. Each MCard is an Object in the Carrier category;
+     * each hash-link is a Morphism in Car(S).
+     *
+     * Polynomial Form: Objects = MCards, Morphisms = hash references
+     */
+    CARRIER = "Carrier",
+    /**
+     * LENS - Tight morphism (structure-preserving interface map)
+     *
+     * PCard's abstract_spec ↔ concrete_impl relationship is a Lens.
+     * Ensures type safety: Abstract types match Concrete types.
+     *
+     * Lens = (get, put) pair with coherence laws
+     */
+    LENS = "Lens",
+    /**
+     * CHART - Loose morphism (behavioral interaction pattern)
+     *
+     * PCard's balanced_expectations (tests) describe the wiring.
+     * Enables flexibility: same Abstract spec via different Concrete implementations.
+     *
+     * Chart = horizontal morphism in Target double category
+     */
+    CHART = "Chart",
+    /**
+     * ARENA - Interface type (what can interact)
+     *
+     * VCard is the Arena. It defines the subject_did, capabilities[],
+     * and ExternalRef[]. An Arena is a pair of sets (Inputs, Outputs).
+     *
+     * Arena = (I, O) → Polynomial functor P(X) = Σ_{i∈I} X^{O(i)}
+     */
+    ARENA = "Arena",
+    /**
+     * ACTION - Module structure where interactions act on systems
+     *
+     * VCard enables Action: interactions (Charts/PCards) act on
+     * systems (MCards/Carrier) to produce new systems.
+     * The VCard authorization gate is the mechanism of this action.
+     *
+     * Action = Loose(I) ⊛ Car(S) → Car(S)
+     */
+    ACTION = "Action",
+    /**
+     * TARGET - Double category I of all interfaces and interactions
+     *
+     * The CLM design space. Contains all possible Arenas (objects),
+     * Lenses (tight morphisms), and Charts (loose morphisms).
+     */
+    TARGET = "Target",
+    /**
+     * TIGHT - Vertical composition direction (strict)
+     *
+     * Prerequisites chains. Cannot skip foundational concepts.
+     * Ensures type safety across compositions.
+     *
+     * Vertical = mandatory sequential dependency
+     */
+    TIGHT = "Tight",
+    /**
+     * LOOSE - Horizontal composition direction (flexible)
+     *
+     * Same concept via different interaction patterns.
+     * Enables behavioral flexibility while preserving semantics.
+     *
+     * Horizontal = parallel/interchangeable alternatives
+     */
+    LOOSE = "Loose",
+    /**
+     * UNIT - Identity object for parallel composition
+     *
+     * Empty MCard / Root Namespace. The neutral element.
+     * For any system S: Unit ⊗ S ≅ S
+     */
+    UNIT = "Unit"
+}
+/**
+ * EOS (Experimental-Operational Symmetry) Role
+ *
+ * Each MVP Card type enforces a specific dimension of symmetry
+ * to ensure environment-invariant correctness.
+ */
+export declare enum EOSRole {
+    /**
+     * INVARIANT_CONTENT - The Galois Root
+     *
+     * MCard: Hash(Content) is a pure function.
+     * Same content in Dev = Same hash in Prod.
+     * Environment-invariant identity.
+     */
+    INVARIANT_CONTENT = "InvariantContent",
+    /**
+     * GENERATIVE_LENS - Controlled Symmetry Breaking 1
+     *
+     * PCard: Pure function f(x)=y.
+     * Invariant in definition, variant only in input.
+     * The logic is environment-invariant.
+     */
+    GENERATIVE_LENS = "GenerativeLens",
+    /**
+     * SOVEREIGN_DECISION - Controlled Symmetry Breaking 2
+     *
+     * VCard: The Gap Junction.
+     * Breaks symmetry by introducing Authority.
+     * Decisional reality creation.
+     */
+    SOVEREIGN_DECISION = "SovereignDecision"
+}
+/**
+ * Card Plane in the MVP Cards architecture
+ *
+ * Maps to SDN (Software-Defined Networking) plane separation:
+ * Data Plane → Control Plane → Application Plane
+ */
+export declare enum CardPlane {
+    /**
+     * DATA_PLANE - MCard
+     *
+     * Immutable, content-addressable storage.
+     * The monadic foundation that wraps effects.
+     * CRD-only operations (Create, Retrieve, Delete).
+     */
+    DATA = "Data",
+    /**
+     * CONTROL_PLANE - PCard
+     *
+     * Polynomial functor composition.
+     * Monadic execution via PTR.
+     * Policy and logic gating.
+     */
+    CONTROL = "Control",
+    /**
+     * APPLICATION_PLANE - VCard
+     *
+     * Value exchange and authentication.
+     * Side effect management (IO Monad).
+     * Sovereign memory and authorization.
+     */
+    APPLICATION = "Application"
+}
+/**
+ * Polynomial Functor Type
+ *
+ * The mathematical foundation for DOTS.
+ * Every DOTS component is a polynomial functor of the form:
+ * P(X) = Σ_{i∈I} X^{O(i)}
+ */
+export interface PolynomialFunctor {
+    /** Positions (I) - input types, system states */
+    positions: string[];
+    /** Directions O(i) - output types per position */
+    directions: Record<string, string[]>;
+}
+/**
+ * DOTS metadata that can be attached to any card type
+ */
+export interface DOTSMetadata {
+    /** Primary DOTS role (Carrier, Lens, Chart, Arena, Action) */
+    role: DOTSRole;
+    /** EOS symmetry role */
+    eosRole?: EOSRole;
+    /** Card plane (Data, Control, Application) */
+    plane: CardPlane;
+    /** Polynomial functor representation (optional) */
+    polynomial?: PolynomialFunctor;
+    /** Tight morphism references (prerequisite hashes) */
+    tightRefs?: string[];
+    /** Loose morphism references (alternative implementation hashes) */
+    looseRefs?: string[];
+}
+/**
+ * Create DOTS metadata for an MCard
+ */
+export declare function createMCardDOTSMetadata(tightRefs?: string[], looseRefs?: string[]): DOTSMetadata;
+/**
+ * Create DOTS metadata for a PCard (CLM)
+ */
+export declare function createPCardDOTSMetadata(isLens: boolean, tightRefs?: string[], looseRefs?: string[]): DOTSMetadata;
+/**
+ * Create DOTS metadata for a VCard
+ */
+export declare function createVCardDOTSMetadata(): DOTSMetadata;
+//# sourceMappingURL=dots.d.ts.map

package/dist/types/dots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dots.d.ts","sourceRoot":"","sources":["../../src/types/dots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,oBAAY,QAAQ;IAChB;;;;;;;OAOG;IACH,OAAO,YAAY;IAEnB;;;;;;;OAOG;IACH,IAAI,SAAS;IAEb;;;;;;;OAOG;IACH,KAAK,UAAU;IAEf;;;;;;;OAOG;IACH,KAAK,UAAU;IAEf;;;;;;;;OAQG;IACH,MAAM,WAAW;IAEjB;;;;;OAKG;IACH,MAAM,WAAW;IAEjB;;;;;;;OAOG;IACH,KAAK,UAAU;IAEf;;;;;;;OAOG;IACH,KAAK,UAAU;IAEf;;;;;OAKG;IACH,IAAI,SAAS;CAChB;AAED;;;;;GAKG;AACH,oBAAY,OAAO;IACf;;;;;;OAMG;IACH,iBAAiB,qBAAqB;IAEtC;;;;;;OAMG;IACH,eAAe,mBAAmB;IAElC;;;;;;OAMG;IACH,kBAAkB,sBAAsB;CAC3C;AAED;;;;;GAKG;AACH,oBAAY,SAAS;IACjB;;;;;;OAMG;IACH,IAAI,SAAS;IAEb;;;;;;OAMG;IACH,OAAO,YAAY;IAEnB;;;;;;OAMG;IACH,WAAW,gBAAgB;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B,iDAAiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,8DAA8D;IAC9D,IAAI,EAAE,QAAQ,CAAC;IAEf,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;IAEjB,mDAAmD;IACnD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,GAAE,MAAM,EAAO,EACxB,SAAS,GAAE,MAAM,EAAO,GACzB,YAAY,CAQd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,OAAO,EACf,SAAS,GAAE,MAAM,EAAO,EACxB,SAAS,GAAE,MAAM,EAAO,GACzB,YAAY,CAQd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,YAAY,CAMtD"}

package/dist/types/dots.js

@@ -0,0 +1,201 @@
+/**
+ * DOTS Vocabulary Types
+ *
+ * From the Double Operadic Theory of Systems (DOTS), this module provides
+ * a minimal, domain-independent vocabulary for describing compositional systems.
+ *
+ * The MVP Cards architecture maps directly to DOTS:
+ * - MCard → Carrier (the actual data/systems)
+ * - PCard → Lens (tight) + Chart (loose)
+ * - VCard → Arena + Action
+ *
+ * Reference: docs/WorkingNotes/Hub/Theory/Integration/DOTS Vocabulary as Efficient Representation for ABC Curriculum.md
+ */
+/**
+ * DOTS Role enumeration
+ *
+ * These nine terms (seven structural + Action + Unit) form a complete,
+ * compositional language for describing any system, interface, or interaction.
+ */
+export var DOTSRole;
+(function (DOTSRole) {
+    /**
+     * CARRIER - Category Car(S) of all actual data/systems
+     *
+     * MCard is the Carrier. Each MCard is an Object in the Carrier category;
+     * each hash-link is a Morphism in Car(S).
+     *
+     * Polynomial Form: Objects = MCards, Morphisms = hash references
+     */
+    DOTSRole["CARRIER"] = "Carrier";
+    /**
+     * LENS - Tight morphism (structure-preserving interface map)
+     *
+     * PCard's abstract_spec ↔ concrete_impl relationship is a Lens.
+     * Ensures type safety: Abstract types match Concrete types.
+     *
+     * Lens = (get, put) pair with coherence laws
+     */
+    DOTSRole["LENS"] = "Lens";
+    /**
+     * CHART - Loose morphism (behavioral interaction pattern)
+     *
+     * PCard's balanced_expectations (tests) describe the wiring.
+     * Enables flexibility: same Abstract spec via different Concrete implementations.
+     *
+     * Chart = horizontal morphism in Target double category
+     */
+    DOTSRole["CHART"] = "Chart";
+    /**
+     * ARENA - Interface type (what can interact)
+     *
+     * VCard is the Arena. It defines the subject_did, capabilities[],
+     * and ExternalRef[]. An Arena is a pair of sets (Inputs, Outputs).
+     *
+     * Arena = (I, O) → Polynomial functor P(X) = Σ_{i∈I} X^{O(i)}
+     */
+    DOTSRole["ARENA"] = "Arena";
+    /**
+     * ACTION - Module structure where interactions act on systems
+     *
+     * VCard enables Action: interactions (Charts/PCards) act on
+     * systems (MCards/Carrier) to produce new systems.
+     * The VCard authorization gate is the mechanism of this action.
+     *
+     * Action = Loose(I) ⊛ Car(S) → Car(S)
+     */
+    DOTSRole["ACTION"] = "Action";
+    /**
+     * TARGET - Double category I of all interfaces and interactions
+     *
+     * The CLM design space. Contains all possible Arenas (objects),
+     * Lenses (tight morphisms), and Charts (loose morphisms).
+     */
+    DOTSRole["TARGET"] = "Target";
+    /**
+     * TIGHT - Vertical composition direction (strict)
+     *
+     * Prerequisites chains. Cannot skip foundational concepts.
+     * Ensures type safety across compositions.
+     *
+     * Vertical = mandatory sequential dependency
+     */
+    DOTSRole["TIGHT"] = "Tight";
+    /**
+     * LOOSE - Horizontal composition direction (flexible)
+     *
+     * Same concept via different interaction patterns.
+     * Enables behavioral flexibility while preserving semantics.
+     *
+     * Horizontal = parallel/interchangeable alternatives
+     */
+    DOTSRole["LOOSE"] = "Loose";
+    /**
+     * UNIT - Identity object for parallel composition
+     *
+     * Empty MCard / Root Namespace. The neutral element.
+     * For any system S: Unit ⊗ S ≅ S
+     */
+    DOTSRole["UNIT"] = "Unit";
+})(DOTSRole || (DOTSRole = {}));
+/**
+ * EOS (Experimental-Operational Symmetry) Role
+ *
+ * Each MVP Card type enforces a specific dimension of symmetry
+ * to ensure environment-invariant correctness.
+ */
+export var EOSRole;
+(function (EOSRole) {
+    /**
+     * INVARIANT_CONTENT - The Galois Root
+     *
+     * MCard: Hash(Content) is a pure function.
+     * Same content in Dev = Same hash in Prod.
+     * Environment-invariant identity.
+     */
+    EOSRole["INVARIANT_CONTENT"] = "InvariantContent";
+    /**
+     * GENERATIVE_LENS - Controlled Symmetry Breaking 1
+     *
+     * PCard: Pure function f(x)=y.
+     * Invariant in definition, variant only in input.
+     * The logic is environment-invariant.
+     */
+    EOSRole["GENERATIVE_LENS"] = "GenerativeLens";
+    /**
+     * SOVEREIGN_DECISION - Controlled Symmetry Breaking 2
+     *
+     * VCard: The Gap Junction.
+     * Breaks symmetry by introducing Authority.
+     * Decisional reality creation.
+     */
+    EOSRole["SOVEREIGN_DECISION"] = "SovereignDecision";
+})(EOSRole || (EOSRole = {}));
+/**
+ * Card Plane in the MVP Cards architecture
+ *
+ * Maps to SDN (Software-Defined Networking) plane separation:
+ * Data Plane → Control Plane → Application Plane
+ */
+export var CardPlane;
+(function (CardPlane) {
+    /**
+     * DATA_PLANE - MCard
+     *
+     * Immutable, content-addressable storage.
+     * The monadic foundation that wraps effects.
+     * CRD-only operations (Create, Retrieve, Delete).
+     */
+    CardPlane["DATA"] = "Data";
+    /**
+     * CONTROL_PLANE - PCard
+     *
+     * Polynomial functor composition.
+     * Monadic execution via PTR.
+     * Policy and logic gating.
+     */
+    CardPlane["CONTROL"] = "Control";
+    /**
+     * APPLICATION_PLANE - VCard
+     *
+     * Value exchange and authentication.
+     * Side effect management (IO Monad).
+     * Sovereign memory and authorization.
+     */
+    CardPlane["APPLICATION"] = "Application";
+})(CardPlane || (CardPlane = {}));
+/**
+ * Create DOTS metadata for an MCard
+ */
+export function createMCardDOTSMetadata(tightRefs = [], looseRefs = []) {
+    return {
+        role: DOTSRole.CARRIER,
+        eosRole: EOSRole.INVARIANT_CONTENT,
+        plane: CardPlane.DATA,
+        tightRefs,
+        looseRefs
+    };
+}
+/**
+ * Create DOTS metadata for a PCard (CLM)
+ */
+export function createPCardDOTSMetadata(isLens, tightRefs = [], looseRefs = []) {
+    return {
+        role: isLens ? DOTSRole.LENS : DOTSRole.CHART,
+        eosRole: EOSRole.GENERATIVE_LENS,
+        plane: CardPlane.CONTROL,
+        tightRefs,
+        looseRefs
+    };
+}
+/**
+ * Create DOTS metadata for a VCard
+ */
+export function createVCardDOTSMetadata() {
+    return {
+        role: DOTSRole.ARENA,
+        eosRole: EOSRole.SOVEREIGN_DECISION,
+        plane: CardPlane.APPLICATION
+    };
+}
+//# sourceMappingURL=dots.js.map

package/dist/types/dots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dots.js","sourceRoot":"","sources":["../../src/types/dots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,QAuFX;AAvFD,WAAY,QAAQ;IAChB;;;;;;;OAOG;IACH,+BAAmB,CAAA;IAEnB;;;;;;;OAOG;IACH,yBAAa,CAAA;IAEb;;;;;;;OAOG;IACH,2BAAe,CAAA;IAEf;;;;;;;OAOG;IACH,2BAAe,CAAA;IAEf;;;;;;;;OAQG;IACH,6BAAiB,CAAA;IAEjB;;;;;OAKG;IACH,6BAAiB,CAAA;IAEjB;;;;;;;OAOG;IACH,2BAAe,CAAA;IAEf;;;;;;;OAOG;IACH,2BAAe,CAAA;IAEf;;;;;OAKG;IACH,yBAAa,CAAA;AACjB,CAAC,EAvFW,QAAQ,KAAR,QAAQ,QAuFnB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,OA2BX;AA3BD,WAAY,OAAO;IACf;;;;;;OAMG;IACH,iDAAsC,CAAA;IAEtC;;;;;;OAMG;IACH,6CAAkC,CAAA;IAElC;;;;;;OAMG;IACH,mDAAwC,CAAA;AAC5C,CAAC,EA3BW,OAAO,KAAP,OAAO,QA2BlB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,SA2BX;AA3BD,WAAY,SAAS;IACjB;;;;;;OAMG;IACH,0BAAa,CAAA;IAEb;;;;;;OAMG;IACH,gCAAmB,CAAA;IAEnB;;;;;;OAMG;IACH,wCAA2B,CAAA;AAC/B,CAAC,EA3BW,SAAS,KAAT,SAAS,QA2BpB;AAwCD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACnC,YAAsB,EAAE,EACxB,YAAsB,EAAE;IAExB,OAAO;QACH,IAAI,EAAE,QAAQ,CAAC,OAAO;QACtB,OAAO,EAAE,OAAO,CAAC,iBAAiB;QAClC,KAAK,EAAE,SAAS,CAAC,IAAI;QACrB,SAAS;QACT,SAAS;KACZ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACnC,MAAe,EACf,YAAsB,EAAE,EACxB,YAAsB,EAAE;IAExB,OAAO;QACH,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;QAC7C,OAAO,EAAE,OAAO,CAAC,eAAe;QAChC,KAAK,EAAE,SAAS,CAAC,OAAO;QACxB,SAAS;QACT,SAAS;KACZ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACnC,OAAO;QACH,IAAI,EAAE,QAAQ,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,kBAAkB;QACnC,KAAK,EAAE,SAAS,CAAC,WAAW;KAC/B,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mcard-js",
-    "version": "2.1.13",
+    "version": "2.1.14",
     "description": "MCard - Content-addressable storage with cryptographic hashing, handle resolution, and vector search for Node.js and browsers",
     "type": "module",
     "main": "dist/index.js",