logicsrc/apps/logicsrc-web/contract/spec-discovery.contract.test.ts

import { describe, expect, it, vi } from "vitest";
import { familyOfSpec } from "../src/lib/specs";
import { listDocs, readDoc } from "../src/lib/docs";
import { GET as llms } from "../src/app/llms.txt/route";
import { GET as llmsFull } from "../src/app/llms-full.txt/route";
import sitemap from "../src/app/sitemap";

// Spec discovery must work even when the optional blog database is offline.
vi.mock("../src/lib/supabase", () => ({ publicClient: () => { throw new Error("offline"); } }));

describe.each([
  { slug: "openagent", name: "OpenAgent", family: "people" },
  { slug: "openskill", name: "OpenSkill", family: "people" },
  { slug: "openabtest", name: "OpenABTest", family: "process" },
  { slug: "openfleet", name: "OpenFleet", family: "process" },
  { slug: "openrental", name: "OpenRental", family: "catalogs" },
  { slug: "openwall", name: "OpenWall", family: "people" }
])("$name public discovery", ({ slug, name, family }) => {
  it("serves the specification through its family and docs index", () => {
    expect(familyOfSpec(slug)?.slug).toBe(family);
    expect(listDocs()).toContainEqual(expect.objectContaining({ slug, title: name }));
    expect(readDoc(slug)).toMatch(/Status: \*{0,2}0\.1/);
  });

  it("includes a reachable docs URL and the full contract in the LLM feeds", async () => {
    // A spec with a landing page is linked there and cites its docs URL after
    // it; a docs-only spec is linked straight to /docs/<slug>. Both must name
    // the docs URL somewhere on the line.
    const text = await llms().text();
    expect(text).toMatch(new RegExp(`\\[${name}\\]\\(https://[^)]+/(docs/)?${slug}\\)`));
    expect(text).toContain(`/docs/${slug}`);
    expect(await llmsFull().text()).toContain(readDoc(slug)!.trim());
  });

  it("includes the docs route in the sitemap without a blog connection", async () => {
    const entries = await sitemap();
    expect(entries.some((entry) => new URL(entry.url).pathname === `/docs/${slug}`)).toBe(true);
  });
});