ima2-gen 1.1.9 → 1.1.11

package/bin/commands/comfy.ts

@@ -18,7 +18,7 @@ const FLAGS = {
   help: { short: "h", type: "boolean" },
 };
 
-async function exportSub(argv) {
+async function exportSub(argv: string[]) {
   const args = parseArgs(argv, { flags: FLAGS });
   const filename = args.positional[0];
   if (!filename) die(2, "filename required");
@@ -28,8 +28,8 @@ async function exportSub(argv) {
   const resp: any = await request(server.base, "/api/comfy/export-image", {
     method: "POST",
     body: { filename },
-  }).catch((e) => die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`));
-  const target = args.out || `${filename}.workflow.json`;
+  }).catch((e: unknown) => { const err = e as { message?: string; code?: string }; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
+  const target = String(args.out || `${filename}.workflow.json`);
   if (!args.force) {
     try {
       await access(target);
@@ -45,7 +45,7 @@ const SUB: Record<string, (argv: any[]) => Promise<void>> = {
   export: exportSub,
 };
 
-export default async function comfyCmd(argv) {
+export default async function comfyCmd(argv: string[]) {
   const sub = argv[0];
   if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
   const handler = SUB[sub];

package/bin/commands/config.js

@@ -1,10 +1,7 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { createInterface } from "readline/promises";
 import { parseArgs } from "../lib/args.js";
 import { out, die, color, json } from "../lib/output.js";
-import { config as runtimeConfig } from "../../config.js";
-const CONFIG_FILE = runtimeConfig.storage.configFile;
-const CONFIG_DIR = runtimeConfig.storage.configDir;
+import { CONFIG_FILE, buildEffectiveConfig, deleteNestedKey, displayPath, envOverrideForKey, getNestedKey, isAuthConfigKey, isSensitiveConfigKey, isWritableConfigKey, loadFileCfg, parseConfigValue, redactValue, restartNotice, saveFileCfg, setNestedKey, } from "../lib/config-store.js";
 const HELP = `
   ima2 config <subcommand> [options]
 
@@ -28,130 +25,6 @@ const FLAGS = {
     yes: { short: "y", type: "boolean" },
     help: { short: "h", type: "boolean" },
 };
-// Keys config set is allowed to write
-const KNOWN_KEYS = new Set([
-    "imageModels.default",
-    "imageModels.reasoningEffort",
-    "log.level",
-    "features.cardNews",
-    "cardNewsPlanner.enabled",
-    "cardNewsPlanner.model",
-    "cardNewsPlanner.timeoutMs",
-    "cardNewsPlanner.deterministicFallback",
-    "comfy.defaultUrl",
-    "comfy.uploadTimeoutMs",
-    "comfy.maxUploadBytes",
-    "storage.generatedDir",
-    "storage.generatedDirName",
-    "server.port",
-    "server.host",
-    "server.bodyLimit",
-    "oauth.proxyPort",
-    "oauth.statusTimeoutMs",
-    "oauth.restartDelayMs",
-    "limits.maxRefCount",
-    "limits.maxParallel",
-    "history.defaultPageSize",
-    "history.maxPageCap",
-]);
-// Auth keys live in the same file but must go through setup/login
-const AUTH_KEYS = new Set(["provider", "apiKey"]);
-const REDACT_PATTERN = /token|secret|apikey|password/i;
-const ALWAYS_REDACT = new Set(["provider", "apiKey", "oauth.token", "oauth.refreshToken"]);
-// Env var that overrides each writable key
-const KEY_TO_ENV = {
-    "imageModels.default": "IMA2_IMAGE_MODEL_DEFAULT",
-    "imageModels.reasoningEffort": "IMA2_REASONING_EFFORT",
-    "log.level": "IMA2_LOG_LEVEL",
-    "features.cardNews": "IMA2_CARD_NEWS",
-    "server.port": "IMA2_PORT",
-    "server.host": "IMA2_HOST",
-    "server.bodyLimit": "IMA2_BODY_LIMIT",
-    "oauth.proxyPort": "IMA2_OAUTH_PROXY_PORT",
-    "storage.generatedDir": "IMA2_GENERATED_DIR",
-    "cardNewsPlanner.enabled": "IMA2_CARD_NEWS_PLANNER",
-    "cardNewsPlanner.model": "IMA2_CARD_NEWS_PLANNER_MODEL",
-    "cardNewsPlanner.timeoutMs": "IMA2_CARD_NEWS_PLANNER_TIMEOUT_MS",
-    "limits.maxParallel": "IMA2_MAX_PARALLEL",
-    "limits.maxRefCount": "IMA2_MAX_REF_COUNT",
-    "history.defaultPageSize": "IMA2_HISTORY_PAGE_SIZE",
-};
-function redactValue(key, value) {
-    if (ALWAYS_REDACT.has(key) || REDACT_PATTERN.test(key)) {
-        return value ? "<redacted>" : value;
-    }
-    return value;
-}
-function loadFileCfg() {
-    if (!existsSync(CONFIG_FILE))
-        return {};
-    try {
-        return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
-    }
-    catch {
-        return {};
-    }
-}
-function saveFileCfg(cfg) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
-    writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2));
-}
-function getNestedKey(obj, dotKey) {
-    const parts = dotKey.split(".");
-    let cur = obj;
-    for (const p of parts) {
-        if (cur == null || typeof cur !== "object")
-            return undefined;
-        cur = cur[p];
-    }
-    return cur;
-}
-function setNestedKey(obj, dotKey, value) {
-    const parts = dotKey.split(".");
-    let cur = obj;
-    for (let i = 0; i < parts.length - 1; i++) {
-        if (cur[parts[i]] == null || typeof cur[parts[i]] !== "object")
-            cur[parts[i]] = {};
-        cur = cur[parts[i]];
-    }
-    cur[parts[parts.length - 1]] = value;
-}
-function deleteNestedKey(obj, dotKey) {
-    const parts = dotKey.split(".");
-    let cur = obj;
-    for (let i = 0; i < parts.length - 1; i++) {
-        if (cur == null || typeof cur !== "object")
-            return false;
-        cur = cur[parts[i]];
-    }
-    if (cur == null || typeof cur !== "object")
-        return false;
-    const last = parts[parts.length - 1];
-    if (!(last in cur))
-        return false;
-    delete cur[last];
-    return true;
-}
-function stripSets(v) {
-    if (v instanceof Set)
-        return [...v];
-    if (Array.isArray(v))
-        return v.map(stripSets);
-    if (v && typeof v === "object") {
-        const r = {};
-        for (const [k, val] of Object.entries(v))
-            r[k] = stripSets(val);
-        return r;
-    }
-    return v;
-}
-function buildEffectiveConfig() {
-    return stripSets(runtimeConfig);
-}
-function displayPath(p) {
-    const home = process.env.HOME || "";
-    return home && p.startsWith(home) ? p.replace(home, "~") : p;
-}
 async function pathSub(_argv) {
     out(CONFIG_FILE);
 }
@@ -198,26 +71,21 @@ async function setSub(argv) {
     const [key, rawValue] = args.positional;
     if (!key || rawValue === undefined)
         die(2, "usage: config set <key> <value>");
-    if (AUTH_KEYS.has(key)) {
+    if (isAuthConfigKey(key)) {
         die(2, `"${key}" is an auth key. Use 'ima2 setup' or 'ima2 login' to change authentication.`);
     }
-    if (!KNOWN_KEYS.has(key)) {
+    if (!isWritableConfigKey(key)) {
         die(2, `unknown config key: "${key}". Run 'ima2 config ls --effective' to see the config structure.`);
     }
-    // Parse value: try JSON, fall back to raw string
-    let value = rawValue;
-    try {
-        value = JSON.parse(rawValue);
-    }
-    catch { }
+    const value = parseConfigValue(rawValue);
     // Warn if env var is overriding this key
-    const envVar = KEY_TO_ENV[key];
-    if (envVar && process.env[envVar] !== undefined) {
-        out(color.yellow(`warning: env ${envVar}=${process.env[envVar]} is currently overriding this value.`));
+    const override = envOverrideForKey(key);
+    if (override) {
+        out(color.yellow(`warning: env ${override.envVar}=${override.value} is currently overriding this value.`));
         out(`The file change will only apply after unsetting the env var and restarting the server.`);
     }
     // Confirm if writing a sensitive key
-    if ((ALWAYS_REDACT.has(key) || REDACT_PATTERN.test(key)) && !args.yes) {
+    if (isSensitiveConfigKey(key) && !args.yes) {
         const rl = createInterface({ input: process.stdin, output: process.stdout });
         const ans = await rl.question(`warning: "${key}" is a sensitive credential. Write to config file? [y/N] `);
         rl.close();
@@ -230,14 +98,14 @@ async function setSub(argv) {
     setNestedKey(fileCfg, key, value);
     saveFileCfg(fileCfg);
     out(color.green("✓ ") + `wrote ${key}=${JSON.stringify(value)} to ${displayPath(CONFIG_FILE)}`);
-    out(color.dim("note: server must be restarted to pick up config changes (run `ima2 serve`)"));
+    out(color.dim(restartNotice()));
 }
 async function rmSub(argv) {
     const args = parseArgs(argv, { flags: FLAGS });
     const key = args.positional[0];
     if (!key)
         die(2, "key required. Usage: config rm <key>");
-    if (AUTH_KEYS.has(key)) {
+    if (isAuthConfigKey(key)) {
         die(2, `"${key}" is an auth key. Use 'ima2 setup' or 'ima2 login' to change authentication.`);
     }
     const fileCfg = loadFileCfg();
@@ -248,7 +116,7 @@ async function rmSub(argv) {
     }
     saveFileCfg(fileCfg);
     out(color.green("✓ ") + `removed ${key} from ${displayPath(CONFIG_FILE)}`);
-    out(color.dim("note: server must be restarted to pick up config changes (run `ima2 serve`)"));
+    out(color.dim(restartNotice()));
 }
 const SUB = {
     path: pathSub,

package/bin/commands/config.ts

@@ -1,11 +1,23 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { createInterface } from "readline/promises";
 import { parseArgs } from "../lib/args.js";
 import { out, die, color, json } from "../lib/output.js";
-import { config as runtimeConfig } from "../../config.js";
-
-const CONFIG_FILE = runtimeConfig.storage.configFile;
-const CONFIG_DIR  = runtimeConfig.storage.configDir;
+import {
+  CONFIG_FILE,
+  buildEffectiveConfig,
+  deleteNestedKey,
+  displayPath,
+  envOverrideForKey,
+  getNestedKey,
+  isAuthConfigKey,
+  isSensitiveConfigKey,
+  isWritableConfigKey,
+  loadFileCfg,
+  parseConfigValue,
+  redactValue,
+  restartNotice,
+  saveFileCfg,
+  setNestedKey,
+} from "../lib/config-store.js";
 
 const HELP = `
   ima2 config <subcommand> [options]
@@ -32,135 +44,11 @@ const FLAGS = {
   help:      { short: "h", type: "boolean" },
 };
 
-// Keys config set is allowed to write
-const KNOWN_KEYS = new Set([
-  "imageModels.default",
-  "imageModels.reasoningEffort",
-  "log.level",
-  "features.cardNews",
-  "cardNewsPlanner.enabled",
-  "cardNewsPlanner.model",
-  "cardNewsPlanner.timeoutMs",
-  "cardNewsPlanner.deterministicFallback",
-  "comfy.defaultUrl",
-  "comfy.uploadTimeoutMs",
-  "comfy.maxUploadBytes",
-  "storage.generatedDir",
-  "storage.generatedDirName",
-  "server.port",
-  "server.host",
-  "server.bodyLimit",
-  "oauth.proxyPort",
-  "oauth.statusTimeoutMs",
-  "oauth.restartDelayMs",
-  "limits.maxRefCount",
-  "limits.maxParallel",
-  "history.defaultPageSize",
-  "history.maxPageCap",
-]);
-
-// Auth keys live in the same file but must go through setup/login
-const AUTH_KEYS = new Set(["provider", "apiKey"]);
-
-const REDACT_PATTERN = /token|secret|apikey|password/i;
-const ALWAYS_REDACT  = new Set(["provider", "apiKey", "oauth.token", "oauth.refreshToken"]);
-
-// Env var that overrides each writable key
-const KEY_TO_ENV: Record<string, string> = {
-  "imageModels.default":              "IMA2_IMAGE_MODEL_DEFAULT",
-  "imageModels.reasoningEffort":      "IMA2_REASONING_EFFORT",
-  "log.level":                        "IMA2_LOG_LEVEL",
-  "features.cardNews":                "IMA2_CARD_NEWS",
-  "server.port":                      "IMA2_PORT",
-  "server.host":                      "IMA2_HOST",
-  "server.bodyLimit":                 "IMA2_BODY_LIMIT",
-  "oauth.proxyPort":                  "IMA2_OAUTH_PROXY_PORT",
-  "storage.generatedDir":             "IMA2_GENERATED_DIR",
-  "cardNewsPlanner.enabled":          "IMA2_CARD_NEWS_PLANNER",
-  "cardNewsPlanner.model":            "IMA2_CARD_NEWS_PLANNER_MODEL",
-  "cardNewsPlanner.timeoutMs":        "IMA2_CARD_NEWS_PLANNER_TIMEOUT_MS",
-  "limits.maxParallel":               "IMA2_MAX_PARALLEL",
-  "limits.maxRefCount":               "IMA2_MAX_REF_COUNT",
-  "history.defaultPageSize":          "IMA2_HISTORY_PAGE_SIZE",
-};
-
-function redactValue(key: string, value: any): any {
-  if (ALWAYS_REDACT.has(key) || REDACT_PATTERN.test(key)) {
-    return value ? "<redacted>" : value;
-  }
-  return value;
-}
-
-function loadFileCfg(): Record<string, any> {
-  if (!existsSync(CONFIG_FILE)) return {};
-  try { return JSON.parse(readFileSync(CONFIG_FILE, "utf-8")); }
-  catch { return {}; }
-}
-
-function saveFileCfg(cfg: Record<string, any>) {
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2));
-}
-
-function getNestedKey(obj: any, dotKey: string): any {
-  const parts = dotKey.split(".");
-  let cur = obj;
-  for (const p of parts) {
-    if (cur == null || typeof cur !== "object") return undefined;
-    cur = cur[p];
-  }
-  return cur;
-}
-
-function setNestedKey(obj: any, dotKey: string, value: any): void {
-  const parts = dotKey.split(".");
-  let cur = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    if (cur[parts[i]] == null || typeof cur[parts[i]] !== "object") cur[parts[i]] = {};
-    cur = cur[parts[i]];
-  }
-  cur[parts[parts.length - 1]] = value;
-}
-
-function deleteNestedKey(obj: any, dotKey: string): boolean {
-  const parts = dotKey.split(".");
-  let cur = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    if (cur == null || typeof cur !== "object") return false;
-    cur = cur[parts[i]];
-  }
-  if (cur == null || typeof cur !== "object") return false;
-  const last = parts[parts.length - 1];
-  if (!(last in cur)) return false;
-  delete cur[last];
-  return true;
-}
-
-function stripSets(v: any): any {
-  if (v instanceof Set)  return [...v];
-  if (Array.isArray(v))  return v.map(stripSets);
-  if (v && typeof v === "object") {
-    const r: any = {};
-    for (const [k, val] of Object.entries(v)) r[k] = stripSets(val);
-    return r;
-  }
-  return v;
-}
-
-function buildEffectiveConfig(): Record<string, any> {
-  return stripSets(runtimeConfig);
-}
-
-function displayPath(p: string): string {
-  const home = process.env.HOME || "";
-  return home && p.startsWith(home) ? p.replace(home, "~") : p;
-}
-
-async function pathSub(_argv) {
+async function pathSub(_argv: string[]) {
   out(CONFIG_FILE);
 }
 
-async function lsSub(argv) {
+async function lsSub(argv: string[]) {
   const args = parseArgs(argv, { flags: FLAGS });
   if (args.effective) {
     const eff = buildEffectiveConfig();
@@ -173,7 +61,7 @@ async function lsSub(argv) {
   }
 }
 
-async function getSub(argv) {
+async function getSub(argv: string[]) {
   const args = parseArgs(argv, { flags: FLAGS });
   const key = args.positional[0];
   if (!key) die(2, "key required. Usage: config get <dotted.key>");
@@ -188,31 +76,29 @@ async function getSub(argv) {
   }
 }
 
-async function setSub(argv) {
+async function setSub(argv: string[]) {
   const args = parseArgs(argv, { flags: FLAGS });
   const [key, rawValue] = args.positional;
   if (!key || rawValue === undefined) die(2, "usage: config set <key> <value>");
 
-  if (AUTH_KEYS.has(key)) {
+  if (isAuthConfigKey(key)) {
     die(2, `"${key}" is an auth key. Use 'ima2 setup' or 'ima2 login' to change authentication.`);
   }
-  if (!KNOWN_KEYS.has(key)) {
+  if (!isWritableConfigKey(key)) {
     die(2, `unknown config key: "${key}". Run 'ima2 config ls --effective' to see the config structure.`);
   }
 
-  // Parse value: try JSON, fall back to raw string
-  let value: any = rawValue;
-  try { value = JSON.parse(rawValue); } catch {}
+  const value = parseConfigValue(rawValue);
 
   // Warn if env var is overriding this key
-  const envVar = KEY_TO_ENV[key];
-  if (envVar && process.env[envVar] !== undefined) {
-    out(color.yellow(`warning: env ${envVar}=${process.env[envVar]} is currently overriding this value.`));
+  const override = envOverrideForKey(key);
+  if (override) {
+    out(color.yellow(`warning: env ${override.envVar}=${override.value} is currently overriding this value.`));
     out(`The file change will only apply after unsetting the env var and restarting the server.`);
   }
 
   // Confirm if writing a sensitive key
-  if ((ALWAYS_REDACT.has(key) || REDACT_PATTERN.test(key)) && !args.yes) {
+  if (isSensitiveConfigKey(key) && !args.yes) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     const ans = await rl.question(`warning: "${key}" is a sensitive credential. Write to config file? [y/N] `);
     rl.close();
@@ -224,15 +110,15 @@ async function setSub(argv) {
   saveFileCfg(fileCfg);
 
   out(color.green("✓ ") + `wrote ${key}=${JSON.stringify(value)} to ${displayPath(CONFIG_FILE)}`);
-  out(color.dim("note: server must be restarted to pick up config changes (run `ima2 serve`)"));
+  out(color.dim(restartNotice()));
 }
 
-async function rmSub(argv) {
+async function rmSub(argv: string[]) {
   const args = parseArgs(argv, { flags: FLAGS });
   const key = args.positional[0];
   if (!key) die(2, "key required. Usage: config rm <key>");
 
-  if (AUTH_KEYS.has(key)) {
+  if (isAuthConfigKey(key)) {
     die(2, `"${key}" is an auth key. Use 'ima2 setup' or 'ima2 login' to change authentication.`);
   }
 
@@ -244,7 +130,7 @@ async function rmSub(argv) {
   }
   saveFileCfg(fileCfg);
   out(color.green("✓ ") + `removed ${key} from ${displayPath(CONFIG_FILE)}`);
-  out(color.dim("note: server must be restarted to pick up config changes (run `ima2 serve`)"));
+  out(color.dim(restartNotice()));
 }
 
 type Sub = (argv: any[]) => Promise<void>;
@@ -256,7 +142,7 @@ const SUB: Record<string, Sub> = {
   rm:   rmSub,
 };
 
-export default async function configCmd(argv) {
+export default async function configCmd(argv: string[]) {
   const sub = argv[0];
   if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
   const handler = SUB[sub];

package/bin/commands/defaults.js

@@ -0,0 +1,180 @@
+import { config } from "../../config.js";
+import { parseArgs } from "../lib/args.js";
+import { resolveServer, request } from "../lib/client.js";
+import { buildEffectiveConfig, deleteNestedKey, displayPath, envOverrideForKey, getNestedKey, loadFileCfg, restartNotice, saveFileCfg, setNestedKey, CONFIG_FILE, } from "../lib/config-store.js";
+import { color, die, dieWithError, json, out } from "../lib/output.js";
+const MODEL_KEYS = ["imageModels.default", "apiProvider.defaultImageModel"];
+const REASONING_KEYS = ["imageModels.reasoningEffort", "apiProvider.defaultReasoningEffort"];
+const HELP = `
+  ima2 defaults [subcommand] [options]
+
+  Inspect or change persistent model/reasoning defaults.
+
+  Subcommands:
+    ls                         Show effective defaults
+    set model <model>          Persist default model for OAuth and API paths
+    set reasoning <effort>     Persist default reasoning effort for OAuth and API paths
+    reset model                Remove persisted model defaults
+    reset reasoning            Remove persisted reasoning defaults
+
+  Options:
+    --json                     Print JSON
+    --local                    Do not query running server
+    --server <url>             Query a specific running server for ls/default output
+`;
+const FLAGS = {
+    json: { type: "boolean" },
+    local: { type: "boolean" },
+    server: { type: "string" },
+    help: { short: "h", type: "boolean" },
+};
+function localDefaults() {
+    const effective = buildEffectiveConfig();
+    return {
+        ok: true,
+        source: "local",
+        server: null,
+        defaults: {
+            oauth: {
+                model: getNestedKey(effective, "imageModels.default"),
+                reasoningEffort: getNestedKey(effective, "imageModels.reasoningEffort"),
+            },
+            api: {
+                model: getNestedKey(effective, "apiProvider.defaultImageModel"),
+                reasoningEffort: getNestedKey(effective, "apiProvider.defaultReasoningEffort"),
+                size: getNestedKey(effective, "apiProvider.defaultSize"),
+                webSearchEnabled: getNestedKey(effective, "apiProvider.allowWebSearch"),
+            },
+        },
+    };
+}
+async function readDefaults(args) {
+    if (args.local)
+        return localDefaults();
+    try {
+        const server = await resolveServer({ serverFlag: args.server });
+        const capabilities = await request(server.base, "/api/capabilities", { timeoutMs: 5000 });
+        return {
+            ok: true,
+            source: "server",
+            server: server.base,
+            defaults: capabilities.defaults,
+        };
+    }
+    catch (error) {
+        if (args.server)
+            throw error;
+        return localDefaults();
+    }
+}
+function printDefaults(payload) {
+    out(`ima2 defaults (${payload.source})`);
+    out(`server: ${payload.server || "none"}`);
+    out("");
+    out(`oauth model: ${payload.defaults?.oauth?.model}`);
+    out(`oauth reasoning: ${payload.defaults?.oauth?.reasoningEffort}`);
+    out(`api model: ${payload.defaults?.api?.model}`);
+    out(`api reasoning: ${payload.defaults?.api?.reasoningEffort}`);
+    if (payload.defaults?.api?.size)
+        out(`api size: ${payload.defaults.api.size}`);
+    if (payload.defaults?.api?.webSearchEnabled !== undefined) {
+        out(`api web search: ${payload.defaults.api.webSearchEnabled ? "enabled" : "disabled"}`);
+    }
+}
+function validateModel(value) {
+    if (!config.imageModels.valid.has(value)) {
+        die(2, `model must be one of: ${Array.from(config.imageModels.valid).join(", ")}`);
+    }
+}
+function validateReasoning(value) {
+    if (!config.imageModels.validReasoningEfforts.has(value)) {
+        die(2, `reasoning must be one of: ${Array.from(config.imageModels.validReasoningEfforts).join(", ")}`);
+    }
+}
+function warnOverrides(keys) {
+    for (const key of keys) {
+        const override = envOverrideForKey(key);
+        if (!override)
+            continue;
+        out(color.yellow(`warning: env ${override.envVar}=${override.value} is currently overriding ${key}.`));
+    }
+}
+function setDefaults(keys, value) {
+    const fileCfg = loadFileCfg();
+    for (const key of keys)
+        setNestedKey(fileCfg, key, value);
+    saveFileCfg(fileCfg);
+    warnOverrides(keys);
+    out(color.green("✓ ") + `wrote ${keys.join(", ")}=${JSON.stringify(value)} to ${displayPath(CONFIG_FILE)}`);
+    out(color.dim(restartNotice()));
+}
+function resetDefaults(keys) {
+    const fileCfg = loadFileCfg();
+    let changed = false;
+    for (const key of keys)
+        changed = deleteNestedKey(fileCfg, key) || changed;
+    if (!changed) {
+        out(color.dim(`(no persisted defaults found for ${keys.join(", ")})`));
+        return;
+    }
+    saveFileCfg(fileCfg);
+    out(color.green("✓ ") + `removed ${keys.join(", ")} from ${displayPath(CONFIG_FILE)}`);
+    out(color.dim(restartNotice()));
+}
+async function listSub(argv) {
+    const args = parseArgs(argv, { flags: FLAGS });
+    try {
+        const payload = await readDefaults(args);
+        if (args.json)
+            json(payload);
+        else
+            printDefaults(payload);
+    }
+    catch (error) {
+        dieWithError(error);
+    }
+}
+async function setSub(argv) {
+    const args = parseArgs(argv, { flags: FLAGS });
+    const [target, value] = args.positional;
+    if (!target || !value)
+        die(2, "usage: defaults set <model|reasoning> <value>");
+    if (target === "model") {
+        validateModel(value);
+        setDefaults(MODEL_KEYS, value);
+        return;
+    }
+    if (target === "reasoning") {
+        validateReasoning(value);
+        setDefaults(REASONING_KEYS, value);
+        return;
+    }
+    die(2, "target must be one of: model, reasoning");
+}
+async function resetSub(argv) {
+    const args = parseArgs(argv, { flags: FLAGS });
+    const target = args.positional[0];
+    if (target === "model") {
+        resetDefaults(MODEL_KEYS);
+        return;
+    }
+    if (target === "reasoning") {
+        resetDefaults(REASONING_KEYS);
+        return;
+    }
+    die(2, "usage: defaults reset <model|reasoning>");
+}
+export default async function defaultsCmd(argv) {
+    const sub = argv[0];
+    if (sub === "--help" || sub === "-h") {
+        out(HELP);
+        return;
+    }
+    if (!sub || sub === "ls" || sub.startsWith("-"))
+        return listSub(sub === "ls" ? argv.slice(1) : argv);
+    if (sub === "set")
+        return setSub(argv.slice(1));
+    if (sub === "reset")
+        return resetSub(argv.slice(1));
+    die(2, `unknown subcommand: ${sub}\n${HELP}`);
+}