@petepetrash/circuit 0.1.0

package/dist/runtime/run/run-close.js

@@ -0,0 +1,228 @@
+// Run closure for the graph runner.
+//
+// Owns the close path for one run: the complete-close proof gap, the
+// primary-result outcome bind, the admitted verdict, and writing the
+// run.closed trace entry plus result.json. The graph-runner loop decides
+// WHEN to close; this module decides what the closed run records.
+import { isDegradedCompletionOutcome } from '../../shared/outcome.js';
+import { resolveEngineFlags } from './engine-flags.js';
+import { honestyLatchGap } from './honesty-ledger.js';
+import { writeRuntimeRunResult } from './result-writer.js';
+import { proofPolicyRequirementKey, recordValue, traceScope } from './trace-evidence.js';
+// Exported so the result-recovery projection rebuilds the same summary string.
+// At recovery time the terminal route target is not durably recorded, so
+// regeneration calls this with no target and gets the outcome-only form.
+export function resultSummary(outcome, terminalTarget) {
+    if (terminalTarget === undefined)
+        return `Run closed with outcome ${outcome}.`;
+    return `Run closed with outcome ${outcome} via ${terminalTarget}.`;
+}
+export function outcomeForTerminal(target) {
+    if (target === '@complete')
+        return 'complete';
+    if (target === '@stop')
+        return 'stopped';
+    if (target === '@handoff')
+        return 'handoff';
+    return 'escalated';
+}
+// Maps a flow's primary-result outcome word onto the run-close outcome the bind
+// applies. Vocabulary-agnostic on purpose: it does NOT enumerate one flow's
+// success words, it reads the shared degraded-completion set. Order matters:
+// `handoff` is a neutral pause with its own terminal outcome, and it is ALSO a
+// member of DEGRADED_COMPLETION_OUTCOMES (for the surface-qualifier use), so it
+// must be matched first or it would bind to `stopped`. Every remaining degraded
+// word (partial, needs_attention, failed, blocked, stopped) downgrades an
+// @complete close to `stopped` (operator-visible "needs attention", exit 1).
+// Anything else — a clean success word like `complete`, `fixed`, or
+// `not-reproduced` — returns undefined so the proof-derived @complete stands.
+// That last branch is what lets Fix arm this bind: the old form downgraded every
+// non-`complete` word to `stopped`, which would have turned Fix's `fixed` /
+// `not-reproduced` successes into `stopped` on every run.
+function runOutcomeForPrimaryResultOutcome(outcome) {
+    if (outcome === 'handoff')
+        return 'handoff';
+    if (isDegradedCompletionOutcome(outcome))
+        return 'stopped';
+    return undefined;
+}
+function stringArrayField(value, key) {
+    if (typeof value !== 'object' || value === null)
+        return [];
+    const raw = value[key];
+    if (!Array.isArray(raw))
+        return [];
+    return raw.filter((item) => typeof item === 'string');
+}
+// A `needs_attention`-shaped close should name WHY, not just that it happened
+// (F7). Every cause here is re-derived from evidence the primary result
+// already carries — a worker never gets to self-report its own stop reason.
+// Loose by design: an absent or malformed field contributes no phrase rather
+// than throwing, so a flow whose primary result carries none of these fields
+// degrades to the unchanged base reason.
+function primaryResultCausePhrases(primaryResult) {
+    const phrases = [];
+    const scope = primaryResult.scope;
+    for (const guardrail of stringArrayField(scope, 'unassessed_guardrails')) {
+        phrases.push(`unassessed guardrail '${guardrail}'`);
+    }
+    for (const guardrail of stringArrayField(scope, 'violated_guardrails')) {
+        phrases.push(`violated guardrail '${guardrail}'`);
+    }
+    if (primaryResult.review_verdict === 'accept-with-fixes') {
+        phrases.push("review verdict 'accept-with-fixes'");
+    }
+    for (const path of stringArrayField(primaryResult.touch_area, 'out_of_bounds_paths')) {
+        phrases.push(`out-of-bounds path '${path}'`);
+    }
+    return phrases;
+}
+// Exported for characterization (terminal-outcome-bound-primary-result.test.ts):
+// the close-time bound read must fail open (return undefined, never throw) so a
+// missing or corrupt primary result falls through to the proof-derived outcome.
+export async function terminalOutcomeBoundToPrimaryResult(context, outcome) {
+    if (outcome !== 'complete')
+        return undefined;
+    // First-class composition (M4): both the behavior flag and the primary-result
+    // path now read off the runtime flow's manifest. A composed flow that declares
+    // this bind and a primary result on its manifest is honored with no by-id
+    // catalog package in the path.
+    const engineFlags = resolveEngineFlags(context.flow);
+    if (engineFlags?.bindsTerminalOutcomeToPrimaryResult !== true)
+        return undefined;
+    const primaryResultPath = context.flow.runtimeSurface?.primaryResult?.path;
+    if (primaryResultPath === undefined)
+        return undefined;
+    // The primary result is read at close time to bind the run outcome. Reading it
+    // can throw (the file may be absent, or hold malformed JSON), and a throw here
+    // would turn an otherwise-successful @complete close into a runtime exception.
+    // Fail open: if the bound read cannot be completed, fall through to the
+    // proof-derived outcome rather than crashing the close path.
+    let primaryResult;
+    try {
+        primaryResult = await context.files.readJson(primaryResultPath);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof primaryResult !== 'object' || primaryResult === null)
+        return undefined;
+    const primaryOutcome = primaryResult.outcome;
+    if (typeof primaryOutcome !== 'string')
+        return undefined;
+    const boundOutcome = runOutcomeForPrimaryResultOutcome(primaryOutcome);
+    if (boundOutcome === undefined)
+        return undefined;
+    const baseReason = `primary result '${primaryResultPath}' reported outcome '${primaryOutcome}'`;
+    const causes = primaryResultCausePhrases(primaryResult);
+    return {
+        outcome: boundOutcome,
+        reason: causes.length === 0 ? baseReason : `${baseReason} (${causes.join('; ')})`,
+    };
+}
+// Exported and entries-based (not context-based) so the result-recovery
+// projection computes the identical admitted verdict from a loaded trace.
+export function latestAdmittedVerdict(entries) {
+    const admitted = new Set();
+    for (const entry of entries) {
+        if (entry.kind === 'check.evaluated' &&
+            entry.check_kind === 'result_verdict' &&
+            entry.outcome === 'pass' &&
+            entry.step_id !== undefined &&
+            entry.attempt !== undefined) {
+            admitted.add(`${entry.step_id}:${entry.attempt}`);
+        }
+    }
+    for (const entry of [...entries].reverse()) {
+        if (entry.kind !== 'relay.completed' && entry.kind !== 'sub_run.completed')
+            continue;
+        if (typeof entry.verdict !== 'string' || entry.verdict.length === 0)
+            continue;
+        if (entry.step_id === undefined || entry.attempt === undefined)
+            continue;
+        if (!admitted.has(`${entry.step_id}:${entry.attempt}`))
+            continue;
+        if (entry.kind === 'sub_run.completed' && entry.child_outcome !== 'complete')
+            continue;
+        return entry.verdict;
+    }
+    return undefined;
+}
+// Exported so the until-loop stop-judge can reuse this exact proof floor as the
+// default evidenceConfirms signal: the engine honors a goal-met claim only when
+// closing complete right now would have no proof gap (undefined return). Slice 3
+// composes the honesty ledger's open latches over this same floor.
+export function completeCloseProofGap(context) {
+    const entries = context.trace.getAll();
+    const latestRequiredProofByRequirement = new Map();
+    for (const [index, entry] of entries.entries()) {
+        if (entry.kind !== 'guidance.decision' || entry.subject !== 'proof_policy')
+            continue;
+        const selected = recordValue(entry.selected);
+        if (selected.close_requires_proven !== true)
+            continue;
+        latestRequiredProofByRequirement.set(proofPolicyRequirementKey(entry), { entry, index });
+    }
+    for (const { entry, index } of latestRequiredProofByRequirement.values()) {
+        const guidanceScope = traceScope(entry);
+        const hasPassingProof = entries.some((candidate, proofIndex) => {
+            if (proofIndex <= index || candidate.kind !== 'proof.assessed')
+                return false;
+            const proofScope = traceScope(candidate);
+            return (candidate.proof_policy_decision_id === entry.decision_id &&
+                candidate.overall_status === 'proven' &&
+                candidate.close_allowed === true &&
+                proofScope.flow_id === guidanceScope.flow_id &&
+                proofScope.step_id === guidanceScope.step_id &&
+                proofScope.attempt === guidanceScope.attempt);
+        });
+        if (!hasPassingProof) {
+            return `run.closed complete requires passing proof.assessed for proof_policy decision '${String(entry.decision_id)}'`;
+        }
+    }
+    return undefined;
+}
+export async function closeRun(context, outcome, terminalTarget, reason) {
+    const proofGap = outcome === 'complete' ? completeCloseProofGap(context) : undefined;
+    // The finalize chokepoint: even with the proof gate clear, a `complete` close
+    // is blocked while the until-loop honesty ledger holds an open overclaim
+    // latch. Unlike a proof gap (a contract violation -> 'aborted'), an open latch
+    // is an honest non-completion: the loop tried, did not fully resolve, and
+    // downgrades to 'stopped' (operator-visible "needs attention"). Inert on every
+    // run without a ledger, so the default close path is unchanged.
+    const latchGap = outcome === 'complete' && proofGap === undefined
+        ? honestyLatchGap(context.honestyLedger)
+        : undefined;
+    const proofOutcome = proofGap !== undefined ? 'aborted' : latchGap !== undefined ? 'stopped' : outcome;
+    const honestyGapClear = proofGap === undefined && latchGap === undefined;
+    const primaryResultOutcome = honestyGapClear
+        ? await terminalOutcomeBoundToPrimaryResult(context, proofOutcome)
+        : undefined;
+    const finalOutcome = primaryResultOutcome?.outcome ?? proofOutcome;
+    const finalReason = proofGap ?? latchGap ?? primaryResultOutcome?.reason ?? reason;
+    const finalTerminalTarget = honestyGapClear && primaryResultOutcome === undefined ? terminalTarget : undefined;
+    await context.trace.append({
+        run_id: context.runId,
+        kind: 'run.closed',
+        outcome: finalOutcome,
+        ...(finalReason === undefined ? {} : { reason: finalReason }),
+    });
+    const verdict = finalOutcome === 'complete' ? latestAdmittedVerdict(context.trace.getAll()) : undefined;
+    const result = {
+        schema_version: 1,
+        run_id: context.runId,
+        flow_id: context.flow.id,
+        goal: context.goal,
+        ...(context.why === undefined ? {} : { why: context.why }),
+        outcome: finalOutcome,
+        summary: resultSummary(finalOutcome, finalTerminalTarget),
+        closed_at: context.now().toISOString(),
+        trace_entries_observed: context.trace.getAll().length,
+        manifest_hash: context.manifestHash,
+        ...(finalReason === undefined ? {} : { reason: finalReason }),
+        ...(verdict === undefined ? {} : { verdict }),
+    };
+    const resultPath = await writeRuntimeRunResult(context.files, result);
+    return { kind: 'closed', result: { ...result, resultPath } };
+}
+//# sourceMappingURL=run-close.js.map

