@haibun/core 3.0.5 → 3.1.1

package/build/currentVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const currentVersion = "3.0.5";
+export declare const currentVersion = "3.1.1";
 //# sourceMappingURL=currentVersion.d.ts.map

package/build/currentVersion.js

@@ -1 +1,2 @@
-export const currentVersion = '3.0.5';
+export const currentVersion = '3.1.1';
+//# sourceMappingURL=currentVersion.js.map

package/build/lib/EventLogger.d.ts

@@ -0,0 +1,30 @@
+import { THaibunEvent, TArtifactEvent } from '../schema/events.js';
+import { TFeatureStep } from './defs.js';
+export type { THaibunEvent } from '../schema/events.js';
+export { ImageArtifact, VideoArtifact, HtmlArtifact, SpeechArtifact, JsonArtifact, MermaidArtifact, HttpTraceArtifact, ResolvedFeaturesArtifact, FileArtifact, } from '../schema/events.js';
+export type { TArtifactEvent } from '../schema/events.js';
+export interface IEventLogger {
+    suppressConsole?: boolean;
+    setStepperCallback?(callback: (event: THaibunEvent) => void): void;
+    emit(event: THaibunEvent): void;
+    log(featureStep: TFeatureStep, level: 'info' | 'debug' | 'trace' | 'warn' | 'error', message: string, payload?: Record<string, unknown>): void;
+    stepStart(featureStep: TFeatureStep, stepperName: string, actionName: string): void;
+    stepEnd(featureStep: TFeatureStep, stepperName: string, actionName: string, ok: boolean, error?: string): void;
+    artifact(featureStep: TFeatureStep, artifact: TArtifactEvent): void;
+}
+export declare class EventLogger implements IEventLogger {
+    private stepperCallback?;
+    suppressConsole: boolean;
+    constructor();
+    setStepperCallback(callback: (event: THaibunEvent) => void): void;
+    emit(event: THaibunEvent): void;
+    log(featureStep: TFeatureStep, level: 'info' | 'debug' | 'trace' | 'warn' | 'error', message: string, payload?: Record<string, unknown>): void;
+    stepStart(featureStep: TFeatureStep, stepperName: string, actionName: string): void;
+    stepEnd(featureStep: TFeatureStep, stepperName: string, actionName: string, ok: boolean, error?: string): void;
+    /**
+     * Emit an artifact event. The artifact should already be a valid TArtifactEvent
+     * (parsed via the appropriate Zod schema like ImageArtifact.parse()).
+     */
+    artifact(featureStep: TFeatureStep, artifact: TArtifactEvent): void;
+}
+//# sourceMappingURL=EventLogger.d.ts.map

package/build/lib/EventLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventLogger.d.ts","sourceRoot":"","sources":["../../src/lib/EventLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,cAAc,EAAwJ,MAAM,qBAAqB,CAAC;AACnP,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIzC,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/I,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpF,OAAO,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/G,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACrE;AAyBD,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,eAAe,CAAC,CAAgC;IACjD,eAAe,EAAE,OAAO,CAAS;;IASxC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAIjE,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAiB/B,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW9I,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAenF,OAAO,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB9G;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;CASpE"}

package/build/lib/EventLogger.js

