rea/experiments/atomic-codemode/reference.test.mjs

import test from "node:test";
import assert from "node:assert/strict";
import Ajv2020 from "ajv/dist/2020.js";
import { methods, reference } from "./api.mjs";
import { createReference } from "./reference.mjs";

test("reference index discovers named methods without constructing unrequested schemas", () => {
  const registry = {
    sample: {
      summary:
        "Discover a declared capability; inspect its full contract before use.",
      description: "Declared capability; live coverage is unknown.",
      get input() {
        throw new Error("Schema was not requested");
      },
    },
  };
  const lookup = createReference(registry);
  const index = lookup("", {
    names: { sample: "facts_sample" },
    view: "index",
  });
  assert.deepEqual(index.methods, [
    {
      method: "sample",
      name: "facts_sample",
      description: registry.sample.summary,
    },
  ]);
  assert.equal(index.coverage.view, "index");
  assert.equal(index.coverage.declared_methods, 1);
  assert.throws(() => lookup("sample"), /Schema was not requested/);
  assert.throws(
    () => lookup("", { view: "unknown" }),
    /Unknown reference view/,
  );
  const all = reference("", { view: "index" });
  assert.equal(all.methods.length, 15);
  assert.ok(
    all.methods.some(
      (m) => m.method === "relations" && m.description.includes("operands"),
    ),
  );
  assert.ok(
    all.methods.every(
      (m) =>
        m.description === methods[m.method].summary &&
        typeof m.description === "string" &&
        m.description.length > 0 &&
        !Object.hasOwn(m, "input_schema") &&
        !Object.hasOwn(m, "returns"),
    ),
  );
  assert.ok(
    Buffer.byteLength(JSON.stringify(all)) <
      Buffer.byteLength(JSON.stringify(reference())),
  );
  assert.ok(all.notes.some((note) => note.includes("not full contracts")));
});

test("named reference lists preserve caller order and exact schemas across presentations", () => {
  const names = Object.fromEntries(
    Object.keys(methods).map((name) => [name, `facts_${name}`]),
  );
  const result = reference(
    "facts_values, facts_snapshot facts_values unknown",
    { names, includeExamples: false },
  );
  assert.deepEqual(
    result.methods.map((m) => m.method),
    ["values", "snapshot"],
  );
  assert.deepEqual(
    result.methods.map((m) => m.name),
    ["facts_values", "facts_snapshot"],
  );
  assert.deepEqual(result.unmatched_queries, ["unknown"]);
  assert.equal(result.coverage.declared_methods, 15);
  assert.equal(result.coverage.matched_methods, 2);
  assert.equal(result.coverage.selection, "named");
  const javascript = reference("rea.values snapshot");
  assert.deepEqual(
    javascript.methods.map((m) => m.method),
    ["values", "snapshot"],
  );
  assert.deepEqual(
    result.methods.map((m) => m.input_schema),
    javascript.methods.map((m) => m.input_schema),
  );
  const validate = new Ajv2020({ strict: false }).compile(
    result.methods[1].input_schema,
  );
  assert.equal(validate({ entry: "0xea6d0" }), true);
  assert.equal(validate({ snapshot: "wrong contract" }), false);
  const validateValues = new Ajv2020({ strict: false }).compile(
    result.methods[0].input_schema,
  );
  assert.equal(validateValues({ snapshot: "snap_example", ids: ["v1"] }), true);
  assert.equal(
    methods.values.input.parse({ snapshot: "snap_example" }).limit,
    20,
  );
  assert.equal(Object.hasOwn(result.methods[0], "example"), false);
});

test("topic/all reference selection and shared schema ownership remain explicit", () => {
  assert.equal(reference().methods.length, 15);
  assert.equal(reference("no-such-topic").coverage.matched_methods, 0);
  assert.ok(
    reference("memory aliases").methods.some((m) => m.method === "slice"),
  );
  assert.deepEqual(
    reference("memory aliases", { view: "index" }).methods.map((m) => m.method),
    reference("memory aliases").methods.map((m) => m.method),
  );
  for (const entry of reference().methods) {
    assert.equal(entry.description, methods[entry.method].description);
    assert.equal(methods[entry.method].method, entry.method);
  }
  const before = reference("snapshot").methods[0];
  assert.throws(() => {
    before.input_schema.properties.entry.type = "number";
  }, TypeError);
  const after = reference("snapshot").methods[0];
  assert.equal(after.input_schema.properties.entry.type, "string");
  assert.throws(
    () => reference("values", { names: { snapshot: "values" } }),
    /Ambiguous/,
  );
  assert.throws(
    () => reference("values", { names: { unknown: "facts_values" } }),
    /Unknown/,
  );
});