package/dist/runtime/run/run-close.js.map

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

package/dist/runtime/run/run-context.d.ts

@@ -0,0 +1,59 @@
+import type { RuntimePackageIndex } from '../../flows/registries/runtime-index.js';
+import type { Axes } from '../../schemas/axes.js';
+import type { RecoveryRouteBindingV0 } from '../../schemas/recovery-route-kind.js';
+import type { Ref } from '../../schemas/ref.js';
+import type { PowerInferenceChannel } from '../../selection/power-inference.js';
+import type { UserSkillRegistry } from '../../shared/user-skill-registry.js';
+import type { SkillHookInjectionChannel } from '../../skill-hooks/injection.js';
+import type { AcceptanceRetryFeedback } from '../acceptance-criteria.js';
+import type { RunId } from '../domain/run.js';
+import type { ExecutableFlow } from '../manifest/executable-flow.js';
+import type { RunFileStore } from '../run-files/run-file-store.js';
+import type { TraceStore } from '../trace/trace-store.js';
+import type { RuntimeExecutionCapabilities } from './capabilities.js';
+import type { DeliveredContextSlice } from './context-delivery.js';
+import type { ExternalFileReader } from './external-files.js';
+import type { HonestyLedger } from './honesty-ledger.js';
+import type { OracleCommandPinChannel } from './oracle-command-pin.js';
+export interface RunContext extends Omit<RuntimeExecutionCapabilities, 'executors' | 'progressSurface'> {
+    readonly flow: ExecutableFlow;
+    readonly packageIndex: RuntimePackageIndex;
+    readonly runId: RunId;
+    readonly runDir: string;
+    readonly goal: string;
+    readonly why?: string;
+    readonly manifestHash: string;
+    readonly reuseChildrenFrom?: string;
+    readonly workContractRef?: Ref;
+    readonly recoveryRouteBindings?: readonly RecoveryRouteBindingV0[];
+    readonly entryModeName?: string;
+    readonly depth?: string;
+    readonly axes?: Axes;
+    readonly unattended?: boolean;
+    readonly recursionDepth?: number;
+    readonly recursionAncestors?: ReadonlySet<string>;
+    readonly guidanceSelection?: {
+        readonly bindsExecutionDepthToGuidanceSelection: boolean;
+    };
+    readonly now: () => Date;
+    readonly files: RunFileStore;
+    readonly trace: TraceStore;
+    readonly externalFiles: ExternalFileReader;
+    readonly activeStepAttempt?: number;
+    readonly acceptanceRetryFeedback?: AcceptanceRetryFeedback;
+    readonly activeSliceIndex?: number;
+    readonly activeSlice?: unknown;
+    readonly deliveredContextSlices?: readonly DeliveredContextSlice[];
+    readonly contextDeliveryActive?: boolean;
+    readonly skillHookInjections?: SkillHookInjectionChannel;
+    readonly powerInference?: PowerInferenceChannel;
+    readonly skillRegistry?: UserSkillRegistry;
+    readonly resumeCheckpoint?: {
+        readonly stepId: string;
+        readonly attempt: number;
+        readonly selection: string;
+    };
+    readonly honestyLedger?: HonestyLedger;
+    readonly oracleCommandPins?: OracleCommandPinChannel;
+}
+//# sourceMappingURL=run-context.d.ts.map

