@rsaglobaltech/specgate 0.8.1

package/dist/scripts/docs/build-site.js

@@ -0,0 +1,425 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Render `docs/**.md` into a documentation site.
+ *
+ * ## Why this exists
+ *
+ * The site published twenty markdown documents as `text/markdown`, so a reader
+ * who followed a link got the source — comment markers, front-matter, the lot.
+ * The landing page linked to four of them. The other sixteen existed and were
+ * unreachable.
+ *
+ * ## Why it renders at build time
+ *
+ * A page that needs JavaScript to show its own text is a page that is slower,
+ * unindexable and broken behind a corporate proxy that strips scripts. These
+ * are plain HTML documents; the JavaScript that ships alongside adds search,
+ * copy buttons and a theme toggle, and the site reads fine without it.
+ *
+ * `marked` is a devDependency, so none of this reaches the published package —
+ * `package.json` still has zero runtime dependencies, which is what lets the
+ * CLI run through `npx` on someone else's machine.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSite = buildSite;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const marked_1 = require("marked");
+const nav_1 = require("./nav");
+const blocks_1 = require("./blocks");
+const ROOT = path.resolve(__dirname, "..", "..", "..");
+/** Absolute base for metadata a link scraper resolves without a page context. */
+const SITE = "https://rsaglobaltech.github.io/specgate";
+const DOCS = path.join(ROOT, "docs");
+const REPO = "https://github.com/rsaglobaltech/specgate";
+/** Assets copied through untouched. */
+// `roi.html` used to be here. A calculator that estimates a saving is a sales
+// artefact, not documentation, and it was the only page on the site written in
+// a different voice.
+const VERBATIM = ["index.html", "assets"];
+// ── Markdown → HTML ──────────────────────────────────────────────────────────
+/** `The harness` → `the-harness`. Stable, because anchors end up in links. */
+function slugifyHeading(text, taken) {
+    const base = text
+        .toLowerCase()
+        .replace(/`/g, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "section";
+    let id = base;
+    let n = 2;
+    while (taken.has(id))
+        id = `${base}-${n++}`;
+    taken.add(id);
+    return id;
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/**
+ * Rewrite a link the way the site serves it.
+ *
+ * `./harness.md` becomes `harness.html`, because that is what is published.
+ * Leaving them pointing at `.md` was half of why the old site was unreadable:
+ * every internal link dropped the reader back into raw source.
+ */
+function rewriteLink(href, slug) {
+    if (/^[a-z]+:/i.test(href) || href.startsWith("#") || href.startsWith("//"))
+        return href;
+    const [target, hash] = href.split("#");
+    if (!target)
+        return href;
+    // A link that climbs out of `docs/` points at a repository file — README,
+    // CONTRIBUTING, a pack's yaml — which is not published here. Sending it to
+    // GitHub is the honest destination; rewriting `../SECURITY.md` to
+    // `../SECURITY.html` invented a page that has never existed.
+    const depth = slug.split("/").length - 1;
+    const resolved = path.posix.normalize(path.posix.join(path.posix.dirname(slug), target));
+    if (resolved.startsWith("..")) {
+        const inRepo = path.posix.normalize(path.posix.join("docs", path.posix.dirname(slug), target));
+        return `${REPO}/blob/main/${inRepo}${hash ? `#${hash}` : ""}`;
+    }
+    void depth;
+    if (!target.endsWith(".md"))
+        return href;
+    const html = `${target.slice(0, -3)}.html`;
+    return hash ? `${html}#${hash}` : html;
+}
+/**
+ * A heading's plain text, for the anchor id and the contents list.
+ *
+ * Repeated until it stops changing: one pass of `/<[^>]+>/g` leaves a nested or
+ * malformed tag behind — `<<b>i>` becomes `<i>` — which CodeQL reports as
+ * `js/incomplete-multi-character-sanitization`. Nothing here reaches a browser
+ * as markup, but a half-stripped heading would still produce a wrong anchor.
+ */
+function stripTags(html) {
+    let out = String(html);
+    let previous;
+    do {
+        previous = out;
+        out = out.replace(/<[^>]*>/g, "");
+    } while (out !== previous);
+    return out.trim();
+}
+function renderMarkdown(source, currentSlug) {
+    const headings = [];
+    const taken = new Set();
+    let title = "";
+    const renderer = new marked_1.marked.Renderer();
+    renderer.heading = ({ tokens, depth }) => {
+        const text = renderer.parser.parseInline(tokens);
+        const plain = stripTags(text);
+        if (depth === 1 && !title)
+            title = plain;
+        const id = slugifyHeading(plain, taken);
+        if (depth >= 2 && depth <= 3)
+            headings.push({ id, text: plain, level: depth });
+        return (`<h${depth} id="${id}">${text}` +
+            `<a class="anchor" href="#${id}" aria-label="Link to this section">#</a></h${depth}>\n`);
+    };
+    renderer.link = ({ href, title: linkTitle, tokens }) => {
+        const text = renderer.parser.parseInline(tokens);
+        const target = rewriteLink(String(href || ""), currentSlug);
+        const external = /^https?:/i.test(target);
+        const attrs = [
+            `href="${escapeHtml(target)}"`,
+            linkTitle ? `title="${escapeHtml(linkTitle)}"` : "",
+            external ? 'target="_blank" rel="noreferrer"' : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+        return `<a ${attrs}>${text}</a>`;
+    };
+    renderer.code = ({ text, lang }) => {
+        const language = String(lang || "").split(/\s+/)[0] || "text";
+        return (`<figure class="code" data-lang="${escapeHtml(language)}">` +
+            `<button class="code__copy" type="button" aria-label="Copy to clipboard">Copy</button>` +
+            `<pre><code class="language-${escapeHtml(language)}">${escapeHtml(text)}</code></pre>` +
+            `</figure>\n`);
+    };
+    renderer.table = ({ header, rows }) => {
+        const head = header
+            .map((cell) => `<th>${renderer.parser.parseInline(cell.tokens)}</th>`)
+            .join("");
+        const body = rows
+            .map((row) => `<tr>${row
+            .map((cell) => `<td>${renderer.parser.parseInline(cell.tokens)}</td>`)
+            .join("")}</tr>`)
+            .join("");
+        return `<div class="table-wrap"><table><thead><tr>${head}</tr></thead><tbody>${body}</tbody></table></div>\n`;
+    };
+    const html = marked_1.marked.parse(source, { renderer, gfm: true, breaks: false });
+    return { html, headings, title };
+}
+// ── The page shell ───────────────────────────────────────────────────────────
+/**
+ * The sidebar, from a page that may be nested.
+ *
+ * `up` is not decoration: a page at `case-studies/case-1.html` linking to a
+ * bare `getting-started.html` asks for `case-studies/getting-started.html`,
+ * which does not exist. Every link out of a nested page needs the climb.
+ */
+function sidebar(currentSlug, up) {
+    const sections = nav_1.NAV.map((section) => {
+        const items = section.entries
+            .map((entry) => {
+            const active = entry.slug === currentSlug ? ' class="is-active" aria-current="page"' : "";
+            return `<li><a href="${up}${entry.slug}.html"${active}>${escapeHtml(entry.label)}</a></li>`;
+        })
+            .join("");
+        return `<div class="side__group"><h2>${escapeHtml(section.title)}</h2><ul>${items}</ul></div>`;
+    }).join("");
+    return sections;
+}
+function onThisPage(headings) {
+    if (headings.length < 2)
+        return "";
+    const items = headings
+        .map((h) => `<li class="toc__l${h.level}"><a href="#${h.id}">${escapeHtml(h.text)}</a></li>`)
+        .join("");
+    return `<nav class="toc" aria-label="On this page"><h2>On this page</h2><ul>${items}</ul></nav>`;
+}
+function pageShell(page, version) {
+    const entry = (0, nav_1.navEntry)(page.slug);
+    const { prev, next } = (0, nav_1.neighbours)(page.slug);
+    const depth = page.slug.split("/").length - 1;
+    const up = "../".repeat(depth);
+    const link = (slug) => `${up}${slug}.html`;
+    const pager = [
+        prev
+            ? `<a class="pager__prev" href="${link(prev.slug)}"><span>Previous</span>${escapeHtml(prev.label)}</a>`
+            : "<span></span>",
+        next
+            ? `<a class="pager__next" href="${link(next.slug)}"><span>Next</span>${escapeHtml(next.label)}</a>`
+            : "<span></span>",
+    ].join("");
+    return `<!doctype html>
+<html lang="en" data-slug="${escapeHtml(page.slug)}">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(page.title)} — create-spec-driven-app</title>
+<meta name="description" content="${escapeHtml(entry?.blurb || page.title)}">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;700&family=IBM+Plex+Mono:wght@400;600&display=swap" rel="stylesheet">
+<link rel="icon" href="${up}assets/favicon.svg" type="image/svg+xml">
+<meta property="og:title" content="${escapeHtml(page.title)} — create-spec-driven-app">
+<meta property="og:description" content="${escapeHtml(entry?.blurb || page.title)}">
+<meta property="og:image" content="${SITE}/assets/og-card.png">
+<meta name="twitter:card" content="summary_large_image">
+<link rel="stylesheet" href="${up}assets/docs.css">
+<script>
+  // Applied before paint so the page never flashes the wrong theme.
+  (function () {
+    var t = localStorage.getItem("csda-theme");
+    if (t) document.documentElement.setAttribute("data-theme", t);
+  })();
+</script>
+</head>
+<body>
+<a class="skip" href="#content">Skip to content</a>
+
+<header class="top">
+  <button class="top__menu" type="button" aria-label="Open navigation" aria-expanded="false">☰</button>
+  <a class="top__brand" href="${up}index.html"><span aria-hidden="true">⬡</span> create-spec-driven-app</a>
+  <span class="top__version">v${escapeHtml(version)}</span>
+  <div class="top__search">
+    <input type="search" id="search" placeholder="Search the docs…" autocomplete="off"
+           aria-label="Search documentation">
+    <div class="top__results" id="results" hidden></div>
+  </div>
+  <nav class="top__links">
+    <a href="${up}packs/">Packs</a>
+    <a href="${REPO}" target="_blank" rel="noreferrer">GitHub</a>
+    <a href="https://www.npmjs.com/package/create-spec-driven-app" target="_blank" rel="noreferrer">npm</a>
+  </nav>
+  <button class="top__theme" type="button" aria-label="Switch theme">◐</button>
+</header>
+
+<div class="shell">
+  <aside class="side" id="side">${sidebar(page.slug, up)}</aside>
+
+  <main class="content" id="content">
+    <article class="prose">
+${page.html}
+    </article>
+    <nav class="pager" aria-label="Neighbouring pages">${pager}</nav>
+    <footer class="page-foot">
+      <a href="${REPO}/edit/main/docs/${escapeHtml(page.slug)}.md" target="_blank" rel="noreferrer">Edit this page</a>
+      <span>·</span>
+      <a href="${REPO}/issues/new" target="_blank" rel="noreferrer">Something wrong? Open an issue</a>
+    </footer>
+  </main>
+
+  ${onThisPage(page.headings)}
+</div>
+
+<script src="${up}assets/docs.js" defer></script>
+</body>
+</html>
+`;
+}
+// ── Walking the source ───────────────────────────────────────────────────────
+function markdownFiles(dir, prefix = "") {
+    const out = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name.startsWith("."))
+            continue;
+        const full = path.join(dir, entry.name);
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            out.push(...markdownFiles(full, rel));
+        }
+        else if (entry.name.endsWith(".md")) {
+            out.push(rel.slice(0, -3));
+        }
+    }
+    return out.sort();
+}
+/**
+ * The hand-written parts of the site, copied across.
+ *
+ * `index.html` gets one transformation on the way: its `csda:diagram` markers
+ * are resolved, the same way a markdown page's are. The diagram is a source
+ * file in the repository and the marker is one line, so there is nothing to go
+ * stale between them — unlike the terminal recording, which needs the CLI to
+ * regenerate and is therefore committed into the file rather than injected here.
+ */
+function copyVerbatim(outDir, available) {
+    for (const name of VERBATIM) {
+        const from = path.join(DOCS, name);
+        if (!fs.existsSync(from))
+            continue;
+        if (name === "index.html") {
+            fs.writeFileSync(path.join(outDir, name), (0, blocks_1.inlineDiagrams)(fs.readFileSync(from, "utf8"), available), "utf8");
+            continue;
+        }
+        fs.cpSync(from, path.join(outDir, name), { recursive: true });
+    }
+}
+/**
+ * The documentation home — every section, every page, one line each.
+ *
+ * The site had no such page. `index.html` is the marketing landing, so a reader
+ * who wanted the documentation had nowhere to land and no way to see what
+ * existed. Generated rather than hand-written, so a page added to `NAV` appears
+ * here without anybody remembering to add it twice.
+ */
+function docsHome(version) {
+    const cards = nav_1.NAV.map((section) => {
+        const items = section.entries
+            .map((entry) => `<li><a href="${entry.slug}.html"><strong>${escapeHtml(entry.label)}</strong>` +
+            `<span>${escapeHtml(entry.blurb)}</span></a></li>`)
+            .join("");
+        return (`<section class="home__group">` +
+            `<h2>${escapeHtml(section.title)}</h2>` +
+            `<p class="home__summary">${escapeHtml(section.summary)}</p>` +
+            `<ul class="home__list">${items}</ul></section>`);
+    }).join("");
+    const page = {
+        slug: "docs",
+        title: "Documentation",
+        headings: [],
+        text: "",
+        html: `<h1>Documentation</h1>` +
+            `<p class="home__lede">Specifications that are checked, not admired. Start with ` +
+            `<a href="getting-started.html">Getting started</a> if the folder is empty, or ` +
+            `<a href="quickstart.html">You cloned a repo</a> if somebody handed you one.</p>` +
+            `<figure class="code" data-lang="bash">` +
+            `<button class="code__copy" type="button" aria-label="Copy to clipboard">Copy</button>` +
+            `<pre><code class="language-bash">npx create-spec-driven-app@latest init</code></pre>` +
+            `</figure>` +
+            `<div class="home">${cards}</div>`,
+    };
+    return pageShell(page, version);
+}
+function buildSite(outDir) {
+    const version = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf8")).version;
+    fs.rmSync(outDir, { recursive: true, force: true });
+    fs.mkdirSync(outDir, { recursive: true });
+    const slugs = markdownFiles(DOCS);
+    const index = [];
+    const available = (0, blocks_1.diagrams)(DOCS);
+    for (const slug of slugs) {
+        const source = fs.readFileSync(path.join(DOCS, `${slug}.md`), "utf8");
+        // The marker is ours and means nothing to a reader.
+        const cleaned = (0, blocks_1.inlineDiagrams)(source.replace(/^<!--\s*csda:allow-placeholders[^>]*-->\s*\n?/gm, ""), available);
+        const { html, headings, title } = renderMarkdown(cleaned, slug);
+        const page = {
+            slug,
+            title: title || (0, nav_1.navEntry)(slug)?.label || slug,
+            html,
+            headings,
+            text: cleaned
+                .replace(/```[\s\S]*?```/g, " ")
+                .replace(/[#*`>|_-]/g, " ")
+                .replace(/\s+/g, " ")
+                .trim()
+                .slice(0, 1500),
+        };
+        const target = path.join(outDir, `${slug}.html`);
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.writeFileSync(target, pageShell(page, version), "utf8");
+        index.push({ slug, title: page.title, text: page.text });
+    }
+    fs.writeFileSync(path.join(outDir, "docs.html"), docsHome(version), "utf8");
+    fs.mkdirSync(path.join(outDir, "assets"), { recursive: true });
+    fs.writeFileSync(path.join(outDir, "assets", "search-index.json"), JSON.stringify(index), "utf8");
+    copyVerbatim(outDir, available);
+    fs.writeFileSync(path.join(outDir, ".nojekyll"), "", "utf8");
+    // Depth used to exempt a page, which is how `articles/` and `case-studies/`
+    // stayed published and unreachable. `docs/specs/` is the one real exception:
+    // those pages are the project's own specifications, published so the links
+    // that reference them resolve, and deliberately not in a reader's sidebar.
+    const orphans = slugs.filter((slug) => !(0, nav_1.navEntry)(slug) && !slug.startsWith("specs/"));
+    return { pages: slugs.length, orphans };
+}
+if (require.main === module) {
+    const at = process.argv.indexOf("--out");
+    const outDir = at !== -1 ? process.argv[at + 1] : path.join(ROOT, "_site");
+    const { pages, orphans } = buildSite(path.resolve(outDir));
+    process.stdout.write(`ℹ️  [docs] rendered ${pages} page(s) into ${outDir}\n`);
+    if (orphans.length > 0) {
+        process.stdout.write(`⚠️  [docs] not in the sidebar, so nobody can navigate to them: ${orphans.join(", ")}\n`);
+    }
+}
+//# sourceMappingURL=build-site.js.map

package/dist/scripts/docs/build-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-site.js","sourceRoot":"","sources":["../../../scripts/docs/build-site.ts"],"names":[],"mappings":"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"}

package/dist/scripts/docs/nav.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * The shape of the documentation site, decided once.
+ *
+ * Ordered by the question a reader is asking, not alphabetically and not by
+ * the order the files happened to be written. Someone who has just run `npx
+ * create-spec-driven-app` needs a different page from someone deciding whether
+ * to adopt the tool at all, and the sidebar should make that obvious without
+ * being read end to end.
+ *
+ * A document missing from this list is still rendered — it simply does not
+ * appear in the sidebar. `tests/unit/docs-site.test.ts` fails when a shipped
+ * document is orphaned that way, because a page nobody can navigate to is a
+ * page nobody reads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NAV = void 0;
+exports.navSlugs = navSlugs;
+exports.navEntry = navEntry;
+exports.neighbours = neighbours;
+exports.NAV = [
+    {
+        title: "Start here",
+        summary: "Fifteen minutes from nothing to a project whose specs are checked by CI.",
+        entries: [
+            {
+                slug: "getting-started",
+                label: "Getting started",
+                blurb: "Install, scaffold a project, and run the gate for the first time.",
+            },
+            {
+                slug: "quickstart",
+                label: "You cloned a repo",
+                blurb: "Someone handed you a spec-driven repository. Start here instead.",
+            },
+            {
+                slug: "walkthrough",
+                label: "Walkthrough",
+                blurb: "The whole loop end to end, in one sitting.",
+            },
+            {
+                slug: "tutorial",
+                label: "Tutorial: Smart Parking",
+                blurb: "A complete worked example, from a blank folder to a delivered requirement.",
+            },
+        ],
+    },
+    {
+        title: "Working with specs",
+        summary: "What a specification is here, and what the tool does with it.",
+        entries: [
+            {
+                slug: "writing-specs",
+                label: "Writing specs",
+                blurb: "Requirements, scenarios and the traceability matrix.",
+            },
+            {
+                slug: "validating",
+                label: "Validating",
+                blurb: "The gate: structure, traceability, Gherkin and TDD.",
+            },
+            {
+                slug: "reviewing-changes",
+                label: "Reviewing changes",
+                blurb: "Propose, review and archive a change to specs that already shipped.",
+            },
+            {
+                slug: "domain-packs",
+                label: "Domain packs",
+                blurb: "Install a curated domain model instead of writing one from scratch.",
+            },
+        ],
+    },
+    {
+        title: "Agents and the harness",
+        summary: "The part that spends money. Read the harness page before pointing an agent at anything.",
+        entries: [
+            {
+                slug: "agents",
+                label: "Agent tools",
+                blurb: "Wire Claude Code, Cursor, Copilot and five others into the same loop.",
+            },
+            {
+                slug: "agent-setup",
+                label: "Choosing your agent",
+                blurb: "Claude, Aider, Cursor or a three-line wrapper — and the two things that bite.",
+            },
+            {
+                slug: "harness",
+                label: "The harness",
+                blurb: "Unattended delivery: plan → agent → gate → done, one worktree per requirement.",
+            },
+            {
+                slug: "bootstrap-prompt",
+                label: "Bootstrap prompt",
+                blurb: "The prompt that turns an idea into a first specification.",
+            },
+        ],
+    },
+    {
+        title: "Running it for real",
+        summary: "CI, boards, and the things an enterprise asks before it says yes.",
+        entries: [
+            {
+                slug: "automation",
+                label: "Automation",
+                blurb: "Generate the gate for GitHub, GitLab, Azure or Jenkins.",
+            },
+            {
+                slug: "alm",
+                label: "Jira and Azure Boards",
+                blurb: "Mirror requirements onto a board without letting the board define them.",
+            },
+            {
+                slug: "deployment",
+                label: "Deployment",
+                blurb: "Where the generated project expects to be deployed from.",
+            },
+            {
+                slug: "supply-chain",
+                label: "Supply chain",
+                blurb: "SBOM, licences, provenance and what ships in the tarball.",
+            },
+        ],
+    },
+    {
+        title: "Reference",
+        summary: "Look things up.",
+        entries: [
+            {
+                slug: "commands",
+                label: "Command reference",
+                blurb: "Every command, its flags and its JSON shape.",
+            },
+            {
+                slug: "how-to",
+                label: "How-to guides",
+                blurb: "Short answers to specific questions.",
+            },
+            {
+                slug: "troubleshooting",
+                label: "Troubleshooting",
+                blurb: "When the gate says no and you disagree.",
+            },
+            {
+                slug: "comparisons",
+                label: "Comparisons",
+                blurb: "How this differs from OpenSpec, Spec Kit and writing it yourself.",
+            },
+            {
+                slug: "release-process",
+                label: "Release process",
+                blurb: "How a version is cut, and what support it gets.",
+            },
+        ],
+    },
+    {
+        // These two were published and linked from nowhere. They are the two
+        // documents that explain *why* the tool is shaped this way, which makes
+        // them the wrong ones to leave unreachable.
+        title: "Background",
+        summary: "Why it works this way.",
+        entries: [
+            {
+                slug: "articles/specs-that-cannot-lie",
+                label: "Specs that cannot lie",
+                blurb: "The argument the tool is built on, and the defects that shaped it.",
+            },
+            {
+                slug: "case-studies/case-1",
+                label: "Worked example: brownfield adoption",
+                blurb: "An illustration — invented company, constructed numbers — of the workflow end to end.",
+            },
+        ],
+    },
+];
+/** Every slug the sidebar links to, in reading order. */
+function navSlugs() {
+    return exports.NAV.flatMap((section) => section.entries.map((entry) => entry.slug));
+}
+/** The entry for a slug, or `null` when the document is not in the sidebar. */
+function navEntry(slug) {
+    for (const section of exports.NAV) {
+        const found = section.entries.find((entry) => entry.slug === slug);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** What comes before and after this page, for the footer links. */
+function neighbours(slug) {
+    const all = exports.NAV.flatMap((section) => section.entries);
+    const at = all.findIndex((entry) => entry.slug === slug);
+    if (at === -1)
+        return { prev: null, next: null };
+    return { prev: all[at - 1] ?? null, next: all[at + 1] ?? null };
+}
+//# sourceMappingURL=nav.js.map

package/dist/scripts/docs/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../../../scripts/docs/nav.ts"],"names":[],"mappings":"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"}