@schnick371/devsteps-shared 1.1.0-next.4 → 2.0.0-next.1

package/dist/runtime/index.js

@@ -0,0 +1,171 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Runtime public API
+ * Exposes process schemas, the state machine, persistence, controls, and workflow adapters.
+ */
+import { z } from 'zod';
+import { WorkflowRouteVerdict, WorkflowSideEffect } from '../schemas/workflow-v2-vocabulary.js';
+import { WorkflowParty, WorkflowRunMode } from './workflow-v2-types.js';
+export const RuntimeState = z.enum([
+    'created',
+    'ready',
+    'running',
+    'waiting',
+    'awaiting-input',
+    'paused',
+    'succeeded',
+    'failed',
+    'cancelled',
+    'stale',
+]);
+export const RuntimeActor = z.enum(['agent', 'human', 'system']);
+/** A step added or changed while its run was open, until the run passes it (STORY-465). */
+const StepRevision = z.object({
+    change: z.enum(['added', 'changed']),
+    actor: RuntimeActor,
+    actor_name: z.string().min(1).max(200).optional(),
+    at: z.string().datetime(),
+});
+const RuntimeStateDefinition = z.object({
+    terminal: z.boolean().default(false),
+    resumable: z.boolean().default(true),
+    retryable: z.boolean().default(false),
+    requires_human: z.boolean().default(false),
+});
+const RuntimeGuard = z.object({
+    kind: z.string().min(1),
+    parameters: z.record(z.string(), z.unknown()).default({}),
+});
+const RuntimeTransition = z.object({
+    event: z.string().min(1),
+    from: z.array(z.string().min(1)).min(1),
+    to: z.string().min(1),
+    guards: z.array(RuntimeGuard).default([]),
+});
+export const ProcessDefinition = z.object({
+    schema_version: z.string().min(1),
+    process_type: z.string().min(1),
+    definition_id: z.string().min(1),
+    definition_revision: z.string().min(1),
+    definition_digest: z.string().min(1),
+    initial_state: z.string().min(1).default('created'),
+    states: z.record(z.string(), RuntimeStateDefinition),
+    transitions: z.array(RuntimeTransition),
+    max_attempts: z.number().int().min(1).default(1),
+    allow_parallel_runs: z.boolean().default(false),
+});
+export const ProcessRun = z.object({
+    schema_version: z.string().min(1),
+    run_id: z.string().uuid(),
+    process_type: z.string().min(1),
+    definition_id: z.string().min(1),
+    definition_revision: z.string().min(1),
+    definition_digest: z.string().min(1),
+    state: z.string().min(1),
+    created_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+    workspace_fingerprint: z.string().min(1),
+    parent_run_id: z.string().uuid().optional(),
+    attempt: z.number().int().min(1),
+    version: z.number().int().min(1),
+    terminal: z.boolean(),
+    // Compiled-workflow runs (definition schema_version "2.0") carry their cursor data here;
+    // the state machine of v1 runs never reads or writes these fields.
+    definition_schema_version: z.literal('2.0').optional(),
+    manifest_digest: z.string().min(1).optional(),
+    host_profile: z.string().min(1).optional(),
+    variables: z.record(z.string(), z.unknown()).optional(),
+    policy: z.object({ max_side_effect: WorkflowSideEffect.optional() }).optional(),
+    completed_step_ids: z.array(z.string()).optional(),
+    outputs: z.record(z.string(), z.record(z.string(), z.unknown())).optional(),
+    step_attempts: z.record(z.string(), z.number().int().min(0)).optional(),
+    pending_verdict: WorkflowRouteVerdict.nullable().optional(),
+    verdict: WorkflowRouteVerdict.nullable().optional(),
+    finished_at: z.string().datetime().optional(),
+    reason: z.string().max(2000).optional(),
+    /** v2: who works the run; absent on runs started before STORY-463 (see `workflowRunMode`). */
+    mode: WorkflowRunMode.optional(),
+    /** v2: per-step assignments that override the mode's default (DEC-023). */
+    assignments: z.record(z.string(), WorkflowParty).optional(),
+    /** v2: the outline label of each step, fixed at start and never shifted (DEC-024). */
+    step_labels: z.record(z.string(), z.string().min(1).max(40)).optional(),
+    /** v2: steps added or changed while the run was open (STORY-465). */
+    step_revisions: z.record(z.string(), StepRevision).optional(),
+});
+export const ProcessEvent = z.object({
+    schema_version: z.string().min(1),
+    event_id: z.string().uuid(),
+    run_id: z.string().uuid(),
+    sequence: z.number().int().min(1),
+    type: z.string().min(1),
+    occurred_at: z.string().datetime(),
+    from_state: z.string().min(1),
+    to_state: z.string().min(1),
+    actor: RuntimeActor,
+    /**
+     * Who the actor was, by name: an agent's designation such as
+     * `claude-code:Engineer-Walkthroughs`, or a person's name. The kind lives in `actor`; this is
+     * the signature, and it is never rewritten once an event carries it.
+     */
+    actor_name: z.string().min(1).max(200).optional(),
+    idempotency_key: z.string().min(1).max(500).optional(),
+    /**
+     * v2: the party this event is addressed to, so a waiting agent wakes only on events meant for
+     * it, by matching `"notify":"agent"` in the appended log line (DEC-022).
+     */
+    notify: WorkflowParty.optional(),
+    payload: z.record(z.string(), z.unknown()).default({}),
+});
+export * from './controls.js';
+export * from './dispatcher.js';
+export * from './event-log.js';
+export * from './evidence.js';
+export * from './guide-catalog.js';
+export * from './human-checkpoint.js';
+export * from './json-path.js';
+export * from './predicates.js';
+export * from './reconciliation.js';
+export * from './redaction.js';
+export * from './run-event-payload.js';
+export * from './run-history.js';
+export * from './run-store.js';
+export * from './run-trail.js';
+export * from './state-machine.js';
+export * from './workflow-contract.js';
+export * from './workflow-response.js';
+export * from './workflow-template.js';
+export * from './workflow-v1-cancel.js';
+export * from './workflow-v2-context.js';
+export * from './workflow-v2-continuation.js';
+export * from './workflow-v2-dispatch.js';
+export * from './workflow-v2-engine.js';
+export * from './workflow-v2-failure-route.js';
+export * from './workflow-v2-fields.js';
+export * from './workflow-v2-finalize.js';
+export * from './workflow-v2-handover.js';
+export * from './workflow-v2-human.js';
+export * from './workflow-v2-human-response.js';
+export * from './workflow-v2-labels.js';
+export * from './workflow-v2-notes.js';
+export * from './workflow-v2-observation.js';
+export * from './workflow-v2-operator-words.js';
+export * from './workflow-v2-parties.js';
+export * from './workflow-v2-party-state.js';
+export * from './workflow-v2-receipt.js';
+export * from './workflow-v2-reply.js';
+export * from './workflow-v2-report.js';
+export * from './workflow-v2-report-render.js';
+export * from './workflow-v2-revise.js';
+export * from './workflow-v2-revise-open.js';
+export * from './workflow-v2-routing.js';
+export * from './workflow-v2-run.js';
+export * from './workflow-v2-run-events.js';
+export * from './workflow-v2-runtime-steps.js';
+export * from './workflow-v2-skip.js';
+export * from './workflow-v2-types.js';
+export * from './workflow-v2-variables.js';
+export * from './workflow-v2-wait.js';
+export * from './workspace-fingerprint.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

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