package/dist/runtime/run/run-context.d.ts.map

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

package/dist/runtime/run/run-context.js

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

package/dist/runtime/run/run-context.js.map

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

package/dist/runtime/run/run-transition.d.ts

@@ -0,0 +1,43 @@
+import type { RouteTarget, TerminalTarget } from '../domain/route.js';
+export type RouteDeclarationTransition = {
+    readonly kind: 'declared_route';
+    readonly target: RouteTarget;
+} | {
+    readonly kind: 'undeclared_route_abort';
+    readonly reason: string;
+};
+export type RouteTargetTransition = {
+    readonly kind: 'step_advance';
+    readonly targetStepId: string;
+} | {
+    readonly kind: 'terminal_close';
+    readonly terminalTarget: TerminalTarget;
+} | {
+    readonly kind: 'self_pass_cycle_abort' | 'completed_step_cycle_abort' | 'recovery_attempts_exhausted_abort';
+    readonly reason: string;
+};
+export declare function isRouteTargetAbort(transition: RouteTargetTransition): transition is Extract<RouteTargetTransition, {
+    readonly reason: string;
+}>;
+export declare function classifyRouteDeclarationTransition(input: {
+    readonly stepId: string;
+    readonly route: string;
+    readonly target: RouteTarget | undefined;
+}): RouteDeclarationTransition;
+export declare function isCompletedStepReentryAbort(input: {
+    readonly completedCount: number;
+    readonly isRecoveryReturnToOrigin: boolean;
+    readonly routeHasRecoveryMechanics: boolean;
+    readonly maxAttempts: number;
+}): boolean;
+export declare function classifyRouteTargetTransition(input: {
+    readonly stepId: string;
+    readonly route: string;
+    readonly target: RouteTarget;
+    readonly targetCompletedCount: number;
+    readonly isRecoveryReturnToOrigin: boolean;
+    readonly routeHasRecoveryMechanics: boolean;
+    readonly targetMaxAttempts: number;
+    readonly recoveryReasonSuffix: string;
+}): RouteTargetTransition;
+//# sourceMappingURL=run-transition.d.ts.map

