@aperant/framework 0.6.2

package/dist/cli/wfrun/dag.d.mts

@@ -0,0 +1,28 @@
+/**
+ * DFS-based cycle detector. Returns the offending path (array of ids ending
+ * at the start of the cycle) or `null` if the graph is acyclic.
+ * @param {Array<{id: string, depends_on?: string[]}>} nodes
+ * @returns {string[] | null}
+ */
+export function detectNodeCycle(nodes: Array<{
+    id: string;
+    depends_on?: string[];
+}>): string[] | null;
+/**
+ * Kahn's algorithm wave grouping. Each wave is the set of nodes whose deps
+ * are entirely satisfied by earlier waves. Within a wave, nodes are sorted
+ * by `id`.
+ * @param {Array<{id: string, depends_on?: string[]}>} nodes
+ * @returns {{ok: true, waves: any[][]} | {ok: false, cycle: string[]}}
+ */
+export function resolveWaves(nodes: Array<{
+    id: string;
+    depends_on?: string[];
+}>): {
+    ok: true;
+    waves: any[][];
+} | {
+    ok: false;
+    cycle: string[];
+};
+//# sourceMappingURL=dag.d.mts.map

package/dist/cli/wfrun/dag.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.mts","sourceRoot":"","sources":["../../../src/cli/wfrun/dag.mjs"],"names":[],"mappings":"AAwBA;;;;;GAKG;AACH,uCAHW,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,GACxC,MAAM,EAAE,GAAG,IAAI,CAuC3B;AAED;;;;;;GAMG;AACH,oCAHW,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,GACxC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAqCrE"}

package/dist/cli/wfrun/dag.mjs

@@ -0,0 +1,115 @@
+/**
+ * wfrun/dag.mjs — Topological wave grouping + cycle detection for C17 workflows.
+ *
+ * resolveWaves(nodes) returns `{ok: true, waves}` (Node[][] — wave = set of
+ * nodes with all deps satisfied by earlier waves) or `{ok: false, cycle}` when
+ * the graph is cyclic. Nodes within a wave are sorted by `id` for determinism.
+ *
+ * detectNodeCycle(nodes) is exposed for direct use — it mirrors
+ * src/cli/graph/depends-on.mjs detectDependsOnCycle but walks a node-id
+ * adjacency list (no task_id scoping).
+ */
+/**
+ * Build a Map<id, string[]> of forward edges (id → deps it waits on).
+ * @param {Array<{id: string, depends_on?: string[]}>} nodes
+ */
+function buildAdj(nodes) {
+    const adj = new Map();
+    for (const node of nodes) {
+        adj.set(node.id, [...(node.depends_on ?? [])]);
+    }
+    return adj;
+}
+/**
+ * DFS-based cycle detector. Returns the offending path (array of ids ending
+ * at the start of the cycle) or `null` if the graph is acyclic.
+ * @param {Array<{id: string, depends_on?: string[]}>} nodes
+ * @returns {string[] | null}
+ */
+export function detectNodeCycle(nodes) {
+    const adj = buildAdj(nodes);
+    const WHITE = 0;
+    const GRAY = 1;
+    const BLACK = 2;
+    const color = new Map();
+    for (const id of adj.keys())
+        color.set(id, WHITE);
+    const stack = [];
+    let cycle = null;
+    function visit(u) {
+        if (cycle)
+            return;
+        color.set(u, GRAY);
+        stack.push(u);
+        for (const v of adj.get(u) ?? []) {
+            if (cycle)
+                return;
+            const c = color.get(v);
+            if (c === GRAY) {
+                // v is on current stack → cycle from v to current u then back to v
+                const idx = stack.indexOf(v);
+                cycle = [...stack.slice(idx), v];
+                return;
+            }
+            if (c === WHITE)
+                visit(v);
+        }
+        stack.pop();
+        color.set(u, BLACK);
+    }
+    // Iterate ids in stable order for deterministic cycle reporting.
+    const ids = [...adj.keys()].sort();
+    for (const id of ids) {
+        if (cycle)
+            break;
+        if (color.get(id) === WHITE)
+            visit(id);
+    }
+    return cycle;
+}
+/**
+ * Kahn's algorithm wave grouping. Each wave is the set of nodes whose deps
+ * are entirely satisfied by earlier waves. Within a wave, nodes are sorted
+ * by `id`.
+ * @param {Array<{id: string, depends_on?: string[]}>} nodes
+ * @returns {{ok: true, waves: any[][]} | {ok: false, cycle: string[]}}
+ */
+export function resolveWaves(nodes) {
+    const cycle = detectNodeCycle(nodes);
+    if (cycle)
+        return { ok: false, cycle };
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    const remainingDeps = new Map();
+    for (const n of nodes) {
+        remainingDeps.set(n.id, new Set(n.depends_on ?? []));
+    }
+    const waves = [];
+    const placed = new Set();
+    while (placed.size < nodes.length) {
+        const ready = [];
+        for (const n of nodes) {
+            if (placed.has(n.id))
+                continue;
+            const deps = remainingDeps.get(n.id);
+            let allPlaced = true;
+            for (const d of deps) {
+                if (!placed.has(d)) {
+                    allPlaced = false;
+                    break;
+                }
+            }
+            if (allPlaced)
+                ready.push(n);
+        }
+        if (ready.length === 0) {
+            // Should be unreachable — cycle detected above.
+            return { ok: false, cycle: [...nodes.filter((n) => !placed.has(n.id)).map((n) => n.id)] };
+        }
+        ready.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+        waves.push(ready.map((n) => byId.get(n.id)));
+        for (const n of ready)
+            placed.add(n.id);
+    }
+    return { ok: true, waves };
+}
+//# sourceMappingURL=dag.mjs.map

