Files
OmniRoute/tests/unit/agent-bridge-mappings-sync-8656.test.ts
Diego Rodrigues de Sa e Souza e7f6b1d130 feat(radar): flag-gated signed free-model catalog overlay (#9515)
* feat(dashboard): add RADAR_ENABLED flag (default off)

* feat(db): radar feed cache + settings with encrypted supporter key

* feat(radar): signed feed sync with pinned key and version floor

- feedSchema.ts: Zod v4 schema mirroring the server feed format
  (discriminated union on budget.kind, enum constraints, etc.)
- pinnedKeys.ts: Ed25519 SPKI-DER pinned key + env override for forks
- verify.ts: signature verification over exact wire bytes, never throws
- sync.ts: full download/verify/validate/cache pipeline with injectable
  deps, feature-flag gate, opt-in gate, version floor (numeric compare),
  and sanitized error reasons (no stack traces)
- 40 tests covering: contract hash, key handling, sig verification,
  schema validation, version compare, all sync paths (disabled, opt_out,
  invalid_signature, invalid_schema, stale, updated, error), auth header
  injection, and cache-untouched assertions for every failure mode

* feat(radar): read-time overlay merge rules over the free catalog

Pure function applyFeed() merges the cached Radar feed over the static
baseline catalog at read time, honoring 4 rules:

1. Feed never overwrites a local override field.
2. enabled:false disables the entry with disabledBy:"radar" provenance.
3. User-added entry NOT in the feed survives untouched.
4. User deletion tombstone prevents feed resurrection.

getRadarCatalog() accessor in index.ts: flag off / no cache / corrupt
payload all fall back to baseline. Valid cache applies the overlay and
returns feed metadata (version, tier, fetchedAt).

TDD: 19 tests (4 rules + dedup + origin + accessor flag/cache/corrupt/
valid/bad-feed + baselineToMergedEntries converter).

* feat(dashboard): radar catalog and guided setup screens

- API routes: GET /api/radar/catalog, POST /api/radar/sync, POST /api/radar/settings
  - All gated on RADAR_ENABLED flag (404 when off)
  - Error responses via buildErrorBody(), never raw stack/message
  - Settings never echoes clear supporter key (masked omr_****<last4>)
  - Sync delegates to syncRadar() server-side, never proxies feed URL
- Dashboard pages:
  - /dashboard/radar: 4 states (flag off, opt-in pending, empty, populated)
  - /dashboard/radar/setup?provider=X: guided setup with steps, key URL, test connection
  - Uses existing Card component and next-intl patterns
- Sidebar: radar entry in costs group with icon
- i18n: pt-BR and en keys for radarPage and radarSetupPage namespaces
- Tests:
  - radar-api-routes.test.ts: 11 tests (flag-off 404, flag-on shape, error sanitization)
  - radar-page-state.test.ts: 5 tests (pure state logic)
  - All 90 radar tests pass (including prior 74)

* docs(radar): module doc and flag-off inertia test

Add docs/frameworks/RADAR.md covering the flag gate, the separate data-sync
opt-in and privacy promise, the Ed25519 signature/pinned-key security model,
tiers, the read-time overlay merge rules, and the self-hosting env vars —
plus index entries in CLAUDE.md/AGENTS.md/docs/README.md/REPOSITORY_MAP.md.

Document RADAR_FEED_URL and RADAR_FEED_PUBKEY in .env.example and
docs/reference/ENVIRONMENT.md to satisfy check:env-doc-sync, which was
failing on this branch since the sync.ts commit added the reads.

Add tests/unit/radar-inertia.test.ts as the single canonical place asserting
the "RADAR_ENABLED off => zero behavioral delta" claim end to end: the three
/api/radar/* routes 404, the flag resolves to the definition default with no
override, getRadarCatalog() returns exactly the baseline without touching the
cache, and computeFreeModelTotals() keeps its pinned values with the Radar
module imported alongside it.

* fix(db): renumber radar migration to 135 after collision with 134

The base branch introduced 134_proxy_logs_egress_ip while this branch carried
134_radar_cache_settings; the migration runner rejects duplicate numeric prefixes.
This migration has never been applied to a real database (the PR is unmerged), so
no retroactive isSchemaAlreadyApplied guard is needed.

* i18n(radar): translate radar catalog and setup strings to all locales

The UI-coverage ratchet measures (present - placeholder) / total_en, so the
__MISSING__ sentinels that i18n:sync-ui writes do not count as covered — only
real translations restore the metric. Scoped to this PR's namespaces
(radarPage, radarSetupPage, sidebar.radar*) instead of a bulk sync, which would
have pulled ~978 unrelated pending keys into this diff.

Placeholders and code identifiers verified preserved across all 1682 strings.

* fix(radar): trust the served-tier header instead of the signed body field

The signed feed body always carries tier:"live" by design (one signed
artifact per version — rewriting the field server-side per request
would break the exact-bytes Ed25519 signature). The server now returns
the tier ACTUALLY served via the x-omniroute-feed-tier response
header, so free users on a delayed community snapshot no longer see
"Ao vivo (tempo real)" in the UI.

sync.ts now reads and validates that header (falling back to the
body's tier only when the header is absent or holds an unrecognized
value) and stores the served tier in the cache; index.ts already
surfaces cache.tier to the UI unchanged.

* test(combo): shorten an assert message that exceeded the line limit

The assertion added by #9507 was 104 chars, so prettier reformatted it into
five lines on the next commit that touched the file, pushing it past its
frozen size (3449) and failing check:file-size. The message is shortened
(the issue reference stays in the comment directly above); the assertion
itself is unchanged, and the file is back to 3448 lines and prettier-clean.

* i18n(radar): use the canonical zh-TW glossary terms

The machine translation produced retired renderings the glossary gate blocks:
供應商 for provider (canonical 提供者) and 文檔 for documentation (canonical 文件).
Fixed across the 11 affected radar strings; tests/unit/i18n-glossary-consistency-check.test.ts
is back to 17/17.

* fix(radar): point the default feed URL at the domain that exists

radar.omniroute.dev was a placeholder for a domain that was never registered,
so an out-of-the-box sync would fail DNS resolution for every user. The live
feed is served from radar.omniroute.online (the subdomain the design always
specified), now behind Cloudflare TLS. Forks still override it via
RADAR_FEED_URL.

---------

Co-authored-by: diegosouzapw <diegosouzapw@users.noreply.github.com>
2026-08-06 05:58:58 -03:00

170 lines
6.1 KiB
TypeScript

/**
* Regression test for issue #8656 follow-up: model mappings saved via the UI
* are invisible to the MITM proxy because the proxy reads from key_value
* (namespace='mitmAlias') while the UI writes to agent_bridge_mappings.
*
* This test verifies that syncAgentBridgeMappingsToMitmAlias() properly copies
* mappings from agent_bridge_mappings to key_value for agents that have a
* registered alias key in standaloneRouting.cjs::AGENT_ROUTE_CONFIG.
*/
import test from "node:test";
import assert from "node:assert/strict";
import fs from "fs";
import os from "os";
import path from "path";
const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-8656-sync-"));
process.env.DATA_DIR = TEST_DATA_DIR;
process.env.DISABLE_SQLITE_AUTO_BACKUP = "true";
// Import db core first to allow reset
const core = await import("../../src/lib/db/core.ts");
// Import getMitmAlias to verify key_value entries
const { getMitmAlias } = await import("../../src/lib/db/models/mitmAlias.ts");
function resetDb() {
core.resetDbInstance();
fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true });
fs.mkdirSync(TEST_DATA_DIR, { recursive: true });
}
test.beforeEach(() => {
resetDb();
});
test.after(() => {
try {
fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true });
} catch {
/* noop */
}
});
// ── Sync Tests ─────────────────────────────────────────────────────────────
test("syncAgentBridgeMappingsToMitmAlias: copies antigravity mappings to key_value", async () => {
// Dynamic import after DB reset
const { setMappings, syncAgentBridgeMappingsToMitmAlias } = await import(
"../../src/lib/db/agentBridgeMappings.ts?t=" + Date.now()
);
// Arrange: save mappings for antigravity
setMappings("antigravity", [
{ source: "gpt-oss-120b-medium", target: "openai/gpt-4o" },
{ source: "gemini-2.0-flash", target: "anthropic/claude-sonnet-4" },
]);
// Act: sync to mitmAlias
syncAgentBridgeMappingsToMitmAlias("antigravity");
// Get a fresh import of getMitmAlias to read the key_value table
const { getMitmAlias: getAlias } = await import(
"../../src/lib/db/models/mitmAlias.ts?t=" + Date.now()
);
// Assert: key_value has the mappings
const alias = await getAlias("antigravity");
assert.ok(alias, "mitmAlias for antigravity should exist");
assert.equal(
alias["gpt-oss-120b-medium"],
"openai/gpt-4o",
"gpt-oss-120b-medium should map to openai/gpt-4o"
);
assert.equal(
alias["gemini-2.0-flash"],
"anthropic/claude-sonnet-4",
"gemini-2.0-flash should map to anthropic/claude-sonnet-4"
);
});
test("syncAgentBridgeMappingsToMitmAlias: skips agents not in MITM_ALIAS_AGENTS", async () => {
const { setMappings, syncAgentBridgeMappingsToMitmAlias } = await import(
"../../src/lib/db/agentBridgeMappings.ts?t=" + Date.now()
);
// Arrange: save mappings for cursor (not in MITM_ALIAS_AGENTS)
setMappings("cursor", [{ source: "gpt-4o", target: "openai/gpt-4o" }]);
// Act: sync should skip cursor (no-op)
syncAgentBridgeMappingsToMitmAlias("cursor");
// Assert: key_value should have no mitmAlias entry for cursor
const { getMitmAlias: getAlias } = await import(
"../../src/lib/db/models/mitmAlias.ts?t=" + Date.now()
);
const alias = await getAlias();
assert.equal(alias["cursor"], undefined, "cursor should not have a mitmAlias entry");
});
test("syncAgentBridgeMappingsToMitmAlias: replaces existing mitmAlias entry", async () => {
const { setMappings, syncAgentBridgeMappingsToMitmAlias } = await import(
"../../src/lib/db/agentBridgeMappings.ts?t=" + Date.now()
);
// Arrange: save initial mappings and sync
setMappings("antigravity", [{ source: "gpt-oss-120b-medium", target: "openai/gpt-4o" }]);
syncAgentBridgeMappingsToMitmAlias("antigravity");
// Act: save different mappings and sync again
setMappings("antigravity", [
{ source: "gpt-oss-120b-medium", target: "anthropic/claude-opus-4" },
]);
syncAgentBridgeMappingsToMitmAlias("antigravity");
// Assert: key_value should have the updated mapping
const { getMitmAlias: getAlias } = await import(
"../../src/lib/db/models/mitmAlias.ts?t=" + Date.now()
);
const alias = await getAlias("antigravity");
assert.equal(
alias["gpt-oss-120b-medium"],
"anthropic/claude-opus-4",
"should have updated mapping after re-sync"
);
});
test("syncAgentBridgeMappingsToMitmAlias: empty mappings clear key_value entry", async () => {
const { setMappings, syncAgentBridgeMappingsToMitmAlias } = await import(
"../../src/lib/db/agentBridgeMappings.ts?t=" + Date.now()
);
// Arrange: save some mappings first
setMappings("antigravity", [{ source: "gpt-oss-120b-medium", target: "openai/gpt-4o" }]);
syncAgentBridgeMappingsToMitmAlias("antigravity");
// Act: clear mappings and sync
setMappings("antigravity", []);
syncAgentBridgeMappingsToMitmAlias("antigravity");
// Assert: key_value entry should be an empty object
const { getMitmAlias: getAlias } = await import(
"../../src/lib/db/models/mitmAlias.ts?t=" + Date.now()
);
const alias = await getAlias("antigravity");
assert.ok(alias, "antigravity mitmAlias entry should still exist (empty object)");
assert.equal(Object.keys(alias).length, 0, "antigravity mitmAlias should have no mappings");
});
test("syncAgentBridgeMappingsToMitmAlias: works for claude-code agent", async () => {
const { setMappings, syncAgentBridgeMappingsToMitmAlias } = await import(
"../../src/lib/db/agentBridgeMappings.ts?t=" + Date.now()
);
// Arrange: save and sync for claude-code
setMappings("claude-code", [{ source: "claude-sonnet-4", target: "openai/gpt-4o" }]);
syncAgentBridgeMappingsToMitmAlias("claude-code");
// Assert
const { getMitmAlias: getAlias } = await import(
"../../src/lib/db/models/mitmAlias.ts?t=" + Date.now()
);
const alias = await getAlias("claude-code");
assert.ok(alias, "mitmAlias for claude-code should exist");
assert.equal(
alias["claude-sonnet-4"],
"openai/gpt-4o",
"claude-sonnet-4 should map to openai/gpt-4o"
);
});