yaml-flow 7.1.0 → 8.0.0

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

@@ -1,80 +0,0 @@
-id: portfolio-tracker-step-machine-pycli
-settings:
-  start_step: t0_reset_board
-  max_total_steps: 30
-  timeout_ms: 120000
-
-steps:
-  t0_reset_board:
-    description: Reset board runtime directory for idempotent reruns
-    expects_data: [runtime_root, board_name]
-    produces_data: [board_dir]
-    handler:
-      cli: python ./handlers-py/reset-board-dir.py
-      input-transforms:
-        BOARD_DIR: runtime_root & "/" & board_name
-      output-transforms:
-        board_dir: data.board_dir
-    transitions:
-      success: t0_init_board
-    failure_transitions:
-      failure: failed_state
-
-  t0_init_board:
-    description: Initialize board with card-store and outputs-store refs (pycli)
-    expects_data: [board_dir]
-    produces_data: [board_dir]
-    handler:
-      cli: python ./handlers-py/init-board.py
-      input-transforms:
-        BOARD_DIR: board_dir
-      output-transforms:
-        board_dir: data.board_dir
-    transitions:
-      success: t1_add_cards
-    failure_transitions:
-      failure: failed_state
-
-  t1_add_cards:
-    description: Add cards via card-store set and upsert-card --all (pycli)
-    expects_data: [board_dir, cards]
-    produces_data: [cards_added]
-    handler:
-      cli: python ./handlers-py/add-cards.py
-      input-transforms:
-        BOARD_DIR: board_dir
-        CARDS: cards
-      output-transforms:
-        cards_added: data.count
-    transitions:
-      success: t2_poll_status
-    failure_transitions:
-      failure: failed_state
-
-  t2_poll_status:
-    description: Poll board status until all cards are completed (pycli)
-    expects_data: [board_dir, expected_card_count]
-    produces_data: [all_completed]
-    handler:
-      cli: python ./handlers-py/poll-status.py
-      input-transforms:
-        BOARD_DIR: board_dir
-        EXPECTED_CARD_COUNT: expected_card_count
-        TIMEOUT_MS: "30000"
-        POLL_MS: "500"
-      output-transforms:
-        all_completed: data.completed
-    transitions:
-      success: success_state
-    failure_transitions:
-      timeout: failed_state
-      failure: failed_state
-
-terminal_states:
-  success_state:
-    return_intent: success
-    return_artifacts: [board_dir, cards_added, all_completed]
-
-  failed_state:
-    return_intent: failure
-    return_artifacts: [error, board_dir]

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

@@ -1,76 +0,0 @@
-id: portfolio-tracker-step-machine
-settings:
-  start_step: t0_reset_board
-  max_total_steps: 30
-  timeout_ms: 120000
-
-steps:
-  t0_reset_board:
-    description: Reset board runtime directory for idempotent reruns
-    expects_data: [runtime_root, board_name]
-    produces_data: [board_dir]
-    handler:
-      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:
-      failure: failed_state
-
-  t0_init_board:
-    description: Initialize board with card-store and outputs-store refs
-    expects_data: [board_dir]
-    produces_data: [board_dir]
-    handler:
-      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:
-      failure: failed_state
-
-  t1_add_cards:
-    description: Add 3 cards via card-store set and upsert-card --all
-    expects_data: [board_dir, cards]
-    produces_data: [cards_added]
-    handler:
-      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:
-      failure: failed_state
-
-  t2_poll_status:
-    description: Poll board status until all 3 cards are completed
-    expects_data: [board_dir, expected_card_count]
-    produces_data: [all_completed]
-    handler:
-      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:
-      timeout: failed_state
-      failure: failed_state
-
-terminal_states:
-  success_state:
-    return_intent: success
-    return_artifacts: [board_dir, cards_added, all_completed]
-
-  failed_state:
-    return_intent: failure
-    return_artifacts: [error, board_dir]

package/examples/cli/step-machine-cli/portfolio-tracker/portfolio-tracker.input.json

