yaml-flow 3.1.0 → 4.0.0

package/dist/stores/file.d.cts

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

package/dist/stores/file.d.ts

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

package/dist/stores/index.d.cts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.cjs';
 export { LocalStorageStore } from './localStorage.cjs';
 export { FileStore } from './file.cjs';
-import '../types-FZ_eyErS.cjs';
+import '../types-ycun84cq.cjs';

package/dist/stores/index.d.ts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.js';
 export { LocalStorageStore } from './localStorage.js';
 export { FileStore } from './file.js';
-import '../types-FZ_eyErS.js';
+import '../types-ycun84cq.js';

package/dist/stores/localStorage.d.cts

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

package/dist/stores/localStorage.d.ts

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

package/dist/stores/memory.d.cts

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

package/dist/stores/memory.d.ts

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

package/dist/{types-BwvgvlOO.d.cts → types-BzLD8bjb.d.cts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-DEj7OakX.cjs';
+import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-CMFSIjpc.cjs';
 
 /**
  * Continuous Event Graph — Types

package/dist/{types-ClRA8hzC.d.ts → types-C2eJ7DAV.d.ts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-DEj7OakX.js';
+import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-CMFSIjpc.js';
 
 /**
  * Continuous Event Graph — Types

package/dist/{types-DEj7OakX.d.cts → types-CMFSIjpc.d.cts}

@@ -134,7 +134,7 @@ interface StuckDetection {
     outputs_unresolvable: string[];
     tasks_blocked: string[];
 }
-type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskCreationEvent;
+type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskUpsertEvent | TaskRemovalEvent | NodeRequiresAddEvent | NodeRequiresRemoveEvent | NodeProvidesAddEvent | NodeProvidesRemoveEvent;
 interface TaskStartedEvent {
     type: 'task-started';
     taskName: string;
@@ -165,6 +165,12 @@ interface TaskProgressEvent {
     taskName: string;
     message?: string;
     progress?: number;
+    /**
+     * Arbitrary update payload — used by source delivery to carry
+     * { bindTo, fetchedAt, dest } or { bindTo, failure, reason }.
+     * card-handler receives this via TaskHandlerInput.update.
+     */
+    update?: Record<string, unknown>;
     timestamp: string;
     executionId?: string;
 }
@@ -185,12 +191,41 @@ interface AgentActionEvent {
     timestamp: string;
     config?: Partial<ExecutionConfig>;
 }
