yaml-flow 5.4.2 → 7.0.0

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

@@ -1,179 +0,0 @@
-import { b as LiveGraphSnapshot, L as LiveGraph } from '../types-CHSdoAAA.cjs';
-import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-x5XREkXm.cjs';
-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.
- */
-
-/** Envelope stored in board-graph.json — wraps the LiveGraph snapshot with journal pointer. */
-interface BoardEnvelope {
-    lastDrainedJournalId: string;
-    graph: LiveGraphSnapshot;
-}
-interface JournalEntry {
-    id: string;
-    event: GraphEvent;
-}
-declare class BoardJournal implements Journal {
-    private readonly journalPath;
-    private lastDrainedId;
-    constructor(journalPath: string, lastDrainedJournalId: string);
-    append(event: GraphEvent): void;
-    drain(): GraphEvent[];
-    get size(): number;
-    get lastDrainedJournalId(): string;
-}
-interface CardInventoryEntry {
-    cardId: string;
-    cardFilePath: string;
-    addedAt: string;
-}
-interface CardInventoryIndex {
-    byCardId: Map<string, CardInventoryEntry>;
-    byCardPath: Map<string, CardInventoryEntry>;
-}
-declare function readCardInventory(boardDir: string): CardInventoryEntry[];
-declare function lookupCardPath(boardDir: string, cardId: string): string | null;
-declare function appendCardInventory(boardDir: string, entry: CardInventoryEntry): void;
-declare function buildCardInventoryIndex(boardDir: string): CardInventoryIndex;
-/**
- * Initialize a board directory.
- * - Dir doesn't exist → create it, write empty board-graph.json
- * - Dir exists + valid board-graph.json → no-op, return 'exists'
- * - Dir exists + non-empty (no valid board-graph.json) → throw
- */
-declare function initBoard(dir: string): 'created' | 'exists';
-declare function loadBoardEnvelope(dir: string): BoardEnvelope;
-declare function loadBoard(dir: string): LiveGraph;
-declare function saveBoard(dir: string, rg: ReactiveGraph, journal: BoardJournal): void;
-/**
- * Acquire an exclusive lock on the board, run `fn`, then release.
- * Uses proper-lockfile on board-graph.json.
- */
-declare function withBoardLock<T>(boardDir: string, fn: () => T): T;
-
-declare function encodeSourceToken(payload: SourceTokenPayload): string;
-declare function decodeSourceToken(token: string): SourceTokenPayload | null;
-/**
- * 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).
- */
-declare function appendEventToJournal(boardDir: string, event: GraphEvent): void;
-/**
- * Read journal entries after the given ID. Pure file read, no mutation.
- */
-declare function getUndrainedEntries(boardDir: string, lastDrainedId: string): JournalEntry[];
-/**
- * Run one lock-guarded processing pass for this board.
- *
- * GUARANTEE (single-pass only):
- * - At most one process performs this pass at a time (board lock).
- * - If lock is acquired, exactly one drain/apply/save cycle is executed.
- * - If lock is busy, returns false immediately (no waiting).
- *
- * This function does NOT guarantee full settlement; it only advances the baton
- * by one cycle in the relay model.
- */
-declare function processAccumulatedEvents(boardDir: string): Promise<boolean>;
-/**
- * Schedule continued draining until the board eventually settles.
- *
- * GUARANTEE (system-level eventual progress):
- * - Default behavior launches a detached background worker process that runs
- *   `process-accumulated-events --inline-loop`.
- * - Returns quickly to caller; does not synchronously wait for settlement.
- * - Under relay assumptions, pending entries eventually drain to zero:
- *   1) at least one runner continues, 2) no crash/forced exit in relay window,
- *   3) lock remains healthy, 4) new events do not arrive forever.
- *
- * INTERNAL MODE:
- * - `inlineLoop: true` executes the while(pending) loop in the current process.
- * - Used by the worker command to avoid recursive worker spawning.
- */
-declare function processAccumulatedEventsInfinitePass(boardDir: string, settleDelayMs?: number, options?: {
-    inlineLoop?: boolean;
-}): Promise<boolean>;
-/**
- * Forced drain entrypoint: first run one immediate pass, then delegate to
- * infinite-pass continuation.
- *
- * GUARANTEE:
- * - In default mode, this guarantees immediate forward progress (single pass)
- *   and guaranteed scheduling of eventual continuation (background worker).
- * - In `inlineLoop` mode, this runs full in-process settle loop and returns
- *   only after pending reaches zero (or lock contention aborts loop).
- */
-declare function processAccumulatedEventsForced(boardDir: string, options?: {
-    inlineLoop?: boolean;
-}): Promise<void>;
-type BoardLiveCard = LiveCard;
-/**
- * Transform a LiveCard into a TaskConfig for the reactive graph.
- *
- * Every card gets handler: 'card-handler'.
- * The handler inspects the card and decides what to do:
- * run compute, invoke source_defs.
- */
-declare function liveCardToTaskConfig(card: BoardLiveCard): TaskConfig;
-declare function cli(argv: string[]): Promise<void>;
-
-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