package/dist/cli/wfrun/dag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.mjs","sourceRoot":"","sources":["../../../src/cli/wfrun/dag.mjs"],"names":[],"mappings":"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"}

package/dist/cli/wfrun/interpolate.d.mts

@@ -0,0 +1,48 @@
+/**
+ * Enumerate all `${…}` reference paths in a template string.
+ * Escaped `\${…}` tokens are skipped.
+ * @param {string} template
+ * @returns {string[]}
+ */
+export function collectReferences(template: string): string[];
+/**
+ * Interpolate a single string template.
+ * @param {string} template
+ * @param {object} context { inputs: {...}, <nodeId>: { outputs: {...} }, ... }
+ * @param {{mode?: 'run'|'plan'}} [opts]
+ * @returns {string}
+ */
+export function interpolate(template: string, context: object, opts?: {
+    mode?: "run" | "plan";
+}): string;
+/**
+ * Deep-interpolate every string leaf of a node body. Returns a new node —
+ * input is not mutated. Recurses into plain objects and arrays only.
+ * @param {object} node
+ * @param {object} context
+ * @param {{mode?: 'run'|'plan'}} [opts]
+ */
+export function interpolateNode(node: object, context: object, opts?: {
+    mode?: "run" | "plan";
+}): any;
+/**
+ * wfrun/interpolate.mjs — String-substitution helpers for C17 workflows.
+ *
+ * Grammar (literal path lookup only — no expressions, filters, or defaulting):
+ *   ${inputs.<name>}
+ *   ${<nodeId>.outputs.<key>}
+ *
+ * Escaping: `\${…}` is left as-is (the backslash is stripped). A bare `$`
+ * not followed by `{` is left alone.
+ *
+ * Modes:
+ *   'run'  — every reference must resolve; missing paths throw InterpolationError.
+ *   'plan' — unknown `<nodeId>.outputs.*` refs are left as literal `${…}`
+ *            tokens so the plan can be emitted before agent nodes have run.
+ *            `inputs.*` must still resolve.
+ */
+export class InterpolationError extends Error {
+    constructor(message: any, path: any);
+    path: any;
+}
+//# sourceMappingURL=interpolate.d.mts.map

package/dist/cli/wfrun/interpolate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.mts","sourceRoot":"","sources":["../../../src/cli/wfrun/interpolate.mjs"],"names":[],"mappings":"AA2BA;;;;;GAKG;AACH,4CAHW,MAAM,GACJ,MAAM,EAAE,CAUpB;AAkBD;;;;;;GAMG;AACH,sCALW,MAAM,WACN,MAAM,SACN;IAAC,IAAI,CAAC,EAAE,KAAK,GAAC,MAAM,CAAA;CAAC,GACnB,MAAM,CAmBlB;AAED;;;;;;GAMG;AACH,sCAJW,MAAM,WACN,MAAM,SACN;IAAC,IAAI,CAAC,EAAE,KAAK,GAAC,MAAM,CAAA;CAAC,OAI/B;AA9FD;;;;;;;;;;;;;;;GAeG;AAEH;IACC,qCAIC;IADA,UAAgB;CAEjB"}

package/dist/cli/wfrun/interpolate.mjs

