@petepetrash/circuit 0.1.0

package/dist/cli/resume-input.js

@@ -0,0 +1,58 @@
+import { join, resolve } from 'node:path';
+import { runsRoot } from '../shared/control-plane-paths.js';
+export function matchCheckpointChoice(raw, choices) {
+    for (const choice of choices) {
+        if (choice.id === raw)
+            return { kind: 'exact', id: choice.id };
+    }
+    const wanted = raw.trim().toLowerCase();
+    if (wanted.length === 0)
+        return { kind: 'no_match' };
+    const idMatches = choices.filter((choice) => choice.id.toLowerCase() === wanted);
+    if (idMatches.length === 1 && idMatches[0] !== undefined) {
+        return { kind: 'normalized', id: idMatches[0].id };
+    }
+    // Ids stay authoritative: the label rung only runs when no id claimed the
+    // value, and an ambiguous label refuses rather than guesses.
+    if (idMatches.length === 0) {
+        const labelMatches = choices.filter((choice) => choice.label.trim().toLowerCase() === wanted);
+        if (labelMatches.length === 1 && labelMatches[0] !== undefined) {
+            return { kind: 'normalized', id: labelMatches[0].id };
+        }
+    }
+    return { kind: 'no_match' };
+}
+export function invalidCheckpointChoiceMessage(input) {
+    const lines = [
+        `error: '${input.attempted}' is not one of this checkpoint's choices.`,
+        'The run is waiting with these choices:',
+    ];
+    for (const choice of input.checkpoint.choices) {
+        lines.push(choice.label === choice.id ? `  ${choice.id}` : `  ${choice.id} (${choice.label})`);
+    }
+    lines.push(`Resume with: circuit resume --run-folder ${input.runFolder} --checkpoint-choice <one of the choices above>`);
+    return lines.join('\n');
+}
+// Operators paste the run id from the JSON envelope or the checkpoints list at
+// least as often as the full folder path. A bare name (no path separator)
+// also gets a try under the project's runs root before we give up.
+export function runFolderCandidates(argument, cwd) {
+    const direct = resolve(cwd, argument);
+    const isBareName = !argument.includes('/') && !argument.includes('\\') && argument !== '.' && argument !== '..';
+    if (!isBareName)
+        return [direct];
+    return [direct, join(runsRoot(cwd), argument)];
+}
+// Two honest shapes: a path that is not on disk was "not found"; a path that
+// exists but holds no readable run trace must never be described that way.
+export function missingRunFolderMessage(input) {
+    const lead = input.exists
+        ? `error: ${input.resolved} is not a resumable Circuit run folder (it has no readable run trace).`
+        : `error: no Circuit run folder found at ${input.resolved}.`;
+    return [
+        lead,
+        "A run's folder is .circuit/runs/<run id> inside the project that started it.",
+        'List runs that are waiting for a decision with: circuit checkpoints',
+    ].join('\n');
+}
+//# sourceMappingURL=resume-input.js.map

package/dist/cli/resume-input.js.map

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

package/dist/cli/routed-connectors.d.ts

@@ -0,0 +1,14 @@
+import type { LayeredConfig as LayeredConfigValue } from '../schemas/config.js';
+import type { CustomConnectorDescriptor } from '../schemas/connector.js';
+import type { HostKind } from '../schemas/host.js';
+export interface RoutedConnectorsInput {
+    readonly configLayers?: readonly LayeredConfigValue[];
+    readonly hostKind?: HostKind;
+}
+export interface RoutedConnectors {
+    readonly names: ReadonlySet<string>;
+    readonly routes: ReadonlyMap<string, readonly string[]>;
+    readonly custom: ReadonlyMap<string, CustomConnectorDescriptor>;
+}
+export declare function resolveRoutedConnectors(input?: RoutedConnectorsInput): RoutedConnectors;
+//# sourceMappingURL=routed-connectors.d.ts.map

package/dist/cli/routed-connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routed-connectors.d.ts","sourceRoot":"","sources":["../../src/cli/routed-connectors.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAyB,MAAM,yBAAyB,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAG/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAMpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAGxD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CACjE;AA2DD,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,qBAA0B,GAAG,gBAAgB,CAoB3F"}

