@petepetrash/circuit 0.1.0

package/dist/selection/relay-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-selection.js","sourceRoot":"","sources":["../../src/selection/relay-selection.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,iCAAiC;AACjC,OAAO,EACL,MAAM,EACN,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAGL,gCAAgC,GACjC,MAAM,yBAAyB,CAAC;AAOjC,SAAS,sCAAsC,CAAC,GAA4B;IAC1E,OAAO,GAAG,CAAC,sCAAsC,KAAK,IAAI,CAAC;AAC7D,CAAC;AAED,SAAS,+CAA+C,CACtD,GAA4B,EAC5B,IAA2B,EAC3B,KAAoB;IAEpB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAoB,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG;QAChB,GAAG,CAAC,eAAe,EAAE,SAAS,IAAI,EAAE,CAAC;QACrC,KAAK;KACN,CAAC;IACF,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC;QAC1C,KAAK,EAAE,YAAY;QACnB,GAAG,CAAC,QAAQ,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrF,MAAM,EAAE;YACN,GAAG,UAAU;YACb,KAAK,EAAE;gBACL,GAAG,UAAU,CAAC,KAAK;gBACnB,CAAC,MAAM,CAAC,EAAE;oBACR,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;oBAC1B,SAAS;iBACV;aACF;SACF;KACF,CAAC,CAAC;IACH,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,aAAa,CAAC,GAAG,eAAe,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qCAAqC,CAC5C,GAA4B,EAC5B,IAA2B,EAC3B,KAAoB;IAEpB,IAAI,CAAC,sCAAsC,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,+CAA+C,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,GAA4B,EAC5B,IAA2B,EAC3B,IAA2B,EAC3B,KAAoB;IAEpB,OAAO,gCAAgC,CAAC;QACtC,IAAI;QACJ,IAAI;QACJ,YAAY,EAAE,qCAAqC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC;KACtE,CAAC,CAAC,QAAQ,CAAC;AACd,CAAC"}

package/dist/selection/selection-resolver.d.ts

@@ -0,0 +1,23 @@
+import type { LayeredConfig } from '../schemas/config.js';
+import { type SelectionOverride as SelectionOverrideValue, SelectionResolution } from '../schemas/selection-policy.js';
+export interface GuidanceSelectionFlow {
+    readonly id: string;
+    readonly default_selection?: SelectionOverrideValue | undefined;
+    readonly stages: readonly {
+        readonly id: string;
+        readonly steps: readonly string[];
+        readonly selection?: SelectionOverrideValue | undefined;
+    }[];
+}
+export interface GuidanceSelectionStep {
+    readonly id: string;
+    readonly selection?: unknown | undefined;
+}
+interface ResolveSelectionInput {
+    readonly flow: GuidanceSelectionFlow;
+    readonly step: GuidanceSelectionStep;
+    readonly configLayers?: readonly LayeredConfig[];
+}
+export declare function resolveSelectionForGuidanceInput(input: ResolveSelectionInput): SelectionResolution;
+export {};
+//# sourceMappingURL=selection-resolver.d.ts.map

package/dist/selection/selection-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-resolver.d.ts","sourceRoot":"","sources":["../../src/selection/selection-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAIL,KAAK,iBAAiB,IAAI,sBAAsB,EAChD,mBAAmB,EAGpB,MAAM,gCAAgC,CAAC;AAIxC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;KACzD,EAAE,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1C;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAClD;AAkID,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qBAAqB,GAC3B,mBAAmB,CAmErB"}

package/dist/selection/selection-resolver.js

