yaml-flow 5.4.2 → 7.0.0

package/examples/example-board/cards/card-portfolio.json

@@ -2,11 +2,16 @@
   "id": "card-portfolio",
   "meta": {
     "title": "My Portfolio",
-    "tags": ["portfolio"],
+    "tags": [
+      "portfolio"
+    ],
     "desc": "Manage your stock holdings — edit tickers and quantities inline, add or delete rows. Changes propagate downstream immediately."
   },
   "provides": [
-    { "bindTo": "holdings", "ref": "card_data.holdings" }
+    {
+      "bindTo": "holdings",
+      "ref": "card_data.holdings"
+    }
   ],
   "compute": [],
   "view": {
@@ -17,28 +22,67 @@
         "data": {
           "bind": "card_data.holdings",
           "writeTo": "card_data.holdings",
-          "columns": ["ticker", "quantity", "cost_basis"],
+          "columns": [
+            "ticker",
+            "quantity",
+            "cost_basis"
+          ],
           "schema": {
             "properties": {
-              "quantity":   { "type": "number" },
-              "cost_basis": { "type": "number" }
+              "quantity": {
+                "type": "number"
+              },
+              "cost_basis": {
+                "type": "number"
+              }
             }
           }
         }
       }
     ],
     "layout": {
-      "board": { "col": 4, "order": 1 },
-      "canvas": { "x": 50, "y": 50, "w": 320, "h": 340 }
+      "board": {
+        "col": 4,
+        "order": 1
+      },
+      "canvas": {
+        "x": 50,
+        "y": 50,
+        "w": 320,
+        "h": 340
+      }
     },
-    "features": { "chat": true }
+    "features": {
+      "chat": true
+    }
   },
   "card_data": {
     "holdings": [
-      { "ticker": "AAPL",  "quantity": 10, "cost_basis": 150.00 },
-      { "ticker": "MSFT",  "quantity": 5,  "cost_basis": 310.00 },
-      { "ticker": "GOOGL", "quantity": 2,  "cost_basis": 280.00 },
-      { "ticker": "TSLA",  "quantity": 3,  "cost_basis": 200.00 }
+      {
+        "ticker": "AAPL",
+        "quantity": 10,
+        "cost_basis": 150
+      },
+      {
+        "ticker": "MSFT",
+        "quantity": 5,
+        "cost_basis": 310
+      },
+      {
+        "ticker": "GOOGL",
+        "quantity": 2,
+        "cost_basis": 280
+      },
+      {
+        "ticker": "TSLA",
+        "quantity": 3,
+        "cost_basis": 200
+      },
+      {
+        "ticker": "NVDA",
+        "quantity": 5,
+        "cost_basis": 310
+      }
     ]
   }
-}
+}

package/examples/example-board/cards/card-rebalance-impact.json

@@ -2,11 +2,17 @@
   "id": "card-rebalance-impact",
   "meta": {
     "title": "Rebalance Impact",
-    "tags": ["portfolio", "simulation"],
+    "tags": [
+      "portfolio",
+      "simulation"
+    ],
     "simulation": true,
     "desc": "Before/after impact summary of the proposed rebalance scenario."
   },
-  "requires": ["positions", "proposed_trades"],
+  "requires": [
+    "positions",
+    "proposed_trades"
+  ],
   "compute": [
     {
       "bindTo": "total_current_value",
@@ -53,13 +59,23 @@
     "elements": [
       {
         "kind": "markdown",
-        "data": { "bind": "computed_values.summary_md" }
+        "data": {
+          "bind": "computed_values.summary_md"
+        }
       }
     ],
     "layout": {
-      "board": { "col": 6, "order": 8 },
-      "canvas": { "x": 1360, "y": 480, "w": 400, "h": 280 }
+      "board": {
+        "col": 6,
+        "order": 8
+      },
+      "canvas": {
+        "x": 1360,
+        "y": 480,
+        "w": 400,
+        "h": 280
+      }
     }
   },
   "card_data": {}
-}
+}

package/examples/example-board/cards/card-rebalance-sim.json

@@ -2,11 +2,20 @@
   "id": "card-rebalance-sim",
   "meta": {
     "title": "Rebalance Proposal",
-    "tags": ["portfolio", "simulation"],
+    "tags": [
+      "portfolio",
+      "simulation"
+    ],
     "simulation": true,
     "desc": "AI-proposed rebalance trades based on portfolio intelligence. Edit quantities before pinning."
   },