package/dist/cli/routed-connectors.js

@@ -0,0 +1,85 @@
+// The routed connector set — every connector at least one public flow's relay
+// step would actually dispatch through, under the effective config layers and
+// host kind. `circuit doctor` grades only these connectors for readiness;
+// everything else is reported informationally, since a broken connector no
+// flow routes to cannot break a run.
+//
+// Reuses the exact connector-resolution seam `circuit preview` walks
+// (explicitConnectorForStep + resolveConnectorForGuidanceInput) rather than
+// duplicating it, but skips the model/effort machinery `circuit preview`
+// needs and doctor does not — no codex default-model cache read.
+import { resolveConnectorForGuidanceInput } from '../connectors/resolver.js';
+import { flowDefinitions } from '../flows/catalog.js';
+import { compileSchematicToCompiledFlow } from '../flows/compile-schematic-to-flow.js';
+import { fromCompiledFlow } from '../runtime/manifest/from-compiled-flow.js';
+import { buildRuntimePackageIndex } from '../runtime/manifest/runtime-package-index.js';
+import { RelayRole as RelayRoleSchema } from '../schemas/step.js';
+import { explicitConnectorForStep, firstCompiledFlow } from './flow-selection-preview.js';
+// The teachable phrase for one resolution source. `role:`/`flow:` name the
+// config keys (`relay.roles.<role>`, `relay.flows.<flow>`) an operator would
+// set to change the decision; `step pin` is authored by the flow itself.
+function describeResolutionSource(source) {
+    switch (source.source) {
+        case 'explicit':
+            return 'step pin';
+        case 'role':
+            return `role: ${source.role}`;
+        case 'flow':
+            return `flow: ${source.flow_id}`;
+        case 'default':
+            return 'default';
+        case 'auto':
+            return 'auto';
+    }
+}
+function routedConnectorsForFlow(flowId, layers, hostKind) {
+    const definition = flowDefinitions.find((candidate) => candidate.id === flowId);
+    if (definition === undefined)
+        throw new Error(`unknown flow '${flowId}'`);
+    const compiled = firstCompiledFlow(compileSchematicToCompiledFlow(definition.schematic));
+    const index = buildRuntimePackageIndex(fromCompiledFlow(compiled));
+    const resolved = [];
+    for (const step of index.flow.steps) {
+        if (step.kind !== 'relay')
+            continue;
+        const role = RelayRoleSchema.parse(step.role);
+        const explicitConnector = explicitConnectorForStep(step, layers);
+        const decision = resolveConnectorForGuidanceInput({
+            flowId,
+            role,
+            configLayers: layers,
+            ...(explicitConnector === undefined ? {} : { explicitConnector }),
+            ...(hostKind === undefined ? {} : { hostKind }),
+        });
+        resolved.push({
+            connectorName: decision.connectorName,
+            route: describeResolutionSource(decision.resolvedFrom),
+            descriptor: decision.connector.kind === 'custom' ? decision.connector : undefined,
+        });
+    }
+    return resolved;
+}
+export function resolveRoutedConnectors(input = {}) {
+    const layers = input.configLayers ?? [];
+    const names = new Set();
+    const routeSets = new Map();
+    const custom = new Map();
+    for (const definition of flowDefinitions) {
+        if (definition.visibility !== 'public')
+            continue;
+        for (const step of routedConnectorsForFlow(definition.id, layers, input.hostKind)) {
+            names.add(step.connectorName);
+            const routeSet = routeSets.get(step.connectorName) ?? new Set();
+            routeSet.add(step.route);
+            routeSets.set(step.connectorName, routeSet);
+            if (step.descriptor !== undefined)
+                custom.set(step.connectorName, step.descriptor);
+        }
+    }
+    const routes = new Map();
+    for (const [name, routeSet] of routeSets) {
+        routes.set(name, [...routeSet].sort());
+    }
+    return { names, routes, custom };
+}
+//# sourceMappingURL=routed-connectors.js.map

