npm - yaml-flow - Versions diffs - 3.1.1 → 4.0.0 - Mend

yaml-flow 3.1.1 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (148) hide show

package/examples/browser/{index.html → step-machine-browser/index.html} RENAMED Viewed

@@ -1,58 +1,58 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>yaml-flow Browser Example</title>
-    <style>
-        * { box-sizing: border-box; }
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-            max-width: 800px;
-            margin: 40px auto;
-            padding: 20px;
-            background: #f5f5f5;
-        }
-        h1 { color: #333; }
-        .card {
-            background: white;
-            border-radius: 8px;
-            padding: 20px;
-            margin: 20px 0;
-            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-        }
-        .step-list {
-            display: flex;
-            gap: 10px;
-            flex-wrap: wrap;
-            margin: 10px 0;
-        }
-        .step {
-            padding: 8px 16px;
-            border-radius: 20px;
-            background: #e0e0e0;
-            font-size: 14px;
-        }
-        .step.active {
-            background: #2196F3;
-            color: white;
-        }
-        .step.completed {
-            background: #4CAF50;
-            color: white;
-        }
-        button {
-            background: #2196F3;
-            color: white;
-            border: none;
-            padding: 12px 24px;
-            border-radius: 6px;
-            cursor: pointer;
-            font-size: 16px;
-            margin: 5px;
-        }
-        button:hover { background: #1976D2; }
-        button:disabled { background: #ccc; cursor: not-allowed; }
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Step Machine Browser Example — yaml-flow</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      max-width: 800px;
+      margin: 40px auto;
+      padding: 20px;
+      background: #f5f5f5;
+    }
+    h1 { color: #333; }
+    .card {
+      background: white;
+      border-radius: 8px;
+      padding: 20px;
+      margin: 20px 0;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+    }
+    .step-list {
+      display: flex;
+      gap: 10px;
+      flex-wrap: wrap;
+      margin: 10px 0;
+    }
+    .step {
+      padding: 8px 16px;
+      border-radius: 20px;
+      background: #e0e0e0;
+      font-size: 14px;
+    }
+    .step.active {
+      background: #2196F3;
+      color: white;
+    }
+    .step.completed {
+      background: #4CAF50;
+      color: white;
+    }
+    button {
+      background: #2196F3;
+      color: white;
+      border: none;
+      padding: 12px 24px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-size: 16px;
+      margin: 5px;
+    }
+    button:hover { background: #1976D2; }
+    button:disabled { background: #ccc; cursor: not-allowed; }
         .log {
             background: #263238;
             color: #aed581;
@@ -83,7 +83,7 @@
     </style>
 </head>
 <body>
-    <h1>🔄 yaml-flow Browser Demo</h1>
+    <h1>yaml-flow Step Machine Browser Example</h1>
     <div class="card">
         <h2>Simple Greeting Flow</h2>

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

@@ -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/cli/step-machine-cli/portfolio-tracker/cards/portfolio-form.json ADDED Viewed

@@ -0,0 +1,43 @@
+{
+  "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"
+          ]
+        }
+      }
+    ]
+  }
+}

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

@@ -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/cli/step-machine-cli/portfolio-tracker/cards/price-fetch.json ADDED Viewed

@@ -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 --tmp-file-name tmp_file1", "bindTo": "prices", "outputFile": "prices.json" }
+  ],
+  "view": {
+    "elements": [
+      { "kind": "table", "label": "Market Prices", "data": { "bind": "sources.prices" } }
+    ]
+  }
+}

package/examples/cli/step-machine-cli/portfolio-tracker/fetch-prices.js ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * 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';
+function getArgValue(flagName) {
+  const idx = process.argv.indexOf(flagName);
+  if (idx < 0) return undefined;
+  return process.argv[idx + 1];
+}
+const envBoardDir = (process.env.BOARD_DIR ?? '').trim();
+const tmpFileName = String(getArgValue('--tmp-file-name') ?? process.env.TMP_FILE_NAME ?? 'tmp_file1').trim();
+const tmpFilePath = envBoardDir ? path.join(envBoardDir, tmpFileName) : '';
+if (!tmpFilePath) {
+  console.error('BOARD_DIR environment variable is required for fetch-prices.js');
+  process.exit(1);
+}
+function getReadableTmpFile() {
+  if (!fs.existsSync(tmpFilePath)) return undefined;
+  const content = fs.readFileSync(tmpFilePath, 'utf-8').trim();
+  if (!content) return undefined;
+  return { tmpFile: tmpFilePath, content };
+}
+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/cli/step-machine-cli/portfolio-tracker/handlers/_board-cli.js ADDED Viewed