package/dist/runtime/run/run-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-transition.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/run-transition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,MAAM,0BAA0B,GAClC;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC,GACD;IACE,QAAQ,CAAC,IAAI,EACT,uBAAuB,GACvB,4BAA4B,GAC5B,mCAAmC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,GAChC,UAAU,IAAI,OAAO,CAAC,qBAAqB,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAE3E;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C,GAAG,0BAA0B,CAQ7B;AAOD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAMV;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC,GAAG,qBAAqB,CAiCxB"}

package/dist/runtime/run/run-transition.js

@@ -0,0 +1,52 @@
+export function isRouteTargetAbort(transition) {
+    return 'reason' in transition;
+}
+export function classifyRouteDeclarationTransition(input) {
+    if (input.target === undefined) {
+        return {
+            kind: 'undeclared_route_abort',
+            reason: `step '${input.stepId}' selected undeclared route '${input.route}'`,
+        };
+    }
+    return { kind: 'declared_route', target: input.target };
+}
+// Shared abort predicate for re-entering an already completed step: re-entry
+// is allowed only while a recovery route still has attempts left, and never
+// counts the corridor's sanctioned return-to-origin hop. graph-runner applies
+// the same rule at step entry (with a resume-checkpoint exemption);
+// classifyRouteTargetTransition applies it at route selection.
+export function isCompletedStepReentryAbort(input) {
+    return (input.completedCount > 0 &&
+        !input.isRecoveryReturnToOrigin &&
+        (!input.routeHasRecoveryMechanics || input.completedCount >= input.maxAttempts));
+}
+export function classifyRouteTargetTransition(input) {
+    if (input.target.kind === 'terminal') {
+        return { kind: 'terminal_close', terminalTarget: input.target.target };
+    }
+    if (input.target.stepId === input.stepId && input.route === 'pass') {
+        return {
+            kind: 'self_pass_cycle_abort',
+            reason: `route cycle detected: step '${input.stepId}' routes via '${input.route}' to itself`,
+        };
+    }
+    if (isCompletedStepReentryAbort({
+        completedCount: input.targetCompletedCount,
+        isRecoveryReturnToOrigin: input.isRecoveryReturnToOrigin,
+        routeHasRecoveryMechanics: input.routeHasRecoveryMechanics,
+        maxAttempts: input.targetMaxAttempts,
+    })) {
+        if (input.routeHasRecoveryMechanics) {
+            return {
+                kind: 'recovery_attempts_exhausted_abort',
+                reason: `route '${input.route}' for step '${input.target.stepId}' exhausted max_attempts=${input.targetMaxAttempts}${input.recoveryReasonSuffix}`,
+            };
+        }
+        return {
+            kind: 'completed_step_cycle_abort',
+            reason: `route cycle detected: step '${input.stepId}' routes via '${input.route}' to already completed step '${input.target.stepId}'${input.recoveryReasonSuffix}`,
+        };
+    }
+    return { kind: 'step_advance', targetStepId: input.target.stepId };
+}
+//# sourceMappingURL=run-transition.js.map