@@ -0,0 +1,112 @@
+/**
+ * wfrun/interpolate.mjs — String-substitution helpers for C17 workflows.
+ *
+ * Grammar (literal path lookup only — no expressions, filters, or defaulting):
+ *   ${inputs.<name>}
+ *   ${<nodeId>.outputs.<key>}
+ *
+ * Escaping: `\${…}` is left as-is (the backslash is stripped). A bare `$`
+ * not followed by `{` is left alone.
+ *
+ * Modes:
+ *   'run'  — every reference must resolve; missing paths throw InterpolationError.
+ *   'plan' — unknown `<nodeId>.outputs.*` refs are left as literal `${…}`
+ *            tokens so the plan can be emitted before agent nodes have run.
+ *            `inputs.*` must still resolve.
+ */
+export class InterpolationError extends Error {
+    constructor(message, path) {
+        super(message);
+        this.name = 'InterpolationError';
+        this.path = path;
+    }
+}
+const REF_RE = /(\\?)\$\{([^}]+)\}/g;
+/**
+ * Enumerate all `${…}` reference paths in a template string.
+ * Escaped `\${…}` tokens are skipped.
+ * @param {string} template
+ * @returns {string[]}
+ */
+export function collectReferences(template) {
+    if (typeof template !== 'string')
+        return [];
+    const refs = [];
+    for (const m of template.matchAll(REF_RE)) {
+        if (m[1] === '\\')
+            continue;
+        refs.push(m[2].trim());
+    }
+    return refs;
+}
+/**
+ * Resolve a single dotted path against a context object.
+ * @returns {{ok: true, value: string} | {ok: false}}
+ */
+function lookup(path, context) {
+    const parts = path.split('.').map((p) => p.trim());
+    let cur = context;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return { ok: false };
+        if (!Object.hasOwn(cur, part))
+            return { ok: false };
+        cur = cur[part];
+    }
+    if (cur == null)
+        return { ok: false };
+    return { ok: true, value: String(cur) };
+}
+/**
+ * Interpolate a single string template.
+ * @param {string} template
+ * @param {object} context { inputs: {...}, <nodeId>: { outputs: {...} }, ... }
+ * @param {{mode?: 'run'|'plan'}} [opts]
+ * @returns {string}
+ */
+export function interpolate(template, context, opts = {}) {
+    const mode = opts.mode ?? 'run';
+    if (typeof template !== 'string')
+        return template;
+    return template.replace(REF_RE, (match, esc, expr) => {
+        if (esc === '\\')
+            return match.slice(1); // strip the backslash, emit ${…}
+        const path = expr.trim();
+        const res = lookup(path, context);
+        if (res.ok)
+            return res.value;
+        if (mode === 'plan') {
+            // Only allow deferring node-output refs; inputs.* must resolve now.
+            if (path.startsWith('inputs.')) {
+                throw new InterpolationError(`unresolved input reference: \${${path}}`, path);
+            }
+            return match;
+        }
+        throw new InterpolationError(`unresolved reference: \${${path}}`, path);
+    });
+}
+/**
+ * Deep-interpolate every string leaf of a node body. Returns a new node —
+ * input is not mutated. Recurses into plain objects and arrays only.
+ * @param {object} node
+ * @param {object} context
+ * @param {{mode?: 'run'|'plan'}} [opts]
+ */
+export function interpolateNode(node, context, opts = {}) {
+    return walk(node, context, opts);
+}
+function walk(value, context, opts) {
+    if (typeof value === 'string')
+        return interpolate(value, context, opts);
+    if (Array.isArray(value))
+        return value.map((v) => walk(v, context, opts));
+    if (value != null && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = walk(v, context, opts);
+        }
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=interpolate.mjs.map

package/dist/cli/wfrun/interpolate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.mjs","sourceRoot":"","sources":["../../../src/cli/wfrun/interpolate.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,IAAI;QACxB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;CACD;AAED,MAAM,MAAM,GAAG,qBAAqB,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAQ;IACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IAC3C,MAAM,IAAI,GAAG,EAAE,CAAA;IACf,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,SAAQ;QAC3B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,IAAI,EAAE,OAAO;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAClD,IAAI,GAAG,GAAG,OAAO,CAAA;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;QAChE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;QACnD,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;IACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAA;IAC/B,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACjD,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACpD,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAC,iCAAiC;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACjC,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,GAAG,CAAC,KAAK,CAAA;QAC5B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrB,oEAAoE;YACpE,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,kBAAkB,CAAC,kCAAkC,IAAI,GAAG,EAAE,IAAI,CAAC,CAAA;YAC9E,CAAC;YACD,OAAO,KAAK,CAAA;QACb,CAAC;QACD,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,IAAI,GAAG,EAAE,IAAI,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE;IACvD,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IACvE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IACzE,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,EAAE,CAAA;QACd,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,GAAG,CAAA;IACX,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/cli/wfrun/parse.d.mts

@@ -0,0 +1,70 @@
+/**
+ * Parse a YAML workflow file from disk.
+ * @param {string} absPath absolute path to the YAML file
+ * @returns {{ok: true, workflow: any} | {ok: false, errors: {path: string, message: string}[]}}
+ */
+export function parseWorkflowFile(absPath: string): {
+    ok: true;
+    workflow: any;
+} | {
+    ok: false;
+    errors: {
+        path: string;
+        message: string;
+    }[];
+};
+/**
+ * Parse a YAML workflow from a string (exposed for tests).
+ * @param {string} text raw YAML
+ * @param {string} [source] optional label for error messages
+ */
+export function parseWorkflowString(text: string, source?: string): {
+    ok: boolean;
+    errors: {
+        path: string;
+        message: string;
+    }[];
+    workflow?: undefined;
+} | {
+    ok: boolean;
+    workflow: {
+        apiVersion: "aperant.dev/v1";
+        kind: "Workflow";
+        metadata: {
+            id: string;
+            description?: string | undefined;
+        };
+        inputs: {
+            name: string;
+            required: boolean;
+            default?: string | undefined;
+            description?: string | undefined;
+        }[];
+        nodes: ({
+            id: string;
+            kind: "skill";
+            skill: string;
+            depends_on: string[];
+            outputs: string[];
+            prompt?: string | undefined;
+        } | {
+            id: string;
+            kind: "agent";
+            agent: string;
+            depends_on: string[];
+            outputs: string[];
+            prompt?: string | undefined;
+        } | {
+            id: string;
+            kind: "tool";
+            run: {
+                command: string;
+                args: string[];
+            };
+            depends_on: string[];
+            outputs: string[];
+        })[];
+    };
+    errors?: undefined;
+};
+//# sourceMappingURL=parse.d.mts.map

package/dist/cli/wfrun/parse.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.mts","sourceRoot":"","sources":["../../../src/cli/wfrun/parse.mjs"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,2CAHW,MAAM,GACJ;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,EAAE,CAAA;CAAC,CAU9F;AAED;;;;GAIG;AACH,0CAHW,MAAM,WACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyEhB"}