@@ -0,0 +1,110 @@
+import { LogEvent, LifecycleEvent } from '../schema/events.js';
+import { formatCurrentSeqPath } from './util/index.js';
+// Re-export artifact schemas for use by artifact producers
+export { ImageArtifact, VideoArtifact, HtmlArtifact, SpeechArtifact, JsonArtifact, MermaidArtifact, HttpTraceArtifact, ResolvedFeaturesArtifact, FileArtifact, } from '../schema/events.js';
+/**
+ * Get caller info for the emitter field (e.g., "Executor:238")
+ */
+function getEmitter() {
+    const stack = Error().stack?.split('\n');
+    if (!stack || stack.length < 5)
+        return 'unknown';
+    // Find the first non-EventLogger caller
+    for (let i = 3; i < Math.min(stack.length, 8); i++) {
+        const line = stack[i];
+        if (line.includes('EventLogger'))
+            continue;
+        const match = line.match(/at\s+(?:\w+\.)?(\w+)\s+.*:(\d+):\d+/);
+        if (match) {
+            return `${match[1]}:${match[2]}`;
+        }
+        // Handle "at file:..." pattern
+        const fileMatch = line.match(/\/([^/]+)\.(?:ts|js):(\d+):\d+/);
+        if (fileMatch) {
+            return `${fileMatch[1]}:${fileMatch[2]}`;
+        }
+    }
+    return 'unknown';
+}
+export class EventLogger {
+    stepperCallback;
+    suppressConsole = false;
+    constructor() {
+        // HAIBUN_NDJSON=true forces NDJSON output (for debugging tests)
+        // Otherwise suppress in test environments (VITEST or NODE_ENV=test)
+        const forceNdjson = process.env['HAIBUN_NDJSON'] === 'true';
+        const isTest = process.env['VITEST'] !== undefined || process.env['NODE_ENV'] === 'test';
+        this.suppressConsole = !forceNdjson && isTest;
+    }
+    setStepperCallback(callback) {
+        this.stepperCallback = callback;
+    }
+    emit(event) {
+        // Add emitter info if not already present
+        const eventWithEmitter = {
+            ...event,
+            emitter: event.emitter || getEmitter(),
+        };
+        // Route through stepper callback for in-process monitors
+        if (this.stepperCallback) {
+            this.stepperCallback(eventWithEmitter);
+        }
+        // Output to stdout for CLI piping (unless suppressed)
+        if (!this.suppressConsole) {
+            console.log(JSON.stringify(eventWithEmitter));
+        }
+    }
+    log(featureStep, level, message, payload) {
+        this.emit(LogEvent.parse({
+            id: formatCurrentSeqPath(featureStep.seqPath),
+            timestamp: Date.now(),
+            kind: 'log',
+            level,
+            message,
+            payload
+        }));
+    }
+    stepStart(featureStep, stepperName, actionName) {
+        this.emit(LifecycleEvent.parse({
+            id: formatCurrentSeqPath(featureStep.seqPath),
+            timestamp: Date.now(),
+            kind: 'lifecycle',
+            type: 'step',
+            stage: 'start',
+            label: featureStep.in,
+            status: 'running',
+            intent: featureStep.intent ? { mode: featureStep.intent.mode } : undefined,
+            stepperName,
+            actionName
+        }));
+    }
+    stepEnd(featureStep, stepperName, actionName, ok, error) {
+        this.emit(LifecycleEvent.parse({
+            id: formatCurrentSeqPath(featureStep.seqPath),
+            timestamp: Date.now(),
+            kind: 'lifecycle',
+            type: 'step',
+            stage: 'end',
+            label: featureStep.in,
+            status: ok ? 'completed' : 'failed',
+            error,
+            intent: featureStep.intent ? { mode: featureStep.intent.mode } : undefined,
+            stepperName,
+            actionName
+        }));
+    }
+    /**
+     * Emit an artifact event. The artifact should already be a valid TArtifactEvent
+     * (parsed via the appropriate Zod schema like ImageArtifact.parse()).
+     */
+    artifact(featureStep, artifact) {
+        // Ensure the event has proper id and timestamp
+        const event = {
+            ...artifact,
+            id: artifact.id || `${formatCurrentSeqPath(featureStep.seqPath)}.artifact`,
+            timestamp: artifact.timestamp || Date.now(),
+        };
+        this.emit(event);
+    }
+}
+//# sourceMappingURL=EventLogger.js.map

package/build/lib/EventLogger.js.map

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

package/build/lib/astepper.d.ts

@@ -1,7 +1,16 @@
 import { TWorld, IStepperCycles, TStepperStep, TOptionValue, TEnvVariables, IStepperWhen } from './defs.js';
 import { TAnyFixme } from './fixme.js';