package/dist/runtime/run/run-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-transition.js","sourceRoot":"","sources":["../../../src/runtime/run/run-transition.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,kBAAkB,CAChC,UAAiC;IAEjC,OAAO,QAAQ,IAAI,UAAU,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAIlD;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,SAAS,KAAK,CAAC,MAAM,gCAAgC,KAAK,CAAC,KAAK,GAAG;SAC5E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,oEAAoE;AACpE,+DAA+D;AAC/D,MAAM,UAAU,2BAA2B,CAAC,KAK3C;IACC,OAAO,CACL,KAAK,CAAC,cAAc,GAAG,CAAC;QACxB,CAAC,KAAK,CAAC,wBAAwB;QAC/B,CAAC,CAAC,KAAK,CAAC,yBAAyB,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,WAAW,CAAC,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAS7C;IACC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACzE,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACnE,OAAO;YACL,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,+BAA+B,KAAK,CAAC,MAAM,iBAAiB,KAAK,CAAC,KAAK,aAAa;SAC7F,CAAC;IACJ,CAAC;IAED,IACE,2BAA2B,CAAC;QAC1B,cAAc,EAAE,KAAK,CAAC,oBAAoB;QAC1C,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;QAC1D,WAAW,EAAE,KAAK,CAAC,iBAAiB;KACrC,CAAC,EACF,CAAC;QACD,IAAI,KAAK,CAAC,yBAAyB,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI,EAAE,mCAAmC;gBACzC,MAAM,EAAE,UAAU,KAAK,CAAC,KAAK,eAAe,KAAK,CAAC,MAAM,CAAC,MAAM,4BAA4B,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,oBAAoB,EAAE;aAClJ,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,4BAA4B;YAClC,MAAM,EAAE,+BAA+B,KAAK,CAAC,MAAM,iBAAiB,KAAK,CAAC,KAAK,gCAAgC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE;SACnK,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AACrE,CAAC"}

