yaml-flow 5.2.8 → 5.4.0

package/dist/cli/board-live-cards-cli.d.cts

@@ -3,6 +3,63 @@ import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-x5XREkXm
 import { f as GraphEvent, T as TaskConfig } from '../types-BBhqYGhE.cjs';
 import { J as Journal } from '../journal-B-JCfQnh.cjs';
 
+/**
+ * board-live-cards-lib — Adapter interfaces and shared domain types.
+ *
+ * This file contains only pure TypeScript — no Node built-ins.
+ * It is safe to include in a neutral/browser/V8 (PyMiniRacer) bundle.
+ *
+ * Invariants enforced here:
+ *   - RuntimeInternalStore is never returned raw from public APIs.
+ *   - OutputStore writes are idempotent and schema-versioned.
+ *   - InputStore mutations are explicit operations, never side effects.
+ *   - Locking is acquired at the lib service boundary, not inside adapters.
+ *   - ControlStore writes only during init/administrative flows.
+ *   - InvocationAdapter results are structured, not raw shell-centric.
+ */
+
+interface SourceRuntimeEntry {
+    lastRequestedAt?: string;
+    lastFetchedAt?: string;
+    lastError?: string;
+    /** Timestamp of the most recent card-handler dispatch for this execution run. */
+    queueRequestedAt?: string;
+}
+interface InferenceRuntimeEntry {
+    lastRequestedAt?: string;
+    lastFetchedAt?: string;
+    lastError?: string;
+    /** Same semantics as SourceRuntimeEntry.queueRequestedAt. */
+    queueRequestedAt?: string;
+}
+type FetchRuntimeEntry = SourceRuntimeEntry | InferenceRuntimeEntry;
+interface SourceTokenPayload {
+    /** Original callback token from the reactive graph (encodes taskName) */
+    cbk: string;
+    /** Board directory (absolute path) */
+    rg: string;
+    /** Card id */
+    cid: string;
+    /** source_defs[].bindTo */
+    b: string;
+    /** source_defs[].outputFile (relative to boardDir) */
+    d: string;
+    /** Per-source invocation checksum */
+    cs?: string;
+}
+declare function isSourceInFlight(entry: FetchRuntimeEntry | undefined): boolean;
+/**
+ * Decide what to do with a source/inference fetch given the current runtime entry
+ * and the timestamp of the latest card-handler dispatch (queueRequestedAt).
+ *
+ * - 'dispatch'  : fetch not yet started for this run, or previous fetch predates the request
+ * - 'in-flight' : fetch is already running for this run — update queueRequestedAt and wait
+ * - 'idle'      : fetch already completed for this run — nothing to do
+ */
+declare function decideSourceAction(entry: FetchRuntimeEntry | undefined, queueRequestedAt: string): 'dispatch' | 'in-flight' | 'idle';
+declare function nextEntryAfterFetchDelivery<T extends FetchRuntimeEntry>(entry: T, fetchedAt: string): T;
+declare function nextEntryAfterFetchFailure<T extends FetchRuntimeEntry>(entry: T, reason: string): T;
+
 /**
  * Board Live Cards — Disk persistence + CLI for ReactiveGraph.
  */
