yaml-flow 4.0.0 → 5.0.0

package/examples/index.html

@@ -350,15 +350,15 @@
       </div>
       <div class="section-body">
         <div class="quickstart-grid">
-          <article class="card example-card" data-surface="browser" data-model="livecards" data-search="livecards browser demo board canvas interactive renderer open browser/livecards-browser/index.html">
+          <article class="card example-card" data-surface="browser" data-model="livecards" data-search="livecards example board demo shell board canvas interactive renderer open example-board/demo-shell.html">
             <div class="chip-row">
               <span class="chip">Browser</span>
               <span class="chip">LiveCards</span>
               <span class="chip starter">Starter</span>
             </div>
-            <h3><a href="browser/livecards-browser/index.html">LiveCards browser demo</a></h3>
-            <p>Fastest way to see the LiveCards browser renderer, element kinds, and board/canvas views in one place.</p>
-            <div class="command"><code>Open browser/livecards-browser/index.html</code><button class="copy-btn" data-copy="browser/livecards-browser/index.html">Copy path</button></div>
+            <h3><a href="example-board/demo-shell.html">LiveCards example board demo</a></h3>
+            <p>Fastest way to see the maintained LiveCards browser renderer, board/canvas views, refresh flows, and JSONata-backed example cards in one place.</p>
+            <div class="command"><code>Open example-board/demo-shell.html</code><button class="copy-btn" data-copy="example-board/demo-shell.html">Copy path</button></div>
           </article>
 
           <article class="card example-card" data-surface="browser" data-model="step-machine" data-search="step machine browser demo flowengine open browser/step-machine-browser/index.html">
@@ -440,11 +440,11 @@
       </div>
       <div class="section-body">
         <div class="example-grid">
-          <article class="example-card" data-surface="browser" data-model="livecards" data-search="livecards browser demo page interactive board canvas showcase">
+          <article class="example-card" data-surface="browser" data-model="livecards" data-search="livecards example board demo shell interactive board canvas showcase">
             <div class="chip-row"><span class="chip">Browser</span><span class="chip">LiveCards</span></div>
-            <h3><a href="browser/livecards-browser/index.html">LiveCards Browser Demo</a></h3>
-            <p>Interactive showcase for the browser runtime, including board/canvas views, element demos, and API reference material.</p>
-            <div class="command"><code>Open browser/livecards-browser/index.html</code><button class="copy-btn" data-copy="browser/livecards-browser/index.html">Copy path</button></div>
+            <h3><a href="example-board/demo-shell.html">LiveCards Example Board Demo</a></h3>
+            <p>Interactive example-board shell for the browser runtime, including board/canvas views, refresh flows, and compute-backed example cards.</p>
+            <div class="command"><code>Open example-board/demo-shell.html</code><button class="copy-btn" data-copy="example-board/demo-shell.html">Copy path</button></div>
           </article>
 
           <article class="example-card" data-surface="browser" data-model="step-machine" data-search="step machine browser greeting demo flowengine inlined">
@@ -460,6 +460,13 @@
             <p>Node-driven portfolio tracker demo that exercises end-to-end board-live-cards orchestration for a browser-facing board workflow.</p>
             <div class="command"><code>node examples/browser/boards/portfolio-tracker/portfolio-tracker.js</code><button class="copy-btn" data-copy="node examples/browser/boards/portfolio-tracker/portfolio-tracker.js">Copy</button></div>
           </article>
+
+          <article class="example-card" data-surface="browser" data-model="livecards" data-search="portfolio tracker task-executor external source cli delegation custom">
+            <div class="chip-row"><span class="chip">Browser support</span><span class="chip">LiveCards</span><span class="chip">Task-Executor</span></div>
+            <h3>Portfolio Tracker with Task-Executor</h3>
+            <p>Portfolio tracker with external source execution via task-executor. Demonstrates delegating source.cli execution to a custom executor script.</p>
+            <div class="command"><code>node examples/browser/boards/portfolio-tracker/portfolio-tracker.js --task-executor "node C:\path\to\portfolio-tracker-task-executor.cjs"</code><button class="copy-btn" data-copy="node examples/browser/boards/portfolio-tracker/portfolio-tracker.js --task-executor &quot;node C:\path\to\portfolio-tracker-task-executor.cjs&quot;">Copy</button></div>
+          </article>
         </div>
       </div>
     </section>
