yaml-flow 5.3.0 → 5.4.0

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,
   });
 

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,67 @@ function jsonReply(res, status, payload) {
   res.end(body);
 }
 
+// ---------------------------------------------------------------------------
+// Card preparation — host-level concern, not a reusable runtime concern.
+// Copies source card JSON files into the runtime's tmpCardsDir and writes
+// the concatenated copilot-instructions.md at the board setup root.
+// The runtime's bootstrap operations assume cards are already in tmpCardsDir;
+// the host (this file) decides how and when they get there.
+// ---------------------------------------------------------------------------
+
+const _demoPrepSetupDone = new Map(); // boardId → true
+
+function isDemoSetupDone(boardId, service) {
+  return _demoPrepSetupDone.get(boardId) === true && fs.existsSync(service.tmpCardsDir);
+}
+
+function demoPrepSetup(boardId, service) {
+  const { tmpSurfaceDir, tmpCardsDir, cardsDir, gandalfCardsDir, tmpGandalfCardsDir, boardDir } = service;
+
+  fs.mkdirSync(tmpSurfaceDir, { recursive: true });
+  fs.rmSync(tmpCardsDir, { recursive: true, force: true });
+  fs.mkdirSync(tmpCardsDir, { recursive: true });
+
+  const entries = fs.readdirSync(cardsDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isFile()) continue;
+    if (!entry.name.toLowerCase().endsWith('.json')) continue;
+    fs.copyFileSync(path.join(cardsDir, entry.name), path.join(tmpCardsDir, entry.name));
+  }
+
+  // Copy gandalf-card templates if gandalfCardsDir is configured.
+  if (gandalfCardsDir && fs.existsSync(gandalfCardsDir)) {
+    fs.rmSync(tmpGandalfCardsDir, { recursive: true, force: true });
+    fs.mkdirSync(tmpGandalfCardsDir, { recursive: true });
+    for (const entry of fs.readdirSync(gandalfCardsDir, { withFileTypes: true })) {
+      if (!entry.isFile() || !entry.name.toLowerCase().endsWith('.json')) continue;
+      fs.copyFileSync(path.join(gandalfCardsDir, entry.name), path.join(tmpGandalfCardsDir, entry.name));
+    }
+  }
+
+  // Concatenate agent-instructions*.md into copilot-instructions.md at boardSetupRoot.
+  const boardSetupRoot = path.dirname(boardDir);
+  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.0/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.0/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.0/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.0/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.4.0/browser/board-livecards-runtime-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

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.0",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",