@diff-review-system/drs 4.0.1 → 5.0.0-rc.1

package/dist/lib/workflow/artifact-store.js

@@ -0,0 +1,121 @@
+import { createHash } from 'crypto';
+import { mkdir, readFile, writeFile } from 'fs/promises';
+import { dirname, join } from 'path';
+import { resolveWithinWorkingDir } from '../path-utils.js';
+export const DEFAULT_ARTIFACT_POLICY = {
+    mode: 'ref-large-values',
+    inlineMaxBytes: 64 * 1024,
+};
+export function isArtifactRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.kind === 'artifact-ref' &&
+        typeof value.key === 'string' &&
+        typeof value.uri === 'string');
+}
+/**
+ * Decide whether a value should stay inline or be offloaded to the store.
+ */
+export function shouldInline(serializedSize, policy) {
+    if (policy.mode === 'inline-only')
+        return true;
+    if (policy.mode === 'ref-all-values')
+        return false;
+    return serializedSize <= policy.inlineMaxBytes;
+}
+function serialize(value) {
+    if (typeof value === 'string') {
+        return { bytes: Buffer.from(value, 'utf-8'), contentType: 'text/plain' };
+    }
+    return {
+        bytes: Buffer.from(JSON.stringify(value, null, 2), 'utf-8'),
+        contentType: 'application/json',
+    };
+}
+function deserialize(buf, contentType) {
+    const text = buf.toString('utf-8');
+    if (contentType === 'application/json') {
+        return JSON.parse(text);
+    }
+    if (contentType === 'text/plain') {
+        return text;
+    }
+    // Fallback: try JSON, then treat as string.
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function sha256(buf) {
+    return createHash('sha256').update(buf).digest('hex');
+}
+function slugSegment(value, fallback) {
+    const raw = value === undefined || value === '' ? fallback : String(value);
+    const slug = raw
+        .trim()
+        .replace(/[^A-Za-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug || fallback;
+}
+function sanitizeKey(key) {
+    const segments = key.split('/').map((seg) => slugSegment(seg, 'segment'));
+    if (segments.some((seg) => seg === '..' || seg === '.')) {
+        throw new Error(`Refusing to put artifact with unsafe key: ${key}`);
+    }
+    return segments.join('/');
+}
+/**
+ * Local filesystem artifact store.
+ *
+ * Persists artifacts under `.drs/artifacts/temporal/<namespace>/<key>` within
+ * the specified working directory. The `uri` in returned refs is a relative
+ * path so the store works consistently across machines when the working
+ * directory matches.
+ */
+export class LocalWorkflowArtifactStore {
+    workingDir;
+    baseDir;
+    constructor(workingDir, namespace = 'default') {
+        this.workingDir = workingDir;
+        const slug = slugSegment(namespace, 'default');
+        this.baseDir = `.drs/artifacts/temporal/${slug}`;
+    }
+    async put(key, value, metadata) {
+        const { bytes, contentType } = serialize(value);
+        const resolvedContentType = metadata?.contentType ?? contentType;
+        const hash = sha256(bytes);
+        const safeKey = sanitizeKey(key);
+        const relativePath = join(this.baseDir, `${safeKey}.json`);
+        const fullPath = resolveWithinWorkingDir(this.workingDir, relativePath, 'write');
+        await mkdir(dirname(fullPath), { recursive: true });
+        await writeFile(fullPath, bytes, 'utf-8');
+        return {
+            kind: 'artifact-ref',
+            key,
+            uri: relativePath,
+            contentType: resolvedContentType,
+            sizeBytes: bytes.length,
+            sha256: hash,
+        };
+    }
+    async get(ref) {
+        const fullPath = resolveWithinWorkingDir(this.workingDir, ref.uri, 'read');
+        const bytes = await readFile(fullPath);
+        return deserialize(bytes, ref.contentType);
+    }
+    async exists(ref) {
+        try {
+            const fullPath = resolveWithinWorkingDir(this.workingDir, ref.uri, 'read');
+            await readFile(fullPath);
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return false;
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/lib/workflow/artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../../../src/lib/workflow/artifact-store.ts"],"names":[],"mappings":"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"}

package/dist/lib/workflow/compiled-plan.d.ts

@@ -0,0 +1,87 @@
+import type { DRSConfig, WorkflowNodeConfig } from '../config.js';
+/**
+ * Workflow node as it appears in a compiled plan.
+ *
+ * This is currently an API-facing alias for WorkflowNodeConfig so future plan
+ * schema changes can evolve independently from raw workflow config types.
+ */
+export type CompiledWorkflowNode = WorkflowNodeConfig;
+/**
+ * A DRS workflow control-flow segment expressed as JSON-serializable data.
+ *
+ * - DAG segments list their node ids plus, when a control node routes into
+ *   them, the set of active node ids that should actually execute (inactive
+ *   node ids are skipped by the runner). Active ids are absent for plain DAG
+ *   segments with no gating control node.
+ * - Control segments record the controlling node id.
+ */
+export type CompiledWorkflowSegment = {
+    type: 'dag';
+    nodeIds: string[];
+    activeNodeIds?: string[];
+} | {
+    type: 'control';
+    nodeId: string;
+};
+/**
+ * Metadata for a single workflow input, normalized to a plain object so the
+ * compiled plan is JSON-serializable even when the original input is declared
+ * as a bare string.
+ */
+export interface CompiledWorkflowInput {
+    type: 'string' | 'boolean' | 'number' | 'enum';
+    value?: string;
+    file?: string;
+    default?: string | number | boolean;
+    required?: boolean;
+    values?: Array<string | number | boolean>;
+    description?: string;
+}
+/**
+ * A fully resolved, JSON-serializable description of a workflow ready to be
+ * handed to an executor (local or Temporal). It carries everything needed to
+ * schedule nodes without reloading repo config: normalized nodes, execution
+ * order, waves, control-flow segments, input metadata, and the output key.
+ *
+ * Resolved input *values* are intentionally not part of the plan; they are
+ * supplied separately at run time so the same plan can dispatch multiple runs
+ * with different inputs.
+ */
+export interface CompiledWorkflowPlan {
+    /** Schema version so executors can evolve the shape safely. */
+    schemaVersion: 1;
+    /** Workflow name as resolved from config.workflows. */
+    workflowName: string;
+    /** Optional human-readable description. */
+    description?: string;
+    /** Origin of the workflow definition: packaged or project. */
+    source: 'packaged' | 'project';
+    /** Project workflows overriding a packaged workflow of the same name. */
+    overridesPackaged: boolean;
+    /** Workflow-level output artifact key. May be undefined (last node output). */
+    output?: string;
+    /** Workflow input metadata keyed by input name. */
+    inputs: Record<string, CompiledWorkflowInput>;
+    /** Normalized nodes keyed by id, identical in shape to WorkflowNodeConfig. */
+    nodes: Record<string, CompiledWorkflowNode>;
+    /** Dependency-ordered node ids (topological). */
+    executionOrder: string[];
+    /** Wave grouping for parallel DAG execution. */
+    waves: string[][];
+    /** Control-flow segments for control-bearing workflows; empty for DAG-only. */
+    segments: CompiledWorkflowSegment[];
+    /** True when the workflow uses any control (loop/switch/end/passThrough) node. */
+    hasControlNodes: boolean;
+    /** Id of the last node in execution order, used when output is undefined. */
+    lastNodeId: string;
+}
+/**
+ * Subset of {@link WorkflowRunOptions} relevant to plan compilation. The
+ * workingDir is used only to resolve workflow source info (packaged vs.
+ * project) and does not become part of the serialized plan.
+ */
+export interface CompileWorkflowPlanOptions {
+    workingDir?: string;
+}
+export declare function compileWorkflowPlan(config: DRSConfig, workflowName: string, options?: CompileWorkflowPlanOptions): CompiledWorkflowPlan;
+//# sourceMappingURL=compiled-plan.d.ts.map

package/dist/lib/workflow/compiled-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-plan.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/compiled-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAGT,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAWtB;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,aAAa,EAAE,CAAC,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,yEAAyE;IACzE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9C,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC5C,iDAAiD;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,kFAAkF;IAClF,eAAe,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CAmDtB"}

package/dist/lib/workflow/compiled-plan.js

@@ -0,0 +1,62 @@
+import { loadWorkflowSourceInfo } from '../config.js';
+import { getWorkflowExecutionOrder, getWorkflowExecutionWaves, getWorkflowNodes, hasWorkflowControlNodes, splitWorkflowSegments, } from './planning.js';
+import { getWorkflowInputConfigType } from './input.js';
+function normalizeWorkflowInput(input) {
+    if (typeof input === 'string') {
+        return { type: 'string', value: input };
+    }
+    return {
+        type: getWorkflowInputConfigType(input),
+        value: input.value,
+        file: input.file,
+        default: input.default,
+        required: input.required,
+        values: input.values,
+        description: input.description,
+    };
+}
+export function compileWorkflowPlan(config, workflowName, options = {}) {
+    const workflow = config.workflows?.[workflowName];
+    if (!workflow) {
+        throw new Error(`Unknown workflow "${workflowName}".`);
+    }
+    const workingDir = options.workingDir ?? process.cwd();
+    const sourceInfo = loadWorkflowSourceInfo(workingDir)[workflowName] ?? {
+        source: 'packaged',
+        overridesPackaged: false,
+    };
+    const nodes = getWorkflowNodes(workflowName, workflow);
+    const executionOrder = getWorkflowExecutionOrder(nodes);
+    const waves = getWorkflowExecutionWaves(nodes, executionOrder);
+    const hasControlNodes = hasWorkflowControlNodes(nodes);
+    const segments = hasControlNodes
+        ? splitWorkflowSegments(nodes, executionOrder).map((segment) => segment.type === 'control'
+            ? { type: 'control', nodeId: segment.nodeId }
+            : {
+                type: 'dag',
+                nodeIds: segment.nodeIds,
+                ...(segment.activeNodeIds
+                    ? { activeNodeIds: Array.from(segment.activeNodeIds) }
+                    : {}),
+            })
+        : [];
+    return {
+        schemaVersion: 1,
+        workflowName,
+        description: workflow.description,
+        source: sourceInfo.source,
+        overridesPackaged: sourceInfo.overridesPackaged,
+        output: workflow.output,
+        inputs: Object.fromEntries(Object.entries(workflow.inputs ?? {}).map(([name, input]) => [
+            name,
+            normalizeWorkflowInput(input),
+        ])),
+        nodes,
+        executionOrder,
+        waves,
+        segments,
+        hasControlNodes,
+        lastNodeId: executionOrder[executionOrder.length - 1] ?? '',
+    };
+}
+//# sourceMappingURL=compiled-plan.js.map

package/dist/lib/workflow/compiled-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-plan.js","sourceRoot":"","sources":["../../../src/lib/workflow/compiled-plan.ts"],"names":[],"mappings":"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"}

package/dist/lib/workflow/executor.d.ts

@@ -0,0 +1,18 @@
+import type { DRSConfig } from '../config.js';
+import type { WorkflowRunOptions, WorkflowRunResult } from './types.js';
+/**
+ * Execution backend for DRS workflows.
+ *
+ * The CLI's default backend is the local in-process executor. A Temporal
+ * executor will implement this same interface so that `drs workflow run` can
+ * dispatch through either backend without changing the workflow DSL or the
+ * result shape.
+ */
+export interface WorkflowExecutor {
+    /**
+     * Run a workflow by name using the project config and return the same
+     * `WorkflowRunResult` shape as the local executor.
+     */
+    run(config: DRSConfig, workflowName: string, options?: WorkflowRunOptions): Promise<WorkflowRunResult>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/lib/workflow/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,GAAG,CACD,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}

package/dist/lib/workflow/executor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=executor.js.map

package/dist/lib/workflow/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/lib/workflow/executor.ts"],"names":[],"mappings":""}

package/dist/lib/workflow/graph.d.ts

@@ -0,0 +1,30 @@
+import type { WorkflowConfig } from '../config.js';
+export type WorkflowGraphNodeKind = 'agent' | 'agents' | 'action' | 'control';
+export type WorkflowGraphEdgeKind = 'dependency' | 'control';
+export interface WorkflowGraphNode {
+    id: string;
+    label: string;
+    kind: WorkflowGraphNodeKind;
+    agent?: string;
+    agentsFrom?: string;
+    action?: string;
+    control?: string;
+    condition?: string;
+    output?: string;
+    writes?: string;
+}
+export interface WorkflowGraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    kind: WorkflowGraphEdgeKind;
+    label?: string;
+}
+export interface WorkflowGraph {
+    workflow: string;
+    nodes: WorkflowGraphNode[];
+    edges: WorkflowGraphEdge[];
+}
+export declare function buildWorkflowGraph(workflowName: string, workflow: WorkflowConfig): WorkflowGraph;
+export declare function formatWorkflowGraphMermaid(graph: WorkflowGraph): string;
+//# sourceMappingURL=graph.d.ts.map

package/dist/lib/workflow/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,cAAc,CAAC;AAQvE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,aAAa,CA0BhG;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAcvE"}

package/dist/lib/workflow/graph.js

@@ -0,0 +1,139 @@
+import { getNodeKind, getNodeNeeds, getWorkflowExecutionOrder, getWorkflowNodes, } from './planning.js';
+export function buildWorkflowGraph(workflowName, workflow) {
+    const nodesById = getWorkflowNodes(workflowName, workflow);
+    const orderedNodeIds = getWorkflowExecutionOrder(nodesById);
+    const edges = [];
+    for (const nodeId of orderedNodeIds) {
+        const node = nodesById[nodeId];
+        if (!node)
+            continue;
+        for (const dependency of getNodeNeeds(node)) {
+            edges.push({
+                id: `dependency:${dependency}->${nodeId}`,
+                source: dependency,
+                target: nodeId,
+                kind: 'dependency',
+            });
+        }
+        edges.push(...getWorkflowControlEdges(nodeId, node));
+    }
+    return {
+        workflow: workflowName,
+        nodes: orderedNodeIds.map((nodeId) => buildWorkflowGraphNode(nodeId, nodesById[nodeId])),
+        edges,
+    };
+}
+export function formatWorkflowGraphMermaid(graph) {
+    const lines = ['flowchart TD'];
+    for (const node of graph.nodes) {
+        lines.push(`  ${mermaidId(node.id)}${mermaidNodeShape(node)}`);
+    }
+    for (const edge of graph.edges) {
+        const label = edge.label ? `|${escapeMermaidLabel(edge.label)}|` : '';
+        const arrow = edge.kind === 'control' ? '-.->' : '-->';
+        lines.push(`  ${mermaidId(edge.source)} ${arrow}${label} ${mermaidId(edge.target)}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+function buildWorkflowGraphNode(nodeId, node) {
+    return {
+        id: nodeId,
+        label: getWorkflowGraphNodeLabel(nodeId, node),
+        kind: getNodeKind(node),
+        agent: node.agent,
+        agentsFrom: node.agentsFrom,
+        action: node.action,
+        control: node.control,
+        condition: node.if,
+        output: node.output,
+        writes: node.writes,
+    };
+}
+function getWorkflowGraphNodeLabel(nodeId, node) {
+    if (node.agent)
+        return `${nodeId}\n${node.agent}`;
+    if (node.agentsFrom)
+        return `${nodeId}\n${node.agentsFrom}`;
+    if (node.action)
+        return `${nodeId}\n${node.action}`;
+    if (node.control)
+        return `${nodeId}\n${node.control}`;
+    return nodeId;
+}
+function getWorkflowControlEdges(nodeId, node) {
+    if (node.control === 'loop') {
+        return [
+            ...(node.target
+                ? [
+                    {
+                        id: `control:${nodeId}->${node.target}:loop`,
+                        source: nodeId,
+                        target: node.target,
+                        kind: 'control',
+                        label: node.if ? `loop: ${node.if}` : 'loop',
+                    },
+                ]
+                : []),
+            ...(node.exit
+                ? [
+                    {
+                        id: `control:${nodeId}->${node.exit}:exit`,
+                        source: nodeId,
+                        target: node.exit,
+                        kind: 'control',
+                        label: 'exit',
+                    },
+                ]
+                : []),
+        ];
+    }
+    if (node.control === 'switch') {
+        return [
+            ...Object.entries(node.cases ?? {}).map(([caseLabel, target]) => ({
+                id: `control:${nodeId}->${target}:case:${caseLabel}`,
+                source: nodeId,
+                target,
+                kind: 'control',
+                label: `case ${caseLabel}`,
+            })),
+            ...(node.default
+                ? [
+                    {
+                        id: `control:${nodeId}->${node.default}:default`,
+                        source: nodeId,
+                        target: node.default,
+                        kind: 'control',
+                        label: 'default',
+                    },
+                ]
+                : []),
+        ];
+    }
+    if (node.control === 'passThrough' && node.target) {
+        return [
+            {
+                id: `control:${nodeId}->${node.target}:target`,
+                source: nodeId,
+                target: node.target,
+                kind: 'control',
+                label: 'target',
+            },
+        ];
+    }
+    return [];
+}
+function mermaidId(id) {
+    return `n_${id.replace(/[^A-Za-z0-9_]/g, '_')}`;
+}
+function mermaidNodeShape(node) {
+    const label = escapeMermaidLabel(node.label);
+    if (node.kind === 'control')
+        return `{${label}}`;
+    if (node.kind === 'agent' || node.kind === 'agents')
+        return `([${label}])`;
+    return `[${label}]`;
+}
+function escapeMermaidLabel(label) {
+    return JSON.stringify(label).slice(1, -1).replace(/"/g, '#quot;');
+}
+//# sourceMappingURL=graph.js.map

package/dist/lib/workflow/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/lib/workflow/graph.ts"],"names":[],"mappings":"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"}

package/dist/lib/workflow/input.d.ts

@@ -0,0 +1,4 @@
+import type { WorkflowInputConfig } from '../config.js';
+export type WorkflowInputConfigType = 'string' | 'boolean' | 'number' | 'enum';
+export declare function getWorkflowInputConfigType(input: WorkflowInputConfig): WorkflowInputConfigType;
+//# sourceMappingURL=input.d.ts.map

package/dist/lib/workflow/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,GAAG,uBAAuB,CAE9F"}

package/dist/lib/workflow/input.js

@@ -0,0 +1,4 @@
+export function getWorkflowInputConfigType(input) {
+    return typeof input === 'string' ? 'string' : (input.type ?? 'string');
+}
+//# sourceMappingURL=input.js.map

package/dist/lib/workflow/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/lib/workflow/input.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,0BAA0B,CAAC,KAA0B;IACnE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;AACzE,CAAC"}

package/dist/lib/workflow/node-executor.d.ts

@@ -0,0 +1,19 @@
+import type { WorkflowNodeConfig } from '../config.js';
+import type { WorkflowNodeResult, WorkflowTemplateContext } from './types.js';
+/**
+ * Boundary for side-effecting workflow node execution.
+ *
+ * Deterministic orchestration (dependency scheduling, waves, skip/condition
+ * evaluation, result assembly) lives in the workflow runner/Temporal workflow.
+ * Side effects (agents, actions, git, platform calls, file writes, artifact
+ * operations, model calls) live behind this interface so the same node
+ * execution can run either in-process or as a Temporal activity.
+ *
+ * `runNode` executes a single non-control node using `context` for template
+ * rendering and returns the node's result. Skip/condition decisions are made
+ * by the caller; `runNode` only executes nodes the caller has chosen to run.
+ */
+export interface NodeExecutor {
+    runNode(nodeId: string, node: WorkflowNodeConfig, context: WorkflowTemplateContext): Promise<WorkflowNodeResult>;
+}
+//# sourceMappingURL=node-executor.d.ts.map

package/dist/lib/workflow/node-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/node-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CACL,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/lib/workflow/node-executor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-executor.js.map

package/dist/lib/workflow/node-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.js","sourceRoot":"","sources":["../../../src/lib/workflow/node-executor.ts"],"names":[],"mappings":""}

package/dist/lib/workflow/planning.d.ts

@@ -0,0 +1,52 @@
+import type { WorkflowConfig, WorkflowNodeConfig } from '../config.js';
+import type { WorkflowNodeResult, WorkflowTemplateContext } from './types.js';
+export declare function getNodeNeeds(node: WorkflowNodeConfig): string[];
+export declare function getControlTargets(node: WorkflowNodeConfig): string[];
+export declare function validateWorkflowControlTargets(nodes: Record<string, WorkflowNodeConfig>): void;
+export declare function validateWorkflowControlRouteDirection(nodes: Record<string, WorkflowNodeConfig>, executionOrder: string[]): void;
+export declare function validateWorkflowPassThroughShape(nodeId: string, node: WorkflowNodeConfig): void;
+export declare const WORKFLOW_NODE_FIELDS: Set<string>;
+export declare const EXECUTABLE_NODE_FIELDS: Set<string>;
+export declare const CONTROL_NODE_FIELDS: Record<string, Set<string>>;
+export declare const ACTION_OPTION_FIELDS: Partial<Record<NonNullable<WorkflowNodeConfig['action']>, Set<string>>>;
+export declare function validateAllowedFields(nodeId: string, value: Record<string, unknown>, allowed: Set<string>, subject: string): void;
+export declare function validateWorkflowNodeShape(nodeId: string, node: WorkflowNodeConfig): void;
+export declare function validateWorkflowNodeKinds(nodes: Record<string, WorkflowNodeConfig>): void;
+export declare function hasWorkflowControlNodes(nodes: Record<string, WorkflowNodeConfig>): boolean;
+export declare function isPotentialWorkspaceMutation(node: WorkflowNodeConfig): boolean;
+export declare function getWorkflowExecutionOrder(nodes: Record<string, WorkflowNodeConfig>): string[];
+export declare function getWorkflowNodes(workflowName: string, workflow: WorkflowConfig): Record<string, WorkflowNodeConfig>;
+export declare function getWorkflowExecutionWaves(nodes: Record<string, WorkflowNodeConfig>, executionOrder: string[]): string[][];
+export declare function getPathValue(root: unknown, path: string): unknown;
+export declare function stringifyTemplateValue(value: unknown): string;
+export declare function renderTemplate(template: string, context: WorkflowTemplateContext): string;
+export declare function getNodeKind(node: WorkflowNodeConfig): 'agent' | 'agents' | 'action' | 'control';
+export type WorkflowSegment = {
+    type: 'dag';
+    nodeIds: string[];
+    activeNodeIds?: Set<string>;
+} | {
+    type: 'control';
+    nodeId: string;
+};
+export declare function parseWorkflowExpressionValue(value: string, context?: WorkflowTemplateContext): unknown;
+export declare function isWorkflowTruthy(value: unknown): boolean;
+export declare function normalizeWorkflowBooleanLike(value: unknown): boolean | undefined;
+export declare function compareWorkflowValues(left: unknown, operator: string, right: unknown): boolean;
+export declare function splitWorkflowExpressionOperator(expression: string, operator: '&&' | '||'): string[];
+export declare function stripWorkflowExpressionParens(expression: string): string;
+export declare function evaluateWorkflowExpressionText(rendered: string, context: WorkflowTemplateContext): boolean;
+export declare function evaluateWorkflowExpression(expression: string, context: WorkflowTemplateContext): boolean;
+export declare function splitWorkflowSegments(workflowNodes: Record<string, WorkflowNodeConfig>, executionOrder: string[]): WorkflowSegment[];
+export declare function findWorkflowSegmentIndex(segments: WorkflowSegment[], targetNodeId: string): number;
+export declare function computeActiveWorkflowNodes(workflowNodes: Record<string, WorkflowNodeConfig>, nodeIds: string[], rootNodeId: string, includeRootDependencies?: boolean): Set<string>;
+export declare function runControlWorkflowNode(nodeId: string, node: WorkflowNodeConfig, context: WorkflowTemplateContext): {
+    result: WorkflowNodeResult;
+    nextNodeId?: string;
+    ended?: boolean;
+};
+export declare function createSkippedWorkflowNodeResult(nodeId: string): WorkflowNodeResult;
+export declare function getWorkflowNodeRunCondition(node: WorkflowNodeConfig): string | undefined;
+export declare function getSkippedWorkflowDependencies(node: WorkflowNodeConfig, nodes: Record<string, WorkflowNodeResult>): string[];
+export declare function getWorkflowNodeSkipReason(node: WorkflowNodeConfig, context: WorkflowTemplateContext): string | undefined;
+//# sourceMappingURL=planning.d.ts.map

package/dist/lib/workflow/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/planning.ts"],"names":[],"mappings":"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"}