@@ -699,7 +706,7 @@
             </tr>
           </thead>
           <tbody>
-            <tr data-surface="browser" data-model="livecards"><td><a href="browser/livecards-browser/index.html"><code>examples/browser/livecards-browser/index.html</code></a></td><td>Browser</td><td>LiveCards</td><td><code>Open browser/livecards-browser/index.html</code></td><td>Interactive board/canvas renderer showcase</td></tr>
+            <tr data-surface="browser" data-model="livecards"><td><a href="example-board/demo-shell.html"><code>examples/example-board/demo-shell.html</code></a></td><td>Browser</td><td>LiveCards</td><td><code>Open example-board/demo-shell.html</code></td><td>Maintained example-board browser demo for board/canvas rendering and compute-backed cards</td></tr>
             <tr data-surface="browser" data-model="step-machine"><td><a href="browser/step-machine-browser/index.html"><code>examples/browser/step-machine-browser/index.html</code></a></td><td>Browser</td><td>Step Machine</td><td><code>Open browser/step-machine-browser/index.html</code></td><td>Simple browser-side step-machine demo</td></tr>
             <tr data-surface="browser" data-model="livecards"><td><code>examples/browser/boards/portfolio-tracker/portfolio-tracker.js</code></td><td>Browser support</td><td>LiveCards</td><td><code>node examples/browser/boards/portfolio-tracker/portfolio-tracker.js</code></td><td>End-to-end board-live-cards portfolio driver</td></tr>
             <tr data-surface="cli" data-model="step-machine"><td><code>examples/cli/step-machine-cli/portfolio-tracker/run-portfolio-tracker.bat</code></td><td>CLI</td><td>Step Machine</td><td><code>run-portfolio-tracker.bat</code></td><td>Portfolio tracker YAML flow orchestration</td></tr>

package/examples/npm-libs/continuous-event-graph/live-cards-board.ts