@@ -53,56 +110,9 @@ declare function saveBoard(dir: string, rg: ReactiveGraph, journal: BoardJournal
  * Uses proper-lockfile on board-graph.json.
  */
 declare function withBoardLock<T>(boardDir: string, fn: () => T): T;
-interface SourceTokenPayload {
-    /** Original callback token from the reactive graph (encodes taskName) */
-    cbk: string;
-    /** Board directory (absolute path) */
-    rg: string;
-    /** Card id */
-    cid: string;
-    /** source_defs[].bindTo */
-    b: string;
-    /** source_defs[].outputFile (relative to boardDir) */
-    d: string;
-    /** Per-source invocation checksum */
-    cs?: string;
-}
+
 declare function encodeSourceToken(payload: SourceTokenPayload): string;
 declare function decodeSourceToken(token: string): SourceTokenPayload | null;
-interface SourceRuntimeEntry {
-    lastRequestedAt?: string;
-    lastFetchedAt?: string;
-    lastError?: string;
-    /** Timestamp of the most recent card-handler dispatch — updated on every fresh invocation.
-     * Replaces checksum-based gating: a source fetch is needed whenever
-     * lastFetchedAt is absent or older than queueRequestedAt. */
-    queueRequestedAt?: string;
-}
-interface InferenceRuntimeEntry {
-    lastRequestedAt?: string;
-    lastFetchedAt?: string;
-    lastError?: string;
-    /** Same semantics as SourceRuntimeEntry.queueRequestedAt. */
-    queueRequestedAt?: string;
-}
-type FetchRuntimeEntry = SourceRuntimeEntry | InferenceRuntimeEntry;
-declare function isSourceInFlight(entry: FetchRuntimeEntry | undefined): boolean;
-/**
- * Decide what to do with a source/inference fetch given the current runtime entry
- * and the timestamp of the latest card-handler dispatch (queueRequestedAt).
- *
- * - 'dispatch' : fetch not yet started for this run, or previous fetch predates the request
- * - 'in-flight': fetch is already running for this run — update queueRequestedAt and wait
- * - 'idle'     : fetch already completed for this run — nothing to do
- */
-declare function decideSourceAction(entry: FetchRuntimeEntry | undefined, queueRequestedAt: string): 'dispatch' | 'in-flight' | 'idle';
-declare function nextEntryAfterFetchDelivery<T extends FetchRuntimeEntry>(entry: T, fetchedAt: string): T;
-declare function nextEntryAfterFetchFailure<T extends FetchRuntimeEntry>(entry: T, reason: string): T;
-interface CardRuntimeState {
-    _sources: Record<string, SourceRuntimeEntry>;
-    _inferenceEntry?: InferenceRuntimeEntry;
-    _lastExecutionCount?: number;
-}
 /**
  * Append a raw event to the journal file. No lock, no file read.
  * Safe for hundreds of concurrent callers (appendFileSync is atomic for small writes).
@@ -164,70 +174,6 @@ type BoardLiveCard = LiveCard;
  * run compute, invoke source_defs.
  */
 declare function liveCardToTaskConfig(card: BoardLiveCard): TaskConfig;
-/**
- * Spin up a ReactiveGraph from a board directory with all handlers wired.
- *
- * Single handler:
- *   card-handler — reads card.json, loads sourcesData from outputFiles, runs CardCompute,
- *                  checks undelivered source_defs, emits task-completed or spawns run-sourcedefs-internal.
- *                  Fire & forget — returns 'task-initiated' immediately.
- */
-interface BoardReactiveGraph {
-    rg: ReactiveGraph;
-    journal: BoardJournal;
-}
-declare function createBoardReactiveGraph(boardDir: string): BoardReactiveGraph;
-interface BoardStatusCard {
-    name: string;
-    status: string;
-    error?: {
-        message: string;
-        code?: string;
-        at?: string;
-        source?: 'task-runtime' | 'source-fetch' | 'timeout' | 'unknown';
-    };
-    requires: string[];
-    requires_satisfied: string[];
-    requires_missing: string[];
-    provides_declared: string[];
-    provides_runtime: string[];
-    blocked_by: string[];
-    unblocks: string[];
-    runtime: {
-        attempt_count: number;
-        restart_count: number;
-        in_progress_since: string | null;
-        last_transition_at: string | null;
-        last_completed_at: string | null;
-        last_restarted_at: string | null;
-        status_age_ms: number | null;
-    };
-}
-interface BoardStatusObject {
-    schema_version: 'v1';
-    meta: {
-        board: {
-            path: string;
-        };
-    };
-    summary: {
-        card_count: number;
-        completed: number;
-        eligible: number;
-        pending: number;
-        blocked: number;
-        unresolved: number;
-        failed?: number;
-        in_progress?: number;
-        orphan_cards?: number;
-        topology?: {
-            edge_count: number;
-            max_fan_out_card: string | null;
-            max_fan_out: number;
-        };
-    };
-    cards: BoardStatusCard[];
-}
 declare function cli(argv: string[]): Promise<void>;
 
-export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type BoardReactiveGraph, type BoardStatusCard, type BoardStatusObject, type CardInventoryEntry, type CardInventoryIndex, type CardRuntimeState, type InferenceRuntimeEntry, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, createBoardReactiveGraph, decideSourceAction, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, isSourceInFlight, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, nextEntryAfterFetchDelivery, nextEntryAfterFetchFailure, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };
+export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type CardInventoryEntry, type CardInventoryIndex, type FetchRuntimeEntry, type InferenceRuntimeEntry, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, decideSourceAction, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, isSourceInFlight, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, nextEntryAfterFetchDelivery, nextEntryAfterFetchFailure, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };

package/dist/cli/board-live-cards-cli.d.ts

@@ -3,6 +3,63 @@ import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-EQjytzI_
 import { f as GraphEvent, T as TaskConfig } from '../types-BBhqYGhE.js';
 import { J as Journal } from '../journal-9HEgs7dU.js';
 
+/**
+ * board-live-cards-lib — Adapter interfaces and shared domain types.
+ *
+ * This file contains only pure TypeScript — no Node built-ins.
+ * It is safe to include in a neutral/browser/V8 (PyMiniRacer) bundle.
+ *
+ * Invariants enforced here:
+ *   - RuntimeInternalStore is never returned raw from public APIs.
+ *   - OutputStore writes are idempotent and schema-versioned.
+ *   - InputStore mutations are explicit operations, never side effects.
+ *   - Locking is acquired at the lib service boundary, not inside adapters.
+ *   - ControlStore writes only during init/administrative flows.
+ *   - InvocationAdapter results are structured, not raw shell-centric.
+ */
+
+interface SourceRuntimeEntry {
+    lastRequestedAt?: string;
+    lastFetchedAt?: string;
+    lastError?: string;
+    /** Timestamp of the most recent card-handler dispatch for this execution run. */
+    queueRequestedAt?: string;
+}
+interface InferenceRuntimeEntry {
+    lastRequestedAt?: string;
+    lastFetchedAt?: string;
+    lastError?: string;
+    /** Same semantics as SourceRuntimeEntry.queueRequestedAt. */
+    queueRequestedAt?: string;
+}
+type FetchRuntimeEntry = SourceRuntimeEntry | InferenceRuntimeEntry;
+interface SourceTokenPayload {
+    /** Original callback token from the reactive graph (encodes taskName) */
+    cbk: string;
+    /** Board directory (absolute path) */
+    rg: string;
+    /** Card id */
+    cid: string;
+    /** source_defs[].bindTo */
+    b: string;
+    /** source_defs[].outputFile (relative to boardDir) */
+    d: string;
+    /** Per-source invocation checksum */
+    cs?: string;
+}
+declare function isSourceInFlight(entry: FetchRuntimeEntry | undefined): boolean;
+/**
+ * Decide what to do with a source/inference fetch given the current runtime entry
+ * and the timestamp of the latest card-handler dispatch (queueRequestedAt).
+ *
+ * - 'dispatch'  : fetch not yet started for this run, or previous fetch predates the request
+ * - 'in-flight' : fetch is already running for this run — update queueRequestedAt and wait
+ * - 'idle'      : fetch already completed for this run — nothing to do
+ */
+declare function decideSourceAction(entry: FetchRuntimeEntry | undefined, queueRequestedAt: string): 'dispatch' | 'in-flight' | 'idle';
+declare function nextEntryAfterFetchDelivery<T extends FetchRuntimeEntry>(entry: T, fetchedAt: string): T;
+declare function nextEntryAfterFetchFailure<T extends FetchRuntimeEntry>(entry: T, reason: string): T;
+
 /**
  * Board Live Cards — Disk persistence + CLI for ReactiveGraph.
  */