package/dist/cli/routed-connectors.js.map

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

package/dist/cli/run-flag-vocabulary.d.ts

@@ -0,0 +1,14 @@
+export interface RunExecutionFlag {
+    /** Long flag name as typed, e.g. '--goal'. */
+    readonly flag: string;
+    /** Commander value placeholder, e.g. '<goal>'. Absent for booleans. */
+    readonly valueHint?: string;
+    /**
+     * Whether a living doc may teach this flag. `--dry-run` is declared
+     * but hard-rejected at parse time (see the fail-closed guard in
+     * `parseExecutionArgs`), so no doc is allowed to teach it.
+     */
+    readonly docValid: boolean;
+}
+export declare const RUN_EXECUTION_FLAGS: readonly RunExecutionFlag[];
+//# sourceMappingURL=run-flag-vocabulary.d.ts.map

package/dist/cli/run-flag-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-flag-vocabulary.d.ts","sourceRoot":"","sources":["../../src/cli/run-flag-vocabulary.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAmB1D,CAAC"}

package/dist/cli/run-flag-vocabulary.js

@@ -0,0 +1,38 @@
+// Run execution-flag vocabulary — the single source of truth for the
+// `circuit run` / `circuit resume` option surface.
+//
+// `addExecutionOptions` in `src/cli/run.ts` derives every commander
+// `.option()` call from these rows, and the doc lint
+// (`tests/contracts/doc-command-claims.test.ts`) validates every flag a
+// living doc teaches against the same rows. Adding a flag here is the
+// only step needed for it to parse AND become teachable; a flag absent
+// here cannot appear in a doc without failing the lint.
+//
+// Dependency-light leaf: imports only from `src/schemas/` (zod-only
+// modules), never from `run.ts` or anything that could cycle back into
+// the CLI. The `--process`/`--power` value hints derive from the zod
+// enums so a tier rename is physically one edit that feeds the CLI
+// parser, the help text, and the doc lint together.
+import { PowerDialSetting } from '../schemas/power.js';
+import { Process } from '../schemas/process.js';
+export const RUN_EXECUTION_FLAGS = [
+    { flag: '--goal', valueHint: '<goal>', docValid: true },
+    { flag: '--why', valueHint: '<why>', docValid: true },
+    { flag: '--process', valueHint: `<${Process.options.join('|')}>`, docValid: true },
+    { flag: '--power', valueHint: `<${PowerDialSetting.options.join('|')}>`, docValid: true },
+    { flag: '--tournament', valueHint: '[2|3|4]', docValid: true },
+    { flag: '--autonomous', docValid: true },
+    { flag: '--run-folder', valueHint: '<path>', docValid: true },
+    { flag: '--fixture', valueHint: '<path>', docValid: true },
+    { flag: '--flow-root', valueHint: '<path>', docValid: true },
+    { flag: '--checkpoint-choice', valueHint: '<choice>', docValid: true },
+    { flag: '--progress', valueHint: '<format>', docValid: true },
+    // Declared so the parser owns the rejection message; never teachable.
+    { flag: '--dry-run', docValid: false },
+    { flag: '--include-untracked-content', docValid: true },
+    // Restart cheapness: a prior crashed run's folder whose finished sub-run
+    // fanout branches this fresh run reuses by structural address instead of
+    // re-running. Fresh-run only; rejected on resume.
+    { flag: '--reuse-children-from', valueHint: '<path>', docValid: true },
+];
+//# sourceMappingURL=run-flag-vocabulary.js.map

package/dist/cli/run-flag-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-flag-vocabulary.js","sourceRoot":"","sources":["../../src/cli/run-flag-vocabulary.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,qDAAqD;AACrD,wEAAwE;AACxE,sEAAsE;AACtE,uEAAuE;AACvE,wDAAwD;AACxD,EAAE;AACF,oEAAoE;AACpE,uEAAuE;AACvE,qEAAqE;AACrE,mEAAmE;AACnE,oDAAoD;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAehD,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrD,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClF,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;IACzF,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9D,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC7D,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC1D,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC5D,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IACtE,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC7D,sEAAsE;IACtE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE;IACtC,EAAE,IAAI,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvD,yEAAyE;IACzE,yEAAyE;IACzE,kDAAkD;IAClD,EAAE,IAAI,EAAE,uBAAuB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;CACvE,CAAC"}