package/dist/runtime/json-path.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bounded JSONPath subset for workflow predicates.
+ * Supports `$`, `.key`, `['key']`, `[n]`, `[*]`, and equality filters `[?(@.key=='value')]`.
+ */
+type Segment = Readonly<{
+    kind: 'key';
+    key: string;
+}> | Readonly<{
+    kind: 'index';
+    index: number;
+}> | Readonly<{
+    kind: 'wildcard';
+}> | Readonly<{
+    kind: 'filter';
+    path: readonly string[];
+    value: string | number | boolean | null;
+}>;
+export declare class JsonPathError extends Error {
+    constructor(message: string);
+}
+export declare function parseJsonPath(path: string): Segment[];
+/**
+ * Evaluate a JSONPath. A path without wildcard or filter yields the value or undefined; a path with
+ * one yields the single match unwrapped, an array for several matches, and undefined for none.
+ */
+export declare function evaluateJsonPath(document: unknown, path: string): unknown;
+export {};
+//# sourceMappingURL=json-path.d.ts.map

package/dist/runtime/json-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-path.d.ts","sourceRoot":"","sources":["../../src/runtime/json-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,OAAO,GACR,QAAQ,CAAC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GACtC,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1C,QAAQ,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,GAC9B,QAAQ,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAEnG,qBAAa,aAAc,SAAQ,KAAK;IACtC,YAAmB,OAAO,EAAE,MAAM,EAGjC;CACF;AAyBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAqBrD;AA8CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAWzE"}