@@ -0,0 +1,58 @@
+import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const repoRoot = path.resolve(__dirname, '..', '..', '..', '..', '..');
+const boardCliPath = path.join(repoRoot, 'board-live-cards-cli.js');
+export function runBoardCli(args, options = {}) {
+  const { capture = false, cwd = process.cwd() } = options;
+  const result = spawnSync(process.execPath, [boardCliPath, ...args], {
+    cwd,
+    encoding: 'utf-8',
+    windowsHide: true,
+    stdio: capture ? 'pipe' : 'pipe',
+    env: {
+      ...process.env,
+      BOARD_LIVE_CARDS_NO_SPAWN: process.env.BOARD_LIVE_CARDS_NO_SPAWN ?? '1',
+      BOARD_DIR: process.env.BOARD_DIR ?? '',
+    },
+  });
+  if (result.error) {
+    throw new Error(`Failed to launch board-live-cards-cli: ${result.error.message}`);
+  }
+  if ((result.status ?? 1) !== 0) {
+    const stderr = (result.stderr ?? '').trim();
+    const stdout = (result.stdout ?? '').trim();
+    throw new Error(`board-live-cards-cli failed (${result.status}): ${stderr || stdout || 'no output'}`);
+  }
+  return capture ? (result.stdout ?? '') : '';
+}
+export async function readStdinJson() {
+  let raw = '';
+  process.stdin.setEncoding('utf-8');
+  for await (const chunk of process.stdin) {
+    raw += chunk;
+  }
+  if (!raw.trim()) {
+    return {};
+  }
+  return JSON.parse(raw);
+}
+export function writeResult(payload) {
+  process.stdout.write(JSON.stringify(payload));
+}
+export function writeFailure(message) {
+  writeResult({ result: 'failure', error: message });
+}

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

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+try {
+  const input = await readStdinJson();
+  const boardDir = String(input.BOARD_DIR ?? '').trim();
+  const cardsGlob = String(input.CARDS_GLOB ?? '').trim();
+  if (!boardDir || !cardsGlob) {
+    writeFailure('BOARD_DIR and CARDS_GLOB are required');
+    process.exit(0);
+  }
+  runBoardCli(['add-cards', '--rg', boardDir, '--card-glob', cardsGlob]);
+  writeResult({
+    result: 'success',
+    data: {
+      board_dir: boardDir,
+      cards_glob: cardsGlob,
+    },
+  });
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  writeFailure(message);
+}

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

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+try {
+  const input = await readStdinJson();
+  const boardDir = String(input.BOARD_DIR ?? '').trim();
+  if (!boardDir) {
+    writeFailure('BOARD_DIR is required');
+    process.exit(0);
+  }
+  runBoardCli(['init', boardDir]);
+  writeResult({
+    result: 'success',
+    data: {
+      board_dir: boardDir,
+      message: `initialized ${boardDir}`,
+    },
+  });
+} 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 ADDED Viewed

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readStdinJson, writeFailure, writeResult } from './_board-cli.js';
+try {
+  const input = await readStdinJson();
+  const boardDirInput = String(input.BOARD_DIR ?? '').trim();
+  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,
+    },
+  });
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  writeFailure(message);
+}

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

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

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

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

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

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+try {
+  const input = await readStdinJson();
+  const boardDir = String(input.BOARD_DIR ?? '').trim();
+  const cardsDir = String(input.CARDS_DIR ?? '').trim();
+  const holdings = input.HOLDINGS;
+  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');
+  const raw = fs.readFileSync(cardPath, 'utf-8');
+  const card = JSON.parse(raw);
+  card.state = card.state ?? {};
+  card.state.holdings = holdings;
+  fs.writeFileSync(cardPath, `${JSON.stringify(card, null, 2)}\n`, 'utf-8');
+  runBoardCli(['update-card', '--rg', boardDir, '--card-id', 'portfolio-form', '--restart']);
+  writeResult({
+    result: 'success',
+    data: {
+      saved: true,
+      holdings_count: holdings.length,
+    },
+  });
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  writeFailure(message);
+}

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

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { readStdinJson, runBoardCli, writeFailure, writeResult } from './_board-cli.js';
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+try {
+  const input = await readStdinJson();
+  const boardDir = String(input.BOARD_DIR ?? '').trim();
+  const tasks = Array.isArray(input.COMPLETION_TASKS) ? input.COMPLETION_TASKS : [];
+  const label = String(input.LABEL ?? 'WAIT');
+  const timeoutMs = Number(input.TIMEOUT_MS ?? 30000);
+  const pollMs = Number(input.POLL_MS ?? 500);
+  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 status = runBoardCli(['status', '--rg', boardDir], { capture: true });
+    const complete = tasks.every((task) => new RegExp(`\\bcompleted\\s+${task}\\b`).test(status));
+    if (complete) {
+      writeResult({
+        result: 'success',
+        data: {
+          label,
+          completed: true,
+        },
+      });
+      process.exit(0);
+    }
+    await sleep(pollMs);
+  }
+  writeResult({
+    result: 'timeout',
+    data: {
+      label,
+      completed: false,
+      error: `${label}: timed out waiting for completion`,
+    },
+  });
+} 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 ADDED Viewed

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readStdinJson, writeFailure, writeResult } from './_board-cli.js';
+try {
+  const input = await readStdinJson();
+  const boardDirInput = String(input.BOARD_DIR ?? '').trim();
+  const tmpFileName = String(input.TMP_FILE_NAME ?? '').trim() || 'tmp_file1';
+  const prices = input.PRICES;
+  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);
+  const payload = JSON.stringify(prices);
+  const tmpFile = path.join(boardDir, tmpFileName);
+  fs.mkdirSync(path.dirname(tmpFile), { recursive: true });
+  fs.writeFileSync(tmpFile, payload, 'utf-8');
+  writeResult({
+    result: 'success',
+    data: {
+      wrote: true,
+      tmp_file: tmpFile,
+    },
+  });
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  writeFailure(message);
+}