package/dist/cli/run-output.d.ts

@@ -0,0 +1,32 @@
+import type { OperatorSummaryWriteResult } from '../app/operator-summary/writer.js';
+import type { WriteRunEnvelopeRecordResult } from '../app/run-envelope/source-record.js';
+export interface RouteOutputFieldsInput {
+    readonly selectedFlow: string;
+    readonly routedBy: 'explicit';
+    readonly routerReason: string;
+    readonly entryMode?: string;
+    readonly entryModeSource?: 'explicit' | 'derived';
+}
+export interface SelectedProcessFieldsInput {
+    readonly processId: string;
+    readonly routedBy?: 'explicit';
+    readonly routerReason: string;
+    readonly entryMode?: string;
+}
+export interface SelectedProcessFields {
+    readonly process_id: string;
+    readonly routed_by?: 'explicit';
+    readonly router_reason: string;
+    readonly entry_mode?: string;
+}
+export interface OperatorSummaryOutputFieldsInput {
+    readonly operatorSummary: OperatorSummaryWriteResult;
+}
+export interface RunEnvelopeOutputFieldsInput {
+    readonly runEnvelope: WriteRunEnvelopeRecordResult;
+}
+export declare function routeOutputFields(input: RouteOutputFieldsInput): Record<string, unknown>;
+export declare function selectedProcessFields(input: SelectedProcessFieldsInput): SelectedProcessFields;
+export declare function operatorSummaryOutputFields(input: OperatorSummaryOutputFieldsInput): Record<string, unknown>;
+export declare function runEnvelopeOutputFields(input: RunEnvelopeOutputFieldsInput): Record<string, unknown>;
+//# sourceMappingURL=run-output.d.ts.map

package/dist/cli/run-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-output.d.ts","sourceRoot":"","sources":["../../src/cli/run-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AAEzF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,0BAA0B,CAAC;CACtD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;CACpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQxF;AAOD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,qBAAqB,CAO9F;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/cli/run-output.js

@@ -0,0 +1,47 @@
+export function routeOutputFields(input) {
+    return {
+        selected_flow: input.selectedFlow,
+        routed_by: input.routedBy,
+        router_reason: input.routerReason,
+        ...(input.entryMode === undefined ? {} : { entry_mode: input.entryMode }),
+        ...(input.entryModeSource === undefined ? {} : { entry_mode_source: input.entryModeSource }),
+    };
+}
+// The selected_process literal shared by the run-envelope shadow + source
+// writers (and the route.selected progress event's process facet). The three
+// post-run call sites (closed run, checkpoint-waiting, resume) restate the same
+// shape; this builder owns the optional-field collapsing so the key order and
+// omission rules stay identical across them.
+export function selectedProcessFields(input) {
+    return {
+        process_id: input.processId,
+        ...(input.routedBy === undefined ? {} : { routed_by: input.routedBy }),
+        router_reason: input.routerReason,
+        ...(input.entryMode === undefined ? {} : { entry_mode: input.entryMode }),
+    };
+}
+export function operatorSummaryOutputFields(input) {
+    const operatorSummary = input.operatorSummary;
+    return {
+        operator_summary_path: operatorSummary.jsonPath,
+        operator_summary_markdown_path: operatorSummary.markdownPath,
+        ...(operatorSummary.summary.status_text === undefined
+            ? {}
+            : { operator_summary_status_text: operatorSummary.summary.status_text }),
+        ...(operatorSummary.htmlPath === undefined
+            ? {}
+            : { operator_summary_html_path: operatorSummary.htmlPath }),
+    };
+}
+export function runEnvelopeOutputFields(input) {
+    return {
+        run_envelope_path: input.runEnvelope.path,
+        run_process_evidence_path: input.runEnvelope.processEvidencePath,
+        run_surface_markdown_path: input.runEnvelope.surfacePath,
+        run_surface_status_text: input.runEnvelope.record.surface_output.status_text,
+        ...(input.runEnvelope.decisionPacketPaths.length === 0
+            ? {}
+            : { run_decision_packet_paths: input.runEnvelope.decisionPacketPaths }),
+    };
+}
+//# sourceMappingURL=run-output.js.map

