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

yaml-flow 4.0.0 → 5.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 (95) hide show

package/browser/board-livegraph-runtime.js +1453 -0
package/browser/board-livegraph-runtime.js.map +1 -0
package/browser/card-compute.js +36 -17
package/browser/live-cards.js +848 -109
package/browser/live-cards.schema.json +46 -21
package/dist/board-livegraph-runtime/index.cjs +1448 -0
package/dist/board-livegraph-runtime/index.cjs.map +1 -0
package/dist/board-livegraph-runtime/index.d.cts +101 -0
package/dist/board-livegraph-runtime/index.d.ts +101 -0
package/dist/board-livegraph-runtime/index.js +1441 -0
package/dist/board-livegraph-runtime/index.js.map +1 -0
package/dist/card-compute/index.cjs +159 -44
package/dist/card-compute/index.cjs.map +1 -1
package/dist/card-compute/index.d.cts +36 -11
package/dist/card-compute/index.d.ts +36 -11
package/dist/card-compute/index.js +156 -44
package/dist/card-compute/index.js.map +1 -1
package/dist/cli/board-live-cards-cli.cjs +476 -105
package/dist/cli/board-live-cards-cli.cjs.map +1 -1
package/dist/cli/board-live-cards-cli.d.cts +8 -16
package/dist/cli/board-live-cards-cli.d.ts +8 -16
package/dist/cli/board-live-cards-cli.js +476 -106
package/dist/cli/board-live-cards-cli.js.map +1 -1
package/dist/continuous-event-graph/index.cjs +74 -33
package/dist/continuous-event-graph/index.cjs.map +1 -1
package/dist/continuous-event-graph/index.d.cts +7 -23
package/dist/continuous-event-graph/index.d.ts +7 -23
package/dist/continuous-event-graph/index.js +73 -32
package/dist/continuous-event-graph/index.js.map +1 -1
package/dist/index.cjs +1440 -56
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +21 -3
package/dist/index.d.ts +21 -3
package/dist/index.js +1434 -56
package/dist/index.js.map +1 -1
package/dist/journal-DRfJiheM.d.cts +28 -0
package/dist/journal-NLYuqege.d.ts +28 -0
package/dist/{journal-B_2JnBMF.d.ts → live-cards-bridge-Or7fdEJV.d.ts} +5 -32
package/dist/{journal-BJDjWb5Q.d.cts → live-cards-bridge-vGJ6tMzN.d.cts} +5 -32
package/dist/schedule-CMcZe5Ny.d.ts +21 -0
package/dist/schedule-CiucyCan.d.cts +21 -0
package/examples/browser/boards/portfolio-tracker/cards/holdings-table.json +1 -1
package/examples/browser/boards/portfolio-tracker/cards/portfolio-form.json +3 -3
package/examples/browser/boards/portfolio-tracker/cards/portfolio-value.json +1 -1
package/examples/browser/boards/portfolio-tracker/cards/price-fetch.json +3 -3
package/examples/browser/boards/portfolio-tracker/portfolio-tracker-task-executor.cjs +96 -0
package/examples/browser/boards/portfolio-tracker/portfolio-tracker.js +33 -5
package/examples/browser/livecards-browser/index.html +37 -684
package/examples/cli/step-machine-cli/portfolio-tracker/cards/holdings-table.json +1 -1
package/examples/cli/step-machine-cli/portfolio-tracker/cards/portfolio-form.json +3 -3
package/examples/cli/step-machine-cli/portfolio-tracker/cards/portfolio-value.json +1 -1
package/examples/cli/step-machine-cli/portfolio-tracker/cards/price-fetch.json +3 -3
package/examples/cli/step-machine-cli/portfolio-tracker/handlers/update-holdings-cli.js +2 -2
package/examples/example-board/board.yaml +23 -0
package/examples/example-board/bootstrap_payload.json +1 -0
package/examples/example-board/cards/card-chain-region-alert.json +39 -0
package/examples/example-board/cards/card-chain-region-totals.json +26 -0
package/examples/example-board/cards/card-chain-top-region.json +24 -0
package/examples/example-board/cards/card-ex-actions.json +32 -0
package/examples/example-board/cards/card-ex-chart.json +30 -0
package/examples/example-board/cards/card-ex-filter.json +36 -0
package/examples/example-board/cards/card-ex-filtered-by-preference.json +59 -0
package/examples/example-board/cards/card-ex-form.json +91 -0
package/examples/example-board/cards/card-ex-list.json +22 -0
package/examples/example-board/cards/card-ex-markdown.json +17 -0
package/examples/example-board/cards/card-ex-metric.json +19 -0
package/examples/example-board/cards/card-ex-narrative.json +36 -0
package/examples/example-board/cards/card-ex-source-http.json +28 -0
package/examples/example-board/cards/card-ex-source.json +21 -0
package/examples/example-board/cards/card-ex-status.json +35 -0
package/examples/example-board/cards/card-ex-table.json +30 -0
package/examples/example-board/cards/card-ex-todo.json +29 -0
package/examples/example-board/demo-chat-handler.js +69 -0
package/examples/example-board/demo-server.js +87 -0
package/examples/example-board/demo-shell-browser.html +806 -0
package/examples/example-board/demo-shell-with-server.html +280 -0
package/examples/example-board/demo-shell.html +62 -0
package/examples/example-board/demo-task-executor.js +255 -0
package/examples/example-board/mock.db +15 -0
package/examples/example-board/reusable-board-runtime-client.js +265 -0
package/examples/example-board/reusable-runtime-artifacts-adapter.js +233 -0
package/examples/example-board/reusable-server-runtime.js +1284 -0
package/examples/index.html +16 -9
package/examples/npm-libs/continuous-event-graph/live-cards-board.ts +17 -17
package/examples/npm-libs/continuous-event-graph/live-portfolio-dashboard.ts +23 -23
package/examples/step-machine-cli/portfolio-tracker/cards/holdings-table.json +1 -1
package/examples/step-machine-cli/portfolio-tracker/cards/portfolio-form.json +3 -3
package/examples/step-machine-cli/portfolio-tracker/cards/portfolio-value.json +1 -1
package/examples/step-machine-cli/portfolio-tracker/cards/price-fetch.json +1 -1
package/examples/step-machine-cli/portfolio-tracker/portfolio-tracker-task-executor.cjs +96 -0
package/package.json +16 -2
package/schema/card-runtime.schema.json +25 -0
package/schema/live-cards.schema.json +46 -21
package/browser/ingest-board.js +0 -296
package/examples/ingest.js +0 -733