@@ -36,31 +36,31 @@ const cards: LiveCard[] = [
     id: 'market-feed',
     type: 'source',
     meta: { title: 'Live Market Prices' },
-    state: { prices: [142.5, 305.8, 89.2, 211.0, 178.3] },
-    source: { kind: 'static', bindTo: 'state.prices' },
+    card_data: { prices: [142.5, 305.8, 89.2, 211.0, 178.3] },
+    source: { kind: 'static', bindTo: 'card_data.prices' },
   },
   {
     id: 'stats',
     type: 'card',
     meta: { title: 'Price Statistics' },
-    state: {},
+    card_data: {},
     data: { requires: ['market-feed'] },
     compute: {
-      total: { fn: 'sum', input: 'state.market-feed.prices' },
-      avg: { fn: 'avg', input: 'state.market-feed.prices' },
-      count: { fn: 'count', input: 'state.market-feed.prices' },
+      total: { fn: 'sum', input: 'sources.market-feed.prices' },
+      avg: { fn: 'avg', input: 'sources.market-feed.prices' },
+      count: { fn: 'count', input: 'sources.market-feed.prices' },
     },
   },
   {
     id: 'summary',
     type: 'card',
     meta: { title: 'Summary Label' },
-    state: {},
+    card_data: {},
     data: { requires: ['stats'] },
     compute: {
       label: {
         fn: 'template',
-        input: 'state.stats',
+        input: 'computed_values.stats',
         format: '{{count}} stocks — total ${{total}}, avg ${{avg}}',
       },
     },
@@ -115,37 +115,37 @@ const board: LiveBoard = {
       id: 'equity-feed',
       type: 'source',
       meta: { title: 'Equity Prices' },
-      state: {},
-      source: { kind: 'api', bindTo: 'state.raw', url_template: 'https://api.example.com/equity' },
+      card_data: {},
+      source: { kind: 'api', bindTo: 'card_data.raw', url_template: 'https://api.example.com/equity' },
     },
     {
       id: 'bond-feed',
       type: 'source',
       meta: { title: 'Bond Yields' },
-      state: { yields: [3.2, 4.1, 2.8, 5.0] },
-      source: { kind: 'static', bindTo: 'state.yields' },
+      card_data: { yields: [3.2, 4.1, 2.8, 5.0] },
+      source: { kind: 'static', bindTo: 'card_data.yields' },
     },
     {
       id: 'portfolio-mix',
       type: 'card',
       meta: { title: 'Portfolio Mix Calculator' },
-      state: {},
+      card_data: {},
       data: { requires: ['equity-feed', 'bond-feed'] },
       compute: {
-        equity_total: { fn: 'sum', input: 'state.equity-feed.prices' },
-        bond_total: { fn: 'sum', input: 'state.bond-feed.yields' },
+        equity_total: { fn: 'sum', input: 'sources.equity-feed.prices' },
+        bond_total: { fn: 'sum', input: 'sources.bond-feed.yields' },
       },
     },
     {
       id: 'risk-summary',
       type: 'card',
       meta: { title: 'Risk Summary' },
-      state: {},
+      card_data: {},
       data: { requires: ['portfolio-mix'] },
       compute: {
         label: {
           fn: 'template',
-          input: 'state.portfolio-mix',
+          input: 'computed_values.portfolio-mix',
           format: 'Equities: ${{equity_total}} | Bonds: {{bond_total}}%',
         },
       },

package/examples/npm-libs/continuous-event-graph/live-portfolio-dashboard.ts

@@ -69,8 +69,8 @@ const cards: LiveCard[] = [
   {
     id: 'holdings', type: 'source',
     meta: { title: 'Portfolio Holdings' },
-    data: { provides: { holdings: 'state.holdings' } },
-    state: {
+    data: { provides: { holdings: 'card_data.holdings' } },
+    card_data: {
       holdings: [
         { symbol: 'AAPL', shares: 50, sector: 'tech' },
         { symbol: 'MSFT', shares: 30, sector: 'tech' },
@@ -83,13 +83,13 @@ const cards: LiveCard[] = [
   {
     id: 'price-feed', type: 'source',
     meta: { title: 'Live Price Feed' },
-    data: { provides: { prices: 'state.prices' } },
-    state: { prices: { AAPL: 195.50, MSFT: 420.10, GOOG: 176.30, JPM: 198.20, JNJ: 155.80 } },
+    data: { provides: { prices: 'card_data.prices' } },
+    card_data: { prices: { AAPL: 195.50, MSFT: 420.10, GOOG: 176.30, JPM: 198.20, JNJ: 155.80 } },
   },
   {
     id: 'news-feed', type: 'source',
     meta: { title: 'Market News Feed' },
-    state: {
+    card_data: {
       headlines: [
         { symbol: 'AAPL', headline: 'Apple beats Q4 estimates', sentiment: 0.8 },
         { symbol: 'JPM', headline: 'JPMorgan raises dividend', sentiment: 0.6 },
@@ -100,32 +100,32 @@ const cards: LiveCard[] = [
   {
     id: 'benchmark', type: 'source',
     meta: { title: 'S&P 500 Benchmark' },
-    state: { index: 'SPY', value: 5280.50, dailyReturn: 0.45 },
+    card_data: { index: 'SPY', value: 5280.50, dailyReturn: 0.45 },
   },
   // Compute cards
   {
     id: 'valuator', type: 'card',
     meta: { title: 'Position Valuator' },
     data: { requires: ['holdings', 'price-feed'] },
-    state: {},
+    card_data: {},
   },
   {
     id: 'portfolio-value', type: 'card',
     meta: { title: 'Total Portfolio Value' },
     data: { requires: ['valuator'] },
-    state: {},
+    card_data: {},
   },
   {
     id: 'sector-breakdown', type: 'card',
     meta: { title: 'Sector Breakdown' },
     data: { requires: ['valuator'] },
-    state: {},
+    card_data: {},
   },
   {
     id: 'sentiment', type: 'card',
     meta: { title: 'News Sentiment Score' },
     data: { requires: ['news-feed'] },
-    state: {},
+    card_data: {},
   },
 ];
 
@@ -144,7 +144,7 @@ function makeHandler(
     const result = computeFn(graphRef!.getState());
     try {
       const diskCard = readCard(dir, id);
-      diskCard.state = { ...diskCard.state, ...result };
+      diskCard.card_data = { ...diskCard.card_data, ...result };
       writeCard(dir, diskCard);
     } catch { /* card may not exist yet */ }
     graphRef!.resolveCallback(input.callbackToken, result);
@@ -225,7 +225,7 @@ async function main() {
           if (taskState.data && Object.keys(taskState.data).length > 0) {
             try {
               const diskCard = readCard(tmpDir, taskName);
-              diskCard.state = { ...diskCard.state, ...taskState.data };
+              diskCard.card_data = { ...diskCard.card_data, ...taskState.data };
               writeCard(tmpDir, diskCard);
             } catch { /* not on disk yet */ }
           }
@@ -251,7 +251,7 @@ async function main() {
   log('PHASE 2', 'Adding 7 dynamic cards → 15 total');
 
   addDynamicCard(rg, tmpDir, {
-    id: 'allocation-chart', type: 'card', data: { requires: ['valuator', 'portfolio-value'] }, state: {},
+    id: 'allocation-chart', type: 'card', data: { requires: ['valuator', 'portfolio-value'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const tot = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
@@ -259,7 +259,7 @@ async function main() {
   }, { requires: ['valuator', 'portfolio-value'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'risk-score', type: 'card', data: { requires: ['valuator'] }, state: {},
+    id: 'risk-score', type: 'card', data: { requires: ['valuator'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const vals = pos.map((p: any) => p.value);
@@ -269,7 +269,7 @@ async function main() {
   }, { requires: ['valuator'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'daily-pnl', type: 'card', data: { requires: ['portfolio-value', 'benchmark'] }, state: {},
+    id: 'daily-pnl', type: 'card', data: { requires: ['portfolio-value', 'benchmark'] }, card_data: {},
   }, (e) => {
     const tv = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
     const benchReturn = (e.state.tasks.benchmark?.data as any)?.dailyReturn ?? 0;
@@ -278,14 +278,14 @@ async function main() {
   }, { requires: ['portfolio-value', 'benchmark'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'value-alert', type: 'card', data: { requires: ['portfolio-value'] }, state: {},
+    id: 'value-alert', type: 'card', data: { requires: ['portfolio-value'] }, card_data: {},
   }, (e) => {
     const tv = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
     return { triggered: tv > 25000, threshold: 25000, currentValue: tv };
   }, { requires: ['portfolio-value'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'summary', type: 'card', data: { requires: ['portfolio-value', 'sentiment'] }, state: {},
+    id: 'summary', type: 'card', data: { requires: ['portfolio-value', 'sentiment'] }, card_data: {},
   }, (e) => {
     const tv = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
     const mood = (e.state.tasks.sentiment?.data as any)?.bullish ? 'bullish' : 'bearish';
@@ -293,7 +293,7 @@ async function main() {
   }, { requires: ['portfolio-value', 'sentiment'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'correlation', type: 'card', data: { requires: ['valuator', 'benchmark'] }, state: {},
+    id: 'correlation', type: 'card', data: { requires: ['valuator', 'benchmark'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const techVal = pos.filter((p: any) => p.sector === 'tech').reduce((s: number, p: any) => s + p.value, 0);
@@ -302,7 +302,7 @@ async function main() {
   }, { requires: ['valuator', 'benchmark'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'combined-view', type: 'card', data: { requires: ['summary', 'sector-breakdown', 'risk-score'] }, state: {},
+    id: 'combined-view', type: 'card', data: { requires: ['summary', 'sector-breakdown', 'risk-score'] }, card_data: {},
   }, (e) => ({
     summaryMood: (e.state.tasks.summary?.data as any)?.mood ?? '?',
     sectors: (e.state.tasks['sector-breakdown']?.data as any)?.sectorCount ?? 0,
@@ -326,7 +326,7 @@ async function main() {
   console.log('  benchmark provides:', rg.getState().config.tasks.benchmark.provides);
 
   addDynamicCard(rg, tmpDir, {
-    id: 'market-context', type: 'card', data: { requires: ['market-data'] }, state: {},
+    id: 'market-context', type: 'card', data: { requires: ['market-data'] }, card_data: {},
   }, (e) => {
     const bench = e.state.tasks.benchmark?.data as any ?? {};
     return { indexValue: bench.value ?? 0, context: 'provided via market-data token' };
@@ -409,7 +409,7 @@ async function main() {
   console.log('  combined-view requires:', rg.getState().config.tasks['combined-view'].requires);
 
   addDynamicCard(rg, tmpDir, {
-    id: 'allocation-chart', type: 'card', data: { requires: ['valuator'] }, state: {},
+    id: 'allocation-chart', type: 'card', data: { requires: ['valuator'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const total = pos.reduce((s: number, p: any) => s + p.value, 0);
@@ -436,7 +436,7 @@ async function main() {
     id: 'watchlist', type: 'source',
     meta: { title: 'Watchlist (User Input)' },
     data: { provides: { watchlist: 'state.symbols' } },
-    state: { symbols: ['NVDA', 'AMD', 'AMZN'] },
+    card_data: { symbols: ['NVDA', 'AMD', 'AMZN'] },
   };
   writeCard(tmpDir, watchlistCard);
   rg.registerHandler('watchlist', makeHandler('watchlist', (engine) => {
@@ -463,7 +463,7 @@ async function main() {
   addDynamicCard(rg, tmpDir, {
     id: 'watchlist-prices', type: 'card',
     meta: { title: 'Watchlist Latest Prices' },
-    data: { requires: ['watchlist', 'price-feed'] }, state: {},
+    data: { requires: ['watchlist', 'price-feed'] }, card_data: {},
   }, (engine) => {
     const symbols: string[] = (engine.state.tasks.watchlist?.data as any)?.symbols ?? [];
     const allPrices: Record<string, number> = (engine.state.tasks['price-feed']?.data as any)?.prices ?? {};

package/examples/step-machine-cli/portfolio-tracker/cards/holdings-table.json

@@ -3,7 +3,7 @@
   "meta": { "title": "Holdings Table" },
   "requires": ["holdings", "prices"],
   "provides": [{ "bindTo": "table", "src": "computed_values.table" }],
-  "state": {},
+  "card_data": {},
   "compute": [
     {
       "bindTo": "table",

package/examples/step-machine-cli/portfolio-tracker/cards/portfolio-form.json

@@ -6,10 +6,10 @@
   "provides": [
     {
       "bindTo": "holdings",
-      "src": "state.holdings"
+      "src": "card_data.holdings"
     }
   ],
-  "state": {
+  "card_data": {
     "holdings": [
       {
         "symbol": "AAPL",
@@ -31,7 +31,7 @@
         "kind": "table",
         "label": "Holdings",
         "data": {
-          "bind": "state.holdings",
+          "bind": "card_data.holdings",
           "columns": [
             "symbol",
             "qty"

package/examples/step-machine-cli/portfolio-tracker/cards/portfolio-value.json

@@ -3,7 +3,7 @@
   "meta": { "title": "Portfolio Total Value" },
   "requires": ["table"],
   "provides": [{ "bindTo": "totalValue", "src": "computed_values.totalValue" }],
-  "state": {},
+  "card_data": {},
   "compute": [
     { "bindTo": "totalValue", "expr": "$sum(requires.table.rows.value)" }
   ],

package/examples/step-machine-cli/portfolio-tracker/cards/price-fetch.json

@@ -3,7 +3,7 @@
   "meta": { "title": "Fetch Market Prices" },
   "requires": ["holdings"],
   "provides": [{ "bindTo": "prices", "src": "sources.prices" }],
-  "state": {},
+  "card_data": {},
   "sources": [
     { "cli": "node ../fetch-prices.js --tmp-file-name tmp_file1", "bindTo": "prices", "outputFile": "prices.json" }
   ],

package/examples/step-machine-cli/portfolio-tracker/portfolio-tracker-task-executor.cjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * Portfolio Tracker Task-Executor
+ * 
+ * Implements the run-source-fetch protocol for board-live-cards.
+ * This script acts as an external task-executor that can be registered via .task-executor file.
+ * 
+ * Contract:
+ *   portfolio-tracker-task-executor.js run-source-fetch --in <defFile> --out <resultFile> --err <errFile>
+ * 
+ * Input (--in file):
+ *   JSON source definition with { cli: "...", bindTo: "...", outputFile: "...", ... }
+ * 
+ * Output (on success):
+ *   --out file contains the execution result
+ *   Exit code: 0
+ * 
+ * Output (on error):
+ *   --err file contains error message
+ *   Exit code: 1
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+let subcommand = '';
+let inFile = '';
+let outFile = '';
+let errFile = '';
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === 'run-source-fetch') {
+    subcommand = 'run-source-fetch';
+  } else if (args[i] === '--in' && i + 1 < args.length) {
+    inFile = args[i + 1];
+  } else if (args[i] === '--out' && i + 1 < args.length) {
+    outFile = args[i + 1];
+  } else if (args[i] === '--err' && i + 1 < args.length) {
+    errFile = args[i + 1];
+  }
+}
+
+if (subcommand !== 'run-source-fetch' || !inFile || !outFile || !errFile) {
+  console.error('Usage: portfolio-tracker-task-executor.js run-source-fetch --in <defFile> --out <resultFile> --err <errFile>');
+  process.exit(1);
+}
+
+try {
+  // 1. Read source definition from --in file
+  console.log(`[portfolio-tracker-task-executor] Reading source definition from ${inFile}`);
+  const sourceDefStr = fs.readFileSync(inFile, 'utf-8');
+  const sourceDef = JSON.parse(sourceDefStr);
+  
+  // 2. Extract cli command from source definition
+  const { cli: sourceCliCommand } = sourceDef;
+  if (!sourceCliCommand) {
+    throw new Error('cli is required in source definition');
+  }
+  
+  console.log(`[portfolio-tracker-task-executor] Executing: ${sourceCliCommand}`);
+  
+  // 3. Execute source.cli synchronously and capture output
+  let output;
+  try {
+    output = execSync(sourceCliCommand, {
+      encoding: 'utf-8',
+      timeout: (sourceDef.timeout ?? 120) * 1000,  // Convert to ms
+      cwd: sourceDef.cwd,
+      shell: true,
+      stdio: ['pipe', 'pipe', 'pipe'],  // Capture stdout/stderr
+    });
+  } catch (execErr) {
+    // Even on error, try to use what output we got
+    output = execErr.stdout || '';
+    if (!output) {
+      throw new Error(`Command execution failed: ${execErr.message}`);
+    }
+  }
+  
+  // 4. Write output to --out file
+  console.log(`[portfolio-tracker-task-executor] Writing result to ${outFile}`);
+  fs.writeFileSync(outFile, output.trim(), 'utf-8');
+  
+  console.log(`[portfolio-tracker-task-executor] Success`);
+  process.exit(0);
+} catch (error) {
+  // 3a. On error: write error message to --err file and exit non-zero
+  const errorMsg = error instanceof Error ? error.message : String(error);
+  console.error(`[portfolio-tracker-task-executor] Error:`, errorMsg);
+  
+  fs.writeFileSync(errFile, errorMsg, 'utf-8');
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",
@@ -63,6 +63,11 @@
       "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",
@@ -72,6 +77,11 @@
       "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"
     }
   },
   "browser": {
@@ -87,12 +97,16 @@
   ],
   "scripts": {
     "build": "tsup",
+    "build:browser": "tsup --config tsup.browser.config.ts",
     "dev": "tsup --watch",
     "test": "vitest",
     "test:run": "vitest run",
+    "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\"",
+    "validate:cards": "tsx scripts/validate-live-cards.ts",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build && npm run build:browser"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",

package/schema/card-runtime.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yaml-flow.dev/schema/card-runtime.schema.json",
+  "title": "Card Runtime Computed Artifact",
+  "description": "Published per-card runtime artifact written to runtime-out/cards/<card-id>.computed.json. Contains only values produced by the compute step.",
+  "type": "object",
+  "required": ["schema_version", "card_id", "computed_values"],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "v1",
+      "description": "Artifact schema version."
+    },
+    "card_id": {
+      "type": "string",
+      "description": "The ID of the card this artifact belongs to."
+    },
+    "computed_values": {
+      "type": "object",
+      "description": "Key/value map of outputs produced by the card's JSONata compute steps.",
+      "additionalProperties": true
+    }
+  }
+}