package/dist/cli/run-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-output.js","sourceRoot":"","sources":["../../src/cli/run-output.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,YAAY;QACjC,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,aAAa,EAAE,KAAK,CAAC,YAAY;QACjC,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACzE,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;KAC7F,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtE,aAAa,EAAE,KAAK,CAAC,YAAY;QACjC,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAuC;IAEvC,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,OAAO;QACL,qBAAqB,EAAE,eAAe,CAAC,QAAQ;QAC/C,8BAA8B,EAAE,eAAe,CAAC,YAAY;QAC5D,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YACnD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,4BAA4B,EAAE,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1E,GAAG,CAAC,eAAe,CAAC,QAAQ,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,0BAA0B,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAmC;IAEnC,OAAO;QACL,iBAAiB,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI;QACzC,yBAAyB,EAAE,KAAK,CAAC,WAAW,CAAC,mBAAmB;QAChE,yBAAyB,EAAE,KAAK,CAAC,WAAW,CAAC,WAAW;QACxD,uBAAuB,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW;QAC5E,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC,MAAM,KAAK,CAAC;YACpD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,yBAAyB,EAAE,KAAK,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC"}

package/dist/cli/run-stdout-envelope.d.ts

@@ -0,0 +1,47 @@
+import { type prepareRunStartHistoryRecall } from '../app/history/run-start-recall.js';
+import type { OperatorSummaryWriteResult } from '../app/operator-summary/writer.js';
+import type { LoopResult } from '../app/run-envelope/continuation-loop.js';
+import type { WriteRunEnvelopeRecordResult } from '../app/run-envelope/source-record.js';
+import type { Axes as AxesValue } from '../schemas/axes.js';
+import type { RunResult } from '../schemas/result.js';
+import { type PostRunArtifactWarning } from './post-run-artifacts.js';
+import { type RouteOutputFieldsInput } from './run-output.js';
+export interface RenderedRecallWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export declare function collapseIdenticalCodeWarnings(warnings: readonly RenderedRecallWarning[]): RenderedRecallWarning[];
+export declare function historyRecallOutputFields(input: {
+    readonly runFolder: string;
+    readonly report: ReturnType<typeof prepareRunStartHistoryRecall>['report'];
+}): {
+    history_recall: {
+        warnings: RenderedRecallWarning[];
+        index_state?: "fresh" | "possibly_stale";
+        status: "unavailable" | "used" | "empty";
+        memory_input_count: number;
+        report_path: string;
+        rebuilt: boolean;
+    };
+};
+export interface ComposeRunStdoutEnvelopeInput {
+    readonly runId: RunResult['run_id'];
+    readonly flowId: RunResult['flow_id'];
+    readonly resolvedAxes: AxesValue | undefined;
+    readonly route: RouteOutputFieldsInput | undefined;
+    readonly runFolder: string;
+    readonly outcome: RunResult['outcome'];
+    readonly reason: string | undefined;
+    readonly traceEntriesObserved: number;
+    readonly resultPath: string;
+    readonly runtimeFields: Record<string, unknown>;
+    readonly historyRecallReport: ReturnType<typeof prepareRunStartHistoryRecall>['report'] | undefined;
+    readonly postRunArtifactWarnings: readonly PostRunArtifactWarning[];
+    readonly operatorSummary: OperatorSummaryWriteResult | undefined;
+    readonly runEnvelope: WriteRunEnvelopeRecordResult | undefined;
+    readonly autonomousLoop: (LoopResult & {
+        readonly path: string;
+    }) | undefined;
+}
+export declare function composeRunStdoutEnvelope(input: ComposeRunStdoutEnvelopeInput): Record<string, unknown>;
+//# sourceMappingURL=run-stdout-envelope.d.ts.map