package/dist/runtime/run/run-values.d.ts

@@ -0,0 +1,80 @@
+import { type RuntimeIndexedStep } from '../../flows/registries/runtime-index.js';
+import type { RunFileRef } from '../domain/run-file.js';
+import type { TraceEntry, TraceEntryInput } from '../domain/trace.js';
+import type { RunContext } from './run-context.js';
+export declare const RUN_PORT_NAMES: readonly ["clock", "traceLog", "runFiles", "runDirectory", "progress", "connector", "childRun", "worktree", "selection"];
+export type RunPortName = (typeof RUN_PORT_NAMES)[number];
+export interface RunValue {
+    readonly flow: RunContext['flow'];
+    readonly packageIndex: RunContext['packageIndex'];
+    readonly runId: RunContext['runId'];
+    readonly goal: string;
+    readonly manifestHash: string;
+    readonly entryModeName?: string;
+    readonly depth?: string;
+    readonly axes?: RunContext['axes'];
+    readonly activeStepAttempt?: number;
+    readonly resumeCheckpoint?: RunContext['resumeCheckpoint'];
+    readonly contextDeliveryActive?: boolean;
+}
+export interface ClockPort {
+    readonly now: () => Date;
+}
+export interface TraceLogPort {
+    load(): Promise<readonly TraceEntry[]>;
+    append(input: TraceEntryInput): Promise<TraceEntry>;
+    getAll(): readonly TraceEntry[];
+}
+export interface RunFilesPort {
+    resolve(ref: RunFileRef | string): string;
+    writeJson(ref: RunFileRef | string, value: unknown): Promise<string>;
+    writeText(ref: RunFileRef | string, value: string): Promise<string>;
+    readText(ref: RunFileRef | string): Promise<string>;
+    readJson<T = unknown>(ref: RunFileRef | string): Promise<T>;
+}
+export interface RunDirectoryPort {
+    readonly path: string;
+}
+export interface ProgressPort {
+    readonly report?: RunContext['progress'];
+}
+export interface ConnectorPort {
+    readonly relayConnector?: RunContext['relayConnector'];
+    readonly relayer?: RunContext['relayer'];
+}
+export interface ChildRunPort {
+    readonly executors?: RunContext['childExecutors'];
+    readonly compiledFlowResolver?: RunContext['childCompiledFlowResolver'];
+    readonly runner?: RunContext['childRunner'];
+    readonly externalFiles: RunContext['externalFiles'];
+}
+export interface WorktreePort {
+    readonly projectRoot?: string;
+    readonly evidencePolicy?: RunContext['evidencePolicy'];
+    readonly runner?: RunContext['worktreeRunner'];
+}
+export interface SelectionPort {
+    readonly configLayers?: RunContext['selectionConfigLayers'];
+}
+export interface RunPorts {
+    readonly clock: ClockPort;
+    readonly traceLog: TraceLogPort;
+    readonly runFiles: RunFilesPort;
+    readonly runDirectory: RunDirectoryPort;
+    readonly progress: ProgressPort;
+    readonly connector: ConnectorPort;
+    readonly childRun: ChildRunPort;
+    readonly worktree: WorktreePort;
+    readonly selection: SelectionPort;
+}
+export interface StepExecutionContext<Kind extends RuntimeIndexedStep['kind']> {
+    readonly run: RunValue;
+    readonly ports: RunPorts;
+    readonly indexedStep: Extract<RuntimeIndexedStep, {
+        readonly kind: Kind;
+    }>;
+}
+export declare function runValueFromContext(context: RunContext): RunValue;
+export declare function runPortsFromContext(context: RunContext): RunPorts;
+export declare function stepExecutionContextFromContext<Kind extends RuntimeIndexedStep['kind']>(context: RunContext, stepId: string, kind: Kind): StepExecutionContext<Kind>;
+//# sourceMappingURL=run-values.d.ts.map