package/dist/cli/wfrun/parse.mjs

@@ -0,0 +1,109 @@
+/**
+ * wfrun/parse.mjs — Load + validate a C17 declarative YAML workflow file.
+ *
+ * Pipeline:
+ *   1. readFileSync(UTF-8) → yaml.parse → raw object
+ *   2. WorkflowSchema.safeParse(raw) → structural validation
+ *   3. extra semantic checks: duplicate node ids, dangling depends_on targets.
+ *
+ * Returns a tagged result:
+ *   { ok: true, workflow }           — validated and normalized
+ *   { ok: false, errors: [...] }     — array of { path: string, message: string }
+ *
+ * parse.mjs does NOT perform DAG cycle detection or interpolation validation
+ * — those live in dag.mjs and run.mjs respectively.
+ */
+import { readFileSync } from 'node:fs';
+import * as YAML from 'yaml';
+import { WorkflowSchema } from './schema.mjs';
+/**
+ * Parse a YAML workflow file from disk.
+ * @param {string} absPath absolute path to the YAML file
+ * @returns {{ok: true, workflow: any} | {ok: false, errors: {path: string, message: string}[]}}
+ */
+export function parseWorkflowFile(absPath) {
+    let raw;
+    try {
+        raw = readFileSync(absPath, 'utf-8');
+    }
+    catch (err) {
+        return { ok: false, errors: [{ path: absPath, message: `cannot read file: ${err.message}` }] };
+    }
+    return parseWorkflowString(raw, absPath);
+}
+/**
+ * Parse a YAML workflow from a string (exposed for tests).
+ * @param {string} text raw YAML
+ * @param {string} [source] optional label for error messages
+ */
+export function parseWorkflowString(text, source = '<inline>') {
+    let parsed;
+    try {
+        parsed = YAML.parse(text);
+    }
+    catch (err) {
+        return { ok: false, errors: [{ path: source, message: `YAML parse error: ${err.message}` }] };
+    }
+    if (parsed == null || typeof parsed !== 'object') {
+        return {
+            ok: false,
+            errors: [{ path: source, message: 'workflow root must be a YAML mapping' }],
+        };
+    }
+    const result = WorkflowSchema.safeParse(parsed);
+    if (!result.success) {
+        const errors = result.error.issues.map((issue) => ({
+            path: issue.path.length === 0 ? '<root>' : issue.path.join('.'),
+            message: issue.message,
+        }));
+        return { ok: false, errors };
+    }
+    const workflow = result.data;
+    const errors = [];
+    // Duplicate node ids
+    const seen = new Map();
+    for (let i = 0; i < workflow.nodes.length; i++) {
+        const node = workflow.nodes[i];
+        if (seen.has(node.id)) {
+            errors.push({
+                path: `nodes[${i}].id`,
+                message: `duplicate node id "${node.id}" (first seen at nodes[${seen.get(node.id)}])`,
+            });
+        }
+        else {
+            seen.set(node.id, i);
+        }
+    }
+    // Dangling depends_on references (also catch self-loop here for clarity)
+    const nodeIds = new Set(workflow.nodes.map((n) => n.id));
+    for (let i = 0; i < workflow.nodes.length; i++) {
+        const node = workflow.nodes[i];
+        for (let j = 0; j < (node.depends_on ?? []).length; j++) {
+            const dep = node.depends_on[j];
+            if (!nodeIds.has(dep)) {
+                errors.push({
+                    path: `nodes[${i}].depends_on[${j}]`,
+                    message: `unknown node id "${dep}" referenced by node "${node.id}"`,
+                });
+            }
+        }
+    }
+    // Duplicate input names
+    const seenInputs = new Map();
+    for (let i = 0; i < (workflow.inputs ?? []).length; i++) {
+        const input = workflow.inputs[i];
+        if (seenInputs.has(input.name)) {
+            errors.push({
+                path: `inputs[${i}].name`,
+                message: `duplicate input name "${input.name}"`,
+            });
+        }
+        else {
+            seenInputs.set(input.name, i);
+        }
+    }
+    if (errors.length > 0)
+        return { ok: false, errors };
+    return { ok: true, workflow };
+}
+//# sourceMappingURL=parse.mjs.map