package/dist/cli/run-stdout-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stdout-envelope.d.ts","sourceRoot":"","sources":["../../src/cli/run-stdout-envelope.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,sBAAsB,EAI5B,MAAM,iBAAiB,CAAC;AAQzB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GACzC,qBAAqB,EAAE,CAqBzB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC5E;;;;;;;;;EAaA;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAGtC,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAI5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,mBAAmB,EACxB,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,QAAQ,CAAC,GACzD,SAAS,CAAC;IACd,QAAQ,CAAC,uBAAuB,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpE,QAAQ,CAAC,eAAe,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,WAAW,EAAE,4BAA4B,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,cAAc,EAAE,CAAC,UAAU,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC/E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiDzB"}

package/dist/cli/run-stdout-envelope.js

@@ -0,0 +1,98 @@
+import { join } from 'node:path';
+import { HISTORY_RECALL_REPORT_PATH, } from '../app/history/run-start-recall.js';
+import { postRunArtifactWarningOutputFields, } from './post-run-artifacts.js';
+import { operatorSummaryOutputFields, routeOutputFields, runEnvelopeOutputFields, } from './run-output.js';
+function leadingNumber(message) {
+    const match = message.match(/\d+/);
+    return match === null ? 0 : Number(match[0]);
+}
+// Groups repeated identical-code warnings into one line with a count and the
+// largest example, so an agent-facing channel does not repeat the same one
+// line of information N times (F9). Emission upstream stays per-document;
+// only this render boundary collapses them. Order-preserving: the first
+// occurrence of each code marks its position in the output.
+export function collapseIdenticalCodeWarnings(warnings) {
+    const order = [];
+    const groups = new Map();
+    for (const warning of warnings) {
+        const group = groups.get(warning.code);
+        if (group === undefined) {
+            groups.set(warning.code, [warning]);
+            order.push(warning.code);
+        }
+        else {
+            group.push(warning);
+        }
+    }
+    return order.map((code) => {
+        const group = groups.get(code);
+        const first = group[0];
+        if (group.length === 1)
+            return first;
+        const largest = group.reduce((best, current) => leadingNumber(current.message) > leadingNumber(best.message) ? current : best);
+        return { code, message: `${code} x${group.length} (largest: ${largest.message})` };
+    });
+}
+export function historyRecallOutputFields(input) {
+    return {
+        history_recall: {
+            status: input.report.status,
+            memory_input_count: input.report.memory_input_count,
+            report_path: join(input.runFolder, HISTORY_RECALL_REPORT_PATH),
+            rebuilt: input.report.rebuilt,
+            ...(input.report.index_state === undefined ? {} : { index_state: input.report.index_state }),
+            warnings: collapseIdenticalCodeWarnings(input.report.warnings.map((warning) => ({ code: warning.code, message: warning.message }))),
+        },
+    };
+}
+export function composeRunStdoutEnvelope(input) {
+    return {
+        schema_version: 1,
+        run_id: input.runId,
+        flow_id: input.flowId,
+        ...(input.resolvedAxes === undefined
+            ? {}
+            : {
+                resolved_axes: {
+                    depth: input.resolvedAxes.depth,
+                    tournament: input.resolvedAxes.tournament,
+                    autonomous: input.resolvedAxes.autonomous,
+                },
+            }),
+        ...(input.route === undefined ? {} : routeOutputFields(input.route)),
+        run_folder: input.runFolder,
+        outcome: input.outcome,
+        // Copy the abort reason onto the final envelope so a non-streaming
+        // host (and the present no-blocks branch) renders the specific reason
+        // rather than a generic fallback (F-H-2). result.json carries it too.
+        // A resumed run can also abort; surface its reason the same way (F-H-2).
+        ...(input.reason === undefined ? {} : { reason: input.reason }),
+        trace_entries_observed: input.traceEntriesObserved,
+        result_path: input.resultPath,
+        ...input.runtimeFields,
+        ...(input.historyRecallReport === undefined
+            ? {}
+            : historyRecallOutputFields({
+                runFolder: input.runFolder,
+                report: input.historyRecallReport,
+            })),
+        ...postRunArtifactWarningOutputFields(input.postRunArtifactWarnings),
+        ...(input.operatorSummary === undefined
+            ? {}
+            : operatorSummaryOutputFields({ operatorSummary: input.operatorSummary })),
+        ...(input.runEnvelope === undefined
+            ? {}
+            : runEnvelopeOutputFields({ runEnvelope: input.runEnvelope })),
+        ...(input.autonomousLoop === undefined
+            ? {}
+            : {
+                autonomous_loop: {
+                    outcome: input.autonomousLoop.outcome,
+                    attempts: input.autonomousLoop.attempts.length,
+                    stop_reason: input.autonomousLoop.stopReason,
+                    path: input.autonomousLoop.path,
+                },
+            }),
+    };
+}
+//# sourceMappingURL=run-stdout-envelope.js.map