@@ -1,179 +0,0 @@
-import { b as LiveGraphSnapshot, L as LiveGraph } from '../types-CoW0gQl3.js';
-import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-EQjytzI_.js';
-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.
- */
-
-/** Envelope stored in board-graph.json — wraps the LiveGraph snapshot with journal pointer. */
-interface BoardEnvelope {
-    lastDrainedJournalId: string;
-    graph: LiveGraphSnapshot;
-}
-interface JournalEntry {
-    id: string;
-    event: GraphEvent;
-}
-declare class BoardJournal implements Journal {
-    private readonly journalPath;
-    private lastDrainedId;
-    constructor(journalPath: string, lastDrainedJournalId: string);
-    append(event: GraphEvent): void;
-    drain(): GraphEvent[];
-    get size(): number;
-    get lastDrainedJournalId(): string;
-}
-interface CardInventoryEntry {
-    cardId: string;
-    cardFilePath: string;
-    addedAt: string;
-}
-interface CardInventoryIndex {
-    byCardId: Map<string, CardInventoryEntry>;
-    byCardPath: Map<string, CardInventoryEntry>;
-}
-declare function readCardInventory(boardDir: string): CardInventoryEntry[];
-declare function lookupCardPath(boardDir: string, cardId: string): string | null;
-declare function appendCardInventory(boardDir: string, entry: CardInventoryEntry): void;
-declare function buildCardInventoryIndex(boardDir: string): CardInventoryIndex;
-/**
- * Initialize a board directory.
- * - Dir doesn't exist → create it, write empty board-graph.json
- * - Dir exists + valid board-graph.json → no-op, return 'exists'
- * - Dir exists + non-empty (no valid board-graph.json) → throw
- */
-declare function initBoard(dir: string): 'created' | 'exists';
-declare function loadBoardEnvelope(dir: string): BoardEnvelope;
-declare function loadBoard(dir: string): LiveGraph;
-declare function saveBoard(dir: string, rg: ReactiveGraph, journal: BoardJournal): void;
-/**
- * Acquire an exclusive lock on the board, run `fn`, then release.
- * Uses proper-lockfile on board-graph.json.
- */
-declare function withBoardLock<T>(boardDir: string, fn: () => T): T;
-
-declare function encodeSourceToken(payload: SourceTokenPayload): string;
-declare function decodeSourceToken(token: string): SourceTokenPayload | null;
-/**
- * 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).
- */
-declare function appendEventToJournal(boardDir: string, event: GraphEvent): void;
-/**
- * Read journal entries after the given ID. Pure file read, no mutation.
- */
-declare function getUndrainedEntries(boardDir: string, lastDrainedId: string): JournalEntry[];
-/**
- * Run one lock-guarded processing pass for this board.
- *
- * GUARANTEE (single-pass only):
- * - At most one process performs this pass at a time (board lock).
- * - If lock is acquired, exactly one drain/apply/save cycle is executed.
- * - If lock is busy, returns false immediately (no waiting).
- *
- * This function does NOT guarantee full settlement; it only advances the baton
- * by one cycle in the relay model.
- */
-declare function processAccumulatedEvents(boardDir: string): Promise<boolean>;
-/**
- * Schedule continued draining until the board eventually settles.
- *
- * GUARANTEE (system-level eventual progress):
- * - Default behavior launches a detached background worker process that runs
- *   `process-accumulated-events --inline-loop`.
- * - Returns quickly to caller; does not synchronously wait for settlement.
- * - Under relay assumptions, pending entries eventually drain to zero:
- *   1) at least one runner continues, 2) no crash/forced exit in relay window,
- *   3) lock remains healthy, 4) new events do not arrive forever.
- *
- * INTERNAL MODE:
- * - `inlineLoop: true` executes the while(pending) loop in the current process.
- * - Used by the worker command to avoid recursive worker spawning.
- */
-declare function processAccumulatedEventsInfinitePass(boardDir: string, settleDelayMs?: number, options?: {
-    inlineLoop?: boolean;
-}): Promise<boolean>;
-/**
- * Forced drain entrypoint: first run one immediate pass, then delegate to
- * infinite-pass continuation.
- *
- * GUARANTEE:
- * - In default mode, this guarantees immediate forward progress (single pass)
- *   and guaranteed scheduling of eventual continuation (background worker).
- * - In `inlineLoop` mode, this runs full in-process settle loop and returns
- *   only after pending reaches zero (or lock contention aborts loop).
- */
-declare function processAccumulatedEventsForced(boardDir: string, options?: {
-    inlineLoop?: boolean;
-}): Promise<void>;
-type BoardLiveCard = LiveCard;
-/**
- * Transform a LiveCard into a TaskConfig for the reactive graph.
- *
- * Every card gets handler: 'card-handler'.
- * The handler inspects the card and decides what to do:
- * run compute, invoke source_defs.
- */
-declare function liveCardToTaskConfig(card: BoardLiveCard): TaskConfig;
-declare function cli(argv: string[]): Promise<void>;
-
-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 };