@@ -0,0 +1,153 @@
+import { SelectionOverride, SelectionResolution, } from '../schemas/selection-policy.js';
+const PRE_FLOW_CONFIG_SOURCES = ['default', 'user-global', 'project'];
+function overrideContributes(o) {
+    if (o.model !== undefined)
+        return true;
+    if (o.effort !== undefined)
+        return true;
+    if (o.depth !== undefined)
+        return true;
+    if (o.skills.mode !== 'inherit')
+        return true;
+    if (Object.keys(o.invocation_options).length > 0)
+        return true;
+    return false;
+}
+function composeConfigLayerSelection(base, circuit, current) {
+    if (base === undefined && circuit === undefined)
+        return undefined;
+    const baseSkillOp = base?.skills.mode === 'inherit' ? undefined : base?.skills;
+    const circuitSkillOp = circuit?.skills.mode === 'inherit' ? undefined : circuit?.skills;
+    let skills;
+    if (baseSkillOp !== undefined || circuitSkillOp !== undefined) {
+        // One applied entry represents the whole config source, so same-file
+        // default + per-flow skill ops are normalized to their effective set.
+        const baseSkills = baseSkillOp !== undefined ? applySkillOp(current.skills, baseSkillOp) : current.skills;
+        const composedSkills = circuitSkillOp !== undefined ? applySkillOp(baseSkills, circuitSkillOp) : baseSkills;
+        skills = { mode: 'replace', skills: [...composedSkills] };
+    }
+    const raw = {
+        ...(base?.model !== undefined || circuit?.model !== undefined
+            ? { model: circuit?.model ?? base?.model }
+            : {}),
+        ...(base?.effort !== undefined || circuit?.effort !== undefined
+            ? { effort: circuit?.effort ?? base?.effort }
+            : {}),
+        ...(skills !== undefined ? { skills } : {}),
+        ...(base?.depth !== undefined || circuit?.depth !== undefined
+            ? { depth: circuit?.depth ?? base?.depth }
+            : {}),
+        invocation_options: {
+            ...(base?.invocation_options ?? {}),
+            ...(circuit?.invocation_options ?? {}),
+        },
+    };
+    const parsed = SelectionOverride.parse(raw);
+    return overrideContributes(parsed) ? parsed : undefined;
+}
+function configLayerSelection(flowId, layer, current) {
+    const flows = layer.config.flows;
+    const circuit = Object.hasOwn(flows, flowId) ? flows[flowId] : undefined;
+    return composeConfigLayerSelection(layer.config.defaults.selection, circuit?.selection, current);
+}
+function applySkillOp(base, op) {
+    if (op.mode === 'inherit')
+        return base;
+    if (op.mode === 'replace')
+        return op.skills;
+    if (op.mode === 'append') {
+        const seen = new Set(base);
+        const out = [...base];
+        for (const s of op.skills) {
+            const key = s;
+            if (!seen.has(key)) {
+                seen.add(key);
+                out.push(s);
+            }
+        }
+        return out;
+    }
+    const removeSet = new Set(op.skills);
+    return base.filter((s) => !removeSet.has(s));
+}
+function applyOverride(current, override) {
+    const model = override.model ?? current.model;
+    const effort = override.effort ?? current.effort;
+    const depth = override.depth ?? current.depth;
+    const skills = applySkillOp(current.skills, override.skills);
+    const invocation_options = {
+        ...current.invocation_options,
+        ...override.invocation_options,
+    };
+    return {
+        ...(model !== undefined ? { model } : {}),
+        ...(effort !== undefined ? { effort } : {}),
+        skills,
+        ...(depth !== undefined ? { depth } : {}),
+        invocation_options,
+    };
+}
+function pushIfContributing(applied, entry, resolved) {
+    if (!overrideContributes(entry.override))
+        return resolved;
+    applied.push(entry);
+    return applyOverride(resolved, entry.override);
+}
+function configLayersBySource(layers) {
+    const out = {};
+    const seen = new Set();
+    for (const layer of layers) {
+        if (seen.has(layer.layer)) {
+            throw new Error(`duplicate selection config layer '${layer.layer}'`);
+        }
+        seen.add(layer.layer);
+        out[layer.layer] = layer;
+    }
+    return out;
+}
+export function resolveSelectionForGuidanceInput(input) {
+    const flowId = input.flow.id;
+    const stepId = input.step.id;
+    const applied = [];
+    let resolved = { skills: [], invocation_options: {} };
+    const configLayers = configLayersBySource(input.configLayers ?? []);
+    for (const source of PRE_FLOW_CONFIG_SOURCES) {
+        const layer = configLayers[source];
+        if (layer === undefined)
+            continue;
+        const override = configLayerSelection(flowId, layer, resolved);
+        if (override === undefined)
+            continue;
+        resolved = pushIfContributing(applied, {
+            source,
+            override,
+        }, resolved);
+    }
+    if (input.flow.default_selection !== undefined) {
+        resolved = pushIfContributing(applied, { source: 'flow', override: input.flow.default_selection }, resolved);
+    }
+    for (const stage of input.flow.stages) {
+        const stageSteps = stage.steps;
+        if (!stageSteps.includes(stepId))
+            continue;
+        if (stage.selection === undefined)
+            continue;
+        resolved = pushIfContributing(applied, { source: 'stage', stage_id: stage.id, override: stage.selection }, resolved);
+    }
+    if (input.step.selection !== undefined) {
+        resolved = pushIfContributing(applied, {
+            source: 'step',
+            step_id: input.step.id,
+            override: input.step.selection,
+        }, resolved);
+    }
+    const invocationLayer = configLayers.invocation;
+    const invocationOverride = invocationLayer === undefined
+        ? undefined
+        : configLayerSelection(flowId, invocationLayer, resolved);
+    if (invocationOverride !== undefined) {
+        resolved = pushIfContributing(applied, { source: 'invocation', override: invocationOverride }, resolved);
+    }
+    return SelectionResolution.parse({ resolved, applied });
+}
+//# sourceMappingURL=selection-resolver.js.map