package/dist/runtime/json-path.js

@@ -0,0 +1,120 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bounded JSONPath subset for workflow predicates.
+ * Supports `$`, `.key`, `['key']`, `[n]`, `[*]`, and equality filters `[?(@.key=='value')]`.
+ */
+export class JsonPathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'JsonPathError';
+    }
+}
+const FILTER = /^\?\(@((?:\.[A-Za-z0-9_-]+)+)\s*==\s*('(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*"|-?\d+(?:\.\d+)?|true|false|null)\)$/;
+function filterValue(literal) {
+    if (literal === 'true')
+        return true;
+    if (literal === 'false')
+        return false;
+    if (literal === 'null')
+        return null;
+    if (/^-?\d/.test(literal))
+        return Number(literal);
+    return literal.slice(1, -1).replace(/\\(.)/g, '$1');
+}
+function bracketSegment(content) {
+    if (content === '*')
+        return { kind: 'wildcard' };
+    if (/^\d+$/.test(content))
+        return { kind: 'index', index: Number(content) };
+    const quoted = content.match(/^'([^']*)'$|^"([^"]*)"$/);
+    if (quoted)
+        return { kind: 'key', key: quoted[1] ?? quoted[2] ?? '' };
+    const filter = content.match(FILTER);
+    if (filter) {
+        return { kind: 'filter', path: filter[1].slice(1).split('.'), value: filterValue(filter[2]) };
+    }
+    throw new JsonPathError(`Unsupported JSONPath segment [${content}]`);
+}
+export function parseJsonPath(path) {
+    if (!path.startsWith('$') || path.length > 500) {
+        throw new JsonPathError('A JSONPath starts with $ and has at most 500 characters');
+    }
+    const segments = [];
+    let index = 1;
+    while (index < path.length) {
+        if (path[index] === '.') {
+            const match = path.slice(index + 1).match(/^[A-Za-z0-9_-]+/);
+            if (!match)
+                throw new JsonPathError(`Expected a key after "." at ${index} in ${path}`);
+            segments.push({ kind: 'key', key: match[0] });
+            index += match[0].length + 1;
+        }
+        else if (path[index] === '[') {
+            const close = findClosingBracket(path, index);
+            segments.push(bracketSegment(path.slice(index + 1, close).trim()));
+            index = close + 1;
+        }
+        else {
+            throw new JsonPathError(`Unexpected "${path[index]}" at ${index} in ${path}`);
+        }
+    }
+    return segments;
+}
+function findClosingBracket(path, open) {
+    let quote;
+    for (let index = open + 1; index < path.length; index += 1) {
+        const character = path[index];
+        if (quote) {
+            if (character === '\\')
+                index += 1;
+            else if (character === quote)
+                quote = undefined;
+        }
+        else if (character === "'" || character === '"')
+            quote = character;
+        else if (character === ']')
+            return index;
+    }
+    throw new JsonPathError(`Unclosed "[" in ${path}`);
+}
+function child(value, key) {
+    return typeof value === 'object' && value !== null && key in value
+        ? value[key]
+        : undefined;
+}
+function matchesFilter(entry, segment) {
+    return (segment.path.reduce((current, key) => child(current, key), entry) === segment.value);
+}
+function applyOne(value, segment) {
+    if (segment.kind === 'key') {
+        const next = child(value, segment.key);
+        return next === undefined ? [] : [next];
+    }
+    if (segment.kind === 'index') {
+        return Array.isArray(value) && segment.index < value.length ? [value[segment.index]] : [];
+    }
+    if (segment.kind === 'wildcard') {
+        if (Array.isArray(value))
+            return value;
+        return typeof value === 'object' && value !== null ? Object.values(value) : [];
+    }
+    return Array.isArray(value) ? value.filter((entry) => matchesFilter(entry, segment)) : [];
+}
+function applySegment(values, segment) {
+    return values.flatMap((value) => applyOne(value, segment));
+}
+/**
+ * Evaluate a JSONPath. A path without wildcard or filter yields the value or undefined; a path with
+ * one yields the single match unwrapped, an array for several matches, and undefined for none.
+ */
+export function evaluateJsonPath(document, path) {
+    const segments = parseJsonPath(path);
+    const matches = segments.reduce((values, segment) => applySegment(values, segment), [document]);
+    if (matches.length === 0)
+        return undefined;
+    const branching = segments.some((segment) => segment.kind === 'wildcard' || segment.kind === 'filter');
+    return branching && matches.length > 1 ? matches : matches[0];
+}
+//# sourceMappingURL=json-path.js.map

package/dist/runtime/json-path.js.map

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

package/dist/runtime/predicates.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic workflow predicate evaluation.
+ * Predicates return a bounded verdict and never produce new actions.
+ */
+import type { WorkflowPredicate, WorkflowSemanticJudgment, WorkflowVerdict } from '../schemas/workflow-definition-v2.js';
+export type WorkflowPredicateResult = Readonly<{
+    predicate_id: string;
+    verdict: WorkflowVerdict;
+    kind?: WorkflowPredicate['kind'];
+    target?: string;
+    detail?: string;
+}>;
+export declare class WorkflowPredicateError extends Error {
+    constructor(message: string);
+}
+export type SemanticJudgmentInput = Readonly<{
+    verdict: WorkflowVerdict;
+    confidence: number;
+    rationale: string;
+}>;
+export declare function evaluateSemanticJudgment(contract: WorkflowSemanticJudgment, input: SemanticJudgmentInput): SemanticJudgmentInput;
+export declare function evaluateWorkflowPredicate(predicate: WorkflowPredicate, subject: unknown): WorkflowPredicateResult;
+export type WorkflowPredicateContext = Readonly<{
+    variables: Readonly<Record<string, unknown>>;
+    outputs: Readonly<Record<string, unknown>>;
+    receipt?: unknown;
+}>;
+/**
+ * Evaluate a predicate against run data. `parameters.target` selects the subject (`outputs.<step>.…`,
+ * `variables.…`, or `receipt.…`); without a target the fallback subject is used. Template values in
+ * the other parameters are expanded first. An unusable predicate yields FAIL with the reason.
+ */
+export declare function evaluateWorkflowPredicateInContext(predicate: WorkflowPredicate, context: WorkflowPredicateContext, fallbackSubject?: unknown): WorkflowPredicateResult;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/runtime/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../src/runtime/predicates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAI9C,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAmB,OAAO,EAAE,MAAM,EAGjC;CACF;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,wBAAwB,EAClC,KAAK,EAAE,qBAAqB,GAC3B,qBAAqB,CAWvB;AAgCD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,OAAO,GACf,uBAAuB,CAmEzB;AAED,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAgCH;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,wBAAwB,EACjC,eAAe,CAAC,EAAE,OAAO,GACxB,uBAAuB,CAoCzB"}

package/dist/runtime/predicates.js

@@ -0,0 +1,185 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic workflow predicate evaluation.
+ * Predicates return a bounded verdict and never produce new actions.
+ */
+import { evaluateJsonPath, JsonPathError } from './json-path.js';
+import { renderWorkflowTemplate } from './workflow-template.js';
+export class WorkflowPredicateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowPredicateError';
+    }
+}
+export function evaluateSemanticJudgment(contract, input) {
+    const allowed = new Set(contract.verdicts);
+    if (!allowed.has(input.verdict))
+        throw new WorkflowPredicateError('Semantic verdict is not declared');
+    if (input.rationale.length > contract.rationale_max_length) {
+        throw new WorkflowPredicateError('Semantic rationale exceeds the declared limit');
+    }
+    if (input.confidence < contract.minimum_confidence) {
+        return { ...input, verdict: 'INCONCLUSIVE' };
+    }
+    return input;
+}
+const EXPECTING_KINDS = new Set([
+    'equals',
+    'number-compare',
+    'text-normalized-equals',
+    'text-contains',
+    'json-path-equals',
+    'artifact-count',
+]);
+function parameter(predicate, name) {
+    return predicate.parameters[name];
+}
+function jsonPath(value, path) {
+    try {
+        return evaluateJsonPath(value, path);
+    }
+    catch (error) {
+        if (error instanceof JsonPathError)
+            throw new WorkflowPredicateError(error.message);
+        throw error;
+    }
+}
+function normalizedText(value) {
+    return String(value).normalize('NFKC').trim().replace(/\s+/g, ' ').toLocaleLowerCase('en-US');
+}
+function asVerdict(result) {
+    return result ? 'PASS' : 'FAIL';
+}
+export function evaluateWorkflowPredicate(predicate, subject) {
+    const expected = parameter(predicate, 'expected');
+    if (expected === undefined && EXPECTING_KINDS.has(predicate.kind)) {
+        throw new WorkflowPredicateError(`Predicate ${predicate.id} (${predicate.kind}) has no parameters.expected`);
+    }
+    let result;
+    switch (predicate.kind) {
+        case 'schema-valid':
+            result = parameter(predicate, 'valid') === true;
+            break;
+        case 'equals':
+            result = subject === expected;
+            break;
+        case 'in-set': {
+            const values = parameter(predicate, 'values');
+            result = Array.isArray(values) && values.some((value) => value === subject);
+            break;
+        }
+        case 'number-compare': {
+            const actual = Number(subject);
+            const target = Number(expected);
+            const operator = parameter(predicate, 'operator');
+            if (!Number.isFinite(actual) || !Number.isFinite(target)) {
+                result = false;
+            }
+            else if (operator === 'gt')
+                result = actual > target;
+            else if (operator === 'gte')
+                result = actual >= target;
+            else if (operator === 'lt')
+                result = actual < target;
+            else if (operator === 'lte')
+                result = actual <= target;
+            else if (operator === 'eq')
+                result = actual === target;
+            else
+                throw new WorkflowPredicateError(`Unsupported number operator: ${String(operator)}`);
+            break;
+        }
+        case 'text-normalized-equals':
+            result = normalizedText(subject) === normalizedText(expected);
+            break;
+        case 'text-contains':
+            result = normalizedText(subject).includes(normalizedText(expected));
+            break;
+        case 'text-regex': {
+            const pattern = String(parameter(predicate, 'pattern') ?? '');
+            if (pattern.length > 500)
+                throw new WorkflowPredicateError('Regex pattern exceeds 500 characters');
+            const flags = String(parameter(predicate, 'flags') ?? '');
+            if (!/^[imu]*$/.test(flags))
+                throw new WorkflowPredicateError('Unsupported regex flags');
+            result = new RegExp(pattern, flags).test(String(subject));
+            break;
+        }
+        case 'json-path-equals':
+            result = jsonPath(subject, String(parameter(predicate, 'path') ?? '')) === expected;
+            break;
+        case 'artifact-count':
+            result = Array.isArray(subject) && subject.length === Number(expected);
+            break;
+        case 'file-check':
+        case 'origin-check':
+        case 'digest-check':
+        case 'playwright-assertion':
+            result = parameter(predicate, 'passed') === true;
+            break;
+        default:
+            throw new WorkflowPredicateError(`Unsupported predicate kind: ${predicate.kind}`);
+    }
+    return { predicate_id: predicate.id, verdict: asVerdict(result) };
+}
+function contextValue(context, target) {
+    const [root, ...parts] = target.split('.');
+    const start = root === 'variables'
+        ? context.variables
+        : root === 'outputs'
+            ? context.outputs
+            : root === 'receipt'
+                ? context.receipt
+                : undefined;
+    if (start === undefined && root !== 'receipt') {
+        throw new WorkflowPredicateError(`Predicate target must start with outputs., variables., or receipt.: ${target}`);
+    }
+    return parts.reduce((current, part) => typeof current === 'object' && current !== null && part in current
+        ? current[part]
+        : undefined, start);
+}
+function describeActual(value) {
+    if (value === undefined)
+        return 'absent';
+    const text = JSON.stringify(value) ?? String(value);
+    return text.length > 120 ? `${text.slice(0, 117)}...` : text;
+}
+/**
+ * Evaluate a predicate against run data. `parameters.target` selects the subject (`outputs.<step>.…`,
+ * `variables.…`, or `receipt.…`); without a target the fallback subject is used. Template values in
+ * the other parameters are expanded first. An unusable predicate yields FAIL with the reason.
+ */
+export function evaluateWorkflowPredicateInContext(predicate, context, fallbackSubject) {
+    const target = typeof predicate.parameters.target === 'string' ? predicate.parameters.target : undefined;
+    try {
+        const subject = target ? contextValue(context, target) : fallbackSubject;
+        const parameters = renderWorkflowTemplate(predicate.parameters, context.variables, context.outputs);
+        const result = evaluateWorkflowPredicate({ ...predicate, parameters }, subject);
+        const actual = predicate.kind === 'json-path-equals'
+            ? jsonPath(subject, String(parameters.path ?? ''))
+            : subject;
+        const expectation = predicate.kind === 'number-compare'
+            ? `${String(parameters.operator)} ${describeActual(parameters.expected)}`
+            : predicate.kind === 'text-regex'
+                ? `matches /${String(parameters.pattern)}/`
+                : `expected ${describeActual(parameters.expected ?? parameters.values)}`;
+        return {
+            ...result,
+            kind: predicate.kind,
+            ...(target ? { target } : {}),
+            detail: `actual ${describeActual(actual)}, ${expectation}`,
+        };
+    }
+    catch (error) {
+        return {
+            predicate_id: predicate.id,
+            verdict: 'FAIL',
+            kind: predicate.kind,
+            ...(target ? { target } : {}),
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=predicates.js.map

package/dist/runtime/predicates.js.map

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

package/dist/runtime/process-report-render.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Process report renderers for v1 runs: markdown, html, csv, and json.
+ */
+import { type CanonicalRunReport, type ProcessReport, type ProcessReportFormat } from './process-report.js';
+export declare function renderProcessReport(report: ProcessReport, format: ProcessReportFormat): string;
+export declare function renderCanonicalRunReport(canonical: CanonicalRunReport, format: ProcessReportFormat | 'json'): string;
+//# sourceMappingURL=process-report-render.d.ts.map

package/dist/runtime/process-report-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-report-render.d.ts","sourceRoot":"","sources":["../../src/runtime/process-report-render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAGlB,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAiD7B,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAiB9F;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,mBAAmB,GAAG,MAAM,GACnC,MAAM,CA+BR"}