@claudexor/cli 3.0.3 → 3.1.0

package/dist/codex-device-login.d.ts

@@ -0,0 +1,117 @@
+/**
+ * D-17 Ф4 primary codex login flow: typed device-code auth over the official
+ * codex app-server, with NO Terminal handoff.
+ *
+ * This module is the transport CORE only — a pure JSON-RPC auth driver over an
+ * injected connection. It is consumed by the detached setup-login runner worker
+ * (setup-login-runner.ts), which hosts the `codex app-server --stdio` child in
+ * the SAME detached process group the Terminal flow uses, so every existing
+ * evidence semantic (process-group identity, execution permit, restart
+ * adoption, result sidecar) is preserved (ARCHITECTURE §Interactive runs).
+ *
+ * The transport reuses the request/response + notification patterns proven by
+ * the codex QUOTA app-server client (codex-quota-source.ts): initialize →
+ * initialized notification → typed method calls, with vendor diagnostics never
+ * treated as protocol authority.
+ *
+ * SECRET DISCIPLINE (INV-062, D-17): the one-time `userCode` is a TRANSIENT
+ * disclosure. It rides the runner's transient device-code sidecar and a
+ * read-time snapshot projection ONLY; it is NEVER journaled, logged, or written
+ * to the durable result receipt. The durable authority persists only THAT a
+ * code exists (see {@link deviceCodeDurableMarker}), mirroring how the tee'd
+ * URL/code disclosure of the Terminal flow keeps the code out of the journal.
+ */
+/** One incoming/outgoing JSON-RPC frame. Responses carry a numeric `id`;
+ * notifications carry a `method` and no `id`. */
+export interface JsonRpcFrame {
+    id?: number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code?: number;
+        message?: string;
+    } | null;
+}
+/**
+ * Minimal duplex JSON-RPC connection the driver runs over. The runner wires
+ * this to the `codex app-server --stdio` child's stdio; tests inject a fake
+ * that scripts typed frames. Keeping the driver above this seam is what makes
+ * the capability-probe and completion logic unit-testable with no real codex.
+ */
+export interface CodexAppServerConnection {
+    /** Write one JSON-RPC frame to the app-server. */
+    send(frame: JsonRpcFrame): void;
+    /** Register the sole incoming-frame handler (responses + notifications). */
+    onFrame(handler: (frame: JsonRpcFrame) => void): void;
+    /** Register the transport-fault/close handler (process exit, stdio error). */
+    onClose(handler: (error?: Error) => void): void;
+    /** Best-effort teardown of the underlying transport. */
+    close(): void;
+}
+/** Transient device-code disclosure. `userCode` MUST NOT be journaled/logged. */
+export interface DeviceCodeDisclosure {
+    loginId: string;
+    verificationUrl: string;
+    /** TRANSIENT one-time code — sidecar + read-time projection only. */
+    userCode: string;
+}
+/** Durable, journal-safe marker: proves a code was disclosed WITHOUT the code
+ * or its verification URL. This — and only this — is what the runner's result
+ * receipt / the daemon journal may carry about the device-code disclosure. */
+export interface DeviceCodeDurableMarker {
+    disclosed: true;
+}
+export declare function deviceCodeDurableMarker(_disclosure: DeviceCodeDisclosure): DeviceCodeDurableMarker;
+/** Result of attempting to start a device-code login. */
+export type DeviceLoginStart = {
+    kind: "started";
+    disclosure: DeviceCodeDisclosure;
+    /** Await the vendor's completion signal; cancels on abort. */
+    awaitCompletion(): Promise<DeviceLoginCompletion>;
+} | {
+    /** Typed capability probe: the installed app-server lacks the auth
+     * methods (JSON-RPC method-not-found). The runner maps this to the
+     * `device_auth_unsupported` result so the daemon demotes to the legacy
+     * Terminal fallback — no stdout regex. */
+    kind: "not_supported";
+    detail: string;
+};
+export type DeviceLoginCompletion = {
+    kind: "completed";
+} | {
+    kind: "cancelled";
+} | {
+    kind: "failed";
+    detail: string;
+};
+export type CodexDeviceLoginFlow = "chatgptDeviceCode" | "chatgpt";
+export interface CodexDeviceLoginOptions {
+    /** `chatgptDeviceCode` (primary) or `chatgpt` (secondary browser-callback,
+     * surfaces an `authUrl` rather than a one-time code). */
+    flow?: CodexDeviceLoginFlow;
+    /** Abort awaiting completion (deadline/cancel); triggers account/login/cancel. */
+    signal?: AbortSignal;
+    /** Per-request timeout for the initialize/start handshake (default 8s). */
+    requestTimeoutMs?: number;
+    now?: () => number;
+    setTimeoutFn?: typeof setTimeout;
+    clearTimeoutFn?: typeof clearTimeout;
+}
+/**
+ * Drive the codex app-server through the typed device-code auth handshake.
+ *
+ * initialize → initialized → account/login/start {type} →
+ *   error(method-not-found)  → not_supported   (capability probe fallback)
+ *   error(other)             → throws          (runner classifies as failure)
+ *   result{loginId,verificationUrl,userCode}   → started + awaitCompletion()
+ *
+ * awaitCompletion resolves on an `account/login/completed` notification for the
+ * disclosed loginId (or an `account/updated` notification reporting an
+ * authenticated account), and on abort sends `account/login/cancel {loginId}`.
+ */
+export declare function startCodexDeviceLogin(connection: CodexAppServerConnection, options?: CodexDeviceLoginOptions): Promise<DeviceLoginStart>;
+/** Map a notification to a completion outcome, or null if it is not terminal
+ * for THIS login. Vendor prose is never classified — only typed fields. */
+export declare function classifyCompletion(method: string, params: unknown, loginId: string): DeviceLoginCompletion | null;
+//# sourceMappingURL=codex-device-login.d.ts.map

