yaml-flow 7.1.0 → 8.0.0

package/lib/storage-interface-BhAON-gW.d.ts

@@ -0,0 +1,84 @@
+/**
+ * storage-interface.ts
+ *
+ * Three minimal storage primitives that together cover all persistence needs
+ * of the board-live-cards system. Any backend (Node fs, CosmosDB, Azure Blob,
+ * browser localStorage, in-memory test double) implements these three interfaces.
+ *
+ * The pure-logic stores in board-live-cards-all-stores.ts depend only on these
+ * interfaces — never on Node built-ins.
+ *
+ *  Blob    — raw string content at a logical, backend-neutral key
+ *  Journal — append-only log with cursor-based reads
+ *  KV      — key-value store with list/delete
+ *
+ * Mapping to existing storage adapters:
+ *
+ *   CardStorageAdapter
+ *     inventory (cardId → { blobRef, checksum, fileMetadata? })  → KV
+ *     card JSON files                                             → Blob
+ *     source output files                                         → Blob
+ *
+ *   JournalStorageAdapter     → Journal (board-journal.jsonl)
+ *
+ *   ExecutionRequestStore → KV (keyed by journalId, via createFsKvStorage)
+ *
+ *   StateSnapshotStorageAdapter
+ *     board-graph.json (packed single JSON, written atomically)   → Blob
+ *     per-card sidecars (cards/<id>/runtime, fetched-sources-manifest) → KV
+ */
+interface BlobStat {
+    key: string;
+    size: number;
+    updatedAt?: string;
+    contentType?: string;
+}
+interface BlobStorage {
+    /** Returns raw content string, or null if the blob does not exist. */
+    read(key: string): string | null;
+    /** Write content at key. Implementations should be atomic (write-rename). */
+    write(key: string, content: string): void;
+    /** Returns true if a blob exists at key. */
+    exists(key: string): boolean;
+    /** Delete the blob at key. No-op if it does not exist. */
+    remove(key: string): void;
+    /** Optional binary read for file-like artifacts. */
+    readBytes?(key: string): Uint8Array | null;
+    /** Optional binary write for file-like artifacts. */
+    writeBytes?(key: string, content: Uint8Array): void;
+    /** Optional key listing by prefix. */
+    listKeys?(prefix?: string): string[];
+    /** Optional metadata lookup. */
+    stat?(key: string): BlobStat | null;
+}
+interface KindValueRef {
+    readonly kind: string;
+    readonly value: string;
+}
+/** Serialize a KindValueRef to the wire format: b64:<base64url(json)> */
+declare function serializeRef(ref: KindValueRef): string;
+/** Parse a wire-format ref string (b64:<base64url(json)>) into a KindValueRef. */
+declare function parseRef(s: string): KindValueRef;
+interface KVStorage {
+    /** Returns the stored value, or null if the key does not exist. */
+    read(key: string): unknown | null;
+    /** Write value at key. Overwrites any existing value. */
+    write(key: string, value: unknown): void;
+    /** Delete the key. No-op if it does not exist. */
+    delete(key: string): void;
+    /**
+     * List all keys, optionally filtered to those starting with prefix.
+     * Order is implementation-defined.
+     */
+    listKeys(prefix?: string): string[];
+}
+interface AtomicRelayLock {
+    /**
+     * Attempt to acquire the lock without blocking.
+     * Returns a `release` function if successful, or `null` if the lock is
+     * already held by another actor (relay: that actor will complete the work).
+     */
+    tryAcquire(): (() => void) | null;
+}
+
+export { type AtomicRelayLock as A, type BlobStorage as B, type KVStorage as K, type KindValueRef as a, parseRef as p, serializeRef as s };