package/dist/cli/run-stdout-envelope.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,59 @@
+import type { ExecutorRegistry } from '../runtime/executors/index.js';
+import { type Axes as AxesValue } from '../schemas/axes.js';
+import { type HostKind as HostKindValue } from '../schemas/host.js';
+import { type PowerDialSetting as PowerDialValue } from '../schemas/power.js';
+import { type Process as ProcessValue } from '../schemas/process.js';
+import type { RunEnvelopeOutcome } from '../schemas/run-envelope.js';
+import type { RunClosedOutcome } from '../schemas/trace-entry.js';
+import { type PowerDialResolution } from '../selection/power-tiers.js';
+import type { ComposeWriterFn, RelayFn } from '../shared/relay-runtime-types.js';
+export interface ParsedArgs {
+    command: 'run' | 'resume';
+    flowName?: string;
+    goal?: string;
+    why?: string;
+    axes: AxesValue;
+    power?: PowerDialValue;
+    powerProvided: boolean;
+    processProvided: boolean;
+    tournamentProvided: boolean;
+    autonomousProvided: boolean;
+    runFolder?: string;
+    fixturePath?: string;
+    flowRoot?: string;
+    checkpointChoice?: string;
+    progress?: 'jsonl';
+    includeUntrackedContent: boolean;
+    reuseChildrenFrom?: string;
+}
+interface ResolvedEntryModeSelection {
+    entryModeName?: string;
+    source?: 'explicit' | 'derived';
+    reason?: string;
+}
+export interface RunCommandOptions {
+    relayer?: RelayFn;
+    composeWriter?: ComposeWriterFn;
+    now?: () => Date;
+    runId?: string;
+    configHomeDir?: string;
+    configCwd?: string;
+    hostKind?: HostKindValue;
+    runtimeExecutors?: Partial<ExecutorRegistry>;
+    historyRecall?: 'auto' | 'enabled' | 'disabled';
+}
+export declare const CIRCUIT_HOST_KIND_ENV = "CIRCUIT_HOST_KIND";
+export declare function parseExecutionArgs(command: 'run' | 'resume', argv: readonly string[]): ParsedArgs;
+export declare function deriveProcessFromPower(setting: PowerDialResolution): ProcessValue;
+export declare function clampDerivedDepthToFlow(derived: ProcessValue, allowedDepths: readonly ProcessValue[]): ProcessValue;
+export declare function resolveEntryModeSelection(args: ParsedArgs, finalAxes: AxesValue): ResolvedEntryModeSelection;
+export declare function runResumeCommand(args: ParsedArgs, options: RunCommandOptions): Promise<number>;
+export declare function exitCodeForClosedOutcome(outcome: RunClosedOutcome): number;
+export declare function exitCodeForRun(input: {
+    readonly outcome: RunClosedOutcome;
+    readonly envelopeOutcome?: RunEnvelopeOutcome | undefined;
+    readonly autonomousLoopOutcome?: RunEnvelopeOutcome | undefined;
+}): number;
+export declare function runExecutionCommand(args: ParsedArgs, options: RunCommandOptions): Promise<number>;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

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