-interface TaskCreationEvent {
-    type: 'task-creation';
+interface TaskUpsertEvent {
+    type: 'task-upsert';
     taskName: string;
     taskConfig: TaskConfig;
     timestamp: string;
 }
+interface TaskRemovalEvent {
+    type: 'task-removal';
+    taskName: string;
+    timestamp: string;
+}
+interface NodeRequiresAddEvent {
+    type: 'node-requires-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeRequiresRemoveEvent {
+    type: 'node-requires-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesAddEvent {
+    type: 'node-provides-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesRemoveEvent {
+    type: 'node-provides-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
 interface SchedulerResult {
     /** Tasks eligible for execution */
     eligibleTasks: string[];
@@ -214,4 +249,4 @@ type ExecutionMode = 'dependency-mode' | 'eligibility-mode';
 type ConflictStrategy = 'alphabetical' | 'priority-first' | 'duration-first' | 'cost-optimized' | 'resource-aware' | 'random-select' | 'user-choice' | 'parallel-all' | 'skip-conflicts' | 'round-robin';
 type RefreshStrategy = 'data-changed' | 'epoch-changed' | 'time-based' | 'manual' | 'once';
 
-export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskCreationEvent as j, TaskFailedEvent as k, TaskStartedEvent as l, TaskStatus as m, TaskCircuitBreakerConfig as n, TaskMessage as o, TaskProgressEvent as p, TaskRestartEvent as q, TaskRetryConfig as r };
+export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskFailedEvent as j, TaskStartedEvent as k, TaskStatus as l, TaskCircuitBreakerConfig as m, TaskMessage as n, TaskProgressEvent as o, TaskRestartEvent as p, TaskRetryConfig as q };

package/dist/{types-DEj7OakX.d.ts → types-CMFSIjpc.d.ts}

@@ -134,7 +134,7 @@ interface StuckDetection {
     outputs_unresolvable: string[];
     tasks_blocked: string[];
 }
-type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskCreationEvent;
+type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskUpsertEvent | TaskRemovalEvent | NodeRequiresAddEvent | NodeRequiresRemoveEvent | NodeProvidesAddEvent | NodeProvidesRemoveEvent;
 interface TaskStartedEvent {
     type: 'task-started';
     taskName: string;
@@ -165,6 +165,12 @@ interface TaskProgressEvent {
     taskName: string;
     message?: string;
     progress?: number;
+    /**
+     * Arbitrary update payload — used by source delivery to carry
+     * { bindTo, fetchedAt, dest } or { bindTo, failure, reason }.
+     * card-handler receives this via TaskHandlerInput.update.
+     */
+    update?: Record<string, unknown>;
     timestamp: string;
     executionId?: string;
 }
@@ -185,12 +191,41 @@ interface AgentActionEvent {
     timestamp: string;
     config?: Partial<ExecutionConfig>;
 }
-interface TaskCreationEvent {
-    type: 'task-creation';
+interface TaskUpsertEvent {
+    type: 'task-upsert';
     taskName: string;
     taskConfig: TaskConfig;
     timestamp: string;
 }
+interface TaskRemovalEvent {
+    type: 'task-removal';
+    taskName: string;
+    timestamp: string;
+}
+interface NodeRequiresAddEvent {
+    type: 'node-requires-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeRequiresRemoveEvent {
+    type: 'node-requires-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesAddEvent {
+    type: 'node-provides-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesRemoveEvent {
+    type: 'node-provides-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
 interface SchedulerResult {
     /** Tasks eligible for execution */
     eligibleTasks: string[];
@@ -214,4 +249,4 @@ type ExecutionMode = 'dependency-mode' | 'eligibility-mode';
 type ConflictStrategy = 'alphabetical' | 'priority-first' | 'duration-first' | 'cost-optimized' | 'resource-aware' | 'random-select' | 'user-choice' | 'parallel-all' | 'skip-conflicts' | 'round-robin';
 type RefreshStrategy = 'data-changed' | 'epoch-changed' | 'time-based' | 'manual' | 'once';
 
-export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskCreationEvent as j, TaskFailedEvent as k, TaskStartedEvent as l, TaskStatus as m, TaskCircuitBreakerConfig as n, TaskMessage as o, TaskProgressEvent as p, TaskRestartEvent as q, TaskRetryConfig as r };
+export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskFailedEvent as j, TaskStartedEvent as k, TaskStatus as l, TaskCircuitBreakerConfig as m, TaskMessage as n, TaskProgressEvent as o, TaskRestartEvent as p, TaskRetryConfig as q };

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

@@ -21,6 +21,7 @@ interface StepConfig {
     expects_data?: string[];
     produces_data?: string[];
     transitions: Record<string, string>;
+    failure_transitions?: Record<string, string>;
     retry?: RetryConfig;
     circuit_breaker?: CircuitBreakerConfig;
 }

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

@@ -21,6 +21,7 @@ interface StepConfig {
     expects_data?: string[];
     produces_data?: string[];
     transitions: Record<string, string>;
+    failure_transitions?: Record<string, string>;
     retry?: RetryConfig;
     circuit_breaker?: CircuitBreakerConfig;
 }

package/dist/{validate-DEZ2Ymdb.d.ts → validate-DJQTQ6bP.d.ts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig } from './types-DEj7OakX.js';
+import { G as GraphConfig } from './types-CMFSIjpc.js';
 
 /**
  * Event Graph — Semantic Graph Validation

package/dist/{validate-DqKTZg_o.d.cts → validate-ke92Cleg.d.cts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig } from './types-DEj7OakX.cjs';
+import { G as GraphConfig } from './types-CMFSIjpc.cjs';
 
 /**
  * Event Graph — Semantic Graph Validation

package/examples/browser/boards/portfolio-tracker/cards/holdings-table.json

@@ -0,0 +1,22 @@
+{
+  "id": "holdings-table",
+  "meta": { "title": "Holdings Table" },
+  "requires": ["holdings", "prices"],
+  "provides": [{ "bindTo": "table", "src": "computed_values.table" }],
+  "state": {},
+  "compute": [
+    {
+      "bindTo": "table",
+      "expr": "{ \"rows\": $map(requires.holdings, function($h) { { \"symbol\": $h.symbol, \"qty\": $h.qty, \"price\": $lookup(requires.prices, $h.symbol), \"value\": $h.qty * $lookup(requires.prices, $h.symbol) } }) }"
+    }
+  ],
+  "view": {
+    "elements": [
+      {
+        "kind": "table",
+        "label": "Portfolio Positions",
+        "data": { "bind": "computed_values.table.rows", "columns": ["symbol", "qty", "price", "value"] }
+      }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/cards/portfolio-form.json

@@ -0,0 +1,16 @@
+{
+  "id": "portfolio-form",
+  "meta": { "title": "Portfolio Holdings Form" },
+  "provides": [{ "bindTo": "holdings", "src": "state.holdings" }],
+  "state": {
+    "holdings": [
+      { "symbol": "AAPL", "qty": 50 },
+      { "symbol": "MSFT", "qty": 30 }
+    ]
+  },
+  "view": {
+    "elements": [
+      { "kind": "table", "label": "Holdings", "data": { "bind": "state.holdings", "columns": ["symbol", "qty"] } }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/cards/portfolio-value.json

@@ -0,0 +1,15 @@
+{
+  "id": "portfolio-value",
+  "meta": { "title": "Portfolio Total Value" },
+  "requires": ["table"],
+  "provides": [{ "bindTo": "totalValue", "src": "computed_values.totalValue" }],
+  "state": {},
+  "compute": [
+    { "bindTo": "totalValue", "expr": "$sum(requires.table.rows.value)" }
+  ],
+  "view": {
+    "elements": [
+      { "kind": "metric", "label": "Total Portfolio Value", "data": { "bind": "computed_values.totalValue" } }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/cards/price-fetch.json

@@ -0,0 +1,15 @@
+{
+  "id": "price-fetch",
+  "meta": { "title": "Fetch Market Prices" },
+  "requires": ["holdings"],
+  "provides": [{ "bindTo": "prices", "src": "sources.prices" }],
+  "state": {},
+  "sources": [
+    { "cli": "node ../fetch-prices.js", "bindTo": "prices", "outputFile": "prices.json" }
+  ],
+  "view": {
+    "elements": [
+      { "kind": "table", "label": "Market Prices", "data": { "bind": "sources.prices" } }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/fetch-prices.js

@@ -0,0 +1,43 @@
+/**
+ * fetch-prices.js
+ * Polls for tmp_file1 payload and outputs JSON to stdout once available.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+
+const envBoardDir = (process.env.BOARD_DIR ?? '').trim();
+const tmpFileCandidates = [
+  envBoardDir ? path.join(envBoardDir, 'tmp_file1') : '',
+  path.join(process.cwd(), 'tmp_file1'),
+  path.join(process.cwd(), 'board-runtime', 'tmp_file1'),
+  path.join(process.cwd(), '..', 'board-runtime', 'tmp_file1'),
+].filter(Boolean);
+
+function getReadableTmpFile() {
+  for (const tmpFile of tmpFileCandidates) {
+    if (!fs.existsSync(tmpFile)) continue;
+    const content = fs.readFileSync(tmpFile, 'utf-8').trim();
+    if (content) return { tmpFile, content };
+  }
+  return undefined;
+}
+
+function waitForFile(timeoutMs = 120000) {
+  const started = Date.now();
+  const interval = setInterval(() => {
+    if (Date.now() - started > timeoutMs) {
+      clearInterval(interval);
+      console.error('Timed out waiting for tmp_file1 market prices input.');
+      process.exit(1);
+    }
+
+    const ready = getReadableTmpFile();
+    if (!ready) return;
+
+    clearInterval(interval);
+    fs.writeFileSync(ready.tmpFile, '', 'utf-8');
+    process.stdout.write(`${ready.content}\n`);
+  }, 250);
+}
+
+waitForFile();

package/examples/browser/boards/portfolio-tracker/portfolio-tracker.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+
+set "BOARD_LIVE_CARDS_NO_SPAWN=1"
+node "%~dp0portfolio-tracker.js"
+
+endlocal

package/examples/browser/boards/portfolio-tracker/portfolio-tracker.js

@@ -0,0 +1,189 @@
+/**
+ * portfolio-tracker.js
+ *
+ * Runs the full T0-T4 lifecycle of the portfolio board demo.
+ *
+ * This is a BLACK-BOX client of board-live-cards CLI.
+ * It only calls CLI commands and does NOT inspect board internals.
+ *
+ * Usage: node portfolio-tracker.js
+ */
+
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const CARDS_TEMPLATE = path.join(__dirname, 'cards');
+const REPO_ROOT = path.join(__dirname, '..', '..', '..', '..');
+const CLI_WRAPPER = path.join(REPO_ROOT, 'board-live-cards-cli.js');
+const CLI_TS = path.join(REPO_ROOT, 'src', 'cli', 'board-live-cards-cli.ts');
+const CLI_JS = path.join(REPO_ROOT, 'dist', 'cli', 'board-live-cards-cli.js');
+const TSX_CLI = path.join(REPO_ROOT, 'node_modules', 'tsx', 'dist', 'cli.mjs');
+
+// Keep runtime artifacts out of the repository.
+const RUNTIME_ROOT = fs.mkdtempSync(path.join(os.tmpdir(), 'portfolio-tracker-'));
+const BOARD = path.join(RUNTIME_ROOT, 'board-runtime');
+const CARDS = path.join(RUNTIME_ROOT, 'cards');
+const TMP_FILE = path.join(BOARD, 'tmp_file1');
+
+console.log(`Runtime root: ${RUNTIME_ROOT}`);
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+function cliCommand() {
+  // Prefer node+tsx CLI on Windows to avoid flashing transient cmd windows.
+  if (fs.existsSync(CLI_TS) && fs.existsSync(TSX_CLI)) {
+    return { cmd: process.execPath, prefixArgs: [TSX_CLI, CLI_TS] };
+  }
+  if (fs.existsSync(CLI_WRAPPER)) {
+    return { cmd: process.execPath, prefixArgs: [CLI_WRAPPER] };
+  }
+  if (fs.existsSync(CLI_JS)) {
+    return { cmd: process.execPath, prefixArgs: [CLI_JS] };
+  }
+  return { cmd: process.execPath, prefixArgs: [CLI_WRAPPER] };
+}
+
+function runCli(args, capture = false) {
+  const { cmd, prefixArgs } = cliCommand();
+  const result = spawnSync(cmd, [...prefixArgs, ...args], {
+    stdio: capture ? 'pipe' : 'inherit',
+    shell: false,
+    windowsHide: true,
+    env: {
+      ...process.env,
+      BOARD_LIVE_CARDS_NO_SPAWN: '1',
+    },
+    encoding: capture ? 'utf-8' : undefined,
+  });
+
+  if (result.error) {
+    console.error(`[ERROR] Failed to run CLI ${args[0]}: ${result.error.message}`);
+    process.exit(1);
+  }
+
+  if (result.status !== 0) {
+    if (capture && result.stdout) process.stdout.write(result.stdout);
+    if (capture && result.stderr) process.stderr.write(result.stderr);
+    console.error(`\n[ERROR] board-live-cards-cli ${args[0]} exited with status ${result.status}`);
+    process.exit(1);
+  }
+
+  return capture ? result.stdout : undefined;
+}
+
+function cli(...args) {
+  runCli(args, false);
+}
+
+function statusText() {
+  return runCli(['status', '--rg', BOARD], true) ?? '';
+}
+
+async function waitForAllCompleted(label, timeoutMs = 30000, pollMs = 500) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    const out = statusText();
+    const completed = [
+      /\bcompleted\s+portfolio-form\b/.test(out),
+      /\bcompleted\s+price-fetch\b/.test(out),
+      /\bcompleted\s+holdings-table\b/.test(out),
+      /\bcompleted\s+portfolio-value\b/.test(out),
+    ].every(Boolean);
+
+    if (completed) {
+      console.log(`${label}: all cards completed.`);
+      return;
+    }
+
+    await sleep(pollMs);
+  }
+
+  console.error(`[ERROR] ${label}: timed out waiting for all cards to complete.`);
+  console.error(statusText());
+  process.exit(1);
+}
+
+function writePrices(prices) {
+  if (!fs.existsSync(BOARD)) {
+    fs.mkdirSync(BOARD, { recursive: true });
+  }
+  fs.writeFileSync(TMP_FILE, JSON.stringify(prices), 'utf-8');
+  console.log(`Wrote prices: ${JSON.stringify(prices)}`);
+}
+
+function setupRuntimeCards() {
+  fs.rmSync(CARDS, { recursive: true, force: true });
+  fs.mkdirSync(RUNTIME_ROOT, { recursive: true });
+  fs.cpSync(CARDS_TEMPLATE, CARDS, { recursive: true });
+  fs.copyFileSync(path.join(__dirname, 'fetch-prices.js'), path.join(RUNTIME_ROOT, 'fetch-prices.js'));
+}
+
+(async () => {
+  setupRuntimeCards();
+
+  console.log('\n=== T0: Init board ===');
+  fs.rmSync(BOARD, { recursive: true, force: true });
+
+  cli('init', BOARD);
+  cli('add-cards', '--rg', BOARD, '--card-glob', path.join(CARDS, '*.json'));
+
+  console.log('\n--- T0 Status (after add-cards) ---');
+  process.stdout.write(statusText());
+
+  console.log('\n=== T1: Writing market prices ===');
+  writePrices({ AAPL: 198.50, MSFT: 425.30, GOOG: 178.90, AMZN: 192.40, TSLA: 168.75 });
+  await waitForAllCompleted('T1');
+
+  console.log('\n--- T1 Status ---');
+  process.stdout.write(statusText());
+
+  console.log('\n=== T2: Adding GOOG (100 shares) ===');
+  const portfolioFormPath = path.join(CARDS, 'portfolio-form.json');
+  const portfolioFormV2 = {
+    id: 'portfolio-form',
+    meta: { title: 'Portfolio Holdings Form' },
+    provides: [{ bindTo: 'holdings', src: 'state.holdings' }],
+    state: {
+      holdings: [
+        { symbol: 'AAPL', qty: 50 },
+        { symbol: 'MSFT', qty: 30 },
+        { symbol: 'GOOG', qty: 100 },
+      ],
+    },
+    view: {
+      elements: [
+        { kind: 'table', label: 'Holdings', data: { bind: 'state.holdings', columns: ['symbol', 'qty'] } },
+      ],
+    },
+  };
+  fs.writeFileSync(portfolioFormPath, JSON.stringify(portfolioFormV2, null, 2));
+
+  cli('update-card', '--rg', BOARD, '--card-id', 'portfolio-form', '--restart');
+  await sleep(500);
+  writePrices({ AAPL: 198.50, MSFT: 425.30, GOOG: 178.90, AMZN: 192.40, TSLA: 168.75 });
+  await waitForAllCompleted('T2');
+
+  console.log('\n--- T2 Status ---');
+  process.stdout.write(statusText());
+
+  console.log('\n=== T3: Force price refresh — AAPL now 205.00 ===');
+  cli('retrigger', '--rg', BOARD, '--task', 'price-fetch');
+  await sleep(500);
+  writePrices({ AAPL: 205.00, MSFT: 425.30, GOOG: 178.90, AMZN: 192.40, TSLA: 168.75 });
+  await waitForAllCompleted('T3');
+
+  console.log('\n--- T3 Status ---');
+  process.stdout.write(statusText());
+
+  console.log('\n=== T4: Final board status ===');
+  process.stdout.write(statusText());
+
+  console.log('\nPortfolio tracker completed successfully');
+})();