yaml-flow 5.4.0 → 6.0.0

package/dist/journal-9HEgs7dU.d.ts

@@ -1,28 +0,0 @@
-import { f as GraphEvent } from './types-BBhqYGhE.js';
-
-/**
- * Continuous Event Graph — Journal
- *
- * Append-only event log for the reactive layer.
- * Handlers append events here; drain() reads and clears atomically.
- *
- * Adapter:
- *   - MemoryJournal: in-process array (default)
- */
-
-interface Journal {
-    /** Append an event to the journal. Safe to call from concurrent callbacks. */
-    append(event: GraphEvent): void;
-    /** Read all pending events and clear the journal atomically. */
-    drain(): GraphEvent[];
-    /** Number of pending events (for observability). */
-    readonly size: number;
-}
-declare class MemoryJournal implements Journal {
-    private buffer;
-    append(event: GraphEvent): void;
-    drain(): GraphEvent[];
-    get size(): number;
-}
-
-export { type Journal as J, MemoryJournal as M };

package/dist/journal-B-JCfQnh.d.cts

@@ -1,28 +0,0 @@
-import { f as GraphEvent } from './types-BBhqYGhE.cjs';
-
-/**
- * Continuous Event Graph — Journal
- *
- * Append-only event log for the reactive layer.
- * Handlers append events here; drain() reads and clears atomically.
- *
- * Adapter:
- *   - MemoryJournal: in-process array (default)
- */
-
-interface Journal {
-    /** Append an event to the journal. Safe to call from concurrent callbacks. */
-    append(event: GraphEvent): void;
-    /** Read all pending events and clear the journal atomically. */
-    drain(): GraphEvent[];
-    /** Number of pending events (for observability). */
-    readonly size: number;
-}
-declare class MemoryJournal implements Journal {
-    private buffer;
-    append(event: GraphEvent): void;
-    drain(): GraphEvent[];
-    get size(): number;
-}
-
-export { type Journal as J, MemoryJournal as M };

package/dist/schedule-Cszq9LYY.d.ts

@@ -1,21 +0,0 @@
-import { L as LiveGraph, S as ScheduleResult } from './types-CoW0gQl3.js';
-
-/**
- * Continuous Event Graph — Schedule
- *
- * Pure read-only projection: LiveGraph → ScheduleResult
- *
- * Classifies every non-terminal task into one of:
- *   - eligible: all requires satisfied, ready to dispatch
- *   - pending: requires not yet met, but a viable producer exists (normal waiting)
- *   - unresolved: requires not met, NO task in the graph can produce them (caller's problem)
- *   - blocked: requires not met because the producing task FAILED (caller's problem)
- */
-
-/**
- * Compute the scheduling status of every task in the live graph.
- * Pure function — no side effects.
- */
-declare function schedule(live: LiveGraph): ScheduleResult;
-
-export { schedule as s };

package/dist/schedule-qWNL0RQh.d.cts

@@ -1,21 +0,0 @@
-import { L as LiveGraph, S as ScheduleResult } from './types-CHSdoAAA.cjs';
-
-/**
- * Continuous Event Graph — Schedule
- *
- * Pure read-only projection: LiveGraph → ScheduleResult
- *
- * Classifies every non-terminal task into one of:
- *   - eligible: all requires satisfied, ready to dispatch
- *   - pending: requires not yet met, but a viable producer exists (normal waiting)
- *   - unresolved: requires not met, NO task in the graph can produce them (caller's problem)
- *   - blocked: requires not met because the producing task FAILED (caller's problem)
- */
-
-/**
- * Compute the scheduling status of every task in the live graph.
- * Pure function — no side effects.
- */
-declare function schedule(live: LiveGraph): ScheduleResult;
-
-export { schedule as s };

package/examples/browser/boards/portfolio-tracker/cards/holdings-table.json