package/dist/selection/selection-resolver.js.map

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

package/dist/shared/atomic-io.d.ts

@@ -0,0 +1,11 @@
+export interface AtomicWriteOptions {
+    /**
+     * Called with the staged file's bytes (re-read from disk) before the
+     * rename commits. Throw to abort the write; the target is left untouched.
+     */
+    readonly validate?: (raw: string) => void;
+}
+export declare function writeTextAtomic(path: string, contents: string, options?: AtomicWriteOptions): void;
+/** Atomic write of `JSON.stringify(value, null, 2)` plus a trailing newline. */
+export declare function writeJsonAtomic(path: string, value: unknown, options?: AtomicWriteOptions): void;
+//# sourceMappingURL=atomic-io.d.ts.map

package/dist/shared/atomic-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-io.d.ts","sourceRoot":"","sources":["../../src/shared/atomic-io.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAaN;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAEN"}

package/dist/shared/atomic-io.js

@@ -0,0 +1,29 @@
+// Atomic file writes for control-plane artifacts: stage to a sibling temp
+// file, then rename over the target. Rename is atomic within a filesystem,
+// so a concurrent reader sees either the old file or the new one, never a
+// torn half-write. Writers that persist schema-validated artifacts pass a
+// `validate` hook that re-reads the staged bytes before the rename commits,
+// so a serialization defect can never land on disk.
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+export function writeTextAtomic(path, contents, options = {}) {
+    mkdirSync(dirname(path), { recursive: true });
+    const staging = `${path}.${randomUUID()}.tmp`;
+    writeFileSync(staging, contents);
+    try {
+        options.validate?.(readFileSync(staging, 'utf8'));
+        renameSync(staging, path);
+    }
+    catch (error) {
+        // Failed writes must not accumulate orphaned staging files next to the
+        // target; nothing globs or cleans them up later.
+        rmSync(staging, { force: true });
+        throw error;
+    }
+}
+/** Atomic write of `JSON.stringify(value, null, 2)` plus a trailing newline. */
+export function writeJsonAtomic(path, value, options = {}) {
+    writeTextAtomic(path, `${JSON.stringify(value, null, 2)}\n`, options);
+}
+//# sourceMappingURL=atomic-io.js.map

package/dist/shared/atomic-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-io.js","sourceRoot":"","sources":["../../src/shared/atomic-io.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,4EAA4E;AAC5E,oDAAoD;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,QAAgB,EAChB,UAA8B,EAAE;IAEhC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAC9C,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,iDAAiD;QACjD,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAc,EACd,UAA8B,EAAE;IAEhC,eAAe,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}

package/dist/shared/checkpoint-auto-resolution.d.ts

@@ -0,0 +1,17 @@
+import type { OperatorAutoResolution } from '../schemas/operator-summary.js';
+interface HighestScoreAutoResolutionInput {
+    readonly checkpointId: string;
+    readonly checkpointLabel?: string;
+    readonly choices: readonly string[];
+    readonly resolvedAt: string;
+    readonly branches: readonly unknown[];
+    readonly idPath: string;
+    readonly rubricResultPath: string;
+}
+interface HighestScoreAutoResolutionResult {
+    readonly selection: string;
+    readonly record: OperatorAutoResolution;
+}
+export declare function resolveHighestScoreAutoResolution(input: HighestScoreAutoResolutionInput): HighestScoreAutoResolutionResult;
+export {};
+//# sourceMappingURL=checkpoint-auto-resolution.d.ts.map