-  "requires": ["holdings", "portfolio_mix", "portfolio_risks", "portfolio_action", "positions"],
+  "requires": [
+    "holdings",
+    "portfolio_mix",
+    "portfolio_risks",
+    "portfolio_action",
+    "positions"
+  ],
   "source_defs": [
     {
       "bindTo": "rebalance",
@@ -24,7 +33,20 @@
     }
   ],
   "provides": [
-    { "bindTo": "proposed_trades", "ref": "fetched_sources.rebalance.proposed_trades" }
+    {
+      "bindTo": "proposed_trades",
+      "ref": "fetched_sources.rebalance.proposed_trades"
+    }
+  ],
+  "compute": [
+    {
+      "bindTo": "proposed_trades",
+      "expr": "fetched_sources.rebalance.proposed_trades"
+    },
+    {
+      "bindTo": "_view",
+      "expr": "fetched_sources.rebalance._view"
+    }
   ],
   "view": {
     "elements": [
@@ -32,18 +54,37 @@
         "kind": "ref",
         "label": "Proposed Trades",
         "data": {
-          "bind": "fetched_sources.rebalance.proposed_trades",
-          "viewBind": "fetched_sources.rebalance._view",
+          "bind": "computed_values.proposed_trades",
+          "viewBind": "computed_values._view",
           "fallbackKind": "editable-table",
           "writeTo": "card_data.proposed_trades",
-          "columns": ["ticker", "direction", "current_qty", "change", "proposed_qty", "price", "trade_value", "reason"],
+          "columns": [
+            "ticker",
+            "direction",
+            "current_qty",
+            "change",
+            "proposed_qty",
+            "price",
+            "trade_value",
+            "reason"
+          ],
           "schema": {
             "properties": {
-              "current_qty": { "type": "number" },
-              "change": { "type": "number" },
-              "proposed_qty": { "type": "number" },
-              "price": { "type": "number" },
-              "trade_value": { "type": "number" }
+              "current_qty": {
+                "type": "number"
+              },
+              "change": {
+                "type": "number"
+              },
+              "proposed_qty": {
+                "type": "number"
+              },
+              "price": {
+                "type": "number"
+              },
+              "trade_value": {
+                "type": "number"
+              }
             }
           }
         }
@@ -58,10 +99,20 @@
       }
     ],
     "layout": {
-      "board": { "col": 6, "order": 7 },
-      "canvas": { "x": 840, "y": 480, "w": 500, "h": 280 }
+      "board": {
+        "col": 6,
+        "order": 7
+      },
+      "canvas": {
+        "x": 840,
+        "y": 480,
+        "w": 500,
+        "h": 280
+      }
     },
-    "features": { "refresh": true }
+    "features": {
+      "refresh": true
+    }
   },
   "card_data": {}
-}
+}

package/examples/example-board/demo-chat-handler.js

@@ -10,6 +10,7 @@
  *   runtimeStatusDir— relative subdir: 'runtime-out'
  *   cardsDir        — relative subdir: 'surface/tmp-cards'
  *   chatDir         — absolute path to the card's chats directory
+ *   chatProcessingMarkerKey — relative marker key in chats artifacts store (e.g. 'card-portfolio/.processing')
  *   lastChatFile    — filename of the just-written user message, e.g. '001_user.txt'
  *   serverUrl       — base URL of hosting server (e.g. http://127.0.0.1:7799), optional
  *
@@ -37,13 +38,12 @@ function getArg(name) {
 const boardId     = getArg('--boardId') || '';
 const cardId      = getArg('--cardId') || '';
 const extraStr    = getArg('--extraEncJson') || '';
-const cleanOnExit = getArg('--cleanOnExit') || '';
 
 let extra = {};
 try { extra = JSON.parse(Buffer.from(extraStr, 'base64').toString('utf-8')); }
 catch { console.error('[demo-chat-handler] bad --extraEncJson'); process.exit(0); }
 
-const { boardSetupRoot, boardRuntimeDir, runtimeStatusDir, cardsDir, chatDir, lastChatFile, serverUrl } = extra;
+const { boardSetupRoot, boardRuntimeDir, runtimeStatusDir, cardsDir, chatDir, chatProcessingMarkerKey, lastChatFile, serverUrl } = extra;
 if (!boardSetupRoot || !chatDir || !lastChatFile) {
   console.error('[demo-chat-handler] missing boardSetupRoot/chatDir/lastChatFile');
   process.exit(0);
@@ -153,7 +153,17 @@ try {
 } catch (err) {
   console.error('[demo-chat-handler] wrapper failed: ' + (err?.message ?? err));
 } finally {
-  if (cleanOnExit) {
-    try { fs.unlinkSync(cleanOnExit); } catch {}
+  cleanupProcessingMarker();
+}
+function cleanupProcessingMarker() {
+  // Prefer artifacts-style marker key from extra payload so runtime/handler contract
+  // does not rely on passing an absolute file path argument.
+  if (chatProcessingMarkerKey) {
+    try {
+      const markerPath = path.join(cardsDirAbs, chatProcessingMarkerKey);
+      fs.unlinkSync(markerPath);
+      return;
+    } catch {}
   }
+  try { fs.unlinkSync(path.join(chatDirAbs, '.processing')); } catch {}
 }

package/examples/example-board/demo-server-config.json

@@ -1,5 +1,6 @@
 {
   "port": 7799,
+  "serverMetaStoreRef": "::fs-path::./.server-meta",
   "cardsDir": "./cards",
   "taskExecutorPath": "./demo-task-executor.js",
   "chatHandlerPath": "./demo-chat-handler.js",