@@ -1,44 +0,0 @@
-{
-  "runtime_root": "./runtime",
-  "board_name": "portfolio-tracker-board",
-  "expected_card_count": 3,
-  "cards": [
-    {
-      "id": "portfolio-form",
-      "meta": { "title": "Portfolio Holdings Form" },
-      "provides": [{ "bindTo": "holdings", "ref": "card_data.holdings" }],
-      "card_data": {
-        "holdings": [
-          { "symbol": "AAPL", "qty": 50 },
-          { "symbol": "MSFT", "qty": 30 },
-          { "symbol": "GOOG", "qty": 100 }
-        ]
-      }
-    },
-    {
-      "id": "prices-mock",
-      "meta": { "title": "Mock Market Prices" },
-      "provides": [{ "bindTo": "prices", "ref": "card_data.prices" }],
-      "card_data": {
-        "prices": {
-          "AAPL": 198.5,
-          "MSFT": 425.3,
-          "GOOG": 178.9
-        }
-      }
-    },
-    {
-      "id": "portfolio-value",
-      "meta": { "title": "Portfolio Total Value" },
-      "requires": ["holdings", "prices"],
-      "provides": [{ "bindTo": "totalValue", "ref": "computed_values.totalValue" }],
-      "card_data": {},
-      "compute": [
-        {
-          "bindTo": "totalValue",
-          "expr": "$sum($map(requires.holdings, function($h) { $h.qty * $lookup(requires.prices, $h.symbol) }))"
-        }
-      ]
-    }
-  ]
-}

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

@@ -1,43 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-import json
-import subprocess
-import sys
-from pathlib import Path
-
-
-def main() -> int:
-    here = Path(__file__).resolve().parent
-    repo_root = here.parents[3]
-
-    pycli = repo_root / "pycli" / "main" / "step_machine_pycli.py"
-    flow = here / "inline-python-demo.flow.yaml"
-
-    initial_data = {
-        "name": "Ada",
-        "a": 7,
-        "b": 5,
-    }
-
-    cmd = [
-        sys.executable,
-        str(pycli),
-        str(flow),
-        "--initial-data",
-        json.dumps(initial_data, ensure_ascii=True),
-        "--store",
-        "memory",
-    ]
-
-    proc = subprocess.run(
-        cmd,
-        cwd=str(here),
-        shell=False,
-        check=False,
-    )
-    return proc.returncode
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

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

@@ -1,77 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import subprocess
-import sys
-import tempfile
-from pathlib import Path
-
-
-def _build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(
-        description="Run the step-machine portfolio tracker example via step_machine_pycli.py",
-    )
-    parser.add_argument(
-        "action",
-        nargs="?",
-        choices=["run", "pause", "resume", "status"],
-        default="run",
-        help="Operation to perform (default: run)",
-    )
-    return parser
-
-
-def main() -> int:
-    args = _build_parser().parse_args()
-
-    here = Path(__file__).resolve().parent
-    repo_root = here.parents[3]
-    pycli = repo_root / "pycli" / "main" / "step_machine_pycli.py"
-    flow = here / "portfolio-tracker-pycli.flow.yaml"
-    input_json = here / "portfolio-tracker.input.json"
-
-    temp_root = Path(tempfile.gettempdir()) / "yaml-flow-step-machine-portfolio-tracker"
-    store_dir = temp_root / "store"
-    runtime_root = temp_root / "runtime"
-
-    cmd = [
-        sys.executable,
-        str(pycli),
-        "--store",
-        "file",
-        "--store-dir",
-        str(store_dir),
-    ]
-
-    if args.action in ("run", "resume"):
-        cmd.insert(2, str(flow))
-
-    if args.action == "run":
-        payload = json.loads(input_json.read_text(encoding="utf-8"))
-        payload["runtime_root"] = runtime_root.as_posix()
-        cmd.extend(["--initial-data", json.dumps(payload, ensure_ascii=True)])
-    elif args.action == "resume":
-        cmd.append("--resume")
-    elif args.action == "pause":
-        cmd.append("--pause")
-    elif args.action == "status":
-        cmd.append("--status")
-
-    proc = subprocess.run(
-        cmd,
-        cwd=str(here),
-        shell=False,
-        check=False,
-        env={
-            **os.environ,
-            "PATH": str(Path(sys.executable).parent) + os.pathsep + os.environ.get("PATH", ""),
-        },
-    )
-    return proc.returncode
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/examples/cli/step-machine-cli/portfolio-tracker/run-portfolio-tracker.bat

