codedeck 0.3.0 → 0.4.1

package/dist/cli/commands/send.js.map

@@ -1 +1 @@
-{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/cli/commands/send.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qFAAqF,CAAC;SAClG,QAAQ,CAAC,MAAM,EAAE,wCAAwC,CAAC;SAC1D,QAAQ,CAAC,WAAW,EAAE,sCAAsC,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAe,EAAE,IAAS,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACpD,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;;YACvD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/cli/commands/send.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qFAAqF,CAAC;SAClG,QAAQ,CAAC,MAAM,EAAE,wCAAwC,CAAC;SAC1D,QAAQ,CAAC,WAAW,EAAE,sCAAsC,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAe,EAAE,IAAS,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACpD,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACvD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,qCAAqC,CAAC,CAAC;;YACxG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/setup.js

@@ -1,11 +1,14 @@
-import { getCachedOrDiscoverModels, } from "../../core/models.js";
+import { AUTOCOMPACT_DEFAULT_CAP, AUTOCOMPACT_DEFAULT_PERCENT, } from "../../core/autocompact.js";
+import { getBatchModels, getCachedOrDiscoverModels, } from "../../core/models.js";
+import { isAgentId } from "../../core/session.js";
 import { itemKey } from "../picker-state.js";
 import { runScreens } from "../picker.js";
 import { colors, readDimensions } from "../ui.js";
 import { getCliName } from "../cli-name.js";
 import { getRegistry } from "../../drivers/registry.js";
 import { ROLES } from "../../core/roles.js";
-import { BALANCED_PRESET, DISPATCHER_PRESET, EXPLORER_PRESET, ORCHESTRATOR_PRESETS, isOrchestratorMode, loadConfig, orchestratorModeLabel, resolveOrchestratorMode, saveConfig, } from "../../config/config.js";
+import { getPaths } from "../../config/paths.js";
+import { BALANCED_PRESET, DISPATCHER_PRESET, EXPLORER_PRESET, ORCHESTRATOR_PRESETS, createSetupConfigStore, DEFAULT_CONFIG, isOrchestratorMode, loadConfig, orchestratorModeLabel, resolveOrchestratorMode, saveConfig, serializeConfig, } from "../../config/config.js";
 const ORCHESTRATOR_SCREEN_ROLE = "orchestrator-mode";
 const ORCHESTRATOR_PICKER_GROUP = "orchestrator";
 const PARALLELISM_NONE = "none";
@@ -13,6 +16,11 @@ const SANDBOX_SCREEN_ROLE = "sandbox";
 const SANDBOX_PICKER_GROUP = "sandbox";
 const SANDBOX_OFF = "workspace-write";
 const SANDBOX_ON = "danger-full-access";
+const AUTOCOMPACT_SCREEN_ROLE = "autocompact";
+const AUTOCOMPACT_PICKER_GROUP = "autocompact";
+const AUTOCOMPACT_OFF = "off";
+const AUTOCOMPACT_ON = "on";
+const AUTOCOMPACT_DESCRIPTION = `Native autocompact applies to Claude and OpenCode sessions. Claude's default window is min(${AUTOCOMPACT_DEFAULT_CAP / 1000}k tokens, ${AUTOCOMPACT_DEFAULT_PERCENT * 100}% of the context window); OpenCode uses its internal context trigger.`;
 const ORCHESTRATOR_PARALLELISM_NOTE_LINES = [
     "parallelism is advisory. Version 1 puts the requested cap in the",
     "orchestrator prompt for review verification and does not enforce the",
@@ -144,6 +152,35 @@ export function buildSandboxScreen(config = {}, index = 0, total = 1) {
         next: () => [],
     };
 }
+export function buildAutocompactScreen(config = {}, index = 0, total = 1) {
+    // A hand-tuned block without `enabled` still resolves as active in the
+    // Claude driver (only `enabled: false` disables), so show it as ON rather
+    // than let an accepted OFF silently switch off a working setup.
+    const selected = config.autocompact === undefined || config.autocompact.enabled === false
+        ? AUTOCOMPACT_OFF
+        : AUTOCOMPACT_ON;
+    const values = selected === AUTOCOMPACT_ON
+        ? [AUTOCOMPACT_ON, AUTOCOMPACT_OFF]
+        : [AUTOCOMPACT_OFF, AUTOCOMPACT_ON];
+    const items = values.map((value) => ({
+        id: value,
+        label: value.toUpperCase(),
+        group: AUTOCOMPACT_PICKER_GROUP,
+        harness: AUTOCOMPACT_PICKER_GROUP,
+        ...(value === selected ? { note: "atual" } : {}),
+    }));
+    return {
+        role: AUTOCOMPACT_SCREEN_ROLE,
+        title: "Claude native autocompact",
+        counter: `configuração ${index + 1} de ${total}`,
+        description: [AUTOCOMPACT_DESCRIPTION],
+        items,
+        pinned: true,
+        known: new Set(items.map((item) => itemKey(item.harness, item.id))),
+        harnesses: new Set([AUTOCOMPACT_PICKER_GROUP]),
+        next: () => [],
+    };
+}
 function modeAfterParameter(mode, result) {
     const parameters = collectOrchestratorParameters([result], mode);
     return orchestratorConfigFromSelection("custom", parameters) ?? mode;
@@ -431,7 +468,10 @@ export async function runModelSetupWizard(options = {}) {
         ...roleScreens,
         buildOrchestratorScreen(config, roleScreens.length, roleScreens.length + 1),
     ];
-    const results = await runScreens([...screens, buildSandboxScreen(config, screens.length, screens.length + 1)], { input, output, onResize: watchResize }, paint);
+    const total = screens.length + 2;
+    const sandbox = buildSandboxScreen(config, screens.length, total);
+    const autocompact = buildAutocompactScreen(config, screens.length + 1, total);
+    const results = await runScreens([...screens, sandbox, autocompact], { input, output, onResize: watchResize }, paint);
     if (results.some((result) => result.kind === "aborted")) {
         console.error("Warning: Model setup was interrupted; nothing was saved.");
         return config;
@@ -473,12 +513,25 @@ export async function runModelSetupWizard(options = {}) {
             updatedConfig.defaultSandbox = sandboxSelection.id;
         }
     }
+    const autocompactSelection = answeredResults.find((result) => result.role === AUTOCOMPACT_SCREEN_ROLE);
+    if (autocompactSelection?.kind === "picked") {
+        if (autocompactSelection.id === AUTOCOMPACT_ON) {
+            updatedConfig.autocompact = { ...config.autocompact, enabled: true };
+        }
+        else if (autocompactSelection.id === AUTOCOMPACT_OFF && config.autocompact !== undefined) {
+            updatedConfig.autocompact = { ...config.autocompact, enabled: false };
+        }
+    }
+    let saved = false;
     try {
         (options.save ?? saveConfig)(updatedConfig);
+        saved = true;
     }
     catch (error) {
         console.error(`Warning: Could not save config: ${error instanceof Error ? error.message : String(error)}`);
     }
+    if (!saved)
+        return updatedConfig;
     const summary = roleScreens
         .map((screen) => {
         const binding = agents[screen.role];
@@ -489,20 +542,558 @@ export async function runModelSetupWizard(options = {}) {
     output.write(`\n  saved: ${summary}${modeSummary}\n\n`);
     return updatedConfig;
 }
-export function registerSetupCommand(program) {
+export class SetupUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SetupUsageError";
+    }
+}
+function invalidBindMessage(value) {
+    return `Invalid --bind "${value}": expected role=harness:model (role: general|orchestrator|reviewer|auditor; harness: claude|codex|opencode|omp; model: non-empty and without whitespace, control characters or '=')`;
+}
+export function parseBind(value) {
+    const equals = value.indexOf("=");
+    const roleValue = equals < 0 ? "" : value.slice(0, equals);
+    const right = equals < 0 ? "" : value.slice(equals + 1);
+    const colon = right.indexOf(":");
+    const harnessValue = colon < 0 ? "" : right.slice(0, colon);
+    const model = colon < 0 ? "" : right.slice(colon + 1);
+    const role = ROLES.includes(roleValue) ? roleValue : undefined;
+    const harness = isAgentId(harnessValue) ? harnessValue : undefined;
+    const modelPattern = /^[^\p{White_Space}\p{Cc}\p{Cf}=]+$/u;
+    if (!role || !harness || !modelPattern.test(model))
+        throw new SetupUsageError(invalidBindMessage(value));
+    return { role, binding: { harness, model } };
+}
+export const parseSetupBind = parseBind;
+function parseError(message, json) {
+    return { ok: false, message, json };
+}
+function isSetupFlag(arg) {
+    return arg.startsWith("-");
+}
+export function parseSetupArgs(args) {
+    const json = args.some((arg) => arg === "--json" || arg.startsWith("--json="));
+    const binds = [];
+    let refresh = false;
+    let nonInteractive = false;
+    let dryRun = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--refresh") {
+            refresh = true;
+            continue;
+        }
+        if (arg === "--non-interactive") {
+            nonInteractive = true;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "--json") {
+            continue;
+        }
+        if (arg === "--bind") {
+            const value = args[index + 1];
+            if (value === undefined || isSetupFlag(value)) {
+                return parseError('Option "--bind" expects role=harness:model.', json);
+            }
+            index += 1;
+            try {
+                binds.push(parseBind(value));
+            }
+            catch (error) {
+                return parseError(error instanceof Error ? error.message : String(error), json);
+            }
+            continue;
+        }
+        if (arg.startsWith("--bind=")) {
+            try {
+                binds.push(parseBind(arg.slice("--bind=".length)));
+            }
+            catch (error) {
+                return parseError(error instanceof Error ? error.message : String(error), json);
+            }
+            continue;
+        }
+        if (arg.startsWith("-"))
+            return parseError(`Unknown option "${arg}".`, json);
+        return parseError(`Unexpected argument "${arg}".`, json);
+    }
+    return {
+        ok: true,
+        options: {
+            refresh,
+            nonInteractive,
+            json,
+            dryRun,
+            binds,
+            batch: nonInteractive || json || dryRun || binds.length > 0,
+        },
+    };
+}
+function writeLine(stream, message) {
+    if (stream) {
+        stream.write(`${message}\n`);
+    }
+    else {
+        console.error(message);
+    }
+}
+function configValidation(read) {
+    return {
+        status: read.status,
+        source: read.source,
+        path: read.path,
+        message: read.status === "invalid" ? read.message : null,
+    };
+}
+function notNeededCatalog() {
+    return { status: "not-needed", source: "none", ageMs: null, message: null };
+}
+function emptyEnvelope(message, code, path) {
+    return {
+        proposta: null,
+        validacoes: {
+            config: { status: "not-run", source: "none", path, message: "not-run" },
+            catalogo: { status: "not-needed", source: "none", ageMs: null, message: "not-run" },
+            bindings: [],
+        },
+        mudancas: [],
+        resultado: { status: "error", code, saved: false, message },
+    };
+}
+function jsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function jsonValue(value) {
+    if (value === undefined)
+        return null;
+    if (Array.isArray(value))
+        return value.map(jsonValue);
+    if (jsonObject(value)) {
+        return Object.fromEntries(Object.keys(value).sort((left, right) => left.localeCompare(right)).map((key) => [key, jsonValue(value[key])]));
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null) {
+        return value;
+    }
+    return null;
+}
+function jsonEqual(left, right) {
+    return JSON.stringify(jsonValue(left)) === JSON.stringify(jsonValue(right));
+}
+function pointerPart(value) {
+    return value.replaceAll("~", "~0").replaceAll("/", "~1");
+}
+function diffAt(output, pathValue, beforePresent, before, afterPresent, after, expandObjectChildren = false) {
+    const beforeObject = beforePresent && jsonObject(before) ? before : undefined;
+    const afterObject = afterPresent && jsonObject(after) ? after : undefined;
+    if (beforeObject !== undefined && afterObject !== undefined) {
+        const keys = [...new Set([...Object.keys(beforeObject), ...Object.keys(afterObject)])].sort((left, right) => left.localeCompare(right));
+        if (keys.length === 0)
+            return;
+        for (const key of keys) {
+            diffAt(output, `${pathValue}/${pointerPart(key)}`, Object.hasOwn(beforeObject, key), beforeObject[key], Object.hasOwn(afterObject, key), afterObject[key]);
+        }
+        return;
+    }
+    if (!beforePresent && afterObject !== undefined) {
+        if (expandObjectChildren) {
+            const keys = Object.keys(afterObject).sort((left, right) => left.localeCompare(right));
+            if (keys.length === 0) {
+                output.push({
+                    path: pathValue,
+                    beforePresent: false,
+                    before: null,
+                    afterPresent: true,
+                    after: jsonValue(afterObject),
+                });
+                return;
+            }
+            for (const key of keys) {
+                const value = afterObject[key];
+                const childPath = `${pathValue}/${pointerPart(key)}`;
+                if (jsonObject(value)) {
+                    output.push({
+                        path: childPath,
+                        beforePresent: false,
+                        before: null,
+                        afterPresent: true,
+                        after: jsonValue(value),
+                    });
+                }
+                else {
+                    diffAt(output, childPath, false, undefined, true, value);
+                }
+            }
+            return;
+        }
+        output.push({
+            path: pathValue,
+            beforePresent: false,
+            before: null,
+            afterPresent: true,
+            after: jsonValue(afterObject),
+        });
+        return;
+    }
+    if (beforeObject !== undefined && !afterPresent) {
+        if (expandObjectChildren) {
+            const keys = Object.keys(beforeObject).sort((left, right) => left.localeCompare(right));
+            if (keys.length === 0) {
+                output.push({
+                    path: pathValue,
+                    beforePresent: true,
+                    before: jsonValue(beforeObject),
+                    afterPresent: false,
+                    after: null,
+                });
+                return;
+            }
+            for (const key of keys) {
+                const value = beforeObject[key];
+                const childPath = `${pathValue}/${pointerPart(key)}`;
+                if (jsonObject(value)) {
+                    output.push({
+                        path: childPath,
+                        beforePresent: true,
+                        before: jsonValue(value),
+                        afterPresent: false,
+                        after: null,
+                    });
+                }
+                else {
+                    diffAt(output, childPath, true, value, false, undefined);
+                }
+            }
+            return;
+        }
+        output.push({
+            path: pathValue,
+            beforePresent: true,
+            before: jsonValue(beforeObject),
+            afterPresent: false,
+            after: null,
+        });
+        return;
+    }
+    if (beforePresent === afterPresent && (!beforePresent || jsonEqual(before, after)))
+        return;
+    output.push({
+        path: pathValue,
+        beforePresent,
+        before: jsonValue(before),
+        afterPresent,
+        after: jsonValue(after),
+    });
+}
+export function diffConfig(before, after) {
+    const output = [];
+    const beforeObject = jsonObject(before) ? before : {};
+    const afterObject = jsonObject(after) ? after : {};
+    const keys = [...new Set([...Object.keys(beforeObject), ...Object.keys(afterObject)])].sort((left, right) => left.localeCompare(right));
+    for (const key of keys) {
+        diffAt(output, `/${pointerPart(key)}`, Object.hasOwn(beforeObject, key), beforeObject[key], Object.hasOwn(afterObject, key), afterObject[key], true);
+    }
+    return output.sort((left, right) => left.path.localeCompare(right.path));
+}
+function catalogContains(catalog, model) {
+    return catalog.providers.some((provider) => provider.models.some((candidate) => candidate.id === model || (candidate.aliases !== undefined && candidate.aliases.some((alias) => alias === model))));
+}
+function validateBindings(bindings, catalog) {
+    const byAgent = new Map(catalog.models.map((item) => [item.agent, item]));
+    const entries = bindings.map(({ role, binding }) => {
+        const found = byAgent.get(binding.harness);
+        if (found?.available === false) {
+            return {
+                role,
+                harness: binding.harness,
+                model: binding.model,
+                status: "harness-unavailable",
+                message: `Cannot apply binding for role "${role}": harness "${binding.harness}" is unavailable.`,
+            };
+        }
+        if (catalog.status === "unavailable" || found === undefined) {
+            return {
+                role,
+                harness: binding.harness,
+                model: binding.model,
+                status: "unverified",
+                message: `Cannot validate model "${binding.model}" for harness "${binding.harness}": catalog unavailable.`,
+            };
+        }
+        if (catalog.status === "offline" && !catalogContains(found, binding.model)) {
+            return {
+                role,
+                harness: binding.harness,
+                model: binding.model,
+                status: "unverified",
+                message: `Cannot validate model "${binding.model}" for harness "${binding.harness}": the catalog is stale. Re-run with --refresh.`,
+            };
+        }
+        if (!catalogContains(found, binding.model)) {
+            return {
+                role,
+                harness: binding.harness,
+                model: binding.model,
+                status: "unknown-model",
+                message: `Model "${binding.model}" is not in the ${binding.harness} catalog for role "${role}".`,
+            };
+        }
+        return { role, harness: binding.harness, model: binding.model, status: "accepted", message: "" };
+    });
+    const failed = entries.find((entry) => entry.status !== "accepted");
+    const code = failed === undefined
+        ? undefined
+        : failed.status === "harness-unavailable"
+            ? 11
+            : failed.status === "unknown-model"
+                ? 12
+                : 13;
+    let message = null;
+    if (catalog.status === "offline") {
+        message = failed?.status === "unverified" ? failed.message : "Catalog is stale; using offline cache.";
+    }
+    else if (catalog.status === "unavailable") {
+        message = failed?.message ?? "Catalog unavailable.";
+    }
+    return { entries, code, message };
+}
+function catalogValidation(catalog, message) {
+    if (catalog === undefined)
+        return notNeededCatalog();
+    return {
+        status: catalog.status,
+        source: catalog.source,
+        ageMs: catalog.ageMs,
+        message,
+    };
+}
+function configSummary(config) {
+    const agents = config.agents ?? {};
+    return ROLES.map((role) => {
+        const binding = agents[role];
+        return `${role} ${binding ? `${binding.harness}:${binding.model}` : "unset"}`;
+    }).join(" · ");
+}
+function errorResult(read, proposal, catalog, bindings, changes, code, message) {
+    return {
+        code,
+        envelope: {
+            proposta: proposal,
+            validacoes: { config: configValidation(read), catalogo: catalog, bindings },
+            mudancas: changes,
+            resultado: { status: "error", code, saved: false, message },
+        },
+    };
+}
+export async function runSetupBatch(options, dependencies = {}) {
+    const stderr = dependencies.stderr;
+    const store = dependencies.configStore ?? createSetupConfigStore();
+    let read;
+    try {
+        read = store.read();
+    }
+    catch (error) {
+        const path = getPaths().configFile;
+        const message = `Cannot save config "${path}": ${error instanceof Error ? error.message : String(error)}.`;
+        writeLine(stderr, message);
+        return {
+            code: 15,
+            envelope: emptyEnvelope(message, 15, path),
+        };
+    }
+    if (read.status === "invalid") {
+        const message = read.readError
+            ? `Cannot save config "${getPaths().configFile}": ${read.message}.`
+            : read.message ?? `Config file "${read.path}" contains invalid JSON; no changes were written. Repair or move it and retry.`;
+        writeLine(stderr, message);
+        return errorResult(read, null, notNeededCatalog(), [], [], read.readError ? 15 : 14, message);
+    }
+    const current = { ...DEFAULT_CONFIG, ...(read.config ?? {}) };
+    const lastByRole = new Map();
+    options.binds.forEach((binding, index) => lastByRole.set(binding.role, index));
+    const winning = options.binds.filter((binding, index) => lastByRole.get(binding.role) === index);
+    const existingAgents = jsonObject(current.agents) ? current.agents : {};
+    const proposed = options.binds.length === 0
+        ? { ...current }
+        : {
+            ...current,
+            agents: {
+                ...existingAgents,
+                ...Object.fromEntries(winning.map(({ role, binding }) => [role, binding])),
+            },
+        };
+    const changes = diffConfig(current, proposed);
+    let catalog;
+    let bindingValidations = [];
+    let catalogMessage = null;
+    if (winning.length > 0 || options.refresh) {
+        const agents = winning.length > 0
+            ? [...new Set(winning.map(({ binding }) => binding.harness))]
+            : undefined;
+        catalog = await getBatchModels(dependencies.registry ?? getRegistry(), {
+            agents,
+            refresh: options.refresh,
+            allowNetwork: !options.dryRun || options.refresh,
+            now: dependencies.now,
+            timeoutMs: dependencies.timeoutMs,
+            discover: dependencies.discoverModels,
+            saveCache: dependencies.saveCache,
+            onDiscoveryStart: () => writeLine(stderr, "discovering models..."),
+        });
+        if (catalog.discoveryError !== undefined) {
+            writeLine(stderr, `Warning: ${catalog.discoveryError}.`);
+        }
+        if (catalog.cacheWriteFailed)
+            writeLine(stderr, "Warning: Could not update models cache.");
+        if (winning.length > 0) {
+            const validation = validateBindings(winning, catalog);
+            bindingValidations = validation.entries;
+            catalogMessage = validation.message;
+            if (validation.code !== undefined) {
+                for (const entry of bindingValidations) {
+                    if (entry.status !== "accepted")
+                        writeLine(stderr, entry.message);
+                }
+                return errorResult(read, proposed, catalogValidation(catalog, catalogMessage), bindingValidations, changes, validation.code, bindingValidations.find((entry) => entry.status !== "accepted")?.message ?? "Setup validation failed.");
+            }
+        }
+        else if (catalog.status === "unavailable") {
+            catalogMessage = "Catalog unavailable.";
+            const message = "Model catalog unavailable.";
+            writeLine(stderr, message);
+            return errorResult(read, proposed, catalogValidation(catalog, catalogMessage), [], changes, 13, message);
+        }
+        else if (catalog.status === "offline") {
+            catalogMessage = "Catalog is stale; using offline cache.";
+            writeLine(stderr, catalogMessage);
+        }
+    }
+    const validations = {
+        config: configValidation(read),
+        catalogo: catalogValidation(catalog, catalogMessage),
+        bindings: bindingValidations,
+    };
+    if (winning.length === 0) {
+        const message = "Configuration unchanged.";
+        if (!options.json)
+            writeLine(stderr, message);
+        return {
+            code: 0,
+            envelope: { proposta: proposed, validacoes: validations, mudancas: changes, resultado: { status: "unchanged", code: 0, saved: false, message } },
+        };
+    }
+    if (options.dryRun) {
+        const message = "Dry run; configuration not written.";
+        if (!options.json)
+            writeLine(stderr, message);
+        return {
+            code: 0,
+            envelope: { proposta: proposed, validacoes: validations, mudancas: changes, resultado: { status: "dry-run", code: 0, saved: false, message } },
+        };
+    }
+    const serialized = serializeConfig(proposed);
+    let saved = false;
+    try {
+        const canonicalRaw = read.source === "canonical" ? read.raw : null;
+        if (canonicalRaw !== null && canonicalRaw === serialized) {
+            saved = false;
+        }
+        else {
+            saved = store.save(proposed) !== false;
+        }
+    }
+    catch (error) {
+        const message = `Cannot save config "${getPaths().configFile}": ${error instanceof Error ? error.message : String(error)}.`;
+        writeLine(stderr, message);
+        return errorResult(read, proposed, catalogValidation(catalog, catalogMessage), bindingValidations, changes, 15, message);
+    }
+    if (!saved) {
+        const message = "Configuration unchanged.";
+        if (!options.json)
+            writeLine(stderr, message);
+        return {
+            code: 0,
+            envelope: { proposta: proposed, validacoes: validations, mudancas: [], resultado: { status: "unchanged", code: 0, saved: false, message } },
+        };
+    }
+    const message = "Configuration saved.";
+    if (!options.json)
+        writeLine(stderr, `saved: ${configSummary(proposed)}`);
+    return {
+        code: 0,
+        envelope: { proposta: proposed, validacoes: validations, mudancas: changes, resultado: { status: "applied", code: 0, saved: true, message } },
+    };
+}
+function commandTokens(opts, command) {
+    const tokens = [];
+    if (opts.refresh)
+        tokens.push("--refresh");
+    if (opts.nonInteractive)
+        tokens.push("--non-interactive");
+    if (opts.json)
+        tokens.push("--json");
+    if (opts.dryRun)
+        tokens.push("--dry-run");
+    const binds = Array.isArray(opts.bind) ? opts.bind : opts.bind === undefined ? [] : [opts.bind];
+    for (const bind of binds) {
+        tokens.push("--bind");
+        if (bind !== true)
+            tokens.push(String(bind));
+    }
+    return tokens.concat(command.args.map(String));
+}
+export async function executeSetupAction(args, dependencies = {}) {
+    const parsed = parseSetupArgs(args);
+    const stdout = dependencies.stdout ?? process.stdout;
+    const input = dependencies.input ?? process.stdin;
+    const writeError = (message) => writeLine(dependencies.stderr, message);
+    if (!parsed.ok) {
+        if (parsed.json)
+            stdout.write(`${JSON.stringify(emptyEnvelope(parsed.message, 2, getPaths().configFile))}\n`);
+        writeError(parsed.message);
+        return { code: 2, envelope: parsed.json ? emptyEnvelope(parsed.message, 2, getPaths().configFile) : undefined };
+    }
+    const tty = dependencies.isTTY ?? Boolean(input.isTTY && stdout.isTTY);
+    if (!parsed.options.batch) {
+        if (!tty) {
+            const message = `${getCliName()} setup needs a terminal on both stdin and stdout.`;
+            writeError(message);
+            return { code: 1 };
+        }
+        await runModelSetupWizard({
+            registry: dependencies.registry,
+            input: dependencies.input,
+            output: dependencies.stdout,
+            refresh: parsed.options.refresh,
+            discoverModels: dependencies.wizardDiscoverModels,
+            save: dependencies.saveConfig,
+            isTTY: tty,
+        });
+        return { code: 0 };
+    }
+    const result = await runSetupBatch(parsed.options, dependencies);
+    if (parsed.options.json)
+        stdout.write(`${JSON.stringify(result.envelope)}\n`);
+    return result;
+}
+export function registerSetupCommand(program, dependencies = {}) {
     program
         .command("setup")
         .description("Choose the harness and model each agent should run on")
+        .allowUnknownOption(true)
+        .allowExcessArguments(true)
         .option("--refresh", "ignore the cached catalog and rediscover")
-        .action(async (opts) => {
-        // The message lives here rather than in the wizard, because `open` calls
-        // the same function and has to stay quiet when it cannot prompt.
-        if (!isInteractiveTerminal()) {
-            console.error(`${getCliName()} setup needs a terminal on both stdin and stdout.`);
-            process.exitCode = 1;
-            return;
-        }
-        await runModelSetupWizard({ refresh: opts.refresh });
+        .option("--non-interactive", "run setup without the picker")
+        .option("--json", "output one machine-readable envelope")
+        .option("--dry-run", "show the proposed config without writing it")
+        .option("--bind [binding]", "bind a role to a harness and model", (value, previous = []) => [...previous, value], [])
+        .action(async (opts, command) => {
+        const result = await executeSetupAction(commandTokens(opts, command), dependencies);
+        process.exitCode = result.code;
     });
 }
 //# sourceMappingURL=setup.js.map