yaml-flow 6.0.0 → 7.1.0

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

@@ -7,6 +7,7 @@ fallbacks or defaults.
 """
 
 import copy
+import base64
 import json
 import os
 import shutil
@@ -17,6 +18,11 @@ import time
 import argparse
 
 
+def serialize_ref(ref: dict[str, str]) -> str:
+    payload = json.dumps({"kind": ref.get("kind", ""), "value": ref.get("value", "")}, separators=(",", ":")).encode("utf-8")
+    return "b64:" + base64.urlsafe_b64encode(payload).decode("ascii").rstrip("=")
+
+
 _CLI_PARSER = argparse.ArgumentParser()
 _MODE_GROUP = _CLI_PARSER.add_mutually_exclusive_group()
 _MODE_GROUP.add_argument('--run-pycli', action='store_true', help='Use pycli for board/card operations (default)')
@@ -46,7 +52,6 @@ PYTHON_RUNNER = sys.executable or PYTHON
 
 BOARD_PYCLI = os.path.join(_REPO_ROOT, 'pycli', 'main', 'board_live_cards_pycli.py')
 CARD_STORE_PYCLI = os.path.join(_REPO_ROOT, 'pycli', 'main', 'card_store_pycli.py')
-QUICKJS_BUNDLE = os.path.join(_REPO_ROOT, 'dist', 'pycli', 'quickjs-board-runtime.global.js')
 
 if RUN_PYCLI:
     if not os.path.exists(BOARD_PYCLI):
@@ -55,15 +60,11 @@ if RUN_PYCLI:
     if not os.path.exists(CARD_STORE_PYCLI):
         print(f'[ERROR] pycli entry not found: {CARD_STORE_PYCLI}', file=sys.stderr)
         sys.exit(1)
-    if not os.path.exists(QUICKJS_BUNDLE):
-        print(f'[ERROR] quickjs bundle not found: {QUICKJS_BUNDLE}', file=sys.stderr)
-        print('Run from yaml-flow root: npm run build:quickjs', file=sys.stderr)
-        sys.exit(1)
 
 if RUN_PYCLI:
     ACTIVE_BOARD_BIN = [PYTHON_RUNNER, BOARD_PYCLI]
     ACTIVE_CARD_STORE_BIN = [PYTHON_RUNNER, CARD_STORE_PYCLI]
-    ACTIVE_BOARD_SUFFIX = ['--bundle', QUICKJS_BUNDLE]
+    ACTIVE_BOARD_SUFFIX = []
 else:
     ACTIVE_BOARD_BIN = [NODE, BOARD_CLI]
     ACTIVE_CARD_STORE_BIN = [NODE, CARD_STORE_CLI]
@@ -75,9 +76,9 @@ CARDSTORE_DIR   = os.path.join(_TMP_BASE, 'cardstore')
 BOARDRUNTIME_DIR = os.path.join(_TMP_BASE, 'boardruntime')
 OUTPUTS_DIR     = os.path.join(_TMP_BASE, 'outputs')
 
-CARDSTORE_REF    = f'::fs-path::{CARDSTORE_DIR}'
-BOARDRUNTIME_REF = f'::fs-path::{BOARDRUNTIME_DIR}'
-OUTPUTS_REF      = f'::fs-path::{OUTPUTS_DIR}'
+CARDSTORE_REF    = serialize_ref({'kind': 'fs-path', 'value': CARDSTORE_DIR})
+BOARDRUNTIME_REF = serialize_ref({'kind': 'fs-path', 'value': BOARDRUNTIME_DIR})
+OUTPUTS_REF      = serialize_ref({'kind': 'fs-path', 'value': OUTPUTS_DIR})
 
 # ── Inline card definitions ────────────────────────────────────────────────────
 CARD_PORTFOLIO_FORM = {
@@ -229,7 +230,7 @@ _task_executor_body = json.dumps({
     'task-executor-ref': {
         'meta': 'task-executor',
         'howToRun': 'local-python',
-        'whatToRun': f'::fs-path::{FETCH_PRICES_PY}',
+            'whatToRun': serialize_ref({'kind': 'fs-path', 'value': FETCH_PRICES_PY}),
     }
 })
 run_board_with_input(

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/_board-cli.js

@@ -8,9 +8,23 @@ const repoRoot = path.resolve(__dirname, '..', '..', '..', '..', '..');
 const boardCliPath = path.join(repoRoot, 'board-live-cards-cli.js');
 const cardStoreCliPath = path.join(repoRoot, 'card-store.js');
 
+export function toFsRef(value) {
+  const payload = Buffer.from(JSON.stringify({ kind: 'fs-path', value }), 'utf-8').toString('base64url');
+  return `b64:${payload}`;
+}
+
+function normalizeRefArg(v) {
+  if (typeof v !== 'string') return v;
+  return v;
+}
+
+function normalizeArgs(args) {
+  return args.map((v) => normalizeRefArg(v));
+}
+
 export function runBoardCli(args, options = {}) {
   const { capture = false, cwd = process.cwd() } = options;
-  const result = spawnSync(process.execPath, [boardCliPath, ...args], {
+  const result = spawnSync(process.execPath, [boardCliPath, ...normalizeArgs(args)], {
     cwd,
     encoding: 'utf-8',
     windowsHide: true,
@@ -37,7 +51,7 @@ export function runBoardCli(args, options = {}) {
 /** Spawn CLI with JSON piped to stdin. */
 export function runBoardCliWithInput(args, inputJson, options = {}) {
   const { cwd = process.cwd() } = options;
-  const result = spawnSync(process.execPath, [boardCliPath, ...args], {
+  const result = spawnSync(process.execPath, [boardCliPath, ...normalizeArgs(args)], {
     input: inputJson,
     cwd,
     encoding: 'utf-8',
@@ -65,7 +79,7 @@ export function runBoardCliWithInput(args, inputJson, options = {}) {
 /** Spawn card-store-cli with JSON piped to stdin. */
 export function runCardStoreCliWithInput(args, inputJson, options = {}) {
   const { cwd = process.cwd() } = options;
-  const result = spawnSync(process.execPath, [cardStoreCliPath, ...args], {
+  const result = spawnSync(process.execPath, [cardStoreCliPath, ...normalizeArgs(args)], {
     input: inputJson,
     cwd,
     encoding: 'utf-8',
@@ -106,5 +120,6 @@ export function writeResult(payload) {
 }
 
 export function writeFailure(message) {
-  writeResult({ result: 'failure', error: message });
+  process.stderr.write(message);
+  process.exit(1);
 }

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/add-cards-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readStdinJson, runBoardCli, runCardStoreCliWithInput, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, runCardStoreCliWithInput, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 try {
   const input = await readStdinJson();
@@ -9,10 +9,9 @@ try {
 
   if (!boardDir || cards.length === 0) {
     writeFailure('BOARD_DIR and CARDS (array) are required');
-    process.exit(0);
   }
 
-  const baseRef = `::fs-path::${boardDir}`;
+  const baseRef = toFsRef(boardDir);
 
   // Write all cards to the card store in one call
   runCardStoreCliWithInput(
@@ -24,11 +23,8 @@ try {
   runBoardCli(['upsert-card', '--base-ref', baseRef, '--all']);
 
   writeResult({
-    result: 'success',
-    data: {
-      board_dir: boardDir,
-      count: cards.length,
-    },
+    board_dir: boardDir,
+    cards_added: cards.length,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/init-board-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 try {
   const input = await readStdinJson();
@@ -8,21 +8,17 @@ try {
 
   if (!boardDir) {
     writeFailure('BOARD_DIR is required');
-    process.exit(0);
   }
 
   runBoardCli([
     'init',
-    '--base-ref', `::fs-path::${boardDir}`,
-    '--card-store-ref', `::fs-path::${boardDir}`,
-    '--outputs-store-ref', `::fs-path::${boardDir}`,
+    '--base-ref', toFsRef(boardDir),
+    '--card-store-ref', toFsRef(boardDir),
+    '--outputs-store-ref', toFsRef(boardDir),
   ]);
   writeResult({
-    result: 'success',
-    data: {
-      board_dir: boardDir,
-      message: `initialized ${boardDir}`,
-    },
+    board_dir: boardDir,
+    message: `initialized ${boardDir}`,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/poll-status-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -15,13 +15,12 @@ try {
 
   if (!boardDir || expectedCardCount <= 0) {
     writeFailure('BOARD_DIR and EXPECTED_CARD_COUNT are required');
-    process.exit(0);
   }
 
   const started = Date.now();
 
   while (Date.now() - started < timeoutMs) {
-    const statusJson = runBoardCli(['status', '--base-ref', `::fs-path::${boardDir}`], { capture: true });
+    const statusJson = runBoardCli(['status', '--base-ref', toFsRef(boardDir)], { capture: true });
     let cards = [];
     try {
       cards = JSON.parse(statusJson)?.data?.cards ?? [];
@@ -31,12 +30,9 @@ try {
 
     if (cards.length >= expectedCardCount && completedCount >= expectedCardCount) {
       writeResult({
-        result: 'success',
-        data: {
-          completed: true,
-          card_count: cards.length,
-          completed_count: completedCount,
-        },
+        all_completed: true,
+        card_count: cards.length,
+        completed_count: completedCount,
       });
       process.exit(0);
     }
@@ -44,13 +40,9 @@ try {
     await sleep(pollMs);
   }
 
-  writeResult({
-    result: 'timeout',
-    data: {
-      completed: false,
-      error: `timed out waiting for ${expectedCardCount} cards to complete`,
-    },
-  });
+  // Timeout — exit non-zero
+  process.stderr.write(`timed out waiting for ${expectedCardCount} cards to complete`);
+  process.exit(1);
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);
   writeFailure(message);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/reset-board-dir-cli.js

@@ -10,18 +10,14 @@ try {
 
   if (!boardDirInput) {
     writeFailure('BOARD_DIR is required');
-    process.exit(0);
   }
 
   const boardDir = path.resolve(boardDirInput);
   fs.rmSync(boardDir, { recursive: true, force: true });
 
   writeResult({
-    result: 'success',
-    data: {
-      board_dir: boardDir,
-      reset: true,
-    },
+    board_dir: boardDir,
+    reset: true,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/retrigger-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 try {
   const input = await readStdinJson();
@@ -9,17 +9,13 @@ try {
 
   if (!boardDir || !task) {
     writeFailure('BOARD_DIR and TASK are required');
-    process.exit(0);
   }
 
-  runBoardCli(['retrigger', '--base-ref', `::fs-path::${boardDir}`, '--id', task]);
+  runBoardCli(['retrigger', '--base-ref', toFsRef(boardDir), '--id', task]);
 
   writeResult({
-    result: 'success',
-    data: {
-      task,
-      retriggered: true,
-    },
+    task,
+    retriggered: true,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/status-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 try {
   const input = await readStdinJson();
@@ -8,16 +8,12 @@ try {
 
   if (!boardDir) {
     writeFailure('BOARD_DIR is required');
-    process.exit(0);
   }
 
-  const status = runBoardCli(['status', '--base-ref', `::fs-path::${boardDir}`], { capture: true });
+  const status = runBoardCli(['status', '--base-ref', toFsRef(boardDir)], { capture: true });
 
   writeResult({
-    result: 'success',
-    data: {
-      status,
-    },
+    status,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/update-holdings-cli.js

@@ -2,7 +2,7 @@
 
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { readStdinJson, runBoardCli, runCardStoreCliWithInput, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, runCardStoreCliWithInput, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 try {
   const input = await readStdinJson();
@@ -12,7 +12,6 @@ try {
 
   if (!boardDir || !cardsDir || !Array.isArray(holdings)) {
     writeFailure('BOARD_DIR, CARDS_DIR and HOLDINGS array are required');
-    process.exit(0);
   }
 
   const cardPath = path.join(cardsDir, 'portfolio-form.json');
@@ -22,7 +21,7 @@ try {
   card.card_data.holdings = holdings;
   fs.writeFileSync(cardPath, `${JSON.stringify(card, null, 2)}\n`, 'utf-8');
 
-  const baseRef = `::fs-path::${boardDir}`;
+  const baseRef = toFsRef(boardDir);
   runCardStoreCliWithInput(
     ['set', '--store-ref', baseRef],
     JSON.stringify(card),
@@ -30,11 +29,8 @@ try {
   runBoardCli(['upsert-card', '--base-ref', baseRef, '--card-id', card.id, '--restart']);
 
   writeResult({
-    result: 'success',
-    data: {
-      saved: true,
-      holdings_count: holdings.length,
-    },
+    saved: true,
+    holdings_count: holdings.length,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/wait-completed-cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+import { readStdinJson, runBoardCli, toFsRef, writeFailure, writeResult } from './_board-cli.js';
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -16,13 +16,12 @@ try {
 
   if (!boardDir || tasks.length === 0) {
     writeFailure('BOARD_DIR and COMPLETION_TASKS are required');
-    process.exit(0);
   }
 
   const started = Date.now();
 
   while (Date.now() - started < timeoutMs) {
-    const statusJson = runBoardCli(['status', '--base-ref', `::fs-path::${boardDir}`], { capture: true });
+    const statusJson = runBoardCli(['status', '--base-ref', toFsRef(boardDir)], { capture: true });
     let cards = [];
     try {
       cards = JSON.parse(statusJson)?.data?.cards ?? [];
@@ -31,11 +30,8 @@ try {
 
     if (complete) {
       writeResult({
-        result: 'success',
-        data: {
-          label,
-          completed: true,
-        },
+        label,
+        completed: true,
       });
       process.exit(0);
     }
@@ -43,14 +39,9 @@ try {
     await sleep(pollMs);
   }
 
-  writeResult({
-    result: 'timeout',
-    data: {
-      label,
-      completed: false,
-      error: `${label}: timed out waiting for completion`,
-    },
-  });
+  // Timeout — exit non-zero
+  process.stderr.write(`${label}: timed out waiting for completion`);
+  process.exit(1);
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);
   writeFailure(message);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers/write-prices-cli.js

@@ -12,7 +12,6 @@ try {
 
   if (!boardDirInput || !prices || typeof prices !== 'object' || Array.isArray(prices)) {
     writeFailure('BOARD_DIR and PRICES object are required');
-    process.exit(0);
   }
 
   const boardDir = path.resolve(boardDirInput);
@@ -23,11 +22,8 @@ try {
   fs.writeFileSync(tmpFile, payload, 'utf-8');
 
   writeResult({
-    result: 'success',
-    data: {
-      wrote: true,
-      tmp_file: tmpFile,
-    },
+    wrote: true,
+    tmp_file: tmpFile,
   });
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);

package/examples/cli/step-machine-cli/portfolio-tracker/handlers-py/_board_pycli.py

@@ -6,6 +6,7 @@ Result schema: {"result": "success" | "failure" | "timeout", "data"?: {...}, "er
 from __future__ import annotations
 
 import json
+import base64
 import os
 import subprocess
 import sys
@@ -50,8 +51,17 @@ def _hidden_kwargs() -> dict[str, Any]:
     return kwargs
 
 
+def to_fs_ref(value: str) -> str:
+    payload = json.dumps({"kind": "fs-path", "value": value}, separators=(",", ":")).encode("utf-8")
+    return "b64:" + base64.urlsafe_b64encode(payload).decode("ascii").rstrip("=")
+
+
+def _normalize_args(args: list[str]) -> list[str]:
+    return list(args)
+
+
 def run_board_pycli(args: list[str], *, capture: bool = False) -> str:
-    cmd = [sys.executable, str(BOARD_PYCLI), *args, "--bundle", str(QUICKJS_BUNDLE)]
+    cmd = [sys.executable, str(BOARD_PYCLI), *_normalize_args(args), "--bundle", str(QUICKJS_BUNDLE)]
     proc = subprocess.run(
         cmd,
         capture_output=True,
@@ -66,7 +76,7 @@ def run_board_pycli(args: list[str], *, capture: bool = False) -> str:
 
 
 def run_board_pycli_with_input(args: list[str], input_json: str) -> str:
-    cmd = [sys.executable, str(BOARD_PYCLI), *args, "--bundle", str(QUICKJS_BUNDLE)]
+    cmd = [sys.executable, str(BOARD_PYCLI), *_normalize_args(args), "--bundle", str(QUICKJS_BUNDLE)]
     proc = subprocess.run(
         cmd,
         input=input_json,
@@ -82,7 +92,7 @@ def run_board_pycli_with_input(args: list[str], input_json: str) -> str:
 
 
 def run_card_store_pycli_with_input(args: list[str], input_json: str) -> str:
-    cmd = [sys.executable, str(CARD_STORE_PYCLI), *args]
+    cmd = [sys.executable, str(CARD_STORE_PYCLI), *_normalize_args(args)]
     proc = subprocess.run(
         cmd,
         input=input_json,

package/examples/cli/step-machine-cli/portfolio-tracker/handlers-py/add-cards.py

@@ -11,6 +11,7 @@ from _board_pycli import (  # noqa: E402
     read_stdin_json,
     run_board_pycli,
     run_card_store_pycli_with_input,
+    to_fs_ref,
     write_failure,
     write_result,
 )
@@ -28,7 +29,7 @@ def main() -> int:
             write_failure("BOARD_DIR and CARDS (array) are required")
             return 0
 
-        base_ref = f"::fs-path::{board_dir}"
+        base_ref = to_fs_ref(board_dir)
 
         run_card_store_pycli_with_input(
             ["set", "--store-ref", base_ref],

package/examples/cli/step-machine-cli/portfolio-tracker/handlers-py/init-board.py

@@ -9,6 +9,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parent))
 from _board_pycli import (  # noqa: E402
     read_stdin_json,
     run_board_pycli,
+    to_fs_ref,
     write_failure,
     write_result,
 )
@@ -22,7 +23,7 @@ def main() -> int:
             write_failure("BOARD_DIR is required")
             return 0
 
-        base_ref = f"::fs-path::{board_dir}"
+        base_ref = to_fs_ref(board_dir)
         run_board_pycli([
             "init",
             "--base-ref", base_ref,

package/examples/cli/step-machine-cli/portfolio-tracker/handlers-py/poll-status.py

@@ -11,6 +11,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parent))
 from _board_pycli import (  # noqa: E402
     read_stdin_json,
     run_board_pycli,
+    to_fs_ref,
     write_failure,
     write_result,
 )
@@ -28,7 +29,7 @@ def main() -> int:
             write_failure("BOARD_DIR and EXPECTED_CARD_COUNT are required")
             return 0
 
-        base_ref = f"::fs-path::{board_dir}"
+        base_ref = to_fs_ref(board_dir)
         deadline = time.monotonic() + (timeout_ms / 1000)
 
         while time.monotonic() < deadline:

package/examples/cli/step-machine-cli/portfolio-tracker/portfolio-tracker.flow.yaml

@@ -10,11 +10,11 @@ steps:
     expects_data: [runtime_root, board_name]
     produces_data: [board_dir]
     handler:
-      cli: node ./handlers/reset-board-dir-cli.js
-      input-transforms:
-        BOARD_DIR: runtime_root & "/" & board_name
-      output-transforms:
-        board_dir: data.board_dir
+      type: ref
+      howToRun: local-node
+      whatToRun: {kind: fs-path, value: ./handlers/reset-board-dir-cli.js}
+      argsMassaging:
+        bodyTemplate: "{ 'BOARD_DIR': runtime_root & '/' & board_name }"
     transitions:
       success: t0_init_board
     failure_transitions:
@@ -25,11 +25,11 @@ steps:
     expects_data: [board_dir]
     produces_data: [board_dir]
     handler:
-      cli: node ./handlers/init-board-cli.js
-      input-transforms:
-        BOARD_DIR: board_dir
-      output-transforms:
-        board_dir: data.board_dir
+      type: ref
+      howToRun: local-node
+      whatToRun: {kind: fs-path, value: ./handlers/init-board-cli.js}
+      argsMassaging:
+        bodyTemplate: "{ 'BOARD_DIR': board_dir }"
     transitions:
       success: t1_add_cards
     failure_transitions:
@@ -40,12 +40,11 @@ steps:
     expects_data: [board_dir, cards]
     produces_data: [cards_added]
     handler:
-      cli: node ./handlers/add-cards-cli.js
-      input-transforms:
-        BOARD_DIR: board_dir
-        CARDS: cards
-      output-transforms:
-        cards_added: data.count
+      type: ref
+      howToRun: local-node
+      whatToRun: {kind: fs-path, value: ./handlers/add-cards-cli.js}
+      argsMassaging:
+        bodyTemplate: "{ 'BOARD_DIR': board_dir, 'CARDS': cards }"
     transitions:
       success: t2_poll_status
     failure_transitions:
@@ -56,14 +55,11 @@ steps:
     expects_data: [board_dir, expected_card_count]
     produces_data: [all_completed]
     handler:
-      cli: node ./handlers/poll-status-cli.js
-      input-transforms:
-        BOARD_DIR: board_dir
-        EXPECTED_CARD_COUNT: expected_card_count
-        TIMEOUT_MS: "30000"
-        POLL_MS: "500"
-      output-transforms:
-        all_completed: data.completed
+      type: ref
+      howToRun: local-node
+      whatToRun: {kind: fs-path, value: ./handlers/poll-status-cli.js}
+      argsMassaging:
+        bodyTemplate: "{ 'BOARD_DIR': board_dir, 'EXPECTED_CARD_COUNT': expected_card_count, 'TIMEOUT_MS': '30000', 'POLL_MS': '500' }"
     transitions:
       success: success_state
     failure_transitions:

package/examples/cli/step-machine-cli/portfolio-tracker/run-inline-python-demo-pycli.py

@@ -13,7 +13,6 @@ def main() -> int:
 
     pycli = repo_root / "pycli" / "main" / "step_machine_pycli.py"
     flow = here / "inline-python-demo.flow.yaml"
-    handlers = here / "inline-python-handlers.py"
 
     initial_data = {
         "name": "Ada",
@@ -25,8 +24,6 @@ def main() -> int:
         sys.executable,
         str(pycli),
         str(flow),
-        "--handlers",
-        str(handlers),
         "--initial-data",
         json.dumps(initial_data, ensure_ascii=True),
         "--store",

package/examples/cli/step-machine-demo/jsonata-init-board-cli.js

@@ -9,27 +9,22 @@ process.stdin.on('data', (chunk) => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(raw || '{}');
-    const boardDirFromArg = process.argv[2] ?? '';
-    const boardDirFromInput = input.BOARD_DIR ?? '';
+    const boardDir = input.BOARD_DIR ?? '';
 
-    if (!boardDirFromArg || !boardDirFromInput || boardDirFromArg !== boardDirFromInput) {
-      process.stdout.write(JSON.stringify({
-        result: 'failure',
-        error: 'BOARD_DIR missing or mismatch between cli arg and stdin payload',
-      }));
+    if (!boardDir) {
+      process.stderr.write('BOARD_DIR missing from input');
+      process.exit(1);
       return;
     }
 
     process.stdout.write(JSON.stringify({
-      result: 'success',
-      data: {
-        message: `initialized ${boardDirFromArg}`,
-        ignored: 'will be filtered by produces_data',
-      },
+      message: `initialized ${boardDir}`,
+      ignored: 'will be filtered by produces_data',
     }));
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    process.stdout.write(JSON.stringify({ result: 'failure', error: message }));
+    process.stderr.write(message);
+    process.exit(1);
   }
 });