@@ -1,28 +0,0 @@
-@echo off
-setlocal
-cd /d "%~dp0"
-
-set "EXAMPLE_TEMP_ROOT=%TEMP%\yaml-flow-step-machine-portfolio-tracker"
-set "STORE_DIR=%EXAMPLE_TEMP_ROOT%\store"
-set "RUNTIME_ROOT=%EXAMPLE_TEMP_ROOT%\runtime"
-
-if /I "%~1"=="pause" goto :pause
-if /I "%~1"=="resume" goto :resume
-if /I "%~1"=="status" goto :status
-goto :run
-
-:pause
-node ..\..\..\..\step-machine-cli.js --store file --store-dir "%STORE_DIR%" --pause
-exit /b %ERRORLEVEL%
-
-:resume
-node ..\..\..\..\step-machine-cli.js portfolio-tracker.flow.yaml --store file --store-dir "%STORE_DIR%" --resume
-exit /b %ERRORLEVEL%
-
-:status
-node ..\..\..\..\step-machine-cli.js --store file --store-dir "%STORE_DIR%" --status
-exit /b %ERRORLEVEL%
-
-:run
-node -e "const fs=require('fs');const cp=require('child_process');const raw=JSON.parse(fs.readFileSync('portfolio-tracker.input.json','utf8'));raw.runtime_root=(process.env.RUNTIME_ROOT||'').replace(/\\/g,'/');const r=cp.spawnSync(process.execPath,['..\\..\\..\\..\\step-machine-cli.js','portfolio-tracker.flow.yaml','--initial-data',JSON.stringify(raw)],{stdio:'inherit',windowsHide:true,cwd:__dirname});process.exit(r.status??1);"
-exit /b %ERRORLEVEL%

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

@@ -1,31 +0,0 @@
-#!/usr/bin/env node
-
-let raw = '';
-process.stdin.setEncoding('utf-8');
-process.stdin.on('data', (chunk) => {
-  raw += chunk;
-});
-
-process.stdin.on('end', () => {
-  try {
-    const input = JSON.parse(raw || '{}');
-    const boardDir = input.BOARD_DIR ?? '';
-
-    if (!boardDir) {
-      process.stderr.write('BOARD_DIR missing from input');
-      process.exit(1);
-      return;
-    }
-
-    process.stdout.write(JSON.stringify({
-      message: `initialized ${boardDir}`,
-      ignored: 'will be filtered by produces_data',
-    }));
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(message);
-    process.exit(1);
-  }
-});
-
-process.stdin.resume();

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

@@ -1,54 +0,0 @@
-id: jsonata-init-board-demo
-settings:
-  start_step: t0_prepare
-  max_total_steps: 10
-  timeout_ms: 30000
-
-steps:
-  t0_prepare:
-    description: Build board path from runtime_root and board_name
-    expects_data: [runtime_root, board_name]
-    produces_data: [BOARD_DIR]
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.BOARD_DIR = expects_data.runtime_root & "/" & expects_data.board_name
-        - result = "success"
-    transitions:
-      success: t1_init_board
-      failure: failed_state
-
-  t1_init_board:
-    description: Invoke init-board CLI with BOARD_DIR
-    expects_data: [BOARD_DIR]
-    produces_data: [board_dir, message]
-    handler:
-      type: ref
-      howToRun: local-node
-      whatToRun: {kind: fs-path, value: ./jsonata-init-board-cli.js}
-    transitions:
-      success: t2_map_output
-      failure: failed_state
-
-  t2_map_output:
-    description: Map CLI output to final field names
-    expects_data: [BOARD_DIR, message]
-    produces_data: [board_dir, init_message]
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.board_dir = expects_data.BOARD_DIR
-        - data.init_message = expects_data.message
-        - result = "success"
-    transitions:
-      success: success_state
-      failure: failed_state
-
-terminal_states:
-  success_state:
-    return_intent: success
-    return_artifacts: [board_dir, init_message]
-
-  failed_state:
-    return_intent: failure
-    return_artifacts: [error]

package/examples/cli/step-machine-demo/one-step-cli-only.flow.yaml

@@ -1,21 +0,0 @@
-id: one-step-cli-only
-settings:
-  start_step: run_cli
-steps:
-  run_cli:
-    expects_data: [x]
-    produces_data: [y]
-    handler:
-      type: ref
-      howToRun: local-node
-      whatToRun: {kind: fs-path, value: ./step-cli-echo-y.js}
-    transitions:
-      success: success_state
-      failure: failed_state
-terminal_states:
-  success_state:
-    return_intent: success
-    return_artifacts: [x, y]
-  failed_state:
-    return_intent: failure
-    return_artifacts: [error]

package/examples/cli/step-machine-demo/step-cli-echo-y.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-
-let raw = '';
-process.stdin.setEncoding('utf-8');
-process.stdin.on('data', (chunk) => { raw += chunk; });
-process.stdin.on('end', () => {
-  const input = JSON.parse(raw || '{}');
-  const x = Number(input.x);
-  if (!Number.isFinite(x)) {
-    process.stdout.write(JSON.stringify({ result: 'failure', error: 'x must be numeric' }));
-    return;
-  }
-  process.stdout.write(JSON.stringify({ result: 'success', data: { y: x + 10, z: 999 } }));
-});
-process.stdin.resume();