@@ -1,22 +0,0 @@
-{
-  "id": "holdings-table",
-  "meta": { "title": "Holdings Table" },
-  "requires": ["holdings", "prices"],
-  "provides": [{ "bindTo": "table", "ref": "computed_values.table" }],
-  "card_data": {},
-  "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/browser/boards/portfolio-tracker/cards/portfolio-form.json

@@ -1,16 +0,0 @@
-{
-  "id": "portfolio-form",
-  "meta": { "title": "Portfolio Holdings Form" },
-  "provides": [{ "bindTo": "holdings", "ref": "card_data.holdings" }],
-  "card_data": {
-    "holdings": [
-      { "symbol": "AAPL", "qty": 50 },
-      { "symbol": "MSFT", "qty": 30 }
-    ]
-  },
-  "view": {
-    "elements": [
-      { "kind": "table", "label": "Holdings", "data": { "bind": "card_data.holdings", "columns": ["symbol", "qty"] } }
-    ]
-  }
-}

package/examples/browser/boards/portfolio-tracker/cards/portfolio-risk-assessment.json

@@ -1,28 +0,0 @@
-{
-  "id": "portfolio-risk-assessment",
-  "meta": { "title": "Portfolio Risk Assessment" },
-  "requires": ["table", "totalValue"],
-  "provides": [
-    { "bindTo": "riskAssessment", "ref": "card_data.llm_task_completion_inference.reason" }
-  ],
-  "card_data": {
-    "llm_task_completion_inference": {
-      "sync_tmp_file": "tmp_file2"
-    }
-  },
-  "when_is_task_completed": "Complete this task only when the portfolio has at least 3 positions and no single holding exceeds 60 percent of the total portfolio value.",
-  "view": {
-    "elements": [
-      {
-        "kind": "text",
-        "label": "Risk Assessment",
-        "data": { "bind": "card_data.llm_task_completion_inference.reason" }
-      },
-      {
-        "kind": "text",
-        "label": "Risk Evidence",
-        "data": { "bind": "card_data.llm_task_completion_inference.evidence" }
-      }
-    ]
-  }
-}

package/examples/browser/boards/portfolio-tracker/cards/portfolio-value.json

@@ -1,15 +0,0 @@
-{
-  "id": "portfolio-value",
-  "meta": { "title": "Portfolio Total Value" },
-  "requires": ["table"],
-  "provides": [{ "bindTo": "totalValue", "ref": "computed_values.totalValue" }],
-  "card_data": {},
-  "compute": [
-    { "bindTo": "totalValue", "expr": "$sum(requires.table.rows.value)" }
-  ],
-  "view": {
-    "elements": [
-      { "kind": "metric", "label": "Total Portfolio Value", "data": { "bind": "computed_values.totalValue" } }
-    ]
-  }
-}

package/examples/browser/boards/portfolio-tracker/cards/price-fetch.json

@@ -1,15 +0,0 @@
-{
-  "id": "price-fetch",
-  "meta": { "title": "Fetch Market Prices" },
-  "requires": ["holdings"],
-  "provides": [{ "bindTo": "prices", "ref": "fetched_sources.prices" }],
-  "card_data": {},
-  "source_defs": [
-    { "cli": "node ../fetch-prices.js", "bindTo": "prices", "outputFile": "prices.json" }
-  ],
-  "view": {
-    "elements": [
-      { "kind": "table", "label": "Market Prices", "data": { "bind": "fetched_sources.prices" } }
-    ]
-  }
-}

package/examples/browser/boards/portfolio-tracker/cards/rebalancing-strategy.json

@@ -1,28 +0,0 @@
-{
-  "id": "rebalancing-strategy",
-  "meta": { "title": "Rebalancing Strategy" },
-  "requires": ["table", "totalValue", "riskAssessment"],
-  "provides": [
-    { "bindTo": "rebalancingPlan", "ref": "card_data.llm_task_completion_inference.reason" }
-  ],
-  "card_data": {
-    "llm_task_completion_inference": {
-      "sync_tmp_file": "tmp_file3"
-    }
-  },
-  "when_is_task_completed": "Complete this task when a concrete rebalancing recommendation can be produced from the current holdings table, total value, and risk assessment.",
-  "view": {
-    "elements": [
-      {
-        "kind": "text",
-        "label": "Rebalancing Recommendation",
-        "data": { "bind": "card_data.llm_task_completion_inference.reason" }
-      },
-      {
-        "kind": "text",
-        "label": "Suggested Moves",
-        "data": { "bind": "card_data.llm_task_completion_inference.evidence" }
-      }
-    ]
-  }
-}

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

@@ -1,43 +0,0 @@
-/**
- * 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';
-
-const envBoardDir = (process.env.BOARD_DIR ?? '').trim();
-const tmpFileCandidates = [
-  envBoardDir ? path.join(envBoardDir, 'tmp_file1') : '',
-  path.join(process.cwd(), 'tmp_file1'),
-  path.join(process.cwd(), 'board-runtime', 'tmp_file1'),
-  path.join(process.cwd(), '..', 'board-runtime', 'tmp_file1'),
-].filter(Boolean);
-
-function getReadableTmpFile() {
-  for (const tmpFile of tmpFileCandidates) {
-    if (!fs.existsSync(tmpFile)) continue;
-    const content = fs.readFileSync(tmpFile, 'utf-8').trim();
-    if (content) return { tmpFile, content };
-  }
-  return undefined;
-}
-
-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/browser/boards/portfolio-tracker/portfolio-tracker-task-executor.cjs

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-/**
- * Portfolio Tracker Task-Executor
- * 
- * Implements the run-source-fetch protocol for board-live-cards.
- * This script acts as an external task-executor that can be registered via .task-executor file.
- * 
- * Contract:
- *   portfolio-tracker-task-executor.js run-source-fetch --in <defFile> --out <resultFile> --err <errFile>
- * 
- * Input (--in file):
- *   JSON source definition with { cli: "...", bindTo: "...", outputFile: "...", ... }
- * 
- * Output (on success):
- *   --out file contains the execution result
- *   Exit code: 0
- * 
- * Output (on error):
- *   --err file contains error message
- *   Exit code: 1
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-// Parse command line arguments
-const args = process.argv.slice(2);
-let subcommand = '';
-let inFile = '';
-let outFile = '';
-let errFile = '';
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === 'run-source-fetch') {
-    subcommand = 'run-source-fetch';
-  } else if (args[i] === '--in' && i + 1 < args.length) {
-    inFile = args[i + 1];
-  } else if (args[i] === '--out' && i + 1 < args.length) {
-    outFile = args[i + 1];
-  } else if (args[i] === '--err' && i + 1 < args.length) {
-    errFile = args[i + 1];
-  }
-}
-
-if (subcommand !== 'run-source-fetch' || !inFile || !outFile || !errFile) {
-  console.error('Usage: portfolio-tracker-task-executor.js run-source-fetch --in <defFile> --out <resultFile> --err <errFile>');
-  process.exit(1);
-}
-
-try {
-  // 1. Read source definition from --in file
-  console.log(`[portfolio-tracker-task-executor] Reading source definition from ${inFile}`);
-  const sourceDefStr = fs.readFileSync(inFile, 'utf-8');
-  const sourceDef = JSON.parse(sourceDefStr);
-  
-  // 2. Extract cli command from source definition
-  const { cli: sourceCliCommand } = sourceDef;
-  if (!sourceCliCommand) {
-    throw new Error('cli is required in source definition');
-  }
-  
-  console.log(`[portfolio-tracker-task-executor] Executing: ${sourceCliCommand}`);
-  
-  // 3. Execute source.cli synchronously and capture output
-  let output;
-  try {
-    output = execSync(sourceCliCommand, {
-      encoding: 'utf-8',
-      timeout: (sourceDef.timeout ?? 120) * 1000,  // Convert to ms
-      cwd: sourceDef.cwd,
-      shell: true,
-      stdio: ['pipe', 'pipe', 'pipe'],  // Capture stdout/stderr
-    });
-  } catch (execErr) {
-    // Even on error, try to use what output we got
-    output = execErr.stdout || '';
-    if (!output) {
-      throw new Error(`Command execution failed: ${execErr.message}`);
-    }
-  }
-  
-  // 4. Write output to --out file
-  console.log(`[portfolio-tracker-task-executor] Writing result to ${outFile}`);
-  fs.writeFileSync(outFile, output.trim(), 'utf-8');
-  
-  console.log(`[portfolio-tracker-task-executor] Success`);
-  process.exit(0);
-} catch (error) {
-  // 3a. On error: write error message to --err file and exit non-zero
-  const errorMsg = error instanceof Error ? error.message : String(error);
-  console.error(`[portfolio-tracker-task-executor] Error:`, errorMsg);
-  
-  fs.writeFileSync(errFile, errorMsg, 'utf-8');
-  process.exit(1);
-}

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

@@ -1,7 +0,0 @@
-@echo off
-setlocal
-
-set "BOARD_LIVE_CARDS_NO_SPAWN=1"
-node "%~dp0portfolio-tracker.js"
-
-endlocal