Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
import fs from "node:fs";
import path from "node:path";
import { fileURLToPath } from "node:url";
import { describe, expect, it } from "vitest";
import { agentDocs } from "./agent-kb";
import { headingAnchor, splitByCodeFence, splitFrontmatter } from "./corpus";
import { terms } from "./glossary";
import { DOCS_URL } from "./links";
const sources = import.meta.glob(["../docs/**/*.mdx", "../guides/**/*.mdx"], {
query: "?raw",
import: "default",
eager: true
}) as Record<string, string>;
const mdxFiles = Object.entries(sources).map(([file, raw]) => ({
file: file.replace(/^\.\.\//, ""),
raw
}));
const REPO_ROOT = fileURLToPath(new URL("../../..", import.meta.url));
/** Route (`/docs/reference/jobs`) → heading anchors on that page. */
const pages = new Map<string, Set<string>>();
for (const { file, raw } of mdxFiles) {
const route = `/${file}`.replace(/\.mdx$/, "").replace(/\/index$/, "");
const { body } = splitFrontmatter(raw);
// github-slugger suffixes a repeated heading's anchor: "fields", "fields-1", …
const seen = new Map<string, number>();
const anchors = new Set(
splitByCodeFence(body)
.filter((seg) => !seg.code)
.flatMap((seg) => seg.text.split("\n"))
.filter((l) => /^#{1,6}\s/.test(l))
.map((l) => {
const base = headingAnchor(l.replace(/^#{1,6}\s+/, ""));
const count = seen.get(base) ?? 0;
seen.set(base, count + 1);
return count ? `${base}-${count}` : base;
})
);
pages.set(route, anchors);
}
// App routes the docs site renders without an MDX page of their own.
pages.set("/guides", new Set());
function brokenReason(link: string): string | null {
const [route = "", anchor] = link.split("#");
const anchors = pages.get(route.replace(/\/$/, ""));
if (!anchors) return "no such page";
if (anchor && !anchors.has(anchor)) return `no heading #${anchor}`;
return null;
}
function walkSource(dir: string, out: string[] = []): string[] {
if (!fs.existsSync(dir)) return out;
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
if (entry.name === "node_modules") continue;
const p = path.join(dir, entry.name);
if (entry.isDirectory()) walkSource(p, out);
// Test files may hold deliberately stale URLs; only shipped links count.
else if (/\.tsx?$/.test(entry.name) && !/\.test\.tsx?$/.test(entry.name))
out.push(p);
}
return out;
}
describe("doc links resolve to a real page and heading", () => {
it("found the docs content", () => {
expect(pages.size).toBeGreaterThan(50);
});
it("glossary hrefs", () => {
const broken = Object.entries(terms).flatMap(([id, entry]) => {
const href = (entry as { href?: string }).href;
const reason = href && brokenReason(href);
return reason ? [`${id}: ${href} (${reason})`] : [];
});
expect(broken).toEqual([]);
});
it(`hardcoded ${DOCS_URL} links in apps/ and packages/`, () => {
const roots = ["apps", "packages"].flatMap((top) =>
fs
.readdirSync(path.join(REPO_ROOT, top))
.flatMap((name) => [
path.join(REPO_ROOT, top, name, "app"),
path.join(REPO_ROOT, top, name, "src")
])
);
const pattern =
/https:\/\/docs\.carbon\.ms(\/(?:docs|guides)[^\s"'`)\]]*)/g;
const links = roots
.flatMap((dir) => walkSource(dir))
.flatMap((file) =>
[...fs.readFileSync(file, "utf8").matchAll(pattern)].map((m) => ({
file: path.relative(REPO_ROOT, file),
link: m[1]!
}))
);
expect(links.length).toBeGreaterThan(10);
const broken = links.flatMap(({ file, link }) => {
const reason = brokenReason(link);
return reason ? [`${file}: ${link} (${reason})`] : [];
});
expect(broken).toEqual([]);
});
it("every section the agent links to is a real heading", () => {
const broken = agentDocs.flatMap((doc) =>
doc.sections.flatMap(({ anchor }) => {
if (!anchor) return [];
const link = `/${doc.slug.replace(/(^|\/)index$/, "")}#${anchor}`;
const reason = brokenReason(link);
return reason ? [`${link} (${reason})`] : [];
})
);
expect(agentDocs.some((doc) => doc.sections.length > 3)).toBe(true);
expect(broken).toEqual([]);
});
it("internal links inside the MDX", () => {
const pattern = /\]\((\/(?:docs|guides)[^)\s]*)\)/g;
const broken = mdxFiles.flatMap(({ file, raw }) =>
splitByCodeFence(raw)
.filter((seg) => !seg.code)
.flatMap((seg) => [...seg.text.matchAll(pattern)])
.flatMap((m) => {
const reason = brokenReason(m[1]!);
return reason ? [`${file}: ${m[1]} (${reason})`] : [];
})
);
expect(broken).toEqual([]);
});
});