package/dist/shared/checkpoint-auto-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-auto-resolution.d.ts","sourceRoot":"","sources":["../../src/shared/checkpoint-auto-resolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAI7E,UAAU,+BAA+B;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,gCAAgC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,+BAA+B,GACrC,gCAAgC,CAoElC"}

package/dist/shared/checkpoint-auto-resolution.js

@@ -0,0 +1,72 @@
+import { rankRubricCandidates } from '../policy/rubric.js';
+import { RubricResult } from '../schemas/rubric.js';
+import { resolveDottedPath } from './fanout-branch-template.js';
+export function resolveHighestScoreAutoResolution(input) {
+    const choiceIds = new Set(input.choices);
+    if (choiceIds.size !== input.choices.length) {
+        throw new Error(`checkpoint '${input.checkpointId}' highest-score choices must be unique`);
+    }
+    const candidates = input.branches.flatMap((branch, index) => {
+        const id = resolveDottedPath(branch, input.idPath);
+        if (typeof id !== 'string' || id.length === 0) {
+            throw new Error(`checkpoint '${input.checkpointId}' highest-score branch ${index + 1} is missing id '${input.idPath}'`);
+        }
+        const rawRubric = resolveDottedPath(branch, input.rubricResultPath);
+        if (rawRubric === undefined)
+            return [];
+        if (!choiceIds.has(id))
+            return [];
+        return [
+            {
+                id,
+                original_ordinal: index + 1,
+                result: RubricResult.parse(rawRubric),
+            },
+        ];
+    });
+    const candidateIds = new Set(candidates.map((candidate) => candidate.id));
+    const missingRubricRows = input.choices.filter((choice) => !candidateIds.has(choice));
+    if (missingRubricRows.length > 0) {
+        throw new Error(`checkpoint '${input.checkpointId}' highest-score missing rubric rows for choices: ${missingRubricRows.join(', ')}`);
+    }
+    const ranking = rankRubricCandidates(candidates);
+    const scores = Object.fromEntries(ranking.ranked.map((candidate) => [
+        candidate.id,
+        {
+            aggregate_score: candidate.result.aggregate_score,
+            runtime_veto_count: candidate.result.runtime_veto_count,
+        },
+    ]));
+    const rubricResults = Object.fromEntries(ranking.ranked.map((candidate) => [candidate.id, candidate.result]));
+    const record = {
+        checkpoint_id: input.checkpointId,
+        ...(input.checkpointLabel === undefined ? {} : { checkpoint_label: input.checkpointLabel }),
+        policy: 'highest-score',
+        resolved_value: ranking.winner.id,
+        alternatives_available: ranking.ranked
+            .filter((candidate) => candidate.id !== ranking.winner.id)
+            .map((candidate) => candidate.id),
+        scores,
+        rubric_results: rubricResults,
+        winning_score: ranking.winner.result.aggregate_score,
+        ...(ranking.runner_up === undefined
+            ? {}
+            : { runner_up_score: ranking.runner_up.result.aggregate_score }),
+        margin: ranking.margin,
+        tie_break: ranking.tie_break.final_reason,
+        runtime_veto_effect: runtimeVetoEffect(ranking.ranked),
+        resolved_at: input.resolvedAt,
+    };
+    return { selection: ranking.winner.id, record };
+}
+function runtimeVetoEffect(candidates) {
+    for (const candidate of candidates) {
+        for (const [dimId, dim] of Object.entries(candidate.result.dims)) {
+            if (!dim.runtime_vetoed)
+                continue;
+            return `${candidate.id} ${dimId} runtime_signal=missing forced final_score=fail and dim_score=0`;
+        }
+    }
+    return 'none';
+}
+//# sourceMappingURL=checkpoint-auto-resolution.js.map

package/dist/shared/checkpoint-auto-resolution.js.map

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

package/dist/shared/checkpoint-boundary.d.ts

