create-thally-docs 0.10.122 → 0.10.124

package/README.md

@@ -75,7 +75,7 @@ runs retain subprocess output for scripts and CI. These options also work with
 | --- | --- |
 | `create-thally-docs <dir>` | Scaffold a new project |
 | `create-thally-docs migrate <github-or-docs-url-or-directory> [dir]` | Import a docs repository or public docs site through the shared migration engine |
-| `create-thally-docs check [dir] [--fix] [--ci] [--drift] [--external]` | Lint content for broken links, orphan pages, and missing frontmatter; `--external` also checks links to public hosts (bounded, warnings only) |
+| `create-thally-docs check [dir] [--fix] [--ci] [--drift] [--external]` | Lint content for MDX syntax errors (pages and snippets that cannot be parsed), broken links, orphan pages, and missing frontmatter; `--external` also checks links to public hosts (bounded, warnings only) |
 | `create-thally-docs translate --locale <code>` | Translate content into another locale |
 
 Public URL imports default to 1,000 pages. The web migration flow supports up to

package/dist/{chunk-3WMUNLRV.js → chunk-NITY7H3R.js}

@@ -492,7 +492,7 @@ async function discoverMigration(options) {
   const cloneDir = join5(temporaryRoot, "repository");
   try {
     const cloneWarnings = [];
-    await terminal.step(`Cloning ${source.owner}/${source.repo}`, () => cloneGitHubRepository(source, cloneDir, cloneWarnings), "Source repository cloned");
+    await terminal.step(`Cloning ${source.owner}/${source.repo}`, () => cloneGitHubRepository(source, cloneDir, cloneWarnings, { docsDir: options.docsDir }), "Source repository cloned");
     const sourceRefs = options.sourceRefs?.length ? await terminal.step("Importing sourceRef repositories", () => fetchSourceRefs(options.sourceRefs ?? [], cloneWarnings), "sourceRef repositories imported") : [];
     const bundle = await terminal.step("Converting repository documentation", () => convertRepository({
       sourceRefs,

package/dist/{chunk-HSPM676Z.js → chunk-WKJN3RIC.js}

@@ -13,6 +13,7 @@ import {
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { join, extname, relative } from "path";
 import { execFileSync } from "child_process";
+import { compile, pathToRegexp, regexpToFunction } from "path-to-regexp";
 
 // src/frontmatter.ts
 import { parse as parseYaml } from "yaml";
@@ -39,6 +40,7 @@ function parseFrontmatter(raw) {
 
 // src/check.ts
 import { parse as parseYaml2 } from "yaml";
+import remarkGfm from "remark-gfm";
 import remarkMdx2 from "remark-mdx";
 import remarkParse2 from "remark-parse";
 import { unified as unified2 } from "unified";
@@ -303,8 +305,9 @@ function manualApiProblems(file, data, hasOpenApiReference, mdx, docsApi) {
 }
 
 // src/check.ts
+import { parseMdxTree } from "@thallylabs/core/markdown";
 import { projectNavigationContract } from "@thallylabs/core/navigation";
-import { plainInlineText, slugify } from "@thallylabs/core/slugify";
+import { componentIds, constantString, fieldAnchorBase, fieldAnchorName, numberFieldIds, numberHeadingIds, plainInlineText, slugify } from "@thallylabs/core/slugify";
 import { validateIntegrations } from "@thallylabs/migrate";
 
 // src/external-links.ts
@@ -499,6 +502,19 @@ function scanMdx(dir, results) {
     }
   }
 }
+function compiledMdx(directory, results) {
+  let entries;
+  try {
+    entries = readdirSync(directory, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const fullPath = join(directory, entry.name);
+    if (entry.isDirectory()) compiledMdx(fullPath, results);
+    else if (entry.isFile() && entry.name.endsWith(".mdx")) results.add(fullPath);
+  }
+}
 function addOrphanToNav(projectDir, pageId) {
   const config = readDocsJson(projectDir);
   const tab = config.tabs.find((candidate) => !candidate.href && !candidate.api && (candidate.pages?.length || candidate.groups?.length));
@@ -532,70 +548,132 @@ function forEachNonFencedLine(content, visit) {
     if (!fence) visit(line, index + 1);
   }
 }
-function renderedHeadingText(source) {
-  let visible = "";
-  let inTag = false;
-  let quote = null;
-  for (let index = 0; index < source.length; index++) {
-    const character = source[index];
-    if (!inTag) {
-      if (character === "<") inTag = true;
-      else visible += character;
-      continue;
-    }
-    if (quote) {
-      if (character === quote && source[index - 1] !== "\\") quote = null;
-    } else if (character === '"' || character === "'") {
-      quote = character;
-    } else if (character === ">") {
-      inTag = false;
+var mdxParser = unified2().use(remarkParse2).use(remarkMdx2).use(remarkGfm);
+var SNIPPET_IMPORT = /^\s*import\s+\{([^}]+)\}\s+from\s+['"]\/snippets\/[^'"]+['"];?\s*$/gm;
+var LINE_BREAK = /\r\n|\r|\n/g;
+function countAtMost(ascending, value) {
+  let low = 0;
+  let high = ascending.length;
+  while (low < high) {
+    const middle = low + high >> 1;
+    if (ascending[middle] <= value) low = middle + 1;
+    else high = middle;
+  }
+  return low;
+}
+function parseMdxPage(content) {
+  const removedAt = [];
+  const removedTotal = [];
+  let removed = 0;
+  const source = content.replace(SNIPPET_IMPORT, (match, _names, start) => {
+    removedAt.push(start - removed);
+    removed += match.length;
+    removedTotal.push(removed);
+    return "";
+  });
+  let newlines;
+  const lineAt = (offset) => {
+    const before = countAtMost(removedAt, offset);
+    const original = before === 0 ? offset : offset + removedTotal[before - 1];
+    if (!newlines) {
+      newlines = [];
+      for (const lineBreak of content.matchAll(LINE_BREAK)) newlines.push(lineBreak.index + lineBreak[0].length - 1);
     }
+    return 1 + countAtMost(newlines, original - 1);
+  };
+  try {
+    return { tree: mdxParser.parse(source), lineAt };
+  } catch (error) {
+    const { reason, message, line, place } = error;
+    const offset = place?.offset ?? place?.start?.offset;
+    return {
+      error: {
+        reason: (reason ?? message ?? "The page could not be parsed").split("\n")[0].replace(/\.$/, ""),
+        line: offset === void 0 ? line ?? 1 : lineAt(offset)
+      },
+      lineAt
+    };
   }
-  return visible;
 }
-var mdxParser = unified2().use(remarkParse2).use(remarkMdx2);
 function stringAttribute(node, name) {
   const attribute = node.attributes?.find((item) => item.type === "mdxJsxAttribute" && item.name === name);
   if (!attribute) return void 0;
   return typeof attribute.value === "string" ? attribute.value : null;
 }
-function extractStepHeadings(content) {
-  if (!content.includes("<Step")) return [];
-  let tree;
-  try {
-    tree = mdxParser.parse(content);
-  } catch {
-    return [];
-  }
-  const steps = [];
-  const visit = (node, stepSize) => {
+function constantAttribute(node, name) {
+  const attribute = node.attributes?.find((item) => item.type === "mdxJsxAttribute" && item.name === name);
+  if (!attribute) return void 0;
+  return typeof attribute.value === "string" ? attribute.value : constantString(attribute.value);
+}
+var HEADING_ID_MARKER = /^\s*\/\*\s*#(\S+?)\s*\*\/\s*$/;
+function mdxSyntaxIssue(page, file, bodyLineOffset2, consequence) {
+  if (!page.error) return null;
+  return {
+    severity: "error",
+    message: `MDX syntax error: ${page.error.reason}. ${consequence}`,
+    file,
+    line: page.error.line + bodyLineOffset2
+  };
+}
+function bodyLineOffset(raw, content) {
+  return raw.slice(0, raw.length - content.length).split(LINE_BREAK).length - 1;
+}
+function headingText(node, components, footnoteNumber) {
+  if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
+  if (node.type === "break") return "\n";
+  if (node.type === "footnoteReference") return String(footnoteNumber(node.identifier ?? ""));
+  if (node.type === "mdxTextExpression") return components ? constantString(node) ?? "" : "";
+  if (node.type === "mdxJsxTextElement" && !components) return "";
+  return (node.children ?? []).map((child) => headingText(child, components, footnoteNumber)).join("");
+}
+var STEP_HEADING_SIZES = ["h2", "h3", "h4"];
+function readPageIds(content, parsed) {
+  const tree = parsed.tree ?? parseMdxTree(content);
+  const footnotes = /* @__PURE__ */ new Map();
+  const footnoteNumber = (identifier) => {
+    if (!footnotes.has(identifier)) footnotes.set(identifier, footnotes.size + 1);
+    return footnotes.get(identifier);
+  };
+  const page = { headings: [], fieldBases: [], reserved: /* @__PURE__ */ new Set() };
+  const visit = (node, stepSize, inNote) => {
     let childSize = stepSize;
-    if (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") {
+    if (node.type === "footnoteReference" && !inNote) footnoteNumber(node.identifier ?? "");
+    if (node.type === "heading" && (node.depth ?? 0) >= 2) {
+      const children = node.children ?? [];
+      const marker = children.findIndex((child) => child.type === "mdxTextExpression" && HEADING_ID_MARKER.test(child.value ?? ""));
+      const given = marker < 0 ? void 0 : HEADING_ID_MARKER.exec(children[marker].value ?? "")[1];
+      const heading = marker < 0 ? node : { ...node, children: children.filter((_, index) => index !== marker) };
+      const base = given ?? (slugify(headingText(heading, false, footnoteNumber)) || slugify(headingText(heading, true, footnoteNumber)));
+      page.headings.push({ base, explicit: given !== void 0 });
+    } else if (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") {
+      const authored = constantAttribute(node, "id")?.trim();
+      if (authored) page.reserved.add(authored);
+      for (const id of componentIds(node.name ?? "", (attribute) => constantAttribute(node, attribute))) page.reserved.add(id);
       if (node.name === "Steps") childSize = stringAttribute(node, "titleSize") ?? void 0;
       if (node.name === "Step") {
         const own = stringAttribute(node, "titleSize");
         const size = own === void 0 ? stepSize : own;
         const title = stringAttribute(node, "title")?.trim();
-        if (title && size && ["h2", "h3", "h4"].includes(size)) {
-          const id = stringAttribute(node, "id")?.trim();
-          steps.push({ line: node.position?.start.line ?? 0, base: id || slugify(plainInlineText(title)), explicit: !!id });
+        const stepId = constantAttribute(node, "id");
+        if (title && size && STEP_HEADING_SIZES.includes(size) && stepId !== null) {
+          const given = stepId?.trim();
+          page.headings.push({ base: given || slugify(plainInlineText(title)), explicit: !!given });
         }
       }
+      if (node.name === "ParamField" || node.name === "ResponseField") {
+        const name = fieldAnchorName(node.name, (attribute) => constantAttribute(node, attribute));
+        const base = name === void 0 ? void 0 : fieldAnchorBase(name);
+        if (base && constantAttribute(node, "id") === void 0) page.fieldBases.push(base);
+      }
     }
-    for (const child of node.children ?? []) visit(child, childSize);
+    for (const child of node.children ?? []) visit(child, childSize, inNote || node.type === "footnoteDefinition");
   };
-  visit(tree, void 0);
-  return steps;
+  visit(tree, void 0, false);
+  return page;
 }
-function extractHeadingAnchors(content) {
+function extractHeadingAnchors(content, parsed = parseMdxPage(content)) {
   const anchors = /* @__PURE__ */ new Set();
-  const headings = [];
-  forEachNonFencedLine(content, (line, lineNumber) => {
-    const heading = /^ {0,3}#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
-    if (heading) {
-      const explicit = /\{\/\*\s*#(\S+?)\s*\*\/\}$/.exec(heading[1]);
-      headings.push({ base: explicit?.[1] ?? slugify(renderedHeadingText(heading[1])), explicit: !!explicit, line: lineNumber });
-    }
+  forEachNonFencedLine(content, (line) => {
     for (const idMatch of line.matchAll(EXPLICIT_ID_ATTRIBUTE)) {
       const id = idMatch[1] ?? idMatch[2] ?? idMatch[3];
       if (id) anchors.add(id);
@@ -605,26 +683,11 @@ function extractHeadingAnchors(content) {
       if (name) anchors.add(name);
     }
   });
-  headings.push(...extractStepHeadings(content));
-  headings.sort((left, right) => left.line - right.line);
-  const reserved = new Set(headings.filter((heading) => heading.explicit).map((heading) => heading.base));
-  const used = /* @__PURE__ */ new Set();
-  const occurrences = /* @__PURE__ */ new Map();
-  for (const { base, explicit } of headings) {
-    let id = base;
-    let n = 1;
-    if (explicit) {
-      while (used.has(id)) id = `${base}-${++n}`;
-    } else {
-      n = occurrences.get(base) ?? 0;
-      do
-        id = ++n === 1 ? base : `${base}-${n}`;
-      while (used.has(id) || reserved.has(id));
-      occurrences.set(base, n);
-    }
-    used.add(id);
-    anchors.add(id);
-  }
+  const page = readPageIds(content, parsed);
+  const { ids, used } = numberHeadingIds(page.headings);
+  for (const id of ids) if (id) anchors.add(id);
+  for (const id of numberFieldIds(page.fieldBases, used, page.reserved)) anchors.add(id);
+  for (const id of page.reserved) anchors.add(id);
   return anchors;
 }
 function decodedFragment(fragment) {
@@ -672,34 +735,45 @@ function pageIdToPath(pageId, secondaryLocales) {
   const basePath = navPageId === "introduction" ? "/" : `/${navPageId}`;
   return locale ? `/${locale}${basePath === "/" ? "" : basePath}` : basePath;
 }
-function compileDynamicRedirectSource(source, destination) {
-  if (!source.includes(":")) return null;
-  const paramNames = [];
-  let pattern = "";
-  source.split("/").forEach((segment, index) => {
-    const match = segment.match(/^:([A-Za-z_][A-Za-z0-9_]*)([*+?]?)$/);
-    const separator = index === 0 ? "" : "/";
-    if (!match) {
-      pattern += separator + segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-      return;
-    }
-    const [, name, quantifier] = match;
-    paramNames.push(name);
-    if (quantifier === "*") pattern += `(?:${separator}(.*))?`;
-    else if (quantifier === "?") pattern += `(?:${separator}([^/]+))?`;
-    else pattern += `${separator}(${quantifier === "+" ? ".+" : "[^/]+"})`;
-  });
-  return { regex: new RegExp(`^${pattern}$`), paramNames, destination };
+function compileRedirectSource(source, destination) {
+  const bare = source.replace(/\/$/, "") || "/";
+  const keys = [];
+  let match = null;
+  try {
+    const regexp = pathToRegexp(bare, keys, { delimiter: "/", sensitive: false, strict: true });
+    const matcher = regexpToFunction(new RegExp(regexp.source.replace(/\^/, "^(?!\\/_next)").replace(/\$$/, "(?:\\/)?$"), regexp.flags), keys);
+    match = (path) => {
+      const found = matcher(path);
+      if (!found) return false;
+      for (const key of keys) if (typeof key.name === "number") delete found.params[key.name];
+      return found;
+    };
+  } catch {
+  }
+  return { match, destination, literal: !/[:*+?(){}\\]/.test(bare) };
 }
-function resolveDynamicRedirectDestination(redirect, match) {
-  return redirect.destination.replace(/:([A-Za-z_][A-Za-z0-9_]*)[*+?]?/g, (whole, name) => {
-    const index = redirect.paramNames.indexOf(name);
-    return index === -1 ? whole : match[index + 1] ?? "";
-  });
+function applyRedirect(rule, path) {
+  const found = rule.match?.(path);
+  if (!found) return void 0;
+  if (/^(?:https?:)?\/\//i.test(rule.destination)) return rule.destination;
+  try {
+    return compile(rule.destination.replace(/\?[^#]*/, ""), { validate: false })(found.params);
+  } catch {
+    return null;
+  }
+}
+function matchRedirect(rules, path) {
+  for (const rule of rules) {
+    if (!rule.match) return "unsure";
+    const to = applyRedirect(rule, path);
+    if (to === null) return "unsure";
+    if (to !== void 0) return { to };
+  }
+  return void 0;
 }
 var MAX_REDIRECT_HOPS = 20;
 var MISSING_DESCRIPTION = 'Missing "description" in frontmatter';
-function resolveLink(target, redirects, dynamicRedirects = []) {
+function resolveLink(target, redirects) {
   let current = target;
   let anchor;
   const seen = /* @__PURE__ */ new Set();
@@ -711,14 +785,10 @@ function resolveLink(target, redirects, dynamicRedirects = []) {
     const path = beforeHash.split("?", 1)[0].replace(/\/$/, "") || "/";
     if (seen.has(path) || seen.size >= MAX_REDIRECT_HOPS) return { path, anchor, cycle: true };
     seen.add(path);
-    const literalRedirect = redirects.get(path);
-    if (literalRedirect) {
-      current = literalRedirect;
-      continue;
-    }
-    const dynamicMatch = dynamicRedirects.map((redirect) => ({ redirect, match: path.match(redirect.regex) })).find((candidate) => candidate.match !== null);
-    if (!dynamicMatch) return { path, anchor };
-    current = resolveDynamicRedirectDestination(dynamicMatch.redirect, dynamicMatch.match);
+    const found = matchRedirect(redirects, path);
+    if (found === "unsure") return { path, anchor, unsure: true };
+    if (!found) return { path, anchor };
+    current = found.to;
   }
 }
 function checkPublicSpecs(projectDir, tabs, issues) {
@@ -898,16 +968,7 @@ async function runCheck(projectDir, options) {
     "/api",
     ...Array.from(secondaryLocales, (locale) => `/${locale}/api`)
   ]);
-  const redirectDestinations = new Map(
-    (config.redirects ?? []).filter((redirect) => !redirect.source.includes(":")).map((redirect) => [
-      redirect.source.replace(/\/$/, "") || "/",
-      redirect.destination
-    ])
-  );
-  const dynamicRedirects = (config.redirects ?? []).flatMap((redirect) => {
-    const compiled = compileDynamicRedirectSource(redirect.source, redirect.destination);
-    return compiled ? [compiled] : [];
-  });
+  const redirectRules = (config.redirects ?? []).map(({ source, destination }) => compileRedirectSource(source, destination));
   for (const message of validateIntegrations(config.integrations)) {
     issues.push({ severity: "warning", message, file: "docs.json" });
   }
@@ -927,11 +988,16 @@ async function runCheck(projectDir, options) {
   }
   const allFiles = [];
   if (existsSync(contentDir)) scanMdx(contentDir, allFiles);
+  const compiledPages = /* @__PURE__ */ new Set();
+  compiledMdx(contentDir, compiledPages);
+  const compiledSnippets = /* @__PURE__ */ new Set();
+  compiledMdx(join(projectDir, "snippets"), compiledSnippets);
   const fixedOrphans = [];
   const operationPages = [];
   const validPaths = /* @__PURE__ */ new Set(["/"]);
   const anchorsByPath = /* @__PURE__ */ new Map();
   const linksByFile = [];
+  const linkStubs = [];
   for (const filePath of allFiles) {
     const rel = filePath.slice(contentDir.length + 1).replace(/\.mdx$/, "").replace(/\\/g, "/");
     const pageId = rel.endsWith("/index") ? rel.slice(0, -6) : rel;
@@ -943,7 +1009,7 @@ async function runCheck(projectDir, options) {
       const parsed = parseFrontmatter(raw);
       data = parsed.data;
       content = parsed.content;
-      lineOffset = raw.slice(0, raw.indexOf(content)).split("\n").length - 1;
+      lineOffset = bodyLineOffset(raw, content);
     } catch {
       issues.push({ severity: "error", message: `Could not parse frontmatter`, file: relative(projectDir, filePath) });
       continue;
@@ -960,23 +1026,38 @@ async function runCheck(projectDir, options) {
     const rel2 = relative(projectDir, filePath);
     if (!data.title) issues.push({ severity: "warning", message: `Missing "title" in frontmatter`, file: rel2 });
     const reference = parseDocReference(data.openapi);
-    if (!data.description && !reference) issues.push({ severity: "warning", message: MISSING_DESCRIPTION, file: rel2 });
+    const path = pageIdToPath(pageId, secondaryLocales);
+    const isLinkStub = data.noindex === true && redirectRules.some((rule) => rule.literal && rule.match?.(path));
+    const notices = isLinkStub ? [] : issues;
+    if (!data.description && !reference) notices.push({ severity: "warning", message: MISSING_DESCRIPTION, file: rel2 });
     if (typeof data.openapi !== "string" && content.trim().length < 50) {
-      issues.push({ severity: "warning", message: `Very short body (${content.trim().length} chars) \u2014 page may be empty`, file: rel2 });
+      notices.push({ severity: "warning", message: `Very short body (${content.trim().length} chars) \u2014 page may be empty`, file: rel2 });
     }
+    if (isLinkStub) linkStubs.push({ file: rel2, path, issues: notices });
     if (reference) operationPages.push({ file: rel2, reference, hasDescription: Boolean(data.description) });
     for (const message of manualApiProblems(rel2, data, Boolean(reference), content, config.api)) {
       issues.push({ severity: "warning", file: rel2, message });
     }
     if (options.drift) checkDrift(projectDir, rel2, data, issues);
-    const path = pageIdToPath(pageId, secondaryLocales);
-    const anchors = extractHeadingAnchors(content);
+    const page = parseMdxPage(content);
+    const syntaxIssue = compiledPages.has(filePath) ? mdxSyntaxIssue(page, rel2, lineOffset, "The page cannot render until this is fixed.") : null;
+    if (syntaxIssue) issues.push(syntaxIssue);
+    const anchors = extractHeadingAnchors(content, page);
     validPaths.add(path);
     validPaths.add(`/${pageId}`);
     anchorsByPath.set(path, anchors);
     anchorsByPath.set(`/${pageId}`, anchors);
     linksByFile.push({ file: rel2, path, anchors, links: extractLinks(content), images: extractImageRefs(content), offset: lineOffset });
   }
+  for (const filePath of compiledSnippets) {
+    try {
+      const raw = readFileSync(filePath, "utf8");
+      const { content } = parseFrontmatter(raw);
+      const issue = mdxSyntaxIssue(parseMdxPage(content), relative(projectDir, filePath), bodyLineOffset(raw, content), "Pages that use this snippet cannot render until this is fixed.");
+      if (issue) issues.push(issue);
+    } catch {
+    }
+  }
   for (const [path, anchors] of [...anchorsByPath]) {
     if (secondaryLocales.has(path.split("/")[1])) continue;
     for (const locale of secondaryLocales) {
@@ -986,6 +1067,16 @@ async function runCheck(projectDir, options) {
       anchorsByPath.set(localized, anchors);
     }
   }
+  const isGeneratedPath = (path) => Array.from(generatedApiPaths).some((prefix) => path === prefix || path.startsWith(`${prefix}/`)) || path.startsWith("/_next") || /\.[a-z0-9]+$/i.test(path);
+  for (const { file, path, issues: notices } of linkStubs) {
+    const { path: destination, cycle, external, unsure } = resolveLink(path, redirectRules);
+    if (external || unsure || !cycle && (isGeneratedPath(destination) || validPaths.has(destination))) continue;
+    issues.push(...notices, {
+      severity: "error",
+      message: cycle ? `Broken redirect: "${path}" redirects in a loop, so the page it stands in for cannot be reached` : `Broken redirect: "${path}" redirects to "${destination}", where there is no page`,
+      file
+    });
+  }
   const externalLinks = [];
   for (const { file, anchors, links, offset } of linksByFile) {
     for (const { target, line: contentLine } of links) {
@@ -1002,12 +1093,9 @@ async function runCheck(projectDir, options) {
         continue;
       }
       if (!target.startsWith("/")) continue;
-      const { path, anchor, cycle, external } = resolveLink(target, redirectDestinations, dynamicRedirects);
-      if (external) continue;
-      const isGeneratedApiPath = Array.from(generatedApiPaths).some(
-        (prefix) => path === prefix || path.startsWith(`${prefix}/`)
-      );
-      if (!cycle && (isGeneratedApiPath || path.startsWith("/_next") || /\.[a-z0-9]+$/i.test(path))) continue;
+      const { path, anchor, cycle, external, unsure } = resolveLink(target, redirectRules);
+      if (external || unsure) continue;
+      if (!cycle && isGeneratedPath(path)) continue;
       if (cycle || !validPaths.has(path)) {
         issues.push({ severity: "error", message: `Broken link: "${target}" \u2014 no page at "${path}"`, file, line });
       } else if (anchor && !anchorsByPath.get(path)?.has(decodedFragment(anchor))) {

package/dist/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-3WMUNLRV.js";
+} from "./chunk-NITY7H3R.js";
 import {
   parseFrontmatter,
   runCheck
-} from "./chunk-HSPM676Z.js";
+} from "./chunk-WKJN3RIC.js";
 import "./chunk-KDLP27DS.js";
 import {
   logo,

package/dist/migrate/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-3WMUNLRV.js";
+} from "../chunk-NITY7H3R.js";
 import "../chunk-KDLP27DS.js";
 import "../chunk-BHJYHH67.js";
 import "../chunk-UG3OXVLE.js";

package/dist/migration-worker.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCheck
-} from "./chunk-HSPM676Z.js";
+} from "./chunk-WKJN3RIC.js";
 import "./chunk-KDLP27DS.js";
 import "./chunk-J7255UQA.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.122",
+  "version": "0.10.124",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -53,9 +53,11 @@
     "@anthropic-ai/sdk": "^0.36.0",
     "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
-    "@thallylabs/core": "0.2.17",
-    "@thallylabs/migrate": "0.2.43",
+    "@thallylabs/core": "0.2.18",
+    "@thallylabs/migrate": "0.2.45",
     "p-limit": "^6.1.0",
+    "path-to-regexp": "6.3.0",
+    "remark-gfm": "^4.0.1",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",
     "tar": "^7.5.22",