+export declare const StepperKinds: {
+    readonly MONITOR: "MONITOR";
+    readonly STORAGE: "STORAGE";
+    readonly BROWSER: "BROWSER";
+    readonly SERVER: "SERVER";
+    readonly TEST: "TEST";
+};
+export type TStepperKind = keyof typeof StepperKinds;
 export declare abstract class AStepper {
     world?: TWorld;
+    kind?: TStepperKind;
     setWorld(world: TWorld, _steppers: AStepper[]): Promise<void>;
     abstract steps: TStepperSteps;
     getWorld(): TWorld;

package/build/lib/astepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astepper.d.ts","sourceRoot":"","sources":["../../src/lib/astepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,8BAAsB,QAAQ;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACT,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE;IAMnD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ;CAOR;AACD,MAAM,MAAM,aAAa,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;CAC5B,CAAC;AACF,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE;QACT,CAAC,IAAI,EAAE,MAAM,GAAG;YACf,QAAQ,CAAC,EAAE,OAAO,CAAC;YAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,KAAK;gBAAE,UAAU,CAAC,EAAE,MAAM,CAAC;gBAAC,GAAG,CAAC,EAAE,aAAa,CAAC;gBAAC,MAAM,CAAC,EAAE,SAAS,CAAC;aAAE,CAAC;SACrH,CAAC;KACF,CAAC;CACF;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC1B"}
+{"version":3,"file":"astepper.d.ts","sourceRoot":"","sources":["../../src/lib/astepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,YAAY,CAAC;AAErD,8BAAsB,QAAQ;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,CAAC;IAEd,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE;IAMnD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ;CAOR;AACD,MAAM,MAAM,aAAa,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;CAC5B,CAAC;AACF,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE;QACT,CAAC,IAAI,EAAE,MAAM,GAAG;YACf,QAAQ,CAAC,EAAE,OAAO,CAAC;YAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,KAAK;gBAAE,UAAU,CAAC,EAAE,MAAM,CAAC;gBAAC,GAAG,CAAC,EAAE,aAAa,CAAC;gBAAC,MAAM,CAAC,EAAE,SAAS,CAAC;aAAE,CAAC;SACrH,CAAC;KACF,CAAC;CACF;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC1B"}

package/build/lib/astepper.js

@@ -1,6 +1,14 @@
 import { constructorName } from './util/index.js';
+export const StepperKinds = {
+    MONITOR: 'MONITOR',
+    STORAGE: 'STORAGE',
+    BROWSER: 'BROWSER',
+    SERVER: 'SERVER',
+    TEST: 'TEST',
+};
 export class AStepper {
     world;
+    kind;
     async setWorld(world, _steppers) {
         this.world = world;
         // some steppers like to keep a reference to all steppers

package/build/lib/astepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"astepper.js","sourceRoot":"","sources":["../../src/lib/astepper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,OAAgB,QAAQ;IAC7B,KAAK,CAAU;IACf,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,SAAqB;QAClD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,yDAAyD;QACzD,KAAK,SAAS,CAAC;QACf,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,QAAQ;QACP,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC,yBAAyB,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;CACD"}
+{"version":3,"file":"astepper.js","sourceRoot":"","sources":["../../src/lib/astepper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACH,CAAC;AAIX,MAAM,OAAgB,QAAQ;IAC7B,KAAK,CAAU;IACf,IAAI,CAAgB;IAEpB,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,SAAqB;QAClD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,yDAAyD;QACzD,KAAK,SAAS,CAAC;QACf,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,QAAQ;QACP,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC,yBAAyB,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;CACD"}

package/build/lib/core/flow-runner.d.ts

@@ -0,0 +1,25 @@
+import { TWorld, TFeatureStep, TSeqPath } from '../defs.js';
+import { AStepper } from '../astepper.js';
+import { ExecutionIntent, FlowSignal } from './protocol.js';
+export declare class FlowRunner {
+    private world;
+    private steppers;
+    private resolver;
+    constructor(world: TWorld, steppers: AStepper[]);
+    runStatement(statement: string, options?: {
+        args?: Record<string, string>;
+        intent?: ExecutionIntent;
+        parentStep?: TFeatureStep;
+        seqPath?: TSeqPath;
+    }): Promise<FlowSignal>;
+    runStatements(statements: string[], options?: {
+        args?: Record<string, string>;
+        intent?: ExecutionIntent;
+        parentStep?: TFeatureStep;
+    }): Promise<FlowSignal>;
+    runSteps(steps: TFeatureStep[], options?: {
+        intent?: ExecutionIntent;
+        parentStep?: TFeatureStep;
+    }): Promise<FlowSignal>;
+}
+//# sourceMappingURL=flow-runner.d.ts.map

package/build/lib/core/flow-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/core/flow-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5D,qBAAa,UAAU;IAGV,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,QAAQ;IAFnD,OAAO,CAAC,QAAQ,CAAW;gBAEP,KAAK,EAAE,MAAM,EAAU,QAAQ,EAAE,QAAQ,EAAE;IAIzD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,UAAU,CAAC,EAAE,YAAY,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAkE9K,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,UAAU,CAAC,EAAE,YAAY,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAY9J,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,UAAU,CAAC,EAAE,YAAY,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAgDjI"}

package/build/lib/core/flow-runner.js

@@ -0,0 +1,128 @@
+import { Resolver } from '../../phases/Resolver.js';
+import { FeatureExecutor, incSeqPath } from '../../phases/Executor.js';
+export class FlowRunner {
+    world;
+    steppers;
+    resolver;
+    constructor(world, steppers) {
+        this.world = world;
+        this.steppers = steppers;
+        this.resolver = new Resolver(steppers);
+    }
+    async runStatement(statement, options = {}) {
+        const { intent = { mode: 'authoritative' } } = options;
+        // Merge parent runtimeArgs with current args (current takes precedence)
+        // This enables nested quantifiers: outer vars are visible to inner statements
+        const allArgs = { ...options.parentStep?.runtimeArgs, ...options.args };
+        // Interpolate {varName} patterns using merged args
+        let statementWithArgs = statement;
+        if (Object.keys(allArgs).length > 0) {
+            for (const [key, value] of Object.entries(allArgs)) {
+                statementWithArgs = statementWithArgs.replace(new RegExp(`\\{${key}\\}`, 'g'), value);
+            }
+        }
+        let action;
+        try {
+            action = this.resolver.findSingleStepAction(statementWithArgs);
+        }
+        catch (e) {
+            if (intent.mode === 'speculative') {
+                return { kind: 'fail', message: e.message };
+            }
+            throw e;
+        }
+        let seqPath = options.seqPath;
+        if (!seqPath) {
+            if (options.parentStep) {
+                seqPath = incSeqPath(this.world.runtime.stepResults, [...options.parentStep.seqPath, 1], 1);
+            }
+            else {
+                throw new Error(`runStatement requires seqPath or parentStep. Statement: ${statement}`);
+            }
+        }
+        // Merge parent args with current args (current takes precedence)
+        const mergedArgs = { ...options.parentStep?.runtimeArgs, ...options.args };
+        const featureStep = {
+            path: options.parentStep?.path || this.world.runtime.feature || 'unknown',
+            in: statementWithArgs,
+            seqPath,
+            action,
+            intent,
+            isSubStep: !!options.parentStep,
+            runtimeArgs: Object.keys(mergedArgs).length > 0 ? mergedArgs : undefined
+        };
+        let result;
+        try {
+            result = await FeatureExecutor.doFeatureStep(this.steppers, featureStep, this.world);
+        }
+        catch (e) {
+            if (intent.mode === 'speculative') {
+                return { kind: 'fail', message: e.message };
+            }
+            throw e;
+        }
+        if (result.ok) {
+            return { kind: 'ok', payload: result.stepActionResult };
+        }
+        else {
+            const msg = result.stepActionResult.message;
+            return { kind: 'fail', message: msg, payload: result.stepActionResult };
+        }
+    }
+    async runStatements(statements, options = {}) {
+        let lastResult;
+        for (const stmt of statements) {
+            const result = await this.runStatement(stmt, options);
+            if (result.kind !== 'ok') {
+                return result;
+            }
+            lastResult = result;
+        }
+        return { kind: 'ok', payload: lastResult?.payload };
+    }
+    async runSteps(steps, options = {}) {
+        const { intent = { mode: 'authoritative' }, parentStep } = options;
+        let lastResult;
+        for (const step of steps) {
+            let mappedStep = {
+                ...step,
+                intent,
+                runtimeArgs: { ...parentStep?.runtimeArgs, ...step.runtimeArgs }
+            };
+            if (parentStep) {
+                // For nested steps, we append to the parent's seqPath.
+                // We use incSeqPath to ensure we get a unique path based on what has already executed.
+                // This handles loops and repeated calls correctly.
+                const baseSeqPath = [...parentStep.seqPath, 1];
+                const dir = intent.mode === 'speculative' ? -1 : 1;
+                const seqPath = incSeqPath(this.world.runtime.stepResults, baseSeqPath, dir);
+                mappedStep = { ...mappedStep, seqPath, isSubStep: true };
+            }
+            let result;
+            try {
+                result = await FeatureExecutor.doFeatureStep(this.steppers, mappedStep, this.world);
+            }
+            catch (e) {
+                if (intent.mode === 'speculative') {
+                    return { kind: 'fail', message: e.message };
+                }
+                throw e;
+            }
+            // If not using cycles (which doFeatureStep defaults to WITH_CYCLES), we might need to push results.
+            // But doFeatureStep pushes results if WITH_CYCLES.
+            // If we are in speculative mode, doFeatureStep might still push results if we don't change execMode.
+            // However, FlowRunner doesn't currently control execMode passed to doFeatureStep directly,
+            // it relies on FeatureExecutor defaults.
+            // If we want to avoid polluting stepResults in speculative mode, we might need to adjust FeatureExecutor or pass a flag.
+            // But for now, to ensure incSeqPath works, we NEED results in stepResults.
+            // So we accept that speculative steps might be in stepResults (which is probably fine for debugging).
+            if (!result.ok) {
+                const msg = result.stepActionResult.message;
+                return { kind: 'fail', message: msg, payload: result.stepActionResult };
+            }
+            lastResult = { kind: 'ok', payload: result.stepActionResult };
+        }
+        return { kind: 'ok', payload: lastResult?.payload };
+    }
+}
+//# sourceMappingURL=flow-runner.js.map

package/build/lib/core/flow-runner.js.map

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

package/build/lib/core/protocol.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+export declare const ExecutionIntentSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        speculative: "speculative";
+        authoritative: "authoritative";
+        prose: "prose";
+    }>>;
+    usage: z.ZodOptional<z.ZodEnum<{
+        testing: "testing";
+        debugging: "debugging";
+        background: "background";
+        polling: "polling";
+    }>>;
+    stepperOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+export type ExecutionIntent = z.infer<typeof ExecutionIntentSchema>;
+export declare const FlowSignalSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        ok: "ok";
+        fail: "fail";
+        retry: "retry";
+        skip: "skip";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    fatal: z.ZodOptional<z.ZodBoolean>;
+    payload: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+export type FlowSignal = z.infer<typeof FlowSignalSchema>;
+export declare const SystemMessageSchema: z.ZodObject<{
+    topic: z.ZodOptional<z.ZodString>;
+    signal: z.ZodObject<{
+        kind: z.ZodEnum<{
+            ok: "ok";
+            fail: "fail";
+            retry: "retry";
+            skip: "skip";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+        fatal: z.ZodOptional<z.ZodBoolean>;
+        payload: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+    intent: z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            speculative: "speculative";
+            authoritative: "authoritative";
+            prose: "prose";
+        }>>;
+        usage: z.ZodOptional<z.ZodEnum<{
+            testing: "testing";
+            debugging: "debugging";
+            background: "background";
+            polling: "polling";
+        }>>;
+        stepperOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SystemMessage = z.infer<typeof SystemMessageSchema>;
+//# sourceMappingURL=protocol.d.ts.map

package/build/lib/core/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/lib/core/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/build/lib/core/protocol.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export const ExecutionIntentSchema = z.object({
+    mode: z.enum(['authoritative', 'speculative', 'prose']).default('authoritative'),
+    usage: z.enum(['testing', 'debugging', 'background', 'polling']).optional(),
+    stepperOptions: z.record(z.string(), z.any()).optional(),
+});
+export const FlowSignalSchema = z.object({
+    kind: z.enum(['ok', 'fail', 'retry', 'skip']),
+    message: z.string().optional(),
+    fatal: z.boolean().optional(),
+    payload: z.any().optional(),
+});
+export const SystemMessageSchema = z.object({
+    topic: z.string().optional(),
+    signal: FlowSignalSchema,
+    intent: ExecutionIntentSchema,
+});
+//# sourceMappingURL=protocol.js.map

package/build/lib/core/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/lib/core/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3E,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,qBAAqB;CAC9B,CAAC,CAAC"}

package/build/lib/core-domains.d.ts

@@ -1,17 +1,3 @@
-import { AStepper } from "./astepper.js";
-import { TFeatureStep, TStepValue, TWorld } from "./defs.js";
-export declare const getCoreDomains: (world: TWorld) => {
-    string: {
-        coerce: (proto: TStepValue) => string;
-    };
-    number: {
-        coerce: (proto: TStepValue) => number;
-    };
-    json: {
-        coerce: (proto: TStepValue) => any;
-    };
-    statement: {
-        coerce: (proto: TStepValue, featureStep: TFeatureStep, steppers: AStepper[]) => TFeatureStep[];
-    };
-};
+import { TWorld } from "./defs.js";
+export declare const getCoreDomains: (world: TWorld) => Record<string, import("./defs.js").TRegisteredDomain>;
 //# sourceMappingURL=core-domains.d.ts.map

package/build/lib/core-domains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-domains.d.ts","sourceRoot":"","sources":["../../src/lib/core-domains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAK7D,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM;;wBAE1B,UAAU;;;wBAGV,UAAU;;;wBAQV,UAAU;;;wBAQV,UAAU,eAAe,YAAY,YAAY,QAAQ,EAAE;;CAO3E,CAAC"}
+{"version":3,"file":"core-domains.d.ts","sourceRoot":"","sources":["../../src/lib/core-domains.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+C,MAAM,EAAE,MAAM,WAAW,CAAC;AA0DhF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,0DAA6D,CAAC"}

package/build/lib/core-domains.js

@@ -1,39 +1,58 @@
-import { DOMAIN_STATEMENT, DOMAIN_STRING, DOMAIN_NUMBER, DOMAIN_JSON } from './domain-types.js';
-import { findFeatureStepsFromStatement } from "./util/featureStep-executor.js";
-// Core domain registry factory. Returns coercion functions for built-in domains.
-export const getCoreDomains = (world) => ({
-    [DOMAIN_STRING]: {
-        coerce: (proto) => String(proto.value),
+import { z } from 'zod';
+import { DOMAIN_DATE, DOMAIN_JSON, DOMAIN_NUMBER, DOMAIN_STATEMENT, DOMAIN_STRING, mapDefinitionsToDomains } from './domain-types.js';
+import { findFeatureStepsFromStatement } from "../phases/Resolver.js";
+const numberSchema = z.coerce.number({ error: 'invalid number' })
+    .refine((value) => Number.isFinite(value), 'invalid number');
+const stringSchema = z.coerce.string({ error: 'value is required' });
+const jsonStringSchema = z.string({ error: 'json value is required' });
+const statementSchema = z.string({ error: 'statement label is required' }).min(1, 'statement cannot be empty');
+const dateSchema = z.coerce.date({ error: 'invalid date' });
+const getCoreDomainDefinitions = (world) => ([
+    {
+        selectors: [DOMAIN_STRING],
+        schema: stringSchema,
+        description: 'Plain string literal captured from feature text.'
     },
-    [DOMAIN_NUMBER]: {
-        coerce: (proto) => {
-            if (typeof proto.value !== 'string' && typeof proto.value !== 'number')
-                throw new Error(`invalid number '${String(proto.value)}'`);
-            const n = Number(proto.value);
-            if (isNaN(n))
-                throw new Error(`invalid number '${proto.value}'`);
-            return n;
-        }
+    {
+        selectors: [DOMAIN_NUMBER],
+        schema: numberSchema,
+        description: 'Numeric literal coerced with Number().',
+        comparator: (value, baseline) => value - baseline,
+    },
+    {
+        selectors: [DOMAIN_DATE],
+        schema: dateSchema,
+        description: 'Date object derived from ISO timestamp, epoch ms, or Date literal.',
+        comparator: (value, baseline) => value.getTime() - baseline.getTime(),
     },
-    [DOMAIN_JSON]: {
+    {
+        selectors: [DOMAIN_JSON],
+        schema: jsonStringSchema,
+        description: 'JSON string parsed into native JavaScript values.',
         coerce: (proto) => {
-            if (typeof proto.value !== 'string')
-                throw new Error(`invalid json '${String(proto.value)}'`);
+            const raw = jsonStringSchema.parse(proto.value);
             try {
-                return JSON.parse(proto.value);
+                return JSON.parse(raw);
             }
             catch {
-                throw new Error(`invalid json '${proto.value}'`);
+                throw new Error(`invalid json '${raw}'`);
             }
-        }
+        },
     },
-    [DOMAIN_STATEMENT]: {
+    {
+        selectors: [DOMAIN_STATEMENT],
+        schema: statementSchema,
+        description: 'Reference to another Haibun statement.',
         coerce: (proto, featureStep, steppers) => {
-            const lbl = String(proto.value);
+            if (!featureStep || !steppers) {
+                throw new Error('statement domain coercion requires feature context');
+            }
+            const label = statementSchema.parse(proto.value);
             const seqStart = featureStep.seqPath;
-            // Use the featureStep's path as the base so non-background statements get the correct path
-            return findFeatureStepsFromStatement(lbl, steppers, world, featureStep.path, [...seqStart, 0], -1);
+            return findFeatureStepsFromStatement(label, steppers, world, featureStep.path, [...seqStart, 0], -1);
         }
-    }
-});
+    },
+]);
+// Core domain registry factory. Returns coercion functions for built-in domains.
+export const getCoreDomains = (world) => mapDefinitionsToDomains(getCoreDomainDefinitions(world));
 //# sourceMappingURL=core-domains.js.map

package/build/lib/core-domains.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-domains.js","sourceRoot":"","sources":["../../src/lib/core-domains.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAE/E,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC,aAAa,CAAC,EAAE;QAChB,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;KAClD;IACD,CAAC,aAAa,CAAC,EAAE;QAChB,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE;YAC7B,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnI,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC;QACV,CAAC;KACD;IACD,CAAC,WAAW,CAAC,EAAE;QACd,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE;YAC7B,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9F,IAAI,CAAC;gBACJ,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YAAC,CAAC;QAC9D,CAAC;KACD;IACD,CAAC,gBAAgB,CAAC,EAAE;QACnB,MAAM,EAAE,CAAC,KAAiB,EAAE,WAAyB,EAAE,QAAoB,EAAE,EAAE;YAC9E,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;YACrC,2FAA2F;YAC3F,OAAO,6BAA6B,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpG,CAAC;KACD;CACD,CAAC,CAAC"}
+{"version":3,"file":"core-domains.js","sourceRoot":"","sources":["../../src/lib/core-domains.ts"],"names":[],"mappings":"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"}