@petepetrash/circuit 0.1.0

package/dist/cli/chosen-connectors.js

@@ -0,0 +1,85 @@
+// The chosen 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 ever chooses 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 chosenConnectorsForFlow(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,
+            source: describeResolutionSource(decision.resolvedFrom),
+            descriptor: decision.connector.kind === 'custom' ? decision.connector : undefined,
+        });
+    }
+    return resolved;
+}
+export function resolveChosenConnectors(input = {}) {
+    const layers = input.configLayers ?? [];
+    const names = new Set();
+    const sourceSets = new Map();
+    const custom = new Map();
+    for (const definition of flowDefinitions) {
+        if (definition.visibility !== 'public')
+            continue;
+        for (const step of chosenConnectorsForFlow(definition.id, layers, input.hostKind)) {
+            names.add(step.connectorName);
+            const sourceSet = sourceSets.get(step.connectorName) ?? new Set();
+            sourceSet.add(step.source);
+            sourceSets.set(step.connectorName, sourceSet);
+            if (step.descriptor !== undefined)
+                custom.set(step.connectorName, step.descriptor);
+        }
+    }
+    const sources = new Map();
+    for (const [name, sourceSet] of sourceSets) {
+        sources.set(name, [...sourceSet].sort());
+    }
+    return { names, sources, custom };
+}
+//# sourceMappingURL=chosen-connectors.js.map

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

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

package/dist/cli/circuit.d.ts

@@ -0,0 +1,9 @@
+import type { BriefGitProbe } from '../app/continuity/brief.js';
+import { type RunCommandOptions } from './run.js';
+export interface CliMainOptions extends RunCommandOptions {
+    briefGitProbe?: BriefGitProbe;
+    interactiveShell?: () => Promise<number>;
+}
+export { CIRCUIT_HOST_KIND_ENV } from './run.js';
+export declare function main(argv: readonly string[], options?: CliMainOptions): Promise<number>;
+//# sourceMappingURL=circuit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circuit.d.ts","sourceRoot":"","sources":["../../src/cli/circuit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAqBhE,OAAO,EAEL,KAAK,iBAAiB,EAIvB,MAAM,UAAU,CAAC;AAmBlB,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,aAAa,CAAC,EAAE,aAAa,CAAC;IAG9B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA4FjD,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8GjG"}

package/dist/cli/circuit.js

