mirror of
https://github.com/profullstack/logicsrc.git
synced 2026-10-01 20:33:50 +00:00
Anthony Ettinger
8e4ea2f997
A new LogicSRC spec in the catalogs family. One heading, an identity block (Kind, Web, Repo, Operator, License, Extends, Updated), one line, then eleven layers: Languages, Runtimes, Interfaces (one ### per way in: web, api, cli, tui, mcp, desktop, mobile, worker, extension, bot), Data, Services, Modules, Tooling, Hosting, Auth, Conventions, Not. An item is one bullet: name, version, an optional status word (trial, hold, leaving) and a role. Extends inherits a parent file, sections replace, Conventions and Not accumulate. Rule 8 is the reading rule for agents: use what is listed, prefer listed over new, ask before adding a layer or a service, never add a Not, keep the file true. Discovery at OpenStack.md in the repo, /.well-known/openstack.md, rel=openstack, or a platform path. JSON is derived and never the source. logicsrc.com serves its own at /.well-known/openstack.md: the route extracts the worked example from docs/openstack.md, and a contract test holds the two together and checks the file follows its own rules. rel=openstack in <head> and in the Link header beside openprofile. Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
40 lines
2 KiB
TypeScript
40 lines
2 KiB
TypeScript
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" },
|
|
{ slug: "openstack", name: "OpenStack.md", family: "catalogs" }
|
|
])("$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);
|
|
});
|
|
});
|