@@ -0,0 +1,15 @@
+import { type CheckpointBoundaryProjectionV0 as CheckpointBoundaryProjectionValue, type CheckpointReasonCode, type PolicyRef } from '../schemas/checkpoint-boundary.js';
+import type { CompiledFlowId } from '../schemas/ids.js';
+import type { CheckpointStep } from '../schemas/step.js';
+export { CheckpointBoundaryProjectionV0, CheckpointBoundaryRequestedTraceV0, CheckpointBoundaryResolutionV0, } from '../schemas/checkpoint-boundary.js';
+export declare class CheckpointBoundaryProjectionError extends Error {
+    constructor(message: string);
+}
+interface ProjectCheckpointBoundaryInput {
+    readonly step: CheckpointStep;
+    readonly flowId: CompiledFlowId;
+    readonly reasonCode?: CheckpointReasonCode;
+    readonly declaredDefaultPolicyRefs?: readonly PolicyRef[];
+}
+export declare function projectCheckpointBoundaryV0(input: ProjectCheckpointBoundaryInput): CheckpointBoundaryProjectionValue;
+//# sourceMappingURL=checkpoint-boundary.d.ts.map

package/dist/shared/checkpoint-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-boundary.d.ts","sourceRoot":"","sources":["../../src/shared/checkpoint-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,8BAA8B,IAAI,iCAAiC,EAGxE,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,mCAAmC,CAAC;AAE3C,qBAAa,iCAAkC,SAAQ,KAAK;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,UAAU,8BAA8B;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC3D;AAkED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,8BAA8B,GACpC,iCAAiC,CA4FnC"}

package/dist/shared/checkpoint-boundary.js

@@ -0,0 +1,125 @@
+import { CheckpointBoundaryProjectionV0, } from '../schemas/checkpoint-boundary.js';
+import { sha256OfJson } from '../schemas/hashing.js';
+export { CheckpointBoundaryProjectionV0, CheckpointBoundaryRequestedTraceV0, CheckpointBoundaryResolutionV0, } from '../schemas/checkpoint-boundary.js';
+export class CheckpointBoundaryProjectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CheckpointBoundaryProjectionError';
+    }
+}
+function sha256(value) {
+    return sha256OfJson(value);
+}
+function rejectOldAuthority(path, field, reason) {
+    return { path, field, reason };
+}
+function routeForChoice(step, choiceId) {
+    const directTarget = step.routes[choiceId];
+    if (directTarget !== undefined) {
+        return { id: choiceId, target: directTarget };
+    }
+    throw new CheckpointBoundaryProjectionError(`checkpoint choice '${choiceId}' on step '${step.id}' has no explicit declared route`);
+}
+function consequenceForChoice(choice) {
+    return (choice.description ??
+        choice.label ??
+        `Select checkpoint choice '${choice.id}' and follow its declared route.`);
+}
+function dynamicRouteFamily(step) {
+    const selectTarget = step.routes.select;
+    if (selectTarget !== undefined) {
+        return { id: 'select', target: selectTarget };
+    }
+    const passTarget = step.routes.pass;
+    if (passTarget !== undefined) {
+        return { id: 'pass', target: passTarget };
+    }
+    throw new CheckpointBoundaryProjectionError(`dynamic checkpoint step '${step.id}' has no route family for produced choices`);
+}
+function staticChoices(step) {
+    const choices = step.policy.choices;
+    if (choices === undefined) {
+        throw new CheckpointBoundaryProjectionError(`checkpoint step '${step.id}' has no static choices`);
+    }
+    return choices.map((choice) => ({
+        id: choice.id,
+        ...(choice.label === undefined ? {} : { label: choice.label }),
+        ...(choice.description === undefined ? {} : { description: choice.description }),
+        route: routeForChoice(step, choice.id),
+        consequence: consequenceForChoice(choice),
+    }));
+}
+export function projectCheckpointBoundaryV0(input) {
+    const { step } = input;
+    const rejectedOldAuthority = [];
+    const declaredDefaultPolicyRefs = input.declaredDefaultPolicyRefs ?? [];
+    if (step.policy.auto_resolution !== undefined) {
+        rejectedOldAuthority.push(rejectOldAuthority(`compiled-flow/steps/${step.id}/policy/auto_resolution`, `auto_resolution.${step.policy.auto_resolution.policy}`, 'checkpoint auto-resolution must become declared default or traced guidance, not a direct resolver'));
+    }
+    const choices = step.policy.choices !== undefined
+        ? {
+            kind: 'static',
+            items: staticChoices(step),
+        }
+        : (() => {
+            const routeFamily = dynamicRouteFamily(step);
+            return {
+                kind: 'dynamic',
+                source: step.policy.choices_from,
+                route_family: routeFamily,
+                consequence_template: `Select one dynamic checkpoint choice and take route '${routeFamily.id}' to '${routeFamily.target}'.`,
+            };
+        })();
+    const declaredDefault = step.policy.safe_default_choice !== undefined &&
+        choices.kind === 'static' &&
+        declaredDefaultPolicyRefs.length > 0
+        ? {
+            choice_id: step.policy.safe_default_choice,
+            allowed_when: declaredDefaultPolicyRefs,
+            reason_code: 'safe_default_choice',
+        }
+        : undefined;
+    if (step.policy.safe_default_choice !== undefined && declaredDefault === undefined) {
+        rejectedOldAuthority.push(rejectOldAuthority(`compiled-flow/steps/${step.id}/policy/safe_default_choice`, 'safe_default_choice', 'safe default choices require static choices and explicit policy refs before they become declared defaults'));
+    }
+    const boundary = {
+        schema_version: 0,
+        step_id: step.id,
+        reason_code: input.reasonCode ?? 'ambiguous_intent',
+        authority_required: declaredDefault === undefined ? 'operator' : 'policy',
+        prompt: step.policy.prompt,
+        choices,
+        ...(declaredDefault === undefined ? {} : { declared_default: declaredDefault }),
+        writes: step.writes,
+        check: step.check,
+        proof_refs: [],
+    };
+    const boundaryHash = sha256(boundary);
+    const boundaryRef = {
+        kind: 'work_contract',
+        ref: `compiled-flow/steps/${step.id}/checkpoint-boundary.v0`,
+        sha256: boundaryHash,
+        flow_id: input.flowId,
+        step_id: step.id,
+    };
+    return CheckpointBoundaryProjectionV0.parse({
+        schema_version: 0,
+        boundary,
+        request_trace: {
+            boundary_ref: boundaryRef,
+            boundary_hash: boundaryHash,
+        },
+        allowed_resolution_sources: ['operator', 'declared-default', 'policy'],
+        resume_validation: {
+            request_path_matches_step: true,
+            request_hash_required: true,
+            choices_match_request: true,
+            selected_choice_allowed: true,
+            report_hash_matches_when_present: true,
+            boundary_hash_required: true,
+            guidance_decision_required_before_resolution: true,
+        },
+        rejected_old_authority: rejectedOldAuthority,
+    });
+}
+//# sourceMappingURL=checkpoint-boundary.js.map

