Files
OmniRoute/tests/unit/cli-contexts.test.ts
Xiangzhe 0a74bfbdea feat(cli): relay-like CLI closure — target manifest, Codex TOML, Gemini launcher, guards
- canonical executable manifest (bin/cli/cli-manifest.mjs): run/configure/completion
  derive targets, aliases and --model wiring from one table; drift test cross-checks
  manifest x cliRuntime x UI catalog (tests/unit/cli/cli-manifest-drift.test.ts)
- dashboard Codex generator converged to ~/.codex/config.toml (modern Codex v0.137+,
  verified against codex-cli 0.147.0): conservative merge, env_key auth (key never
  written), refuses invalid TOML, reports legacy config.yaml as migration note
- omniroute run gemini: launcher over OmniRoute's /v1beta surface via
  GOOGLE_GEMINI_BASE_URL + isolated GEMINI_CLI_HOME forcing gemini-api-key auth
  (contract proven against @google/gemini-cli 0.50.0); ACP registration kept distinct
- opt-in real smoke harness for upstream CLIs (RUN_CLI_SMOKE=1, credential by env
  NAME, redacted output): tests/integration/upstream-cli-smoke.int.test.ts
- container-guard homologation for POST /api/cli-tools/apply (422 in container,
  dry-run preview allowed, host write passes) + docs; guard untouched
- typecheck: omniglyphAdapter union narrowing, usageTracking typed signatures
  (UsageLike, no any), models.ts isValidModel params — typecheck:core and
  typecheck:noimplicit:core now clean
- relay core (prior session of this effort): omniroute run for 6 CLIs, configure
  picker with per-context favorites/recents, contexts with optional keychain +
  0600 fallback, provider CRUD with recursive redaction, completion updates, docs
2026-08-18 08:25:16 -03:00

180 lines
6.5 KiB
TypeScript