package/examples/cli/step-machine-demo/step2-double-cli.js

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-
-let raw = '';
-
-process.stdin.setEncoding('utf-8');
-process.stdin.on('data', (chunk) => {
-  raw += chunk;
-});
-
-process.stdin.on('end', () => {
-  try {
-    const input = JSON.parse(raw || '{}');
-    const c = Number(input.c);
-
-    if (!Number.isFinite(c)) {
-      process.stderr.write('step2_double requires numeric c');
-      process.exit(1);
-      return;
-    }
-
-    const d = c * 2;
-    process.stdout.write(JSON.stringify({
-      a: 123,
-      d,
-    }));
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(message);
-    process.exit(1);
-  }
-});
-
-process.stdin.resume();

package/examples/cli/step-machine-demo/two-step-math.flow.yaml

@@ -1,93 +0,0 @@
-id: two-step-math
-settings:
-  start_step: step1_add
-  max_total_steps: 10
-  timeout_ms: 10000
-
-# Demonstrates three compute-jsonata techniques:
-#   1. Basic arithmetic with data.* output and explicit result=
-#   2. Chained ternary with local $var binding ($c :=) — range classification and conditional routing
-#   3. $lookup object-switch — route result directly from a map (see switch test in step-machine-cli.test.ts)
-# NOTE: expr items containing ': ' or '{key: value}' must be single-quoted in YAML.
-
-steps:
-  step1_add:
-    description: Compute c = a + b
-    expects_data: [a, b]
-    produces_data: [c]
-    input_validations:
-      - $type(a) = "number"
-      - $type(b) = "number"
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.c = expects_data.a + expects_data.b
-        - result = "success"
-    transitions:
-      success: step2_classify
-      failure: failed_state
-
-  step2_classify:
-    description: |
-      Classify c using an object-lookup switch.
-      Routes to low_track / mid_track / high_track based on magnitude.
-    expects_data: [c]
-    produces_data: [band]
-    handler:
-      type: compute-jsonata
-      expr:
-        - 'data.band = ($c := expects_data.c; $c < 10 ? "low" : $c < 100 ? "mid" : "high")'
-        - result = data.band
-    transitions:
-      low:  low_track
-      mid:  mid_track
-      high: high_track
-      failure: failed_state
-
-  low_track:
-    description: Small result — multiply by 3
-    expects_data: [c]
-    produces_data: [d]
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.d = expects_data.c * 3
-        - result = "success"
-    transitions:
-      success: success_state
-      failure: failed_state
-
-  mid_track:
-    description: Medium result — multiply by 2
-    expects_data: [c]
-    produces_data: [d]
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.d = expects_data.c * 2
-        - result = "success"
-    transitions:
-      success: success_state
-      failure: failed_state
-
-  high_track:
-    description: Large result — keep as-is (already big enough)
-    expects_data: [c]
-    produces_data: [d]
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.d = expects_data.c
-        - result = "success"
-    transitions:
-      success: success_state
-      failure: failed_state
-
-terminal_states:
-  success_state:
-    return_intent: success
-    return_artifacts: [a, b, c, band, d]
-
-  failed_state:
-    return_intent: failure
-    return_artifacts: [error]

package/examples/cli/step-machine-demo/two-step-mixed.flow.yaml

@@ -1,43 +0,0 @@
-id: two-step-mixed
-settings:
-  start_step: step1_add
-  max_total_steps: 10
-  timeout_ms: 10000
-
-steps:
-  step1_add:
-    description: Compute step computes c = a + b
-    expects_data: [a, b]
-    produces_data: [c]
-    input_validations:
-      - $type(a) = "number"
-      - $type(b) = "number"
-    handler:
-      type: compute-jsonata
-      expr:
-        - data.c = expects_data.a + expects_data.b
-        - result = "success"
-    transitions:
-      success: step2_double
-      failure: failed_state
-
-  step2_double:
-    description: Ref handler computes d = c * 2
-    expects_data: [c]
-    produces_data: [d, e]
-    handler:
-      type: ref
-      howToRun: local-node
-      whatToRun: {kind: fs-path, value: ./step2-double-cli.js}
-    transitions:
-      success: success_state
-      failure: failed_state
-
-terminal_states:
-  success_state:
-    return_intent: success
-    return_artifacts: [a, b, c, d, e, error]
-
-  failed_state:
-    return_intent: failure
-    return_artifacts: [error]