package/examples/example-board/demo-shell-with-server.html ADDED Viewed

@@ -0,0 +1,280 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Example Board Demo (Server Runtime)</title>
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
+  <script src="https://cdn.jsdelivr.net/npm/jsonata/jsonata.min.js"></script>
+  <script src="../../browser/card-compute.js" onerror="this.onerror=null;this.src='https://cdn.jsdelivr.net/npm/yaml-flow@latest/browser/card-compute.js';"></script>
+  <script src="../../browser/live-cards.js" onerror="this.onerror=null;this.src='https://cdn.jsdelivr.net/npm/yaml-flow@latest/browser/live-cards.js';"></script>
+  <script src="./reusable-runtime-artifacts-adapter.js"></script>
+  <script src="./reusable-board-runtime-client.js"></script>
+</head>
+<body class="bg-light">
+  <div class="container-fluid py-3">
+    <div class="d-flex flex-wrap align-items-center justify-content-between gap-2 mb-3">
+      <div>
+        <h1 class="h4 mb-0" id="boardTitle">Example Board (Server Runtime)</h1>
+        <div class="small text-muted" id="boardDesc"></div>
+      </div>
+      <div class="d-flex align-items-center gap-2">
+        <a class="btn btn-sm btn-outline-secondary" href="demo-shell-browser.html">Open Browser Runtime Shell</a>
+        <select class="form-select form-select-sm" id="boardSelector" style="max-width:180px" title="Active board"></select>
+        <button class="btn btn-sm btn-outline-success" id="addBoardBtn">+ Board</button>
+        <div id="addBoardForm" class="d-flex align-items-center gap-1" style="display:none!important">
+          <input class="form-control form-control-sm" id="newBoardId" placeholder="board-id" style="max-width:110px" />
+          <input class="form-control form-control-sm" id="newBoardLabel" placeholder="Label (optional)" style="max-width:150px" />
+          <button class="btn btn-sm btn-success" id="addBoardSubmit">Add</button>
+          <button class="btn btn-sm btn-secondary" id="addBoardCancel">Cancel</button>
+        </div>
+        <button class="btn btn-sm btn-outline-primary" id="modeBoard">Board</button>
+        <button class="btn btn-sm btn-outline-primary" id="modeCanvas">Canvas</button>
+        <button class="btn btn-sm btn-outline-secondary" id="autoLayout">Auto Layout</button>
+        <button class="btn btn-sm btn-outline-dark" id="refreshAll" style="display:none">Refresh All</button>
+        <div class="form-check ms-2">
+          <input class="form-check-input" type="checkbox" id="devModeToggle" />
+          <label class="form-check-label" for="devModeToggle">Dev Mode</label>
+        </div>
+      </div>
+    </div>
+    <div class="alert alert-info small py-2 mb-3">
+      Server runtime mode: updates stream in via SSE from the thin demo-server bridge to board-live-cards-cli.
+      Source execution and event processing happen on the server side.
+    </div>
+    <div class="alert alert-secondary small py-2 mb-3">
+      Contract and decision notes live in <a href="./demo-shell.html#assumptions-and-tradeoffs">Assumptions and Tradeoffs</a>.
+    </div>
+    <div id="boardRoot">
+      <div class="d-flex align-items-center justify-content-center" style="height: 72vh;">
+        <div class="text-center">
+          <div class="spinner-border mb-3" role="status">
+            <span class="visually-hidden">Loading...</span>
+          </div>
+          <p class="text-muted">Initializing board...</p>
+        </div>
+      </div>
+    </div>
+  </div>
+  <script>
+    (function () {
+      let currentMode = 'board';
+      let bootstrapCompleted = false;
+      let activeBoardId = 'default';
+      let runtimeClient = null;
+      function boardPaths(boardId) {
+        const b = encodeURIComponent(boardId || activeBoardId || 'default');
+        const base = `/api/boards/${b}`;
+        return {
+          demoSetup: `${base}/demo-setup`,
+          initBoard: `${base}/init-board`,
+          bootstrapCards: `${base}/bootstrap-cards`,
+          bootstrap: `${base}/bootstrap`,
+          stream: `${base}/sse`,
+          patchCard: function (id) { return `${base}/cards/${encodeURIComponent(id)}`; },
+          cardAction: function (id) { return `${base}/cards/${encodeURIComponent(id)}/actions`; },
+          cardFile: function (id) { return `${base}/cards/${encodeURIComponent(id)}/files`; },
+          cardChats: function (id) { return `${base}/cards/${encodeURIComponent(id)}/chats`; },
+        };
+      }
+      function localServerOrigins() {
+        const params = new URLSearchParams(window.location.search || '');
+        const fromQuery = params.get('demoServerOrigin');
+        const fromWindow = window.DEMO_SERVER_ORIGIN;
+        const hostPref = window.location.hostname === 'localhost' ? 'localhost' : '127.0.0.1';
+        const hostAlt = hostPref === 'localhost' ? '127.0.0.1' : 'localhost';
+        const defaults = [
+          `http://${hostPref}:7799`,
+          `http://${hostAlt}:7799`,
+        ];
+        const unique = [];
+        const push = (v) => {
+          if (!v || typeof v !== 'string') return;
+          if (unique.includes(v)) return;
+          unique.push(v);
+        };
+        push(fromWindow);
+        push(fromQuery);
+        defaults.forEach(push);
+        return unique;
+      }
+      let activeServerOrigin = null;
+      async function fetchServer(path, init) {
+        const origins = activeServerOrigin ? [activeServerOrigin] : localServerOrigins();
+        const failures = [];
+        for (const origin of origins) {
+          const url = `${origin}${path}`;
+          try {
+            const res = await fetch(url, init);
+            activeServerOrigin = origin;
+            return res;
+          } catch (err) {
+            failures.push(`${url} -> ${String(err && err.message || err)}`);
+          }
+        }
+        const tip = 'Start the API bridge from the yaml-flow folder: node examples/example-board/demo-server.js';
+        throw new Error(`Unable to reach example-board demo server. Tried: ${failures.join(' | ')}. ${tip}`);
+      }
+      runtimeClient = window.ReusableBoardRuntimeClient.createBoardRuntimeClient({
+        fetchServer,
+        boardPaths,
+        buildLiveCardModelsFromArtifacts,
+        getServerOrigin: function () { return activeServerOrigin; },
+        initialMode: currentMode,
+        canvas: { height: '72vh', overflow: 'auto' },
+      });
+      function resolveTaskExecutorPathParam() {
+        const params = new URLSearchParams(window.location.search || '');
+        const fromQuery = params.get('taskExecutorPath');
+        const fromWindow = window.DEMO_TASK_EXECUTOR_PATH;
+        if (typeof fromQuery === 'string' && fromQuery.trim()) return fromQuery.trim();
+        if (typeof fromWindow === 'string' && fromWindow.trim()) return fromWindow.trim();
+        return '';
+      }
+      async function loadBoardList() {
+        try {
+          const res = await fetchServer('/api/boards');
+          if (!res.ok) return;
+          const data = await res.json();
+          const boards = Array.isArray(data && data.boards) ? data.boards : [];
+          const sel = document.getElementById('boardSelector');
+          const prev = sel.value;
+          sel.innerHTML = boards.map((b) =>
+            `<option value="${b.id}"${b.id === (prev || activeBoardId) ? ' selected' : ''}>${b.label || b.id}</option>`
+          ).join('');
+          if (boards.length && !boards.some((b) => b.id === activeBoardId)) {
+            activeBoardId = boards[0].id;
+            sel.value = activeBoardId;
+          }
+        } catch (err) {
+          console.warn('Could not load board list', err);
+        }
+      }
+      async function switchBoard(boardId) {
+        if (boardId === activeBoardId && bootstrapCompleted) return;
+        runtimeClient.dispose();
+        bootstrapCompleted = false;
+        activeBoardId = boardId;
+        document.getElementById('boardRoot').innerHTML =
+          '<div class="d-flex align-items-center justify-content-center" style="height:72vh">'
+          + '<div class="text-center"><div class="spinner-border mb-3" role="status">'
+          + '<span class="visually-hidden">Loading...</span></div>'
+          + '<p class="text-muted">Loading board...</p></div></div>';
+        await bootstrap(boardId);
+      }
+      async function bootstrap(boardId) {
+        const bid = boardId || activeBoardId || 'default';
+        // Board title from registry label or fallback
+        document.getElementById('boardTitle').textContent = bid + ' (Server Runtime)';
+        document.getElementById('boardDesc').textContent = '';
+        await runtimeClient.bootstrapBoard({
+          boardId: bid,
+          taskExecutorPath: resolveTaskExecutorPathParam(),
+          rootElement: document.getElementById('boardRoot'),
+          runDemoSetup: true,
+          mode: currentMode,
+        });
+        bootstrapCompleted = true;
+      }
+      document.getElementById('modeBoard').addEventListener('click', function () {
+        currentMode = 'board';
+        runtimeClient.setMode('board');
+      });
+      document.getElementById('modeCanvas').addEventListener('click', function () {
+        currentMode = 'canvas';
+        runtimeClient.setMode('canvas');
+      });
+      document.getElementById('autoLayout').addEventListener('click', function () {
+        currentMode = 'canvas';
+        runtimeClient.autoLayout();
+      });
+      document.getElementById('devModeToggle').addEventListener('change', function () {
+        runtimeClient.setDevMode(this.checked);
+      });
+      document.getElementById('boardSelector').addEventListener('change', function () {
+        switchBoard(this.value).catch(function (err) {
+          console.error(err);
+          document.getElementById('boardRoot').innerHTML =
+            `<div class="alert alert-danger">Failed to switch board: ${String(err && err.message || err)}</div>`;
+        });
+      });
+      document.getElementById('addBoardBtn').addEventListener('click', function () {
+        document.getElementById('addBoardForm').style.removeProperty('display');
+        document.getElementById('newBoardId').focus();
+      });
+      document.getElementById('addBoardCancel').addEventListener('click', function () {
+        document.getElementById('addBoardForm').style.display = 'none';
+        document.getElementById('newBoardId').value = '';
+        document.getElementById('newBoardLabel').value = '';
+      });
+      document.getElementById('addBoardSubmit').addEventListener('click', async function () {
+        const id = document.getElementById('newBoardId').value.trim();
+        const label = document.getElementById('newBoardLabel').value.trim();
+        if (!id) {
+          alert('Board id is required');
+          return;
+        }
+        try {
+          const res = await fetchServer('/api/boards', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ id, label: label || id }),
+          });
+          const data = await res.json();
+          if (!res.ok) {
+            alert(data.error || 'Failed to add board');
+            return;
+          }
+          document.getElementById('addBoardForm').style.display = 'none';
+          document.getElementById('newBoardId').value = '';
+          document.getElementById('newBoardLabel').value = '';
+          await loadBoardList();
+          await switchBoard(id);
+        } catch (err) {
+          alert('Error adding board: ' + String((err && err.message) || err));
+        }
+      });
+      loadBoardList().then(function () {
+        return bootstrap(activeBoardId);
+      }).catch(function (err) {
+        console.error(err);
+        document.getElementById('boardRoot').innerHTML =
+          `<div class="alert alert-danger">Failed to start server runtime demo: ${String(err && err.message || err)}</div>`;
+      });
+      window.addEventListener('beforeunload', function () {
+        runtimeClient.dispose();
+      });
+    })();
+  </script>
+</body>
+</html>