import test from "node:test";
import assert from "node:assert/strict";
import { mkdtempSync, readFileSync, rmSync } from "node:fs";
import { join } from "node:path";
import { tmpdir } from "node:os";
let tmpDir: string;
let origDataDir: string | undefined;
test.before(() => {
tmpDir = mkdtempSync(join(tmpdir(), "omniroute-ctx-test-"));
origDataDir = process.env.DATA_DIR;
process.env.DATA_DIR = tmpDir;
});
test.after(() => {
if (origDataDir === undefined) delete process.env.DATA_DIR;
else process.env.DATA_DIR = origDataDir;
try {
rmSync(tmpDir, { recursive: true, force: true });
} catch {}
});
test("contexts.mjs pode ser importado sem erro", async () => {
const mod = await import("../../bin/cli/contexts.mjs");
assert.equal(typeof mod.loadContexts, "function");
assert.equal(typeof mod.saveContexts, "function");
assert.equal(typeof mod.resolveActiveContext, "function");
assert.equal(typeof mod.configPath, "function");
});
test("loadContexts retorna config padrão quando arquivo não existe", async () => {
const { loadContexts } = await import("../../bin/cli/contexts.mjs");
const cfg = loadContexts();
assert.ok(cfg.contexts);
assert.ok(cfg.contexts.default);
assert.equal(typeof cfg.contexts.default.baseUrl, "string");
assert.equal(cfg.currentContext, "default");
});
test("saveContexts persiste e loadContexts relê", async () => {
const { loadContexts, saveContexts } = await import("../../bin/cli/contexts.mjs");
const cfg = loadContexts();
cfg.contexts.test = { baseUrl: "http://test:9999", apiKey: null };
cfg.currentContext = "test";
saveContexts(cfg);
const cfg2 = loadContexts();
assert.equal(cfg2.currentContext, "test");
assert.equal(cfg2.contexts.test?.baseUrl, "http://test:9999");
});
test("resolveActiveContext retorna contexto ativo", async () => {
const { resolveActiveContext, loadContexts, saveContexts } =
await import("../../bin/cli/contexts.mjs");
const cfg = loadContexts();
cfg.contexts.prod = { baseUrl: "https://prod.example.com", apiKey: "sk-prod" };
cfg.currentContext = "prod";
saveContexts(cfg);
const ctx = resolveActiveContext(undefined);
assert.equal(ctx.baseUrl, "https://prod.example.com");
});
test("resolveActiveContext aceita override pontual", async () => {
const { resolveActiveContext, loadContexts, saveContexts } =
await import("../../bin/cli/contexts.mjs");
const cfg = loadContexts();
cfg.contexts.staging = { baseUrl: "http://staging:20128", apiKey: null };
saveContexts(cfg);
const ctx = resolveActiveContext("staging");
assert.equal(ctx.baseUrl, "http://staging:20128");
});
test("saveContextsSecure guarda tokens no keychain e resolve pela referência", async () => {
const {
loadContexts,
saveContextsSecure,
resolveActiveContext,
setContextKeychainBackendForTests,
} = await import("../../bin/cli/contexts.mjs");
const entries = new Map<string, string>();
const fakeKeychain = {
async getPassword(_service: string, account: string) {
return entries.get(account) || null;
},
async setPassword(_service: string, account: string, value: string) {
entries.set(account, value);
},
async deletePassword(_service: string, account: string) {
entries.delete(account);
return true;
},
};
await setContextKeychainBackendForTests(fakeKeychain);
const cfg = loadContexts();
cfg.contexts.secure = {
baseUrl: "https://secure.example.com",
accessToken: "oma_test_secret",
scope: "write",
};
await saveContextsSecure(cfg);
const persisted = JSON.parse(readFileSync(join(tmpDir, "config.json"), "utf8"));
assert.equal(persisted.contexts.secure.accessToken, undefined);
assert.match(persisted.contexts.secure.credentialRef, /^omniroute-cli:context:/);
assert.equal(resolveActiveContext("secure").accessToken, "oma_test_secret");
assert.ok(entries.size >= 1);
await setContextKeychainBackendForTests(null);
});
test("contexts.mjs (commands) pode ser importado sem erro", async () => {
const mod = await import("../../bin/cli/commands/contexts.mjs");
assert.equal(typeof mod.registerContexts, "function");
});
test("context export redaction covers canonical and legacy profile schemas", async () => {
const { redactContextSecrets } = await import("../../bin/cli/commands/contexts.mjs");
const redacted = redactContextSecrets({
contexts: { remote: { accessToken: "oma-secret", apiKey: "sk-secret" } },
profiles: { legacy: { accessToken: "legacy-secret", apiKey: "legacy-key" } },
});
assert.deepEqual(redacted.contexts.remote, { apiKey: null });
assert.deepEqual(redacted.profiles.legacy, { apiKey: null });
});
test("confirm() declines cleanly on non-interactive stdin (no hung await)", async () => {
// Regression: `contexts remove` without --yes used to prompt even when stdin
// could not answer (pipe/CI/EOF), leaving the readline question pending and
// triggering Node's "unsettled top-level await" warning. With a non-TTY stdin
// confirm() must resolve to false immediately (decline) without touching
// readline — `--yes` remains the way to proceed non-interactively.
const { confirm } = await import("../../bin/cli/commands/contexts.mjs");
const desc = Object.getOwnPropertyDescriptor(process.stdin, "isTTY");
Object.defineProperty(process.stdin, "isTTY", { value: false, configurable: true });
try {
const result = await confirm("Remove context 'x'?");
assert.equal(result, false);
} finally {
if (desc) Object.defineProperty(process.stdin, "isTTY", desc);
else delete (process.stdin as { isTTY?: boolean }).isTTY;
}
});
test("registerContexts registers the singular `context` alias", async () => {
// The connect output and older docs say `omniroute context current` (singular);
// the command is `contexts`. An alias keeps the singular muscle-memory working.
const { registerContexts } = await import("../../bin/cli/commands/contexts.mjs");
let aliasName: string | undefined;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const fakeCtx: any = {
command() {
return this;
},
alias(a: string) {
aliasName = a;
return this;
},
description() {
return this;
},
requiredOption() {
return this;
},
option() {
return this;
},
action() {
return this;
},
};
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const fakeProgram: any = {
command() {
return fakeCtx;
},
};
registerContexts(fakeProgram);
assert.equal(aliasName, "context");
});