@@ -0,0 +1,218 @@
+import { Command, CommanderError } from 'commander';
+import { runCheckpointsCommand } from './checkpoints.js';
+import { CLI_COMMAND_NAMES } from './command-vocabulary.js';
+import { parseCommanderOrThrow } from './commander-support.js';
+import { runConfigCommand } from './config-command.js';
+import { runCreateCommand } from './create.js';
+import { runDoctorCommand } from './doctor.js';
+import { runFrontDoorCommand } from './front-door.js';
+import { runGenerateCommand } from './generate.js';
+import { runHandoffCommand } from './handoff.js';
+import { commandWordList, renderCommandHelp, renderRootHelp, resolveHelpInvocation, } from './help.js';
+import { runHistoryCommand } from './history.js';
+import { runMemoryCommand } from './memory.js';
+import { runPreviewCommand } from './preview.js';
+import { runReclaimCommand } from './reclaim.js';
+import { parseExecutionArgs, runExecutionCommand, runResumeCommand, } from './run.js';
+import { runRunsCommand } from './runs.js';
+import { runUninstallCommand } from './uninstall.js';
+import { readSourceVersion } from './version-info.js';
+export { CIRCUIT_HOST_KIND_ENV } from './run.js';
+function versionInfo() {
+    return {
+        schema_version: 1,
+        name: 'circuit',
+        version: readSourceVersion(),
+        node_version: process.versions.node,
+        runtime_source: process.env.CIRCUIT_RUNTIME_SOURCE ?? 'direct',
+        ...(process.env.CIRCUIT_RUNTIME_PATH === undefined
+            ? {}
+            : { runtime_path: process.env.CIRCUIT_RUNTIME_PATH }),
+        ...(process.env.CIRCUIT_PLUGIN_ROOT === undefined
+            ? {}
+            : { plugin_root: process.env.CIRCUIT_PLUGIN_ROOT }),
+    };
+}
+function runVersionCommand(argv) {
+    const program = new Command('circuit version')
+        .exitOverride()
+        .configureOutput({ writeErr: () => { } })
+        .option('--json');
+    try {
+        program.parse(argv, { from: 'user' });
+    }
+    catch (err) {
+        if (err instanceof CommanderError && err.code === 'commander.helpDisplayed')
+            process.exit(0);
+        const message = err instanceof CommanderError ? err.message.replace(/^error: /, '') : err.message;
+        process.stderr.write(`error: ${message}\n`);
+        return 2;
+    }
+    const unexpected = program.args[0];
+    if (unexpected !== undefined) {
+        process.stderr.write(`error: too many arguments. Expected 0 arguments but got ${program.args.length}.\n`);
+        return 2;
+    }
+    if (program.opts().json === true) {
+        process.stdout.write(`${JSON.stringify(versionInfo(), null, 2)}\n`);
+        return 0;
+    }
+    process.stdout.write(`${readSourceVersion()}\n`);
+    return 0;
+}
+// Rewrite root parse errors so the message names its remedy. A far-miss
+// unknown command gets the front-door pointer (near misses already carry
+// Commander's did-you-mean suggestion); `--version` names the version
+// command (the grammar is frozen, so the flag itself stays rejected).
+function withRootRemedy(message) {
+    if (message.startsWith("unknown option '--version'") ||
+        message.startsWith("unknown option '-V'")) {
+        return `${message}. The version is a command here: run 'circuit version'.`;
+    }
+    if (message.startsWith('unknown command') && !message.includes('Did you mean')) {
+        return `${message}. Valid commands: ${commandWordList()}. See 'circuit --help'.`;
+    }
+    return message;
+}
+function parseTopLevelInvocation(argv) {
+    let invocation;
+    const program = new Command('circuit').exitOverride().configureOutput({ writeErr: () => { } });
+    const addForwardingCommand = (name) => {
+        program
+            .command(name)
+            .allowUnknownOption(true)
+            .allowExcessArguments(true)
+            .argument('[args...]')
+            .action((args) => {
+            invocation = { command: name, argv: args };
+        });
+    };
+    for (const name of CLI_COMMAND_NAMES)
+        addForwardingCommand(name);
+    try {
+        parseCommanderOrThrow(program, argv);
+    }
+    catch (err) {
+        throw new Error(withRootRemedy(err instanceof Error ? err.message : String(err)));
+    }
+    if (invocation === undefined) {
+        throw new Error(`missing command: use ${commandWordList()}`);
+    }
+    return invocation;
+}
+export async function main(argv, options = {}) {
+    // Bare `circuit` is the front door, not an error. In a terminal it opens
+    // the interactive shell; piped or in CI it prints the static orientation
+    // page so agents get discovery instead of a failure.
+    if (argv.length === 0) {
+        if (process.stdin.isTTY === true && process.stdout.isTTY === true) {
+            const launch = options.interactiveShell ??
+                (async () => {
+                    // Lazy import: the Ink/React tree stays out of memory for every
+                    // ordinary subcommand invocation.
+                    const { runInteractiveShell } = await import('./interactive/index.js');
+                    return runInteractiveShell();
+                });
+            return launch();
+        }
+        return runFrontDoorCommand();
+    }
+    // Help never reaches the Commander forwarding parser below: its stubs
+    // parse `<cmd> [args...]` and Commander's generated help for them is an
+    // empty shell. Successful help prints to stdout and RETURNS 0 (no
+    // process.exit, nothing on stderr); an unknown help topic is a usage
+    // error (2) that names the valid commands.
+    const help = resolveHelpInvocation(argv);
+    if (help !== undefined) {
+        if (help.kind === 'unknown-command') {
+            process.stderr.write(`error: unknown command '${help.word}'. Valid commands: ${commandWordList()}. See 'circuit --help'.\n`);
+            return 2;
+        }
+        const page = help.kind === 'root' ? renderRootHelp() : renderCommandHelp(help.command);
+        process.stdout.write(`${page}\n`);
+        return 0;
+    }
+    let invocation;
+    try {
+        invocation = parseTopLevelInvocation(argv);
+    }
+    catch (err) {
+        process.stderr.write(`error: ${err.message}\n`);
+        return 2;
+    }
+    if (invocation.command === 'version') {
+        return runVersionCommand(invocation.argv);
+    }
+    if (invocation.command === 'handoff') {
+        return runHandoffCommand(invocation.argv, {
+            ...(options.now === undefined ? {} : { now: options.now }),
+            ...(options.briefGitProbe === undefined ? {} : { briefGitProbe: options.briefGitProbe }),
+        });
+    }
+    if (invocation.command === 'history') {
+        return runHistoryCommand(invocation.argv);
+    }
+    if (invocation.command === 'memory') {
+        return runMemoryCommand(invocation.argv, {
+            ...(options.now === undefined ? {} : { now: options.now }),
+        });
+    }
+    if (invocation.command === 'create') {
+        return runCreateCommand(invocation.argv, {
+            ...(options.now === undefined ? {} : { now: options.now }),
+        });
+    }
+    if (invocation.command === 'generate') {
+        // generate calls a model, so it needs the relay channel run/resume use (the
+        // runtime builds the production relay when none is injected). create does not.
+        return runGenerateCommand(invocation.argv, {
+            ...(options.now === undefined ? {} : { now: options.now }),
+            ...(options.relayer === undefined ? {} : { relayer: options.relayer }),
+        });
+    }
+    if (invocation.command === 'uninstall') {
+        return runUninstallCommand(invocation.argv);
+    }
+    if (invocation.command === 'runs') {
+        return runRunsCommand(invocation.argv);
+    }
+    if (invocation.command === 'reclaim') {
+        return runReclaimCommand(invocation.argv);
+    }
+    if (invocation.command === 'checkpoints') {
+        return runCheckpointsCommand(invocation.argv, {
+            ...(options.briefGitProbe === undefined ? {} : { briefGitProbe: options.briefGitProbe }),
+        });
+    }
+    if (invocation.command === 'preview') {
+        return runPreviewCommand(invocation.argv);
+    }
+    if (invocation.command === 'doctor') {
+        return runDoctorCommand(invocation.argv);
+    }
+    if (invocation.command === 'config') {
+        return runConfigCommand(invocation.argv);
+    }
+    let args;
+    try {
+        args = parseExecutionArgs(invocation.command, invocation.argv);
+    }
+    catch (err) {
+        process.stderr.write(`error: ${err.message}\n`);
+        return 2;
+    }
+    if (args.command === 'resume') {
+        return runResumeCommand(args, options);
+    }
+    return runExecutionCommand(args, options);
+}
+const invokedDirectly = process.argv[1] !== undefined &&
+    (import.meta.url === `file://${process.argv[1]}` ||
+        import.meta.url.endsWith(process.argv[1].split('/').pop() ?? ''));
+if (invokedDirectly) {
+    main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+        process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=circuit.js.map

package/dist/cli/circuit.js.map

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

package/dist/cli/command-vocabulary.d.ts

@@ -0,0 +1,3 @@
+export declare const CLI_COMMAND_NAMES: readonly ["run", "resume", "handoff", "history", "memory", "create", "generate", "uninstall", "runs", "reclaim", "checkpoints", "preview", "doctor", "config", "version"];
+export type CliCommandName = (typeof CLI_COMMAND_NAMES)[number];
+//# sourceMappingURL=command-vocabulary.d.ts.map

package/dist/cli/command-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-vocabulary.d.ts","sourceRoot":"","sources":["../../src/cli/command-vocabulary.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,iBAAiB,2KAgBpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/cli/command-vocabulary.js

@@ -0,0 +1,26 @@
+// The complete top-level CLI command vocabulary, in dispatch order.
+//
+// This is the single source of truth for both the Commander forwarding
+// setup in circuit.ts (parseTopLevelInvocation) and any consumer that
+// needs to reserve the command words — e.g. the custom-flow create
+// command's reserved-slug guard. It lives in a dependency-free leaf so
+// both circuit.ts and create.ts can import it without forming a module
+// initialization cycle.
+export const CLI_COMMAND_NAMES = [
+    'run',
+    'resume',
+    'handoff',
+    'history',
+    'memory',
+    'create',
+    'generate',
+    'uninstall',
+    'runs',
+    'reclaim',
+    'checkpoints',
+    'preview',
+    'doctor',
+    'config',
+    'version',
+];
+//# sourceMappingURL=command-vocabulary.js.map

package/dist/cli/command-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-vocabulary.js","sourceRoot":"","sources":["../../src/cli/command-vocabulary.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,mEAAmE;AACnE,uEAAuE;AACvE,uEAAuE;AACvE,wBAAwB;AACxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK;IACL,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,WAAW;IACX,MAAM;IACN,SAAS;IACT,aAAa;IACb,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;CACD,CAAC"}

package/dist/cli/commander-support.d.ts

@@ -0,0 +1,6 @@
+import { type Command, CommanderError } from 'commander';
+export declare function configureCommanderProgram(program: Command): Command;
+export declare function commanderErrorMessage(err: unknown): string;
+export declare function isCommanderHelpSignal(err: unknown): err is CommanderError;
+export declare function parseCommanderOrThrow(program: Command, argv: readonly string[]): void;
+//# sourceMappingURL=commander-support.d.ts.map

package/dist/cli/commander-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-support.d.ts","sourceRoot":"","sources":["../../src/cli/commander-support.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMzD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEnE;AAKD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAG1D;AASD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAKzE;AAUD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAYrF"}

package/dist/cli/commander-support.js

@@ -0,0 +1,61 @@
+// Shared Commander bootstrap and error normalization for the CLI command
+// modules. Every command builds a Commander program the same way (override
+// process.exit, silence Commander's own stderr writer) and normalizes the
+// two CommanderError shapes the same way (a displayed --help exits 0; a
+// parse error surfaces its message with Commander's 'error: ' prefix
+// stripped). Call sites differ only in whether they throw the normalized
+// message or return it, so this module exposes both the throwing parse
+// helper and the message extractor.
+import { CommanderError } from 'commander';
+// Apply the shared program configuration: exitOverride() turns Commander's
+// process.exit into a thrown CommanderError, and the silent writeErr keeps
+// Commander from printing its own diagnostics (each command renders its own
+// error envelope on stderr/stdout).
+export function configureCommanderProgram(program) {
+    return program.exitOverride().configureOutput({ writeErr: () => { } });
+}
+// Strip Commander's 'error: ' prefix from a CommanderError message; pass
+// through any other error's message unchanged. Used by call sites that
+// return the message rather than throw (history, runs).
+export function commanderErrorMessage(err) {
+    if (err instanceof CommanderError)
+        return err.message.replace(/^error: /, '');
+    return err instanceof Error ? err.message : String(err);
+}
+// Commander signals help through two error codes, and neither message is fit
+// for an operator: `commander.helpDisplayed` (an explicit --help/-h, help
+// already printed, exit 0) and `commander.help` (the internal '(outputHelp)'
+// error raised by the help command and by a bare invocation of a program
+// that requires a subcommand). Callers that return messages (runs, history,
+// memory) use this predicate to substitute their real missing-subcommand
+// message instead of leaking the raw '(outputHelp)' token.
+export function isCommanderHelpSignal(err) {
+    return (err instanceof CommanderError &&
+        (err.code === 'commander.helpDisplayed' || err.code === 'commander.help'));
+}
+// Configure and parse a program, normalizing CommanderError. A successfully
+// displayed help (--help/-h, or a help command that printed and would exit
+// 0) exits the process with code 0; a help raised as a usage error (bare
+// invocation of a subcommand-only program) becomes a plain 'missing
+// subcommand' Error rather than leaking '(outputHelp)'; any other
+// CommanderError is rethrown as a plain Error carrying the prefix-stripped
+// message; non-Commander errors propagate unchanged. Used by call sites
+// that throw on parse failure (circuit, handoff, create).
+export function parseCommanderOrThrow(program, argv) {
+    try {
+        configureCommanderProgram(program).parse(argv, { from: 'user' });
+    }
+    catch (err) {
+        if (err instanceof CommanderError && err.code === 'commander.helpDisplayed')
+            process.exit(0);
+        if (err instanceof CommanderError && err.code === 'commander.help') {
+            if (err.exitCode === 0)
+                process.exit(0);
+            throw new Error('missing subcommand');
+        }
+        if (err instanceof CommanderError)
+            throw new Error(err.message.replace(/^error: /, ''));
+        throw err;
+    }
+}
+//# sourceMappingURL=commander-support.js.map

package/dist/cli/commander-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-support.js","sourceRoot":"","sources":["../../src/cli/commander-support.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,qEAAqE;AACrE,yEAAyE;AACzE,uEAAuE;AACvE,oCAAoC;AACpC,OAAO,EAAgB,cAAc,EAAE,MAAM,WAAW,CAAC;AAEzD,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,oCAAoC;AACpC,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO,OAAO,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,yEAAyE;AACzE,uEAAuE;AACvE,wDAAwD;AACxD,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,GAAG,YAAY,cAAc;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,yEAAyE;AACzE,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,OAAO,CACL,GAAG,YAAY,cAAc;QAC7B,CAAC,GAAG,CAAC,IAAI,KAAK,yBAAyB,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAC1E,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,oEAAoE;AACpE,kEAAkE;AAClE,2EAA2E;AAC3E,wEAAwE;AACxE,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,IAAuB;IAC7E,IAAI,CAAC;QACH,yBAAyB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAyB;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7F,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACnE,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,GAAG,YAAY,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;QACxF,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/cli/compiled-flow-loading.d.ts

@@ -0,0 +1,21 @@
+import type { ChildCompiledFlowResolver } from '../runtime/run/child-runner.js';
+import type { Axes as AxesValue } from '../schemas/axes.js';
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+import type { Process as ProcessValue } from '../schemas/process.js';
+export interface AxisSupport {
+    allowedDepths: readonly ProcessValue[];
+    supportsTournament: boolean;
+    supportsAutonomous: boolean;
+}
+export declare function defaultFlowRoot(): string;
+export declare function resolveCompiledFlowPath(flowName: string, modeName: string | undefined, override: string | undefined, flowRoot: string | undefined): string;
+export declare function compiledFlowSelectionNameForAxes(axes: AxesValue): string;
+export declare function axisSupportFromFlow(input: {
+    readonly flow: CompiledFlow;
+}): AxisSupport;
+export declare function loadCompiledFlow(compiledFlowPath: string): {
+    flow: CompiledFlow;
+    bytes: Buffer;
+};
+export declare function defaultChildCompiledFlowResolver(flowRoot: string | undefined): ChildCompiledFlowResolver;
+//# sourceMappingURL=compiled-flow-loading.d.ts.map

package/dist/cli/compiled-flow-loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-flow-loading.d.ts","sourceRoot":"","sources":["../../src/cli/compiled-flow-loading.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AASrE,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;IACvC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAqBD,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,CAYR;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAKxE;AAUD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,GAAG,WAAW,CAEd;AAED,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAchG;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,yBAAyB,CAW3B"}

package/dist/cli/compiled-flow-loading.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { validateCompiledFlowKindPolicy } from '../flows/canonical-stage-policy.js';
+import { CompiledFlow } from '../schemas/compiled-flow.js';
+// The npm package ships generated/flows (package.json "files"), two levels
+// above this module: dist/cli/ in a build, src/cli/ in a source checkout.
+// Both land on the package root.
+// Marketplace-safe by source-tree fallback: defaultFlowRoot only uses this
+// path when the directory actually exists (npm package or checkout). In a
+// marketplace bundle, two-up from runtime/ ships no generated/flows, so the
+// probe misses and the cwd default holds, same as before this fallback.
+const packageFlowRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../..', 'generated/flows');
+// Default root when no --flow-root is given. The working directory's copy
+// wins so a circuit checkout (or a blessed local mirror) behaves as before;
+// otherwise fall back to the copy shipped inside the installed package, so
+// `circuit run <flow>` works from any project directory after
+// `npm install -g` (the path the README advertises). When neither exists,
+// keep the cwd path so error messages name the place the operator expected.
+export function defaultFlowRoot() {
+    const cwdRoot = resolve('generated/flows');
+    if (existsSync(cwdRoot))
+        return cwdRoot;
+    if (existsSync(packageFlowRoot))
+        return packageFlowRoot;
+    return cwdRoot;
+}
+export function resolveCompiledFlowPath(flowName, modeName, override, flowRoot) {
+    if (override !== undefined)
+        return resolve(override);
+    const root = flowRoot !== undefined ? resolve(flowRoot) : defaultFlowRoot();
+    // When a mode is explicitly requested, prefer the per-mode file if the
+    // schematic author emitted one. Schematics with route_overrides produce
+    // <mode>.json siblings of circuit.json — see scripts/flows/emit.ts.
+    // Falls back to circuit.json otherwise.
+    if (modeName !== undefined) {
+        const perMode = resolve(root, flowName, `${modeName}.json`);
+        if (existsSync(perMode))
+            return perMode;
+    }
+    return resolve(root, flowName, 'circuit.json');
+}
+export function compiledFlowSelectionNameForAxes(axes) {
+    if (axes.tournament)
+        return 'tournament';
+    if (axes.autonomous)
+        return 'autonomous';
+    if (axes.depth === 'low' || axes.depth === 'high')
+        return axes.depth;
+    return 'default';
+}
+function axisSupportFromAxes(axes) {
+    return {
+        allowedDepths: axes.allowed_depths,
+        supportsTournament: axes.supports_tournament,
+        supportsAutonomous: axes.supports_autonomous,
+    };
+}
+export function axisSupportFromFlow(input) {
+    return axisSupportFromAxes(input.flow.axes);
+}
+export function loadCompiledFlow(compiledFlowPath) {
+    if (!existsSync(compiledFlowPath)) {
+        throw new Error(`compiled flow not found: ${compiledFlowPath}`);
+    }
+    const bytes = readFileSync(compiledFlowPath);
+    const raw = JSON.parse(bytes.toString('utf8'));
+    const flow = CompiledFlow.parse(raw);
+    // Enforce flow-kind canonical stage-set policy at load.
+    // Validator: src/shared/flow-kind-policy.ts.
+    const policy = validateCompiledFlowKindPolicy(flow);
+    if (!policy.ok) {
+        throw new Error(`compiled flow policy violation (${compiledFlowPath}):\n  ${policy.reason}`);
+    }
+    return { flow, bytes };
+}
+export function defaultChildCompiledFlowResolver(flowRoot) {
+    return (ref) => {
+        const compiledFlowPath = resolveCompiledFlowPath(ref.flowId, ref.entryMode, undefined, flowRoot);
+        const { bytes } = loadCompiledFlow(compiledFlowPath);
+        return { flowBytes: bytes };
+    };
+}
+//# sourceMappingURL=compiled-flow-loading.js.map

package/dist/cli/compiled-flow-loading.js.map

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

package/dist/cli/config-command.d.ts

@@ -0,0 +1,33 @@
+import { discoverRuntimeConfigLayers } from '../shared/config-loader.js';
+export interface ConfigCommandOptions {
+    readonly homeDir?: string;
+    readonly cwd?: string;
+}
+type Target = 'project' | 'global';
+export type ConfigWriteResult = {
+    readonly ok: true;
+    readonly filePath: string;
+    readonly layerName: 'project' | 'user-global';
+    readonly removedFile?: boolean;
+} | {
+    readonly ok: true;
+    readonly noop: 'already-unset';
+    readonly layerName: string;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function applyConfigSet(key: string, rawValue: string, target: Target, options?: ConfigCommandOptions): ConfigWriteResult;
+export declare function applyConfigUnset(key: string, target: Target, options?: ConfigCommandOptions): ConfigWriteResult;
+export interface EffectiveEntry {
+    readonly value: unknown;
+    readonly source: 'project' | 'user-global' | 'default';
+}
+export interface ConfigSummary {
+    readonly layers: ReturnType<typeof discoverRuntimeConfigLayers>['selectionConfigLayers'];
+    readonly effective: Record<string, EffectiveEntry>;
+}
+export declare function summarizeConfig(options?: ConfigCommandOptions): ConfigSummary;
+export declare function runConfigCommand(argv: readonly string[], options?: ConfigCommandOptions): number;
+export {};
+//# sourceMappingURL=config-command.d.ts.map

package/dist/cli/config-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-command.d.ts","sourceRoot":"","sources":["../../src/cli/config-command.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,2BAA2B,EAG5B,MAAM,4BAA4B,CAAC;AAepC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAgHnC,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAAC;IAG9C,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,iBAAiB,CA2BnB;AAwBD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,iBAAiB,CAoBnB;AA+FD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACzF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACpD;AAoBD,wBAAgB,eAAe,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA6BjF;AA6DD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAOR"}