package/examples/example-board/demo-shell.html ADDED Viewed

@@ -0,0 +1,62 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Example Board Demo Shell</title>
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
+</head>
+<body class="bg-light">
+  <div class="container py-4">
+    <h1 class="h3 mb-2">Example Board Demo Shell</h1>
+    <p class="text-muted mb-4">Choose which runtime architecture you want to exercise.</p>
+    <div class="row g-3">
+      <div class="col-md-6">
+        <div class="card h-100 shadow-sm">
+          <div class="card-body">
+            <h2 class="h5">Browser Runtime</h2>
+            <p class="small text-muted mb-3">
+              Uses <code>board-livegraph-runtime.js</code> directly in-browser.
+              Source definitions remain opaque and are executed by an in-page task executor shim.
+            </p>
+            <a class="btn btn-primary" href="./demo-shell-browser.html">Open Browser Runtime Shell</a>
+          </div>
+        </div>
+      </div>
+      <div class="col-md-6">
+        <div class="card h-100 shadow-sm">
+          <div class="card-body">
+            <h2 class="h5">Server Runtime</h2>
+            <p class="small text-muted mb-3">
+              Uses a thin API/SSE bridge over <code>board-live-cards-cli</code>.
+              All source execution and event processing happens server-side.
+            </p>
+            <a class="btn btn-outline-primary" href="./demo-shell-with-server.html">Open Server Runtime Shell</a>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="alert alert-secondary small mt-4 mb-0">
+      For server mode, run <code>node examples/example-board/demo-server.js</code> from the <code>yaml-flow</code> folder.
+    </div>
+    <div id="assumptions-and-tradeoffs" class="card mt-3 border-0 shadow-sm">
+      <div class="card-body">
+        <h2 class="h6 mb-2">Assumptions and Tradeoffs (Authoritative Notes)</h2>
+        <ul class="small text-muted mb-0">
+          <li>Runtime artifact contract is intentionally minimal: <code>schema_version</code>, <code>card_id</code>, and <code>computed_values</code>. Rich context like <code>fetched_sources</code> is transport/runtime detail, not persistence contract.</li>
+          <li>Card definitions are treated as source-of-truth for authored state (<code>card_data</code>). Runtime artifacts capture evaluated outputs, not authored configuration.</li>
+          <li>Source definitions are intentionally opaque to the framework. Executor-specific fields are owned by domain teams and passed through without interpretation.</li>
+          <li>Token-level interoperability is the stable boundary: producers emit via <code>provides.bindTo</code>, consumers depend via <code>requires</code>. Domain logic should evolve behind this boundary.</li>
+          <li>Server and browser shells are equivalent by intent, not byte-identical implementations. Browser mode prioritizes local iteration; server mode prioritizes process boundaries and operational realism.</li>
+          <li>Patch and restart behavior is explicit: UI state updates are persisted through card patching, and recomputation/retrigger is a deliberate step, not an implicit side effect.</li>
+          <li>This example is a reference surface for decisions and contracts, not a canonical list of all features. Agents should infer implementation details directly from files in this folder.</li>
+        </ul>
+      </div>
+    </div>
+  </div>
+</body>
+</html>

package/examples/example-board/demo-task-executor.js ADDED Viewed

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+/**
+ * demo-task-executor.js — Simple mock source executor for example-board.
+ *
+ * Protocol (invoked by board-live-cards-cli):
+ *   node demo-task-executor.js run-source-fetch --in <source.json> --out <result.json> [--err <error.txt>]
+ *
+ * Expected source definition:
+ *   { "bindTo": "...", "outputFile": "...", "mock": "keyName" }
+ *
+ * Behavior:
+ *   1. Read mock.db (JSON file next to this script)
+ *   2. Look up source.mock value as a key in mock.db
+ *   3. Write corresponding value to --out file (as JSON)
+ *   4. Exit 0 on success, exit 1 on error
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const MOCK_DB_PATH = path.join(__dirname, 'mock.db');
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+}
+function interpolatePrompt(template, args) {
+  return String(template).replace(/\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g, (_, key) => {
+    const v = args?.[key];
+    if (v === undefined) return '';
+    if (typeof v === 'string') return v;
+    return JSON.stringify(v);
+  });
+}
+function stripCopilotFooter(rawText) {
+  const lines = String(rawText ?? '').split(/\r?\n/);
+  // Remove trailing blank lines first.
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
+  // Remove the standard trailing Copilot metadata footer, if present.
+  if (
+    lines.length >= 3 &&
+    /^Changes\b/i.test(lines[lines.length - 3]) &&
+    /^Requests\b/i.test(lines[lines.length - 2]) &&
+    /^Tokens\b/i.test(lines[lines.length - 1])
+  ) {
+    lines.splice(lines.length - 3, 3);
+  }
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
+  return lines.join('\n');
+}
+function resolveCopilotPrompt(sourceDef) {
+  const cfg = sourceDef?.copilot && typeof sourceDef.copilot === 'object' ? sourceDef.copilot : {};
+  const template = cfg.prompt_template ?? sourceDef.prompt_template;
+  const args = cfg.args ?? cfg.prompt_args ?? sourceDef.prompt_args ?? sourceDef.args ?? {};
+  // Merge explicit args with context from card-handler (_requires includes card-level computed values)
+  const interpolationContext = { ...sourceDef._requires, ...args };
+  if (!template || typeof template !== 'string') return null;
+  return interpolatePrompt(template, interpolationContext);
+}
+function resolveCopilotExecutable() {
+  const envBin = process.env.COPILOT_BIN;
+  if (envBin && fs.existsSync(envBin)) {
+    return envBin;
+  }
+  if (process.platform === 'win32') {
+    try {
+      const out = execFileSync('where.exe', ['copilot'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const candidates = out
+        .split(/\r?\n/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+      const preferred = candidates.find((p) => /\.(cmd|exe|bat)$/i.test(p));
+      if (preferred) return preferred;
+      if (candidates[0]) return candidates[0];
+    } catch {}
+  } else {
+    try {
+      const out = execFileSync('which', ['copilot'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const first = out.split(/\r?\n/).map((s) => s.trim()).find(Boolean);
+      if (first) return first;
+    } catch {}
+  }
+  return 'copilot';
+}
+function runCopilotPrompt(prompt) {
+  const copilotBin = resolveCopilotExecutable();
+  const copilotArgs = ['--allow-all'];
+  try {
+    // Prefer stdin prompt delivery to avoid shell/path quoting issues.
+    return execFileSync(copilotBin, copilotArgs, {
+      input: String(prompt),
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      maxBuffer: 10 * 1024 * 1024,
+    });
+  } catch (directErr) {
+    // Fallback for Git Bash / Windows wrapper path quoting issues.
+    if (process.platform === 'win32') {
+      const isCmdShim = /\.(bat|cmd)$/i.test(copilotBin);
+      if (isCmdShim) {
+        try {
+          return execFileSync(copilotBin, copilotArgs, {
+            input: String(prompt),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            maxBuffer: 10 * 1024 * 1024,
+            shell: true,
+          });
+        } catch {}
+      }
+      try {
+        // Final fallback: resolve through cmd PATH lookup, still piping prompt on stdin.
+        return execFileSync('cmd.exe', ['/d', '/c', 'copilot --allow-all'], {
+          input: String(prompt),
+          encoding: 'utf-8',
+          stdio: ['pipe', 'pipe', 'pipe'],
+          maxBuffer: 10 * 1024 * 1024,
+        });
+      } catch (cmdErr) {
+        const stderrDirect = directErr && typeof directErr === 'object' && 'stderr' in directErr
+          ? String(directErr.stderr || '')
+          : '';
+        const stderrCmd = cmdErr && typeof cmdErr === 'object' && 'stderr' in cmdErr
+          ? String(cmdErr.stderr || '')
+          : '';
+        const msg = [stderrDirect.trim(), stderrCmd.trim(), String(cmdErr && cmdErr.message || cmdErr)]
+          .filter(Boolean)
+          .join(' | ');
+        throw new Error(msg || 'copilot invocation failed');
+      }
+    }
+    const stderrDirect = directErr && typeof directErr === 'object' && 'stderr' in directErr
+      ? String(directErr.stderr || '')
+      : '';
+    const msg = [stderrDirect.trim(), String(directErr && directErr.message || directErr)]
+      .filter(Boolean)
+      .join(' | ');
+    throw new Error(msg || 'copilot invocation failed');
+  }
+}
+function fail(msg, errFile) {
+  if (errFile) {
+    try {
+      fs.writeFileSync(errFile, msg);
+    } catch {}
+  }
+  console.error(`[demo-task-executor] ${msg}`);
+  process.exit(1);
+}
+function runSourceFetchSubcommand(argv) {
+  const inIdx = argv.indexOf('--in');
+  const outIdx = argv.indexOf('--out');
+  const errIdx = argv.indexOf('--err');
+  const inFile = inIdx !== -1 ? argv[inIdx + 1] : undefined;
+  const outFile = outIdx !== -1 ? argv[outIdx + 1] : undefined;
+  const errFile = errIdx !== -1 ? argv[errIdx + 1] : undefined;
+  if (!inFile || !outFile) {
+    fail('Usage: run-source-fetch --in <source.json> --out <result.json> [--err <error.txt>]', errFile);
+  }
+  if (!fs.existsSync(inFile)) {
+    fail(`Input file not found: ${inFile}`, errFile);
+  }
+  let sourceDef;
+  try {
+    sourceDef = readJson(inFile);
+  } catch (err) {
+    fail(`Cannot parse source file: ${String(err && err.message || err)}`, errFile);
+  }
+  let resultValue;
+  if (sourceDef.copilot || sourceDef.prompt_template) {
+    const prompt = resolveCopilotPrompt(sourceDef);
+    if (!prompt) {
+      fail('Source definition missing copilot.prompt_template (or prompt_template)', errFile);
+    }
+    let rawOutput = '';
+    try {
+      rawOutput = runCopilotPrompt(prompt);
+    } catch (err) {
+      const msg = String(err && err.message || err);
+      fail(`copilot invocation failed: ${msg}`, errFile);
+    }
+    resultValue = stripCopilotFooter(rawOutput);
+  } else {
+    // Default mode: mockdb lookup
+    let mockDb;
+    try {
+      if (!fs.existsSync(MOCK_DB_PATH)) {
+        fail(`mock.db not found at ${MOCK_DB_PATH}`, errFile);
+      }
+      mockDb = readJson(MOCK_DB_PATH);
+    } catch (err) {
+      fail(`Cannot parse mock.db: ${String(err && err.message || err)}`, errFile);
+    }
+    const mockKey = sourceDef.mock;
+    if (!mockKey) {
+      fail('Source definition missing "mock" field (key to lookup)', errFile);
+    }
+    resultValue = mockDb[mockKey];
+    if (resultValue === undefined) {
+      fail(`Key "${mockKey}" not found in mock.db`, errFile);
+    }
+  }
+  // Write result to --out as JSON payload, same contract as current mock mode.
+  try {
+    fs.writeFileSync(outFile, JSON.stringify(resultValue, null, 2));
+  } catch (err) {
+    fail(`Cannot write output file: ${String(err && err.message || err)}`, errFile);
+  }
+  process.exit(0);
+}
+function main() {
+  const sub = process.argv[2];
+  if (sub === 'run-source-fetch') {
+    runSourceFetchSubcommand(process.argv.slice(3));
+    return;
+  }
+  console.warn(`[demo-task-executor] Unknown subcommand: ${sub}`);
+  process.exit(0);
+}
+main();

package/examples/example-board/mock.db ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "orders": [
+    { "id": "ORD-1001", "product": "Widget A", "quantity": 3, "amount": 12400, "region": "North" },
+    { "id": "ORD-1002", "product": "Widget B", "quantity": 2, "amount": 8700, "region": "South" },
+    { "id": "ORD-1003", "product": "Widget A", "quantity": 4, "amount": 15200, "region": "East" },
+    { "id": "ORD-1004", "product": "Widget C", "quantity": 1, "amount": 6300, "region": "West" },
+    { "id": "ORD-1005", "product": "Widget B", "quantity": 2, "amount": 9100, "region": "North" },
+    { "id": "ORD-1006", "product": "Widget C", "quantity": 3, "amount": 9800, "region": "South" }
+  ],
+  "prices": [
+    { "product": "Widget A", "price": 4133.33, "currency": "USD" },
+    { "product": "Widget B", "price": 4450.0, "currency": "USD" },
+    { "product": "Widget C", "price": 3266.67, "currency": "USD" }
+  ]
+}