package/dist/shared/checkpoint-boundary.js.map

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

package/dist/shared/config-loader.d.ts

@@ -0,0 +1,20 @@
+import { type Config as ConfigValue, LayeredConfig } from '../schemas/config.js';
+import { type PolicyLayer as PolicyLayerValue } from '../schemas/policy-envelope.js';
+interface DiscoverConfigLayersOptions {
+    readonly homeDir?: string;
+    readonly cwd?: string;
+    readonly invocationConfig?: ConfigValue;
+}
+interface DiscoverRuntimeConfigOptions extends DiscoverConfigLayersOptions {
+    readonly invocationPolicy?: PolicyLayerValue['envelope'];
+}
+export interface RuntimeConfigLayers {
+    readonly selectionConfigLayers: readonly LayeredConfig[];
+    readonly policyLayers: readonly PolicyLayerValue[];
+}
+export declare function userGlobalConfigPath(homeDir?: string): string;
+export declare function projectConfigPath(cwd?: string): string;
+export declare function discoverConfigLayers(options?: DiscoverConfigLayersOptions): readonly LayeredConfig[];
+export declare function discoverRuntimeConfigLayers(options?: DiscoverRuntimeConfigOptions): RuntimeConfigLayers;
+export {};
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/shared/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/shared/config-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,KAAK,MAAM,IAAI,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAGL,KAAK,WAAW,IAAI,gBAAgB,EACrC,MAAM,+BAA+B,CAAC;AAMvC,UAAU,2BAA2B;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC;CACzC;AAED,UAAU,4BAA6B,SAAQ,2BAA2B;IACxE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,aAAa,EAAE,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAY,GAAG,MAAM,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,SAAgB,GAAG,MAAM,CAE7D;AAiGD,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,SAAS,aAAa,EAAE,CAmB1B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,mBAAmB,CAgCrB"}