package/lib/stores/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var i=class{runs=new Map;data=new Map;async saveRunState(t,e){this.runs.set(t,{...e});}async loadRunState(t){let e=this.runs.get(t);return e?{...e}:null}async deleteRunState(t){this.runs.delete(t),this.data.delete(t);}async setData(t,e,s){this.data.has(t)||this.data.set(t,{});let r=this.data.get(t);r[e]=s;}async getData(t,e){return this.data.get(t)?.[e]}async getAllData(t){return {...this.data.get(t)??{}}}async clearData(t){this.data.delete(t);}async listRuns(){return Array.from(this.runs.keys())}clear(){this.runs.clear(),this.data.clear();}};function n(a){return btoa(a).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function c(a){return atob(a.replace(/-/g,"+").replace(/_/g,"/"))}var o=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${n(t)}`}dataPrefix(t){return `data_${n(t)}_`}dataKey(t,e){return `${this.dataPrefix(t)}${n(e)}`}async saveRunState(t,e){this.kv.write(this.stateKey(t),e);}async loadRunState(t){let e=this.kv.read(this.stateKey(t));return e!=null&&typeof e=="object"?e:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async setData(t,e,s){this.kv.write(this.dataKey(t,e),s);}async getData(t,e){return this.kv.read(this.dataKey(t,e))}async getAllData(t){let e=this.dataPrefix(t),s={};for(let r of this.kv.listKeys(e))s[c(r.slice(e.length))]=this.kv.read(r);return s}async clearData(t){for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async listRuns(){return this.kv.listKeys("state_").map(t=>c(t.slice(6)))}};
+exports.KVStorageStore=o;exports.MemoryStore=i;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/lib/stores/index.d.cts

@@ -0,0 +1,4 @@
+export { MemoryStore } from './memory.cjs';
+export { KVStorageStore } from './kv.cjs';
+import '../types-DQ1bKuB1.cjs';
+import '../storage-interface-BhAON-gW.cjs';

package/lib/stores/index.d.ts

@@ -0,0 +1,4 @@
+export { MemoryStore } from './memory.js';
+export { KVStorageStore } from './kv.js';
+import '../types-DQ1bKuB1.js';
+import '../storage-interface-BhAON-gW.js';

package/lib/stores/index.js

@@ -0,0 +1,3 @@
+var i=class{runs=new Map;data=new Map;async saveRunState(t,e){this.runs.set(t,{...e});}async loadRunState(t){let e=this.runs.get(t);return e?{...e}:null}async deleteRunState(t){this.runs.delete(t),this.data.delete(t);}async setData(t,e,s){this.data.has(t)||this.data.set(t,{});let r=this.data.get(t);r[e]=s;}async getData(t,e){return this.data.get(t)?.[e]}async getAllData(t){return {...this.data.get(t)??{}}}async clearData(t){this.data.delete(t);}async listRuns(){return Array.from(this.runs.keys())}clear(){this.runs.clear(),this.data.clear();}};function n(a){return btoa(a).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function c(a){return atob(a.replace(/-/g,"+").replace(/_/g,"/"))}var o=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${n(t)}`}dataPrefix(t){return `data_${n(t)}_`}dataKey(t,e){return `${this.dataPrefix(t)}${n(e)}`}async saveRunState(t,e){this.kv.write(this.stateKey(t),e);}async loadRunState(t){let e=this.kv.read(this.stateKey(t));return e!=null&&typeof e=="object"?e:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async setData(t,e,s){this.kv.write(this.dataKey(t,e),s);}async getData(t,e){return this.kv.read(this.dataKey(t,e))}async getAllData(t){let e=this.dataPrefix(t),s={};for(let r of this.kv.listKeys(e))s[c(r.slice(e.length))]=this.kv.read(r);return s}async clearData(t){for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async listRuns(){return this.kv.listKeys("state_").map(t=>c(t.slice(6)))}};
+export{o as KVStorageStore,i as MemoryStore};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/lib/stores/kv.cjs

@@ -0,0 +1,3 @@
+'use strict';function i(s){return btoa(s).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function a(s){return atob(s.replace(/-/g,"+").replace(/_/g,"/"))}var o=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${i(t)}`}dataPrefix(t){return `data_${i(t)}_`}dataKey(t,e){return `${this.dataPrefix(t)}${i(e)}`}async saveRunState(t,e){this.kv.write(this.stateKey(t),e);}async loadRunState(t){let e=this.kv.read(this.stateKey(t));return e!=null&&typeof e=="object"?e:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async setData(t,e,r){this.kv.write(this.dataKey(t,e),r);}async getData(t,e){return this.kv.read(this.dataKey(t,e))}async getAllData(t){let e=this.dataPrefix(t),r={};for(let n of this.kv.listKeys(e))r[a(n.slice(e.length))]=this.kv.read(n);return r}async clearData(t){for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async listRuns(){return this.kv.listKeys("state_").map(t=>a(t.slice(6)))}};
+exports.KVStorageStore=o;//# sourceMappingURL=kv.cjs.map
+//# sourceMappingURL=kv.cjs.map

package/lib/stores/kv.d.cts

@@ -0,0 +1,32 @@
+import { l as StepMachineStore, k as StepMachineState } from '../types-DQ1bKuB1.cjs';
+import { K as KVStorage } from '../storage-interface-BhAON-gW.cjs';
+
+/**
+ * yaml-flow - KVStorageStore
+ *
+ * StepMachineStore backed by a platform-agnostic KVStorage.
+ * The platform adapter provides the right KVStorage implementation
+ * (Node.js FS, browser localStorage, in-memory, CosmosDB, etc.).
+ *
+ * Key schema (all parts are base64url-encoded — alphanumeric + '-' + '_' only):
+ *   state_<b64(runId)>              → StepMachineState
+ *   data_<b64(runId)>_<b64(key)>   → arbitrary value
+ */
+
+declare class KVStorageStore implements StepMachineStore {
+    private readonly kv;
+    constructor(kv: KVStorage);
+    private stateKey;
+    private dataPrefix;
+    private dataKey;
+    saveRunState(runId: string, state: StepMachineState): Promise<void>;
+    loadRunState(runId: string): Promise<StepMachineState | null>;
+    deleteRunState(runId: string): Promise<void>;
+    setData(runId: string, key: string, value: unknown): Promise<void>;
+    getData(runId: string, key: string): Promise<unknown>;
+    getAllData(runId: string): Promise<Record<string, unknown>>;
+    clearData(runId: string): Promise<void>;
+    listRuns(): Promise<string[]>;
+}
+
+export { KVStorageStore };

package/lib/stores/kv.d.ts

@@ -0,0 +1,32 @@
+import { l as StepMachineStore, k as StepMachineState } from '../types-DQ1bKuB1.js';
+import { K as KVStorage } from '../storage-interface-BhAON-gW.js';
+
+/**
+ * yaml-flow - KVStorageStore
+ *
+ * StepMachineStore backed by a platform-agnostic KVStorage.
+ * The platform adapter provides the right KVStorage implementation
+ * (Node.js FS, browser localStorage, in-memory, CosmosDB, etc.).
+ *
+ * Key schema (all parts are base64url-encoded — alphanumeric + '-' + '_' only):
+ *   state_<b64(runId)>              → StepMachineState
+ *   data_<b64(runId)>_<b64(key)>   → arbitrary value
+ */
+
+declare class KVStorageStore implements StepMachineStore {
+    private readonly kv;
+    constructor(kv: KVStorage);
+    private stateKey;
+    private dataPrefix;
+    private dataKey;
+    saveRunState(runId: string, state: StepMachineState): Promise<void>;
+    loadRunState(runId: string): Promise<StepMachineState | null>;
+    deleteRunState(runId: string): Promise<void>;
+    setData(runId: string, key: string, value: unknown): Promise<void>;
+    getData(runId: string, key: string): Promise<unknown>;
+    getAllData(runId: string): Promise<Record<string, unknown>>;
+    clearData(runId: string): Promise<void>;
+    listRuns(): Promise<string[]>;
+}
+
+export { KVStorageStore };

package/lib/stores/kv.js

@@ -0,0 +1,3 @@
+function i(s){return btoa(s).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function a(s){return atob(s.replace(/-/g,"+").replace(/_/g,"/"))}var o=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${i(t)}`}dataPrefix(t){return `data_${i(t)}_`}dataKey(t,e){return `${this.dataPrefix(t)}${i(e)}`}async saveRunState(t,e){this.kv.write(this.stateKey(t),e);}async loadRunState(t){let e=this.kv.read(this.stateKey(t));return e!=null&&typeof e=="object"?e:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async setData(t,e,r){this.kv.write(this.dataKey(t,e),r);}async getData(t,e){return this.kv.read(this.dataKey(t,e))}async getAllData(t){let e=this.dataPrefix(t),r={};for(let n of this.kv.listKeys(e))r[a(n.slice(e.length))]=this.kv.read(n);return r}async clearData(t){for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async listRuns(){return this.kv.listKeys("state_").map(t=>a(t.slice(6)))}};
+export{o as KVStorageStore};//# sourceMappingURL=kv.js.map
+//# sourceMappingURL=kv.js.map

package/{dist → lib}/stores/memory.d.cts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.cjs';
+import { l as StepMachineStore, k as StepMachineState } from '../types-DQ1bKuB1.cjs';
 
 /**
  * yaml-flow - Memory Store

package/{dist → lib}/stores/memory.d.ts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.js';
+import { l as StepMachineStore, k as StepMachineState } from '../types-DQ1bKuB1.js';
 
 /**
  * yaml-flow - Memory Store

package/{dist/types-HGDTWIun.d.ts → lib/types-CBxkYuLY.d.ts}

@@ -1,5 +1,6 @@
-import { e as KindValueRef, B as BoardPlatformAdapter, d as CommandResult } from './board-live-cards-public-CK_J8uv0.js';
+import { d as BoardPlatformAdapter, a as CommandResult } from './board-live-cards-public-CsmYrvpd.js';
 import { ExecutionRef } from './execution-refs.js';
+import { a as KindValueRef } from './storage-interface-BhAON-gW.js';
 
 /**
  * server-runtime/types.ts

package/{dist/types-ycun84cq.d.cts → lib/types-DQ1bKuB1.d.cts}

@@ -24,6 +24,7 @@ interface StepConfig {
     failure_transitions?: Record<string, string>;
     retry?: RetryConfig;
     circuit_breaker?: CircuitBreakerConfig;
+    forEach?: ForEachConfig;
 }
 interface RetryConfig {
     max_attempts: number;
@@ -34,6 +35,16 @@ interface CircuitBreakerConfig {
     max_iterations: number;
     on_open: string;
 }
+interface ForEachConfig {
+    /** Data key containing the array to iterate over */
+    items: string;
+    /** Variable name for the current item in each iteration */
+    as: string;
+    /** Max concurrent iterations. @default 1 */
+    concurrency?: number;
+    /** Data key to collect results into. Defaults to `<items>_results` */
+    collectAs?: string;
+}
 interface TerminalStateConfig {
     description?: string;
     return_intent: string;

package/{dist/types-ycun84cq.d.ts → lib/types-DQ1bKuB1.d.ts}

@@ -24,6 +24,7 @@ interface StepConfig {
     failure_transitions?: Record<string, string>;
     retry?: RetryConfig;
     circuit_breaker?: CircuitBreakerConfig;
+    forEach?: ForEachConfig;
 }
 interface RetryConfig {
     max_attempts: number;
@@ -34,6 +35,16 @@ interface CircuitBreakerConfig {
     max_iterations: number;
     on_open: string;
 }
+interface ForEachConfig {
+    /** Data key containing the array to iterate over */
+    items: string;
+    /** Variable name for the current item in each iteration */
+    as: string;
+    /** Max concurrent iterations. @default 1 */
+    concurrency?: number;
+    /** Data key to collect results into. Defaults to `<items>_results` */
+    collectAs?: string;
+}
 interface TerminalStateConfig {
     description?: string;
     return_intent: string;

package/{dist/types-CU3DjTKL.d.cts → lib/types-DkFvgxwq.d.cts}

@@ -1,5 +1,6 @@
-import { e as KindValueRef, B as BoardPlatformAdapter, d as CommandResult } from './board-live-cards-public-5n1-syA3.cjs';
+import { d as BoardPlatformAdapter, a as CommandResult } from './board-live-cards-public-BnmRAbQV.cjs';
 import { ExecutionRef } from './execution-refs.cjs';
+import { a as KindValueRef } from './storage-interface-BhAON-gW.cjs';
 
 /**
  * server-runtime/types.ts

package/package.json

@@ -1,114 +1,65 @@
 {
   "name": "yaml-flow",
-  "version": "7.1.0",
+  "version": "8.0.0",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./lib/board-live-cards-public.cjs",
+  "module": "./lib/board-live-cards-public.js",
+  "types": "./lib/board-live-cards-public.d.ts",
   "bin": {
-    "board-live-cards-cli": "./board-live-cards-cli.js",
-    "card-store": "./card-store.js",
-    "step-machine-cli": "./step-machine-cli.js"
+    "board-live-cards-cli": "./cli/node/board-live-cards-cli.js",
+    "card-store": "./cli/node/card-store-cli.js",
+    "artifacts-store": "./cli/node/artifacts-store-cli.js",
+    "step-machine-cli": "./cli/node/step-machine-cli.js",
+    "batch-runner-cli": "./cli/node/batch-runner-cli.js"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./step-machine": {
-      "types": "./dist/step-machine/index.d.ts",
-      "import": "./dist/step-machine/index.js",
-      "require": "./dist/step-machine/index.cjs"
-    },
-    "./event-graph": {
-      "types": "./dist/event-graph/index.d.ts",
-      "import": "./dist/event-graph/index.js",
-      "require": "./dist/event-graph/index.cjs"
-    },
-    "./stores": {
-      "types": "./dist/stores/index.d.ts",
-      "import": "./dist/stores/index.js",
-      "require": "./dist/stores/index.cjs"
-    },
-    "./stores/memory": {
-      "types": "./dist/stores/memory.d.ts",
-      "import": "./dist/stores/memory.js",
-      "require": "./dist/stores/memory.cjs"
-    },
-    "./stores/localStorage": {
-      "types": "./dist/stores/localStorage.d.ts",
-      "import": "./dist/stores/localStorage.js",
-      "require": "./dist/stores/localStorage.cjs"
-    },
-    "./stores/file": {
-      "types": "./dist/stores/file.d.ts",
-      "import": "./dist/stores/file.js",
-      "require": "./dist/stores/file.cjs"
-    },
-    "./batch": {
-      "types": "./dist/batch/index.d.ts",
-      "import": "./dist/batch/index.js",
-      "require": "./dist/batch/index.cjs"
-    },
-    "./config": {
-      "types": "./dist/config/index.d.ts",
-      "import": "./dist/config/index.js",
-      "require": "./dist/config/index.cjs"
-    },
-    "./continuous-event-graph": {
-      "types": "./dist/continuous-event-graph/index.d.ts",
-      "import": "./dist/continuous-event-graph/index.js",
-      "require": "./dist/continuous-event-graph/index.cjs"
-    },
-    "./board-livegraph-runtime": {
-      "types": "./dist/board-livegraph-runtime/index.d.ts",
-      "import": "./dist/board-livegraph-runtime/index.js",
-      "require": "./dist/board-livegraph-runtime/index.cjs"
-    },
-    "./inference": {
-      "types": "./dist/inference/index.d.ts",
-      "import": "./dist/inference/index.js",
-      "require": "./dist/inference/index.cjs"
-    },
-    "./card-compute": {
-      "types": "./dist/card-compute/index.d.ts",
-      "import": "./dist/card-compute/index.js",
-      "require": "./dist/card-compute/index.cjs"
-    },
-    "./runtime-artifacts": {
-      "types": "./dist/runtime-artifacts/index.d.ts",
-      "import": "./dist/runtime-artifacts/index.js",
-      "require": "./dist/runtime-artifacts/index.cjs"
-    },
-    "./storage-refs": {
-      "types": "./dist/storage-refs.d.ts",
-      "import": "./dist/storage-refs.js",
-      "require": "./dist/storage-refs.cjs"
-    },
-    "./execution-refs": {
-      "types": "./dist/execution-refs.d.ts",
-      "import": "./dist/execution-refs.js",
-      "require": "./dist/execution-refs.cjs"
-    },
-    "./board-live-cards-browser": {
-      "types": "./dist/cli/browser-api/board-live-cards-browser-adapter.d.ts",
-      "import": "./dist/cli/browser-api/board-live-cards-browser-adapter.js"
+      "types": "./lib/board-live-cards-public.d.ts",
+      "import": "./lib/board-live-cards-public.js",
+      "require": "./lib/board-live-cards-public.cjs"
+    },
+    "./board-live-cards-public": {
+      "types": "./lib/board-live-cards-public.d.ts",
+      "import": "./lib/board-live-cards-public.js",
+      "require": "./lib/board-live-cards-public.cjs"
+    },
+    "./card-store-public": {
+      "types": "./lib/card-store-public.d.ts",
+      "import": "./lib/card-store-public.js",
+      "require": "./lib/card-store-public.cjs"
+    },
+    "./artifacts-store-public": {
+      "types": "./lib/artifacts-store-public.d.ts",
+      "import": "./lib/artifacts-store-public.js",
+      "require": "./lib/artifacts-store-public.cjs"
+    },
+    "./board-worker-adapter": {
+      "types": "./lib/board-worker-adapter.d.ts",
+      "import": "./lib/board-worker-adapter.js",
+      "require": "./lib/board-worker-adapter.cjs"
+    },
+    "./step-machine-public": {
+      "types": "./lib/step-machine-public/index.d.ts",
+      "import": "./lib/step-machine-public/index.js",
+      "require": "./lib/step-machine-public/index.cjs"
+    },
+    "./card-validation": {
+      "types": "./lib/card-validation.d.ts",
+      "import": "./lib/card-validation.js",
+      "require": "./lib/card-validation.cjs"
     },
     "./board-live-cards-node": {
-      "types": "./dist/cli/node/fs-board-adapter.d.ts",
-      "import": "./dist/cli/node/fs-board-adapter.js"
-    },
-    "./card-store-browser": {
-      "types": "./dist/cli/browser-api/card-store-browser-api.d.ts",
-      "import": "./dist/cli/browser-api/card-store-browser-api.js"
+      "types": "./lib/board-live-cards-node.d.ts",
+      "import": "./lib/board-live-cards-node.js",
+      "require": "./lib/board-live-cards-node.cjs"
     },
-    "./server-runtime": {
-      "types": "./dist/server-runtime/index.d.ts",
-      "import": "./dist/server-runtime/index.js"
+    "./board-live-cards-server-runtime": {
+      "types": "./lib/board-live-cards-server-runtime.d.ts",
+      "import": "./lib/board-live-cards-server-runtime.js",
+      "require": "./lib/board-live-cards-server-runtime.cjs"
     },
     "./package.json": "./package.json"
   },
@@ -116,39 +67,48 @@
     "./stores/file": false
   },
   "files": [
-    "board-live-cards-cli.js",
-    "storage-refs.js",
-    "step-machine-cli.js",
-    "dist",
+    "lib",
+    "cli",
+    "examples/board",
+    "examples/board-local",
+    "examples/portfolio-tracker",
     "schema",
     "browser",
-    "examples"
+    "!browser/card-compute.js",
+    "!browser/board-livegraph-engine.js",
+    "!lib/**/*.map",
+    "!cli/**/*.map",
+    "!browser/**/*.map",
+    "!examples/**/runtime/**",
+    "!examples/**/--base-ref/**",
+    "!examples/**/cards/**/chats/**",
+    "!examples/**/cards/**/files/**"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "npm run -s build:lib && npm run -s build:cli && npm run -s build:public-examples",
+    "build:lib": "tsup --config tsup.config.ts",
+    "build:cli": "tsup --config tsup.cli.config.ts",
+    "build:public-examples": "node scripts/generate-public-examples.mjs",
     "build:browser": "tsup --config tsup.browser.config.ts && node scripts/generate-browser-integrity.mjs",
     "check:bundle-budget": "node scripts/check-bundle-budgets.mjs",
     "check:browser-bundle": "node scripts/check-browser-bundle-safety.mjs",
     "release:gate": "npm run -s build && npm run -s build:browser && npm run -s test:run && npm run -s check:bundle-budget && npm run -s check:browser-bundle",
-    "standalone": "npm run -s test:cli-parity && npm run -s build && node scripts/build-standalone.mjs",
-    "pycli:install": "python -m pip install -r pycli/requirements.txt",
-    "pycli:install:venv": "c:/Users/sreenaga/ADO/ai-tool-evolver/.venv/Scripts/python.exe -m pip install -r pycli/requirements.txt",
-    "pycli:install:py312": "py -3.12 -m pip install -r pycli/requirements.txt",
-    "pycli:install:venv312": "./.venv312/Scripts/python.exe -m pip install -r pycli/requirements.txt",
-    "build:example": "node demo-src/example-board/build.js",
+    "standalone": "echo standalone is canonical; no assembly step required",
+    "pycli:install": "python -m pip install -r py-standalone/requirements.txt",
+    "pycli:install:venv": "c:/Users/sreenaga/ADO/ai-tool-evolver/.venv/Scripts/python.exe -m pip install -r py-standalone/requirements.txt",
+    "pycli:install:py312": "py -3.12 -m pip install -r py-standalone/requirements.txt",
+    "pycli:install:venv312": "./.venv312/Scripts/python.exe -m pip install -r py-standalone/requirements.txt",
     "dev": "tsup --watch",
-    "test": "npm run build:example && vitest",
-    "test:run": "npm run build && npm run build:example && vitest run",
-    "test:cli-parity": "python scripts/cli_parity_check.py",
-    "test:cli-parity:full": "python scripts/cli_parity_check.py --include-portfolio",
-    "test:e2e": "python examples/browser/boards/portfolio-tracker/portfolio-tracker.py --run-pycli",
-    "test:portfolio-tracker-server": "node examples/browser/boards/portfolio-tracker/portfolio-tracker-http-test.js",
-    "test:example-board": "vitest run tests/examples/example-board.test.ts",
-    "check:example-board": "npm run test:example-board && npm run validate:cards -- \"examples/example-board/cards/*.json\"",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:python": "vitest run --config vitest.python.config.ts",
+    "tests:e2e": "npm run -s test:e2e",
+    "tests:python": "npm run -s test:python",
     "validate:cards": "tsx scripts/validate-live-cards.ts",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm run build:browser && npm run check:bundle-budget && npm run check:browser-bundle"
+    "prepublishOnly": "npm run build && npm run build:browser && npm run build:public-examples && npm run check:bundle-budget && npm run check:browser-bundle"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",

package/board-live-cards-cli.js

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const distCli = path.join(__dirname, 'dist', 'cli', 'node', 'board-live-cards-cli.js');
-const srcCli = path.join(__dirname, 'src', 'cli', 'node', 'board-live-cards-cli.ts');
-const tsxCli = path.join(__dirname, 'node_modules', 'tsx', 'dist', 'cli.mjs');
-
-if (fs.existsSync(srcCli)) {
-  const result = spawnSync(process.execPath, [tsxCli, srcCli, ...process.argv.slice(2)], {
-    stdio: 'inherit',
-    shell: false,
-    windowsHide: true,
-  });
-
-  if (result.error) {
-    console.error(`[board-live-cards-cli] Failed to launch dev fallback: ${result.error.message}`);
-    process.exit(1);
-  }
-
-  process.exit(result.status ?? 0);
-} else if (fs.existsSync(distCli)) {
-  const { cli } = await import(pathToFileUrl(distCli).href);
-  await cli(process.argv.slice(2));
-} else {
-  console.error('[board-live-cards-cli] Could not find dist or src CLI entrypoint.');
-  process.exit(1);
-}
-
-function pathToFileUrl(filePath) {
-  const resolved = path.resolve(filePath).replace(/\\/g, '/');
-  return new URL(`file:///${resolved.startsWith('/') ? resolved.slice(1) : resolved}`);
-}