@@ -53,56 +110,9 @@ declare function saveBoard(dir: string, rg: ReactiveGraph, journal: BoardJournal
  * Uses proper-lockfile on board-graph.json.
  */
 declare function withBoardLock<T>(boardDir: string, fn: () => T): T;
-interface SourceTokenPayload {
-    /** Original callback token from the reactive graph (encodes taskName) */
-    cbk: string;
-    /** Board directory (absolute path) */
-    rg: string;
-    /** Card id */
-    cid: string;
-    /** source_defs[].bindTo */
-    b: string;
-    /** source_defs[].outputFile (relative to boardDir) */
-    d: string;
-    /** Per-source invocation checksum */
-    cs?: string;
-}
+
 declare function encodeSourceToken(payload: SourceTokenPayload): string;
 declare function decodeSourceToken(token: string): SourceTokenPayload | null;
-interface SourceRuntimeEntry {
-    lastRequestedAt?: string;
-    lastFetchedAt?: string;
-    lastError?: string;
-    /** Timestamp of the most recent card-handler dispatch — updated on every fresh invocation.
-     * Replaces checksum-based gating: a source fetch is needed whenever
-     * lastFetchedAt is absent or older than queueRequestedAt. */
-    queueRequestedAt?: string;
-}
-interface InferenceRuntimeEntry {
-    lastRequestedAt?: string;
-    lastFetchedAt?: string;
-    lastError?: string;
-    /** Same semantics as SourceRuntimeEntry.queueRequestedAt. */
-    queueRequestedAt?: string;
-}
-type FetchRuntimeEntry = SourceRuntimeEntry | InferenceRuntimeEntry;
-declare function isSourceInFlight(entry: FetchRuntimeEntry | undefined): boolean;
-/**
- * Decide what to do with a source/inference fetch given the current runtime entry
- * and the timestamp of the latest card-handler dispatch (queueRequestedAt).
- *
- * - 'dispatch' : fetch not yet started for this run, or previous fetch predates the request
- * - 'in-flight': fetch is already running for this run — update queueRequestedAt and wait
- * - 'idle'     : fetch already completed for this run — nothing to do
- */
-declare function decideSourceAction(entry: FetchRuntimeEntry | undefined, queueRequestedAt: string): 'dispatch' | 'in-flight' | 'idle';
-declare function nextEntryAfterFetchDelivery<T extends FetchRuntimeEntry>(entry: T, fetchedAt: string): T;
-declare function nextEntryAfterFetchFailure<T extends FetchRuntimeEntry>(entry: T, reason: string): T;
-interface CardRuntimeState {
-    _sources: Record<string, SourceRuntimeEntry>;
-    _inferenceEntry?: InferenceRuntimeEntry;
-    _lastExecutionCount?: number;
-}
 /**
  * Append a raw event to the journal file. No lock, no file read.
  * Safe for hundreds of concurrent callers (appendFileSync is atomic for small writes).
@@ -164,70 +174,6 @@ type BoardLiveCard = LiveCard;
  * run compute, invoke source_defs.
  */
 declare function liveCardToTaskConfig(card: BoardLiveCard): TaskConfig;
-/**
- * Spin up a ReactiveGraph from a board directory with all handlers wired.
- *
- * Single handler:
- *   card-handler — reads card.json, loads sourcesData from outputFiles, runs CardCompute,
- *                  checks undelivered source_defs, emits task-completed or spawns run-sourcedefs-internal.
- *                  Fire & forget — returns 'task-initiated' immediately.
- */
-interface BoardReactiveGraph {
-    rg: ReactiveGraph;
-    journal: BoardJournal;
-}
-declare function createBoardReactiveGraph(boardDir: string): BoardReactiveGraph;
-interface BoardStatusCard {
-    name: string;
-    status: string;
-    error?: {
-        message: string;
-        code?: string;
-        at?: string;
-        source?: 'task-runtime' | 'source-fetch' | 'timeout' | 'unknown';
-    };
-    requires: string[];
-    requires_satisfied: string[];
-    requires_missing: string[];
-    provides_declared: string[];
-    provides_runtime: string[];
-    blocked_by: string[];
-    unblocks: string[];
-    runtime: {
-        attempt_count: number;
-        restart_count: number;
-        in_progress_since: string | null;
-        last_transition_at: string | null;
-        last_completed_at: string | null;
-        last_restarted_at: string | null;
-        status_age_ms: number | null;
-    };
-}
-interface BoardStatusObject {
-    schema_version: 'v1';
-    meta: {
-        board: {
-            path: string;
-        };
-    };
-    summary: {
-        card_count: number;
-        completed: number;
-        eligible: number;
-        pending: number;
-        blocked: number;
-        unresolved: number;
-        failed?: number;
-        in_progress?: number;
-        orphan_cards?: number;
-        topology?: {
-            edge_count: number;
-            max_fan_out_card: string | null;
-            max_fan_out: number;
-        };
-    };
-    cards: BoardStatusCard[];
-}
 declare function cli(argv: string[]): Promise<void>;
 
-export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type BoardReactiveGraph, type BoardStatusCard, type BoardStatusObject, type CardInventoryEntry, type CardInventoryIndex, type CardRuntimeState, type InferenceRuntimeEntry, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, createBoardReactiveGraph, decideSourceAction, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, isSourceInFlight, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, nextEntryAfterFetchDelivery, nextEntryAfterFetchFailure, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };
+export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type CardInventoryEntry, type CardInventoryIndex, type FetchRuntimeEntry, type InferenceRuntimeEntry, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, decideSourceAction, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, isSourceInFlight, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, nextEntryAfterFetchDelivery, nextEntryAfterFetchFailure, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };