yaml-flow 5.3.0 → 5.4.2

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

@@ -79,14 +79,14 @@ function cliCommand() {
 
 function runCli(args, capture = false) {
   const { cmd, prefixArgs } = cliCommand();
+  const env = { ...process.env };
+  // This demo needs real worker dispatch; suppressing spawn keeps source/inference tasks in running state.
+  delete env.BOARD_LIVE_CARDS_NO_SPAWN;
   const result = spawnSync(cmd, [...prefixArgs, ...args], {
     stdio: capture ? 'pipe' : 'inherit',
     shell: false,
     windowsHide: true,
-    env: {
-      ...process.env,
-      BOARD_LIVE_CARDS_NO_SPAWN: '1',
-    },
+    env,
     encoding: capture ? 'utf-8' : undefined,
   });
 
@@ -113,7 +113,7 @@ function statusText() {
   return runCli(['status', '--rg', BOARD], true) ?? '';
 }
 
-async function waitForAllCompleted(label, timeoutMs = 30000, pollMs = 500) {
+async function waitForAllCompleted(label, timeoutMs = 90000, pollMs = 500) {
   const start = Date.now();
   const includeInferenceCards = fs.existsSync(path.join(CARDS, 'portfolio-risk-assessment.json'))
     && fs.existsSync(path.join(CARDS, 'rebalancing-strategy.json'));

package/examples/example-board/agent-instructions.md

@@ -509,11 +509,10 @@ The optional `projections` map lets a source definition declare which upstream d
     "outputFile": "quotes.json",
     "projections": {
       "holdings": "requires.holdings",
-      "topHoldings": "requires.holdings[weight > 0.05]",
-      "threshold": "card_data.threshold"
+      "url_list": "requires.holdings.ticker.('https://query1.finance.yahoo.com/v8/finance/chart/' & $ & '?interval=1d&range=1d')"
     },
-    "chartApi": {
-      "tickersFrom": "holdings.ticker"
+    "url-list": {
+      "cacheTimeout": 3600
     }
   }
 ]
@@ -538,7 +537,7 @@ node board-live-cards-cli.js describe-task-executor-capabilities --rg <boardDir>
 ```
 
 This invokes the executor's `describe-capabilities` subcommand and prints its capabilities JSON to stdout. The output includes:
-- **`sourceKinds`** — every source kind the executor handles (e.g. `mock`, `copilot`, `http`, `chartApi`), each with:
+- **`sourceKinds`** — every source kind the executor handles (e.g. `mock`, `copilot`, `workiq`, `url`, `url-list`), each with:
   - `description` — what the kind does
   - `inputSchema` — the exact `customFields` the executor expects on the source entry
   - `outputShape` — the shape of the JSON written to `--out`

package/examples/example-board/demo-server.js

@@ -126,13 +126,45 @@ function jsonReply(res, status, payload) {
   res.end(body);
 }
 
+// ---------------------------------------------------------------------------
+// Card preparation — host-level concern, not a reusable runtime concern.
+// Writes the concatenated copilot-instructions.md at the board setup root.
+// Cards are served directly from cardsDir (no tmp copy needed).
+// ---------------------------------------------------------------------------
+
+const _demoPrepSetupDone = new Map(); // boardId → true
+
+function isDemoSetupDone(boardId, service) {
+  return _demoPrepSetupDone.get(boardId) === true && fs.existsSync(service.cardsDir);
+}
+
+function demoPrepSetup(boardId, service) {
+  const { cardsDir, gandalfCardsDir, boardDir } = service;
+
+  // Concatenate agent-instructions*.md into copilot-instructions.md at boardSetupRoot.
+  const boardSetupRoot = path.dirname(boardDir);
+  fs.mkdirSync(boardSetupRoot, { recursive: true });
+  const srcDir = path.dirname(cardsDir);
+  const agentInstructionFiles = ['agent-instructions.md', 'agent-instructions-cardlayout.md'];
+  const parts = [];
+  for (const fname of agentInstructionFiles) {
+    const fpath = path.join(srcDir, fname);
+    if (fs.existsSync(fpath)) parts.push(fs.readFileSync(fpath, 'utf-8').trimEnd());
+  }
+  if (parts.length > 0) {
+    fs.writeFileSync(path.join(boardSetupRoot, 'copilot-instructions.md'), parts.join('\n\n') + '\n', 'utf-8');
+  }
+
+  _demoPrepSetupDone.set(boardId, true);
+}
+
 async function handleDemoSetup(req, res, boardId) {
   try {
-    const { service, boardRoot } = runtime.requireBoardService(boardId);
+    const { service } = runtime.requireBoardService(boardId);
     let setupPerformed = false;
 
-    if (!service.isDemoSetupDone()) {
-      service.ensureDemoSetup();
+    if (!isDemoSetupDone(boardId, service)) {
+      demoPrepSetup(boardId, service);
       setupPerformed = true;
     }
 

package/examples/example-board/demo-shell-browser.html

@@ -6,9 +6,9 @@
   <title>Example Board Demo (Browser 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="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/card-compute.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/board-livegraph-engine.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">
@@ -378,7 +378,7 @@
 
         return {
           fetchSource: async function (card, sourceDef) {
-            // chartApi source with mock="quotes" → return mock quote data
+            // mock source with mock="quotes" → return mock quote data
             if (sourceDef && sourceDef.mock === 'quotes') return clone(quoteData);
             // copilot source → return mock analysis object
             if (sourceDef && sourceDef.copilot) return clone(mockAnalysis);

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

@@ -16,10 +16,10 @@
   </style>
   <script src="https://cdn.jsdelivr.net/npm/jsonata/jsonata.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/card-compute.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/board-livegraph-engine.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.3.0/browser/board-livecards-runtime-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.2/browser/board-livecards-runtime-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">
@@ -192,11 +192,14 @@
         document.getElementById('boardTitle').textContent = bid + ' (Server Runtime)';
         document.getElementById('boardDesc').textContent = '';
 
+        // Demo-setup is a host-level concern; call it explicitly before bootstrapping.
+        const setupRes = await fetch(boardPaths(bid).demoSetup);
+        if (!setupRes.ok) throw new Error(`demo-setup failed (${setupRes.status})`);
+
         await runtimeClient.bootstrapBoard({
           boardId: bid,
           taskExecutorPath: resolveTaskExecutorPathParam(),
           rootElement: document.getElementById('boardRoot'),
-          runDemoSetup: true,
           mode: currentMode,
         });
 

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

@@ -45,8 +45,7 @@
  *   - { "url-list": { method?, headers?, cacheTimeout? } }
  *       → fan-out over _projections.url_list (string[]); returns array of responses.
  *         Build url_list in projections: e.g. `requires.holdings.ticker.('https://host/' & $ & '?q=1')`
- *   - { chartApi: { url, headers? }, tickersFrom }  → removed; use url-list instead
- *     prefer url-list for new sources
+ *     Prefer url-list for multi-URL fan-out sources.
  *   A real executor can also handle: graphapi, teams, mail, incidentdb, script, etc.
  *
  * url / url-list notes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "5.3.0",
+  "version": "5.4.2",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",