ima2-gen 1.1.21 → 1.1.22

package/bin/commands/canvas-versions.ts

@@ -1,80 +0,0 @@
-import { readFile } from "fs/promises";
-import { parseArgs, type ParsedArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-
-const HELP = `
-  ima2 canvas-versions <subcommand> [options]
-
-  Subcommands:
-    save <imagefile> [--source <filename>] [--prompt <text>]
-    update <filename> <imagefile> [--source <filename>] [--prompt <text>]
-
-  Notes: server only exposes POST /api/canvas-versions (collection) and
-  PUT /api/canvas-versions/:filename. No GET, no DELETE.
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  source: { type: "string" },
-  prompt: { type: "string" },
-  help: { short: "h", type: "boolean" },
-};
-
-async function getServer(args: ParsedArgs) {
-  try { return await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-}
-
-function buildHeaders(args: ParsedArgs) {
-  const h: Record<string, string> = { "Content-Type": "image/png" };
-  if (args.source) h["X-Ima2-Canvas-Source-Filename"] = String(args.source);
-  if (args.prompt) h["X-Ima2-Canvas-Prompt"] = String(args.prompt);
-  return h;
-}
-
-async function saveSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const file = args.positional[0];
-  if (!file) die(2, "image file required");
-  const buf = await readFile(file);
-  const server = await getServer(args);
-  const resp = await request(server.base, "/api/canvas-versions", {
-    method: "POST",
-    body: buf,
-    raw: true,
-    headers: buildHeaders(args),
-  }).catch((e: unknown) => { const err = e as { message?: string; code?: string }; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ saved canvas version"));
-}
-
-async function updateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const [filename, file] = args.positional;
-  if (!filename || !file) die(2, "usage: canvas-versions update <filename> <imagefile>");
-  const buf = await readFile(file);
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/canvas-versions/${encodeURIComponent(filename)}`, {
-    method: "PUT",
-    body: buf,
-    raw: true,
-    headers: buildHeaders(args),
-  }).catch((e: unknown) => { const err = e as { message?: string; code?: string }; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ updated"));
-}
-
-const SUB: Record<string, (argv: any[]) => Promise<void>> = {
-  save: saveSub,
-  update: updateSub,
-};
-
-export default async function canvasVersionsCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-  const handler = SUB[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}

package/bin/commands/capabilities.ts

@@ -1,110 +0,0 @@
-import { readFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { config } from "../../config.js";
-import { buildIma2Capabilities } from "../../lib/capabilities.js";
-import { parseArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { color, dieWithError, json, out } from "../lib/output.js";
-
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-const PACKAGE_PATH = join(ROOT, "package.json");
-
-const HELP = `
-  ima2 capabilities [--json] [--server <url>] [--require-server]
-
-  Print agent-friendly capability metadata.
-
-  Options:
-    --json             Print JSON
-    --server <url>     Query a specific running server
-    --require-server   Fail instead of falling back to local package metadata
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  "require-server": { type: "boolean" },
-  help: { short: "h", type: "boolean" },
-};
-
-function packageVersion(): string {
-  try {
-    const pkg = JSON.parse(readFileSync(PACKAGE_PATH, "utf-8")) as { version?: string };
-    return pkg.version || "?";
-  } catch {
-    return "?";
-  }
-}
-
-function localCapabilities() {
-  return buildIma2Capabilities({
-    appConfig: config,
-    packageVersion: packageVersion(),
-    source: "local",
-    server: null,
-  });
-}
-
-async function readCapabilities(args: ReturnType<typeof parseArgs>) {
-  try {
-    const server = await resolveServer({ serverFlag: args.server });
-    return await request(server.base, "/api/capabilities", { timeoutMs: 5000 });
-  } catch (error) {
-    if (args.server || args["require-server"]) throw error;
-    return localCapabilities();
-  }
-}
-
-function printText(capabilities: any): void {
-  out(`ima2 capabilities (${capabilities.source})`);
-  out(`version: ${capabilities.version}`);
-  out(`server: ${capabilities.server || "none"}`);
-  out("");
-  out("defaults:");
-  out(`  gpt-oauth model: ${capabilities.defaults?.oauth?.model}`);
-  out(`  gpt-oauth reasoning: ${capabilities.defaults?.oauth?.reasoningEffort}`);
-  out(`  api model: ${capabilities.defaults?.api?.model}`);
-  out(`  api reasoning: ${capabilities.defaults?.api?.reasoningEffort}`);
-  out(`  grok model: ${capabilities.defaults?.grok?.model}`);
-  out(`  grok planner: ${capabilities.defaults?.grok?.plannerModel}`);
-  out("");
-  out("valid:");
-  out(`  models: ${capabilities.valid?.imageModels?.supported?.join(", ")}`);
-  if (capabilities.valid?.imageModels?.grokSupported?.length) {
-    out(`  grok models: ${capabilities.valid.imageModels.grokSupported.join(", ")}`);
-  }
-  if (capabilities.valid?.videoModels?.supported?.length) {
-    out(`  video models: ${capabilities.valid.videoModels.supported.join(", ")}`);
-    out(`  video resolutions: ${capabilities.valid.videoModels.resolutions?.join(", ")}`);
-    out(`  video aspect ratios: ${capabilities.valid.videoModels.aspectRatios?.join(", ")}`);
-    out(`  video duration: ${capabilities.valid.videoModels.durationRange?.[0]}-${capabilities.valid.videoModels.durationRange?.[1]}s`);
-  }
-  out(`  reasoning: ${capabilities.valid?.reasoningEfforts?.join(", ")}`);
-  out(`  quality: ${capabilities.valid?.quality?.join(", ")}`);
-  out(`  modes: ${capabilities.valid?.modes?.join(", ")}`);
-  out(`  moderation: ${capabilities.valid?.moderation?.join(", ")}`);
-  out(`  providers: ${capabilities.valid?.providers?.join(", ")}`);
-  out("");
-  out(`config keys: ${capabilities.configKeys?.writable?.length ?? 0} writable`);
-  out(color.dim("run: ima2 config keys --json"));
-  out("");
-  out(`limits: refs=${capabilities.limits?.maxRefCount}, images=${capabilities.limits?.maxGeneratedImages}`);
-  out(color.dim(`maxParallel: ${capabilities.limits?.maxParallel?.value} (${capabilities.limits?.maxParallel?.note})`));
-}
-
-export default async function capabilitiesCmd(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  if (args.help) {
-    out(HELP);
-    return;
-  }
-
-  try {
-    const capabilities = await readCapabilities(args);
-    if (args.json) json(capabilities);
-    else printText(capabilities);
-  } catch (error) {
-    dieWithError(error);
-  }
-}

package/bin/commands/cardnews.ts

@@ -1,249 +0,0 @@
-import { parseArgs, type ParsedArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-import { config as runtimeConfig } from "../../config.js";
-
-const HELP = `
-  ima2 cardnews <subcommand> [options]
-
-  Subcommands:
-    templates                              List image-templates + role-templates
-    template preview <templateId>          Preview an image template
-    sets                                   List card news sets
-    set show <setId>                       Show a set
-    set manifest <setId>                   Show a set manifest
-    draft [--data <json>]                  Create a draft
-    generate [--data <json>]               Run generation
-    job create [--data <json>]             Create and start a job
-    job show <jobId>                       Show a job
-    job retry <jobId> [--cards <id,...>]   Retry a job (optionally specific cards)
-    card regenerate <cardId> [--data <json>]  Regenerate a single card
-    export [--data <json>]                 Export a bundle
-
-  Note: Card News must be enabled (IMA2_CARD_NEWS=1 or features.cardNews: true in config.json).
-
-  Options:
-    --data <json>   JSON body to send (for draft/generate/job create/card regenerate/export)
-    --cards <ids>   Comma-separated card IDs for job retry
-    --json          Output raw JSON
-    --server <url>  Override server URL
-`;
-
-const FLAGS = {
-  json:   { type: "boolean" },
-  server: { type: "string" },
-  data:   { type: "string" },
-  cards:  { type: "string" },
-  help:   { short: "h", type: "boolean" },
-};
-
-function ensureCardNewsEnabled() {
-  if (!runtimeConfig.features?.cardNews) {
-    die(2, "Card News feature is disabled. Set IMA2_CARD_NEWS=1 (or features.cardNews: true in config.json) and restart the server.");
-  }
-}
-
-async function getServer(args: ParsedArgs) {
-  try { return await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-}
-
-function parseData(raw: unknown): any {
-  if (!raw) return {};
-  if (typeof raw !== "string") return {};
-  try { return JSON.parse(raw); }
-  catch { die(2, `--data must be valid JSON`); }
-}
-
-async function templatesSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  if (args.help) { out(HELP); return; }
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const [imgTemplates, roleTemplates] = await Promise.all([
-    request(server.base, "/api/cardnews/image-templates")
-      .catch((e) => die(exitCodeForError(e), e.message)),
-    request(server.base, "/api/cardnews/role-templates")
-      .catch((e) => die(exitCodeForError(e), e.message)),
-  ]);
-  if (args.json) { json({ imageTemplates: imgTemplates, roleTemplates }); return; }
-  out(color.bold("Image templates:"));
-  out(JSON.stringify(imgTemplates, null, 2));
-  out(color.bold("Role templates:"));
-  out(JSON.stringify(roleTemplates, null, 2));
-}
-
-async function templatePreviewSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const templateId = args.positional[0];
-  if (!templateId) die(2, "templateId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/image-templates/${encodeURIComponent(templateId)}/preview`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function setsSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, "/api/cardnews/sets")
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function setShowSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const setId = args.positional[0];
-  if (!setId) die(2, "setId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/sets/${encodeURIComponent(setId)}`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function setManifestSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const setId = args.positional[0];
-  if (!setId) die(2, "setId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/sets/${encodeURIComponent(setId)}/manifest`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function draftSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/draft", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function generateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/generate", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function jobCreateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/jobs", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function jobShowSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const jobId = args.positional[0];
-  if (!jobId) die(2, "jobId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/jobs/${encodeURIComponent(jobId)}`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function jobRetrySub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const jobId = args.positional[0];
-  if (!jobId) die(2, "jobId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body: any = {};
-  if (args.cards) body.cardIds = String(args.cards).split(",").map((s: string) => s.trim()).filter(Boolean);
-  const resp = await request(server.base, `/api/cardnews/jobs/${encodeURIComponent(jobId)}/retry`, { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + "retry requested");
-  if (resp && typeof resp === "object" && Object.keys(resp).length > 0) out(JSON.stringify(resp, null, 2));
-}
-
-async function cardRegenerateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const cardId = args.positional[0];
-  if (!cardId) die(2, "cardId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, `/api/cardnews/cards/${encodeURIComponent(cardId)}/regenerate`, { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + "regeneration started");
-  if (resp && typeof resp === "object" && Object.keys(resp).length > 0) out(JSON.stringify(resp, null, 2));
-}
-
-async function exportSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/export", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + "export requested");
-  if (resp && typeof resp === "object" && Object.keys(resp).length > 0) out(JSON.stringify(resp, null, 2));
-}
-
-type Sub = (argv: any[]) => Promise<void>;
-
-export default async function cardnewsCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-
-  if (sub === "template") {
-    const s2 = argv[1];
-    if (s2 === "preview") return templatePreviewSub(argv.slice(2));
-    die(2, `unknown subcommand: template ${s2 || ""}\n${HELP}`);
-  }
-  if (sub === "set") {
-    const s2 = argv[1];
-    const SET_SUB: Record<string, Sub> = { show: setShowSub, manifest: setManifestSub };
-    const handler = SET_SUB[s2];
-    if (!handler) die(2, `unknown subcommand: set ${s2 || ""}\n${HELP}`);
-    return handler(argv.slice(2));
-  }
-  if (sub === "job") {
-    const s2 = argv[1];
-    const JOB_SUB: Record<string, Sub> = { create: jobCreateSub, show: jobShowSub, retry: jobRetrySub };
-    const handler = JOB_SUB[s2];
-    if (!handler) die(2, `unknown subcommand: job ${s2 || ""}\n${HELP}`);
-    return handler(argv.slice(2));
-  }
-  if (sub === "card") {
-    const s2 = argv[1];
-    if (s2 === "regenerate") return cardRegenerateSub(argv.slice(2));
-    die(2, `unknown subcommand: card ${s2 || ""}\n${HELP}`);
-  }
-
-  const FLAT: Record<string, Sub> = {
-    templates: templatesSub,
-    sets: setsSub,
-    draft: draftSub,
-    generate: generateSub,
-    export: exportSub,
-  };
-  const handler = FLAT[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}

package/bin/commands/comfy.ts

@@ -1,54 +0,0 @@
-import { writeFile, access } from "fs/promises";
-import { parseArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-
-const HELP = `
-  ima2 comfy <subcommand> [options]
-
-  Subcommands:
-    export <filename> [-o <out>] [--force]
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  out: { short: "o", type: "string" },
-  force: { type: "boolean" },
-  help: { short: "h", type: "boolean" },
-};
-
-async function exportSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const filename = args.positional[0];
-  if (!filename) die(2, "filename required");
-  let server;
-  try { server = await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-  const resp: any = await request(server.base, "/api/comfy/export-image", {
-    method: "POST",
-    body: { filename },
-  }).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);
-      die(2, `${target} already exists. Pass --force to overwrite.`);
-    } catch { /* file does not exist — proceed */ }
-  }
-  await writeFile(target, JSON.stringify(resp, null, 2));
-  if (args.json) { json({ path: target }); return; }
-  out(color.green("✓ ") + target);
-}
-
-const SUB: Record<string, (argv: any[]) => Promise<void>> = {
-  export: exportSub,
-};
-
-export default async function comfyCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-  const handler = SUB[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}

package/bin/commands/config.ts

@@ -1,186 +0,0 @@
-import { createInterface } from "readline/promises";
-import { parseArgs } from "../lib/args.js";
-import { confirmDestructiveAction } from "../lib/destructive-confirm.js";
-import { out, die, color, json } from "../lib/output.js";
-import {
-  CONFIG_FILE,
-  KEY_TO_ENV,
-  WRITABLE_CONFIG_KEYS,
-  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]
-
-  Subcommands:
-    path                          Print config file path
-    ls [--effective] [--json]     List file layer (or merged effective config with --effective)
-    get <key> [--json]            Get a dotted key from effective config (redacts secrets)
-    set <key> <value> [-y]        Write a key to the file layer
-    rm <key> [-y]                 Remove a key from the file layer
-    keys [--json]                 List writable keys and environment overrides
-
-  Keys use dot notation, e.g.: imageModels.default, log.level, features.cardNews
-
-  Options:
-    --effective     Use effective (merged env+file+defaults) config for ls/get
-    --json          Output raw JSON
-    -y, --yes       Skip confirmation prompts
-`;
-
-const FLAGS = {
-  effective: { type: "boolean" },
-  json:      { type: "boolean" },
-  yes:       { short: "y", type: "boolean" },
-  help:      { short: "h", type: "boolean" },
-};
-
-async function pathSub(_argv: string[]) {
-  out(CONFIG_FILE);
-}
-
-async function lsSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  if (args.effective) {
-    const eff = buildEffectiveConfig();
-    if (args.json) { json(eff); return; }
-    out(JSON.stringify(eff, null, 2));
-  } else {
-    const fileCfg = loadFileCfg();
-    if (args.json) { json(fileCfg); return; }
-    out(JSON.stringify(fileCfg, null, 2));
-  }
-}
-
-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>");
-  const eff = buildEffectiveConfig();
-  const raw = getNestedKey(eff, key);
-  const value = redactValue(key, raw);
-  if (args.json) { json({ key, value }); return; }
-  if (value === undefined) {
-    out(color.dim(`(key not found: ${key})`));
-  } else {
-    out(typeof value === "object" ? JSON.stringify(value, null, 2) : String(value));
-  }
-}
-
-async function keysSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const keys = [...WRITABLE_CONFIG_KEYS].sort().map((key) => ({
-    key,
-    env: KEY_TO_ENV[key] ?? null,
-  }));
-  if (args.json) {
-    json({ keys });
-    return;
-  }
-  for (const item of keys) {
-    out(item.env ? `${item.key}  (${item.env})` : item.key);
-  }
-}
-
-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 (isAuthConfigKey(key)) {
-    die(2, `"${key}" is an auth key. Use 'ima2 setup' or 'ima2 login' to change authentication.`);
-  }
-  if (!isWritableConfigKey(key)) {
-    die(2, `unknown config key: "${key}". Run 'ima2 config ls --effective' to see the config structure.`);
-  }
-
-  const value = parseConfigValue(rawValue);
-
-  // Warn if env var is overriding this key
-  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 (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();
-    if (!ans.trim().toLowerCase().startsWith("y")) { out("Aborted."); process.exit(0); }
-  }
-
-  const fileCfg = loadFileCfg();
-  setNestedKey(fileCfg, key, value);
-  saveFileCfg(fileCfg);
-
-  out(color.green("✓ ") + `wrote ${key}=${JSON.stringify(value)} to ${displayPath(CONFIG_FILE)}`);
-  out(color.dim(restartNotice()));
-}
-
-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 (isAuthConfigKey(key)) {
-    die(2, `"${key}" is an auth key. Use 'ima2 setup' or 'ima2 login' to change authentication.`);
-  }
-
-  const fileCfg = loadFileCfg();
-  if (getNestedKey(fileCfg, key) === undefined) {
-    out(color.dim(`(key not found in file layer: ${key})`));
-    return;
-  }
-
-  try {
-    const confirmed = await confirmDestructiveAction(`Remove config key "${key}"?`, Boolean(args.yes));
-    if (!confirmed) {
-      out("Aborted.");
-      return;
-    }
-  } catch (err) {
-    die(2, err instanceof Error ? err.message : String(err));
-  }
-
-  const removed = deleteNestedKey(fileCfg, key);
-  if (!removed) {
-    out(color.dim(`(key not found in file layer: ${key})`));
-    return;
-  }
-  saveFileCfg(fileCfg);
-  out(color.green("✓ ") + `removed ${key} from ${displayPath(CONFIG_FILE)}`);
-  out(color.dim(restartNotice()));
-}
-
-type Sub = (argv: any[]) => Promise<void>;
-const SUB: Record<string, Sub> = {
-  path: pathSub,
-  ls:   lsSub,
-  get:  getSub,
-  set:  setSub,
-  rm:   rmSub,
-  keys: keysSub,
-};
-
-export default async function configCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-  const handler = SUB[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}