package/dist/runtime/run/run-values.d.ts.map

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

package/dist/runtime/run/run-values.js

@@ -0,0 +1,85 @@
+import { requireRuntimeIndexedStep, } from '../../flows/registries/runtime-index.js';
+export const RUN_PORT_NAMES = [
+    'clock',
+    'traceLog',
+    'runFiles',
+    'runDirectory',
+    'progress',
+    'connector',
+    'childRun',
+    'worktree',
+    'selection',
+];
+export function runValueFromContext(context) {
+    return {
+        flow: context.flow,
+        packageIndex: context.packageIndex,
+        runId: context.runId,
+        goal: context.goal,
+        manifestHash: context.manifestHash,
+        ...(context.entryModeName === undefined ? {} : { entryModeName: context.entryModeName }),
+        ...(context.depth === undefined ? {} : { depth: context.depth }),
+        ...(context.axes === undefined ? {} : { axes: context.axes }),
+        ...(context.activeStepAttempt === undefined
+            ? {}
+            : { activeStepAttempt: context.activeStepAttempt }),
+        ...(context.resumeCheckpoint === undefined
+            ? {}
+            : { resumeCheckpoint: context.resumeCheckpoint }),
+        ...(context.contextDeliveryActive === undefined
+            ? {}
+            : { contextDeliveryActive: context.contextDeliveryActive }),
+    };
+}
+export function runPortsFromContext(context) {
+    return {
+        clock: { now: context.now },
+        traceLog: {
+            load: () => context.trace.load(),
+            append: (input) => context.trace.append(input),
+            getAll: () => context.trace.getAll(),
+        },
+        runFiles: {
+            resolve: (ref) => context.files.resolve(ref),
+            writeJson: (ref, value) => context.files.writeJson(ref, value),
+            writeText: (ref, value) => context.files.writeText(ref, value),
+            readText: (ref) => context.files.readText(ref),
+            readJson: (ref) => context.files.readJson(ref),
+        },
+        runDirectory: { path: context.runDir },
+        progress: {
+            ...(context.progress === undefined ? {} : { report: context.progress }),
+        },
+        connector: {
+            ...(context.relayConnector === undefined ? {} : { relayConnector: context.relayConnector }),
+            ...(context.relayer === undefined ? {} : { relayer: context.relayer }),
+        },
+        childRun: {
+            ...(context.childExecutors === undefined ? {} : { executors: context.childExecutors }),
+            ...(context.childCompiledFlowResolver === undefined
+                ? {}
+                : { compiledFlowResolver: context.childCompiledFlowResolver }),
+            ...(context.childRunner === undefined ? {} : { runner: context.childRunner }),
+            externalFiles: context.externalFiles,
+        },
+        worktree: {
+            ...(context.projectRoot === undefined ? {} : { projectRoot: context.projectRoot }),
+            ...(context.evidencePolicy === undefined ? {} : { evidencePolicy: context.evidencePolicy }),
+            ...(context.worktreeRunner === undefined ? {} : { runner: context.worktreeRunner }),
+        },
+        selection: {
+            ...(context.selectionConfigLayers === undefined
+                ? {}
+                : { configLayers: context.selectionConfigLayers }),
+        },
+    };
+}
+export function stepExecutionContextFromContext(context, stepId, kind) {
+    const run = runValueFromContext(context);
+    return {
+        run,
+        ports: runPortsFromContext(context),
+        indexedStep: requireRuntimeIndexedStep(run.packageIndex, stepId, kind),
+    };
+}
+//# sourceMappingURL=run-values.js.map