package/dist/codex-device-login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-device-login.d.ts","sourceRoot":"","sources":["../src/codex-device-login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;iDACiD;AACjD,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAChC,4EAA4E;IAC5E,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACtD,8EAA8E;IAC9E,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAChD,wDAAwD;IACxD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;8EAE8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,oBAAoB,GAChC,uBAAuB,CAIzB;AAED,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,oBAAoB,CAAC;IACjC,8DAA8D;IAC9D,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnD,GACD;IACE;;;8CAG0C;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAC/B;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC;6DACyD;IACzD,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;CACtC;AAKD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAiJ3B;AAED;2EAC2E;AAC3E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,GACd,qBAAqB,GAAG,IAAI,CAwB9B"}

package/dist/codex-device-login.js

@@ -0,0 +1,227 @@
+/**
+ * D-17 Ф4 primary codex login flow: typed device-code auth over the official
+ * codex app-server, with NO Terminal handoff.
+ *
+ * This module is the transport CORE only — a pure JSON-RPC auth driver over an
+ * injected connection. It is consumed by the detached setup-login runner worker
+ * (setup-login-runner.ts), which hosts the `codex app-server --stdio` child in
+ * the SAME detached process group the Terminal flow uses, so every existing
+ * evidence semantic (process-group identity, execution permit, restart
+ * adoption, result sidecar) is preserved (ARCHITECTURE §Interactive runs).
+ *
+ * The transport reuses the request/response + notification patterns proven by
+ * the codex QUOTA app-server client (codex-quota-source.ts): initialize →
+ * initialized notification → typed method calls, with vendor diagnostics never
+ * treated as protocol authority.
+ *
+ * SECRET DISCIPLINE (INV-062, D-17): the one-time `userCode` is a TRANSIENT
+ * disclosure. It rides the runner's transient device-code sidecar and a
+ * read-time snapshot projection ONLY; it is NEVER journaled, logged, or written
+ * to the durable result receipt. The durable authority persists only THAT a
+ * code exists (see {@link deviceCodeDurableMarker}), mirroring how the tee'd
+ * URL/code disclosure of the Terminal flow keeps the code out of the journal.
+ */
+export function deviceCodeDurableMarker(_disclosure) {
+    // Deliberately drops loginId, verificationUrl, and userCode: the journal
+    // records THAT a code exists, never the code (D-17, INV-062).
+    return { disclosed: true };
+}
+/** JSON-RPC "method not found" — the capability-probe signal. */
+const METHOD_NOT_FOUND = -32601;
+/**
+ * Drive the codex app-server through the typed device-code auth handshake.
+ *
+ * initialize → initialized → account/login/start {type} →
+ *   error(method-not-found)  → not_supported   (capability probe fallback)
+ *   error(other)             → throws          (runner classifies as failure)
+ *   result{loginId,verificationUrl,userCode}   → started + awaitCompletion()
+ *
+ * awaitCompletion resolves on an `account/login/completed` notification for the
+ * disclosed loginId (or an `account/updated` notification reporting an
+ * authenticated account), and on abort sends `account/login/cancel {loginId}`.
+ */
+export async function startCodexDeviceLogin(connection, options = {}) {
+    const flow = options.flow ?? "chatgptDeviceCode";
+    const requestTimeoutMs = options.requestTimeoutMs ?? 8_000;
+    const setTimeoutFn = options.setTimeoutFn ?? setTimeout;
+    const clearTimeoutFn = options.clearTimeoutFn ?? clearTimeout;
+    const pending = new Map();
+    const notificationHandlers = new Set();
+    let transportError = null;
+    const failAll = (error) => {
+        transportError ??= error;
+        for (const entry of pending.values()) {
+            clearTimeoutFn(entry.timer);
+            entry.reject(transportError);
+        }
+        pending.clear();
+    };
+    connection.onClose((error) => failAll(error ?? new Error("codex app-server closed")));
+    connection.onFrame((frame) => {
+        if (typeof frame.id === "number") {
+            const entry = pending.get(frame.id);
+            if (!entry)
+                return;
+            clearTimeoutFn(entry.timer);
+            pending.delete(frame.id);
+            entry.resolve(frame);
+            return;
+        }
+        if (typeof frame.method === "string") {
+            for (const handler of notificationHandlers)
+                handler(frame.method, frame.params);
+        }
+    });
+    const request = (id, method, params) => new Promise((resolve, reject) => {
+        if (transportError) {
+            reject(transportError);
+            return;
+        }
+        const timer = setTimeoutFn(() => {
+            pending.delete(id);
+            reject(new Error(`${method} timed out`));
+        }, requestTimeoutMs);
+        pending.set(id, { resolve, reject, timer });
+        connection.send({ id, method, params });
+    });
+    await request(1, "initialize", {
+        clientInfo: { name: "claudexor", version: "2" },
+        capabilities: {},
+    });
+    connection.send({ method: "initialized", params: null });
+    // Register a completion BUFFER before sending account/login/start. A
+    // connection that delivers the start RESPONSE and a matching
+    // `account/login/completed` notification synchronously in ONE input turn would
+    // otherwise drop the completion: the real completion handler cannot be
+    // installed until loginId is known, which is only AFTER this response resolves
+    // (a later microtask). The buffer captures any notification that arrives
+    // during the handshake; it is replayed through the classifier once loginId is
+    // known, so awaitCompletion() can never hang past a vendor success.
+    const bufferedNotifications = [];
+    const bufferHandler = (method, params) => {
+        bufferedNotifications.push({ method, params });
+    };
+    notificationHandlers.add(bufferHandler);
+    const startFrame = await request(2, "account/login/start", { type: flow });
+    // No `await` runs between here and where the real completion handler replaces
+    // the buffer below, so no notification can arrive unbuffered/unhandled in the
+    // gap; stop buffering now that the handshake response has been consumed.
+    notificationHandlers.delete(bufferHandler);
+    if (startFrame.error) {
+        if (startFrame.error.code === METHOD_NOT_FOUND) {
+            return {
+                kind: "not_supported",
+                detail: startFrame.error.message ??
+                    "codex app-server does not expose account/login/start (typed device-code auth)",
+            };
+        }
+        throw new Error(`codex app-server refused account/login/start: ${startFrame.error.message ?? "unknown error"}`);
+    }
+    const disclosure = parseDisclosure(startFrame.result);
+    if (!disclosure) {
+        throw new Error("codex app-server login/start result is missing loginId/verificationUrl");
+    }
+    const loginId = disclosure.loginId;
+    const readTransportError = () => transportError;
+    // Listen for completion EAGERLY (before awaitCompletion is called) so a
+    // `completed`/`updated` notification that races the caller is never lost.
+    let settledOutcome = null;
+    let deliver = null;
+    const onAbort = () => {
+        // Cancel the pending login so the vendor releases the device code, then
+        // report the honest cancellation to the runner.
+        try {
+            connection.send({ method: "account/login/cancel", params: { loginId } });
+        }
+        catch {
+            /* transport already gone */
+        }
+        settle({ kind: "cancelled" });
+    };
+    const settle = (outcome) => {
+        if (settledOutcome)
+            return;
+        settledOutcome = outcome;
+        options.signal?.removeEventListener("abort", onAbort);
+        deliver?.(outcome);
+    };
+    connection.onClose((error) => settle({ kind: "failed", detail: (error ?? new Error("codex app-server closed")).message }));
+    const completionHandler = (method, params) => {
+        const outcome = classifyCompletion(method, params, loginId);
+        if (outcome)
+            settle(outcome);
+    };
+    notificationHandlers.add(completionHandler);
+    // Replay any notification buffered DURING the start handshake (e.g. a
+    // completion delivered synchronously with the start response, before loginId
+    // was known). settle() is idempotent, so a racing live notification and a
+    // replayed one cannot double-settle.
+    for (const buffered of bufferedNotifications) {
+        const outcome = classifyCompletion(buffered.method, buffered.params, loginId);
+        if (outcome)
+            settle(outcome);
+    }
+    if (options.signal?.aborted)
+        onAbort();
+    else
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+    const pendingError = readTransportError();
+    if (pendingError && !settledOutcome)
+        settle({ kind: "failed", detail: pendingError.message });
+    const awaitCompletion = () => new Promise((resolve) => {
+        if (settledOutcome)
+            resolve(settledOutcome);
+        else
+            deliver = resolve;
+    });
+    return { kind: "started", disclosure, awaitCompletion };
+}
+/** Map a notification to a completion outcome, or null if it is not terminal
+ * for THIS login. Vendor prose is never classified — only typed fields. */
+export function classifyCompletion(method, params, loginId) {
+    const record = asRecord(params);
+    if (method === "account/login/completed") {
+        // Match the disclosed login when the vendor echoes an id; a bare completion
+        // is accepted (single in-flight login per app-server).
+        const frameLoginId = record ? asString(record["loginId"]) : null;
+        if (frameLoginId !== null && frameLoginId !== loginId)
+            return null;
+        const success = record ? record["success"] : undefined;
+        if (success === false) {
+            return { kind: "failed", detail: "codex reported the device-code login did not succeed" };
+        }
+        return { kind: "completed" };
+    }
+    if (method === "account/updated") {
+        // An authenticated account transition is a positive completion signal for a
+        // login that never emits a dedicated completed notification.
+        const authenticated = record !== null &&
+            (record["authenticated"] === true ||
+                asString(record["authMethod"]) !== null ||
+                asRecord(record["account"]) !== null);
+        return authenticated ? { kind: "completed" } : null;
+    }
+    return null;
+}
+function parseDisclosure(result) {
+    const record = asRecord(result);
+    if (!record)
+        return null;
+    const loginId = asString(record["loginId"]);
+    const verificationUrl = asString(record["verificationUrl"]) ?? asString(record["authUrl"]) ?? asString(record["url"]);
+    if (!loginId || !verificationUrl)
+        return null;
+    // `userCode` is absent for the browser-callback (`chatgpt`) flow; keep an
+    // empty string so the AuthSheet can render the URL-only card.
+    const userCode = asString(record["userCode"]) ?? "";
+    return { loginId, verificationUrl, userCode };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=codex-device-login.js.map

package/dist/codex-device-login.js.map

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

package/dist/command-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-flags.d.ts","sourceRoot":"","sources":["../src/command-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,mFAAmF;AACnF,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAqCtC,CAAC;AA2BF,eAAO,MAAM,wBAAwB,UAA+C,CAAC;AAErF,eAAO,MAAM,SAAS,EAAE,SAAS,WAAW,EAsI3C,CAAC"}
+{"version":3,"file":"command-flags.d.ts","sourceRoot":"","sources":["../src/command-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,mFAAmF;AACnF,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAqCtC,CAAC;AA2BF,eAAO,MAAM,wBAAwB,UAA+C,CAAC;AAErF,eAAO,MAAM,SAAS,EAAE,SAAS,WAAW,EAmJ3C,CAAC"}

package/dist/command-flags.js

@@ -57,7 +57,7 @@ const FROZEN_REVIEW_FLAGS = [
 ];
 export const FROZEN_REVIEW_FLAG_NAMES = FROZEN_REVIEW_FLAGS.map((flag) => flag.name);
 export const CLI_FLAGS = [
-    valueFlag("harness", "<id[,id...]>", "Force harness(es)"),
+    valueFlag("harness", "<id[,id...]>", "Force the eligible pool; one explicit harness also becomes the effective primary"),
     valueFlag("route", "<local_session|api_key>", "Credential route filter for route-annotated model lists (models command)"),
     valueFlag("mode", "<mode>", "agent verb: ask | plan | agent (strategies are flags, not modes);\n                           apply verb: delivery mode apply | commit | branch | pr"),
     valueFlag("n", "<N>", "Best-of-N width (agent): N isolated candidates + cross-review"),
@@ -75,7 +75,7 @@ export const CLI_FLAGS = [
     valueFlag("max-usd", "<amount>", "Hard per-run spend cap (USD)"),
     valueFlag("max-seconds", "<n>", "Hard wall-clock deadline for the whole run (seconds); on expiry the run is cancelled (wall_clock_exceeded)"),
     valueFlag("deny-path", "<glob>", "Glob no candidate may touch at all (repeatable); isolated runs only — a violating patch is blocked before delivery"),
-    valueFlag("output-schema", "<file>", "JSON Schema file the run's final answer must conform to; engine-validated into final/output.json with a typed conformance receipt"),
+    valueFlag("output-schema", "<file>", "JSON Schema file the run's final answer must conform to; supports $schema http://json-schema.org/draft-07/schema# and https://json-schema.org/draft/2020-12/schema (omitted $schema defaults to draft-07); engine-validated into final/output.json with a typed conformance receipt"),
     valueFlag("max-turns", "<n>", "Per-run turn cap (beats per-harness settings)"),
     valueFlag("prompt-file", "<file>", "Read the prompt from a file (or pass `-` to read stdin)"),
     valueFlag("thread", "<id>", "Continue an existing thread (runs land as its next turn)"),
@@ -90,7 +90,7 @@ export const CLI_FLAGS = [
     valueFlag("web", "<mode>", "External web/search policy: off|auto|cached|live"),
     valueFlag("model", "<id>", "Model hint forwarded to the selected harness route"),
     valueFlag("effort", "<level>", "Reasoning effort hint: low|medium|high|xhigh|max"),
-    valueFlag("primary-harness", "<id>", "Bias single-route modes and first candidate choice"),
+    valueFlag("primary-harness", "<id>", "Explicitly bias single-route modes and first candidate choice; must belong to the pool"),
     valueFlag("portfolio", "<id>", "Removed in v2; always errors (use --routing-goal)"),
     valueFlag("routing-goal", "<goal>", "Routing goal: auto|quality|economy"),
     valueFlag("profile", "<profile-id>", "Credential profile for this run (INV-135); unknown/disabled ids refuse, never default"),
@@ -105,6 +105,7 @@ export const CLI_FLAGS = [
     booleanFlag("browser-redirect", "Codex login: opt into the localhost-callback flow instead of the device-auth default"),
     booleanFlag("dry-run", "Plugin: show lifecycle actions; apply: check patch without mutating"),
     booleanFlag("force", "Reapply verified Claudexor-owned plugin drift; never overwrites unowned files"),
+    valueFlag("display-name", "<name>", "profiles add: human-readable label for the new credential profile"),
     valueFlag("from-env", "<VAR>", null),
     booleanFlag("allow-full-access", null),
     booleanFlag("revoke-full-access", null),

package/dist/command-flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-flags.js","sourceRoot":"","sources":["../src/command-flags.ts"],"names":[],"mappings":"AAeA,mFAAmF;AACnF,MAAM,CAAC,MAAM,SAAS,GAAsB;IAC1C,SAAS;IACT,iBAAiB;IACjB,GAAG;IACH,UAAU;IACV,aAAa;IACb,QAAQ;IACR,UAAU;IACV,SAAS;IACT,WAAW;IACX,MAAM;IACN,sBAAsB;IACtB,SAAS;IACT,aAAa;IACb,WAAW;IACX,WAAW;IACX,eAAe;IACf,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,WAAW;IACX,cAAc;IACd,SAAS;IACT,UAAU;IACV,cAAc;IACd,mBAAmB;IACnB,QAAQ;IACR,OAAO;IACP,MAAM;CACP,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAE,IAAmB,EAAe,EAAE,CAAC,CAAC;IACxF,IAAI;IACJ,IAAI,EAAE,OAAO;IACb,SAAS;IACT,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,IAAmB,EAAe,EAAE,CAAC,CAAC;IACvE,IAAI;IACJ,IAAI,EAAE,SAAS;IACf,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAA2B;IAClD,SAAS,CAAC,cAAc,EAAE,QAAQ,EAAE,sDAAsD,CAAC;IAC3F,SAAS,CAAC,eAAe,EAAE,QAAQ,EAAE,2DAA2D,CAAC;IACjG,SAAS,CAAC,eAAe,EAAE,OAAO,EAAE,mDAAmD,CAAC;IACxF,SAAS,CAAC,gBAAgB,EAAE,QAAQ,EAAE,8CAA8C,CAAC;IACrF,SAAS,CACP,wBAAwB,EACxB,UAAU,EACV,yDAAyD,CAC1D;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,SAAS,GAA2B;IAC/C,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,mBAAmB,CAAC;IACzD,SAAS,CACP,OAAO,EACP,yBAAyB,EACzB,0EAA0E,CAC3E;IACD,SAAS,CACP,MAAM,EACN,QAAQ,EACR,sJAAsJ,CACvJ;IACD,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,+DAA+D,CAAC;IACtF,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,6DAA6D,CAAC;IAC/F,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,uDAAuD,CAAC;IACrF,WAAW,CAAC,aAAa,EAAE,+DAA+D,CAAC;IAC3F,WAAW,CAAC,WAAW,EAAE,oEAAoE,CAAC;IAC9F,WAAW,CAAC,QAAQ,EAAE,yEAAyE,CAAC;IAChG,WAAW,CACT,aAAa,EACb,2HAA2H,CAC5H;IACD,WAAW,CAAC,QAAQ,EAAE,oCAAoC,CAAC;IAC3D,WAAW,CACT,SAAS,EACT,6HAA6H,CAC9H;IACD,WAAW,CACT,UAAU,EACV,2HAA2H,CAC5H;IACD,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,2DAA2D,CAAC;IAC/F,SAAS,CACP,sBAAsB,EACtB,kBAAkB,EAClB,kEAAkE,CACnE;IACD,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,8BAA8B,CAAC;IAChE,SAAS,CACP,aAAa,EACb,KAAK,EACL,4GAA4G,CAC7G;IACD,SAAS,CACP,WAAW,EACX,QAAQ,EACR,oHAAoH,CACrH;IACD,SAAS,CACP,eAAe,EACf,QAAQ,EACR,mIAAmI,CACpI;IACD,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,+CAA+C,CAAC;IAC9E,SAAS,CAAC,aAAa,EAAE,QAAQ,EAAE,yDAAyD,CAAC;IAC7F,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,0DAA0D,CAAC;IACvF,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,iDAAiD,CAAC;IAC9E,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,2CAA2C,CAAC;IAC5E,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,wCAAwC,CAAC;IAC5E,GAAG,mBAAmB;IACtB,SAAS,CACP,gBAAgB,EAChB,QAAQ,EACR,+HAA+H,CAChI;IACD,SAAS,CACP,gBAAgB,EAChB,OAAO,EACP,6EAA6E,CAC9E;IACD,SAAS,CAAC,iBAAiB,EAAE,OAAO,EAAE,kDAAkD,CAAC;IACzF,SAAS,CACP,QAAQ,EACR,WAAW,EACX,oFAAoF,CACrF;IACD,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,kDAAkD,CAAC;IAC9E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,oDAAoD,CAAC;IAChF,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,kDAAkD,CAAC;IAClF,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,oDAAoD,CAAC;IAC1F,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,mDAAmD,CAAC;IACnF,SAAS,CAAC,cAAc,EAAE,QAAQ,EAAE,oCAAoC,CAAC;IACzE,SAAS,CACP,SAAS,EACT,cAAc,EACd,uFAAuF,CACxF;IACD,WAAW,CAAC,SAAS,EAAE,mDAAmD,CAAC;IAC3E,WAAW,CACT,UAAU,EACV,iOAAiO,CAClO;IACD,SAAS,CACP,cAAc,EACd,UAAU,EACV,uFAAuF,CACxF;IACD,SAAS,CACP,mBAAmB,EACnB,QAAQ,EACR,iEAAiE,CAClE;IACD,SAAS,CAAC,QAAQ,EAAE,kBAAkB,EAAE,0CAA0C,CAAC;IACnF,SAAS,CACP,OAAO,EACP,kBAAkB,EAClB,2DAA2D,CAC5D;IACD,WAAW,CAAC,MAAM,EAAE,8BAA8B,CAAC;IACnD,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC;IACxB,WAAW,CACT,kBAAkB,EAClB,sFAAsF,CACvF;IACD,WAAW,CAAC,SAAS,EAAE,qEAAqE,CAAC;IAC7F,WAAW,CACT,OAAO,EACP,+EAA+E,CAChF;IACD,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IACpC,WAAW,CAAC,mBAAmB,EAAE,IAAI,CAAC;IACtC,WAAW,CAAC,oBAAoB,EAAE,IAAI,CAAC;IACvC,SAAS,CAAC,gBAAgB,EAAE,WAAW,EAAE,IAAI,CAAC;IAC9C,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,IAAI,CAAC;IAC9C,SAAS,CAAC,aAAa,EAAE,iBAAiB,EAAE,IAAI,CAAC;IACjD,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC;IAChC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC;IAC7B,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC3B,WAAW,CAAC,oBAAoB,EAAE,IAAI,CAAC;IACvC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC;IAC1B,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC;IACpC,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC;IACvC,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACrC,WAAW,CAAC,SAAS,EAAE,uBAAuB,CAAC;CAChD,CAAC"}
+{"version":3,"file":"command-flags.js","sourceRoot":"","sources":["../src/command-flags.ts"],"names":[],"mappings":"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"}

package/dist/command-help.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Scoped-command help (QA-057): `claudexor <cmd> --help` resolves the command
+ * FIRST and prints that command's own usage from the registry — never the whole
+ * global help — and a typo'd verb with `--help` is a usage error (exit 2), not a
+ * silent exit-0 global-help print. Lives beside the registry (its one source of
+ * truth) but off the registry's ratcheted line budget.
+ */
+import { type CliCommandSpec, type CliFlagKind, type CliMutability } from "./command-registry.js";
+/** Resolve a command spec by id or alias (the one owner of verb resolution). */
+export declare function findCommand(commandId: string): CliCommandSpec | undefined;
+/**
+ * Scoped `claudexor <cmd> --help` text: the command's own usage line, its
+ * declared flags (always including the global affordances), and any extra usage
+ * lines — never the whole global help. Generated from the registry.
+ */
+export declare function renderCommandHelp(cmd: CliCommandSpec): string;
+export interface CommandHelpJson {
+    readonly ok: true;
+    readonly version: string;
+    readonly command: {
+        readonly id: string;
+        readonly aliases: readonly string[];
+        readonly usage: string;
+        readonly summary: string;
+        readonly flags: readonly string[];
+        readonly mutability: CliMutability;
+        readonly stability: "stable" | "experimental";
+        readonly recovery: boolean;
+    };
+    readonly flags: readonly {
+        readonly name: string;
+        readonly kind: CliFlagKind;
+        readonly value_hint: string | null;
+        readonly description: string | null;
+    }[];
+}
+/** Machine-readable scoped help (`claudexor <cmd> --help --json`). */
+export declare function commandHelpJson(version: string, cmd: CliCommandSpec): CommandHelpJson;
+/**
+ * Handle a `--help` request that has already been detected. A bare or `help`
+ * verb prints the global help; a known verb prints its scoped help; a typo'd
+ * verb throws a usage error (the projector renders it, exit 2). Returns the
+ * success exit code (0) after printing.
+ */
+export declare function handleHelpRequest(commandId: string, positionalCount: number, json: boolean, version: string): number;
+//# sourceMappingURL=command-help.d.ts.map

package/dist/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../src/command-help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,aAAa,EAKnB,MAAM,uBAAuB,CAAC;AAI/B,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEzE;AAUD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAkB7D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QACnC,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,cAAc,CAAC;QAC9C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,EAAE,CAAC;CACL;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,eAAe,CAqBrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,MAAM,CAaR"}

package/dist/command-help.js

@@ -0,0 +1,92 @@
+/**
+ * Scoped-command help (QA-057): `claudexor <cmd> --help` resolves the command
+ * FIRST and prints that command's own usage from the registry — never the whole
+ * global help — and a typo'd verb with `--help` is a usage error (exit 2), not a
+ * silent exit-0 global-help print. Lives beside the registry (its one source of
+ * truth) but off the registry's ratcheted line budget.
+ */
+import { CLI_COMMANDS, CLI_FLAGS, helpJson, padded, renderHelp, usageLabel, } from "./command-registry.js";
+import { printJson } from "./cli-io.js";
+import { usageError } from "./cli-error.js";
+/** Resolve a command spec by id or alias (the one owner of verb resolution). */
+export function findCommand(commandId) {
+    return CLI_COMMANDS.find((c) => c.id === commandId || (c.aliases ?? []).includes(commandId));
+}
+/** The flags a command exposes plus the always-available global affordances. */
+function scopedFlagSpecs(cmd) {
+    const names = [...new Set([...cmd.flags, "json", "help"])];
+    return names
+        .map((name) => CLI_FLAGS.find((f) => f.name === name))
+        .filter((f) => f !== undefined);
+}
+/**
+ * Scoped `claudexor <cmd> --help` text: the command's own usage line, its
+ * declared flags (always including the global affordances), and any extra usage
+ * lines — never the whole global help. Generated from the registry.
+ */
+export function renderCommandHelp(cmd) {
+    const lines = [];
+    lines.push(`Usage: ${usageLabel(cmd)}`);
+    lines.push(`  ${cmd.summary}`);
+    for (const extra of cmd.extraUsageLines ?? []) {
+        lines.push(padded(`  ${extra.text}`, extra.help));
+    }
+    const specs = scopedFlagSpecs(cmd).filter((f) => f.help !== null);
+    if (specs.length > 0) {
+        lines.push("");
+        lines.push("Flags:");
+        for (const flag of specs) {
+            const label = flag.kind === "value" ? `--${flag.name} ${flag.valueHint ?? "<value>"}` : `--${flag.name}`;
+            lines.push(padded(label, flag.help, 25));
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+/** Machine-readable scoped help (`claudexor <cmd> --help --json`). */
+export function commandHelpJson(version, cmd) {
+    return {
+        ok: true,
+        version,
+        command: {
+            id: cmd.id,
+            aliases: cmd.aliases ?? [],
+            usage: usageLabel(cmd),
+            summary: cmd.summary,
+            flags: cmd.flags,
+            mutability: cmd.mutability,
+            stability: cmd.stability,
+            recovery: cmd.recovery === true,
+        },
+        flags: scopedFlagSpecs(cmd).map((f) => ({
+            name: f.name,
+            kind: f.kind,
+            value_hint: f.valueHint ?? null,
+            description: f.help === null ? null : f.help.replace(/\n\s+/g, " "),
+        })),
+    };
+}
+/**
+ * Handle a `--help` request that has already been detected. A bare or `help`
+ * verb prints the global help; a known verb prints its scoped help; a typo'd
+ * verb throws a usage error (the projector renders it, exit 2). Returns the
+ * success exit code (0) after printing.
+ */
+export function handleHelpRequest(commandId, positionalCount, json, version) {
+    if (commandId === "help" || positionalCount === 0) {
+        if (json)
+            printJson(helpJson(version));
+        else
+            process.stdout.write(renderHelp(version));
+        return 0;
+    }
+    const spec = findCommand(commandId);
+    if (!spec) {
+        throw usageError(`claudexor: unknown command '${commandId}' (see \`claudexor help\`)`);
+    }
+    if (json)
+        printJson(commandHelpJson(version, spec));
+    else
+        process.stdout.write(renderCommandHelp(spec));
+    return 0;
+}
+//# sourceMappingURL=command-help.js.map

package/dist/command-help.js.map

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

package/dist/command-registry.d.ts

@@ -33,6 +33,8 @@ export declare function commandFlagScopeError(commandId: string, flagNames: read
 export declare function hostFallbackExamples(): readonly string[];
 /** Post-run recovery verbs (inspect/follow/apply/decision). */
 export declare function recoveryVerbs(): readonly string[];
+export declare function usageLabel(cmd: CliCommandSpec): string;
+export declare function padded(left: string, help: string, column?: number): string;
 /** The `claudexor help` text — generated, never hand-edited. */
 export declare function renderHelp(version: string): string;
 /** The REPL `/help` text — generated from REPL_COMMANDS. */

package/dist/command-registry.d.ts.map

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