package/dist/cli/wfrun/parse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.mjs","sourceRoot":"","sources":["../../../src/cli/wfrun/parse.mjs"],"names":[],"mappings":"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"}

package/dist/cli/wfrun/run.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Parse --input k=v flags (repeatable) from an extraArgs array.
+ * Malformed invocations (missing value, missing '=') are surfaced as
+ * structured errors instead of being silently dropped.
+ *
+ * @param {string[]} extraArgs
+ * @returns {{ok: true, inputs: Record<string, string>} | {ok: false, errors: string[]}}
+ */
+export function parseInputFlags(extraArgs: string[]): {
+    ok: true;
+    inputs: Record<string, string>;
+} | {
+    ok: false;
+    errors: string[];
+};
+/**
+ * Generate a run-id: wf-YYYYMMDD-HHmmss-<4 hex>.
+ */
+export function generateRunId(now?: Date): string;
+/**
+ * Main entrypoint dispatched by cmdWfrun.
+ * @param {{subcommand: 'validate'|'plan'|'run', workflowPath: string, projectDir: string, inputs: Record<string,string>, flags?: Map<string,any>}} params
+ * @returns {{ok: true, result: object} | {ok: false, errors: any[]}}
+ */
+export function runWfrun({ subcommand, workflowPath, projectDir, inputs }: {
+    subcommand: "validate" | "plan" | "run";
+    workflowPath: string;
+    projectDir: string;
+    inputs: Record<string, string>;
+    flags?: Map<string, any>;
+}): {
+    ok: true;
+    result: object;
+} | {
+    ok: false;
+    errors: any[];
+};
+export { interpolate };
+import { interpolate } from './interpolate.mjs';
+//# sourceMappingURL=run.d.mts.map

package/dist/cli/wfrun/run.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.mts","sourceRoot":"","sources":["../../../src/cli/wfrun/run.mjs"],"names":[],"mappings":"AAmFA;;;;;;;GAOG;AACH,2CAHW,MAAM,EAAE,GACN;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAC,CAuBtF;AA8GD;;GAEG;AACH,kDAMC;AA0CD;;;;GAIG;AACH,2EAHW;IAAC,UAAU,EAAE,UAAU,GAAC,MAAM,GAAC,KAAK,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAC,GAAG,CAAC,CAAA;CAAC,GACrI;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,EAAE,CAAA;CAAC,CA0NnE;;4BA5cM,mBAAmB"}