OmniRoute/tests/unit/executor-registry.test.ts

import test from "node:test";
import assert from "node:assert/strict";
import fs from "node:fs";
import os from "node:os";
import path from "node:path";

// R0.3 — unit tests for the ExecutorRegistry seam itself (registration
// semantics + wiring of the built-ins). Behavior parity of the full map is
// covered separately by tests/unit/executor-map-golden.test.ts.

const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-executor-registry-"));
process.env.DATA_DIR = TEST_DATA_DIR;

const { registerExecutor, getRegisteredExecutor, hasRegisteredExecutor, listExecutorAliases } =
  await import("../../open-sse/executors/registry.ts");
const { getExecutor, hasSpecializedExecutor, BaseExecutor, DefaultExecutor } =
  await import("../../open-sse/executors/index.ts");
const { getDefaultExecutor } = await import("../../open-sse/executors/defaultResolver.ts");

test.after(() => {
  fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
});

test("built-ins are registered at module load and resolve through the registry", async () => {
  const aliases = listExecutorAliases();
  assert.ok(aliases.length >= 100, `expected the built-in table, got ${aliases.length} aliases`);
  for (const alias of ["antigravity", "kiro", "glm", "9router", "conol-web"]) {
    assert.ok(hasRegisteredExecutor(alias), `missing built-in: ${alias}`);
    assert.equal(await getExecutor(alias), getRegisteredExecutor(alias));
    assert.ok((await getExecutor(alias)) instanceof BaseExecutor);
  }
});

test("registerExecutor throws on duplicate alias", () => {
  assert.throws(() => registerExecutor("kiro", getRegisteredExecutor("kiro")!), {
    message: /already registered: "kiro"/,
  });
});

test("registering a new alias makes it resolvable via getExecutor and hasSpecializedExecutor", async () => {
  const alias = "registry-test-provider";
  assert.equal(hasSpecializedExecutor(alias), false);
  const instance = new DefaultExecutor(alias);
  registerExecutor(alias, instance);
  assert.equal(hasSpecializedExecutor(alias), true);
  assert.equal(await getExecutor(alias), instance);
});

test("registry lookup is exact — Object.prototype names are not executors", async () => {
  // The old object-literal lookup (`executors[provider]`) leaked prototype
  // members: getExecutor("constructor") returned Object's constructor. The Map
  // registry must treat these as unknown providers (DefaultExecutor fallback).
  for (const name of ["constructor", "toString", "hasOwnProperty", "__proto__"]) {
    assert.equal(hasSpecializedExecutor(name), false, name);
    assert.ok((await getExecutor(name)) instanceof DefaultExecutor, name);
  }
});

test("the registry and leaf resolver share fallback executor instances", async () => {
  const provider = "default-resolver-test-provider";
  assert.equal(await getExecutor(provider), getDefaultExecutor(provider));
  assert.equal(getDefaultExecutor(provider), getDefaultExecutor(provider));
});