package/dist/runtime/run/run-values.js.map

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

package/dist/runtime/run/slice-corridor.d.ts

@@ -0,0 +1,27 @@
+import type { SliceLoopEngineFlag } from '../../flows/types.js';
+export interface SliceCorridorDeps {
+    readonly flag: SliceLoopEngineFlag | undefined;
+    readonly depth: string | undefined;
+    readonly readSlices: () => Promise<readonly unknown[]>;
+}
+export declare class SliceCorridor {
+    private readonly deps;
+    private readonly flag;
+    private readonly activeForDepth;
+    private slices;
+    private index;
+    constructor(deps: SliceCorridorDeps);
+    isActive(): boolean;
+    isLoopBodyStep(stepId: string): boolean;
+    ensureInitialized(): Promise<void>;
+    sliceCount(): number;
+    currentSliceIndex(): number;
+    currentSlice(): unknown | undefined;
+    countKey(stepId: string, sliceIndex: number): string;
+    shouldAdvance(input: {
+        stepId: string;
+        targetStepId: string | undefined;
+    }): boolean;
+    advance(): string;
+}
+//# sourceMappingURL=slice-corridor.d.ts.map

package/dist/runtime/run/slice-corridor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice-corridor.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/slice-corridor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAahE,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAE/C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAGnC,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;CACxD;AAED,qBAAa,aAAa;IAMZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAK;gBAEW,IAAI,EAAE,iBAAiB;IAQpD,QAAQ,IAAI,OAAO;IAKnB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC,UAAU,IAAI,MAAM;IAIpB,iBAAiB,IAAI,MAAM;IAI3B,YAAY,IAAI,OAAO,GAAG,SAAS;IASnC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAQpD,aAAa,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO;IAYnF,OAAO,IAAI,MAAM;CAOlB"}