create-thally-docs 0.10.55 → 0.10.57

package/dist/{chunk-D5MH737V.js → chunk-45YUNA3U.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-XYRM4GAT.js";
 import {
   downloadStarter
-} from "./chunk-WH4YY5EW.js";
+} from "./chunk-AQACEZTT.js";
 
 // src/scaffold.ts
 import { existsSync, mkdirSync, readdirSync } from "fs";

package/dist/{chunk-WH4YY5EW.js → chunk-AQACEZTT.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   readStarterReleaseManifest
-} from "./chunk-AUF4NC7X.js";
+} from "./chunk-H57USRQO.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-GHEWAGPJ.js";
+} from "./chunk-YX3DTSOG.js";
 
 // src/download.ts
 import { Readable, Transform, pipeline } from "stream";

package/dist/{chunk-AUF4NC7X.js → chunk-H57USRQO.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-GHEWAGPJ.js";
+} from "./chunk-YX3DTSOG.js";
 
 // src/starter-sync.ts
 import { createHash } from "crypto";

package/dist/{chunk-PJXWW3KP.js → chunk-MCC5PVLL.js}

@@ -5,7 +5,7 @@ import {
   readDocsJson,
   scaffold,
   writeDocsJson
-} from "./chunk-D5MH737V.js";
+} from "./chunk-45YUNA3U.js";
 
 // src/migrate/index.ts
 import { existsSync as existsSync3, mkdirSync, mkdtempSync, readFileSync as readFileSync3, rmSync, writeFileSync } from "fs";
@@ -144,6 +144,7 @@ function addOrphanToNav(projectDir, pageId) {
   }
 }
 var EXPLICIT_ID_ATTRIBUTE = /\bid=(?:"([^"]*)"|'([^']*)'|\{["']([^"'}]*)["']\})/g;
+var NAMED_ANCHOR = /<a\b[^>]*\bname=(?:"([^"]*)"|'([^']*)')/g;
 function forEachNonFencedLine(content, visit) {
   let fence;
   for (const [index, line] of content.split("\n").entries()) {
@@ -158,16 +159,33 @@ function forEachNonFencedLine(content, visit) {
 }
 function extractHeadingAnchors(content) {
   const anchors = /* @__PURE__ */ new Set();
+  const occurrences = /* @__PURE__ */ new Map();
   forEachNonFencedLine(content, (line) => {
     const heading = /^ {0,3}#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
-    if (heading) anchors.add(slugify(heading[1]));
+    if (heading) {
+      const base = slugify(heading[1]);
+      const occurrence = (occurrences.get(base) ?? 0) + 1;
+      occurrences.set(base, occurrence);
+      anchors.add(occurrence === 1 ? base : `${base}-${occurrence}`);
+    }
     for (const idMatch of line.matchAll(EXPLICIT_ID_ATTRIBUTE)) {
       const id = idMatch[1] ?? idMatch[2] ?? idMatch[3];
       if (id) anchors.add(id);
     }
+    for (const nameMatch of line.matchAll(NAMED_ANCHOR)) {
+      const name = nameMatch[1] ?? nameMatch[2];
+      if (name) anchors.add(name);
+    }
   });
   return anchors;
 }
+function decodedFragment(fragment) {
+  try {
+    return decodeURIComponent(fragment);
+  } catch {
+    return fragment;
+  }
+}
 function extractLinks(content) {
   const links = [];
   forEachNonFencedLine(content, (rawLine, lineNumber) => {
@@ -308,15 +326,6 @@ async function runCheck(projectDir, options) {
   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;
-    const { navPageId } = localizedPage(pageId, secondaryLocales);
-    if (!navPageIds.has(navPageId)) {
-      if (fix) {
-        addOrphanToNav(projectDir, pageId);
-        fixedOrphans.push(pageId);
-      } else {
-        issues.push({ severity: "warning", message: `"${pageId}" is not in docs.json nav (orphan)`, file: relative(projectDir, filePath) });
-      }
-    }
     let data = {};
     let content = "";
     let lineOffset = 0;
@@ -330,6 +339,15 @@ async function runCheck(projectDir, options) {
       issues.push({ severity: "error", message: `Could not parse frontmatter`, file: relative(projectDir, filePath) });
       continue;
     }
+    const { navPageId } = localizedPage(pageId, secondaryLocales);
+    if (!navPageIds.has(navPageId) && data.hidden !== true) {
+      if (fix) {
+        addOrphanToNav(projectDir, pageId);
+        fixedOrphans.push(pageId);
+      } else {
+        issues.push({ severity: "warning", message: `"${pageId}" is not in docs.json nav (orphan)`, file: relative(projectDir, filePath) });
+      }
+    }
     const rel2 = relative(projectDir, filePath);
     if (!data.title) issues.push({ severity: "warning", message: `Missing "title" in frontmatter`, file: rel2 });
     if (!data.description) issues.push({ severity: "warning", message: `Missing "description" in frontmatter`, file: rel2 });
@@ -360,7 +378,7 @@ async function runCheck(projectDir, options) {
       if (/^(https?:|mailto:|tel:)/i.test(target)) continue;
       if (target.startsWith("#")) {
         const anchor2 = target.slice(1);
-        if (anchor2 && !anchors.has(anchor2)) {
+        if (anchor2 && !anchors.has(decodedFragment(anchor2))) {
           issues.push({ severity: "warning", message: `Broken anchor: "${target}" not found on this page`, file, line });
         }
         continue;
@@ -374,7 +392,7 @@ async function runCheck(projectDir, options) {
       if (!cycle && (isGeneratedApiPath || path.startsWith("/_next") || /\.[a-z0-9]+$/i.test(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(anchor)) {
+      } else if (anchor && !anchorsByPath.get(path)?.has(decodedFragment(anchor))) {
         issues.push({ severity: "warning", message: `Broken anchor: "${target}" \u2014 no heading "#${anchor}" on that page`, file, line });
       }
     }
@@ -566,6 +584,9 @@ async function migrateDocs(options) {
   if (!options.into) {
     const starterConfig = readExistingConfig(projectDir);
     if (starterConfig?.markdown) bundle.docsConfig.markdown = starterConfig.markdown;
+    if (!bundle.docsConfig.navbar?.primary) {
+      bundle.docsConfig.navbar = { ...bundle.docsConfig.navbar, primary: null };
+    }
     bundle.docsConfig.i18n ??= { defaultLocale: "en", locales: [{ code: "en", label: "English" }] };
   }
   const rendered = renderMigrationFiles(bundle, {

package/dist/{chunk-GHEWAGPJ.js → chunk-YX3DTSOG.js}

@@ -3,19 +3,19 @@
 // src/stable-scaffold-release.json
 var stable_scaffold_release_default = {
   schemaVersion: 1,
-  id: "2026-09-28.974e64cc.4715564f",
+  id: "2026-09-28.9729212c.c28e9504",
   source: {
     repository: "thallylabs/starter",
-    commitSha: "974e64cc151edff5b796e5a685e2c6be3cb7004e",
-    treeSha: "02a97be2240e7edab573c824ad7e806db4e807e1",
-    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/974e64cc151edff5b796e5a685e2c6be3cb7004e",
+    commitSha: "9729212cf5ab3455cfdbd2fc284da5d4126068f9",
+    treeSha: "7f28f290c40006051a02de92672ec936b898105f",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/9729212cf5ab3455cfdbd2fc284da5d4126068f9",
     manifestPath: "starter-release.json",
-    manifestSha256: "19df9b99d40fec2b204700c2df49b6f6159c398c416b7260d36b6a9985c7a922"
+    manifestSha256: "0ced61d232d02d73ec46ed9334ce660b2bfdad6cc0476ab93f6e64b90eac6214"
   },
   runtime: {
     repository: "thallylabs/thally",
-    commitSha: "4715564fff1881f2a4a3276e2808df32496b5214",
-    treeSha: "8ff6fffe59e0588f3de406fea0c941b417ab4ac7",
+    commitSha: "c28e9504e473e6ee3e502f35968568b821479520",
+    treeSha: "8fbb42629955add398fdfd9236999d3e3f3cd29a",
     contentSource: "assets",
     identityContractVersion: 1
   },
@@ -24,6 +24,26 @@ var stable_scaffold_release_default = {
 
 // src/previous-scaffold-releases.json
 var previous_scaffold_releases_default = [
+  {
+    schemaVersion: 1,
+    id: "2026-09-28.974e64cc.4715564f",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "974e64cc151edff5b796e5a685e2c6be3cb7004e",
+      treeSha: "02a97be2240e7edab573c824ad7e806db4e807e1",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/974e64cc151edff5b796e5a685e2c6be3cb7004e",
+      manifestPath: "starter-release.json",
+      manifestSha256: "19df9b99d40fec2b204700c2df49b6f6159c398c416b7260d36b6a9985c7a922"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "4715564fff1881f2a4a3276e2808df32496b5214",
+      treeSha: "8ff6fffe59e0588f3de406fea0c941b417ab4ac7",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
   {
     schemaVersion: 1,
     id: "2026-09-23.03d99cfb.f870a2e2",

package/dist/index.js

@@ -3,17 +3,17 @@ import {
   migrateDocs,
   parseFrontmatter,
   runCheck
-} from "./chunk-PJXWW3KP.js";
+} from "./chunk-MCC5PVLL.js";
 import {
   logo,
   scaffold,
   slugify,
   success
-} from "./chunk-D5MH737V.js";
+} from "./chunk-45YUNA3U.js";
 import "./chunk-XYRM4GAT.js";
-import "./chunk-WH4YY5EW.js";
-import "./chunk-AUF4NC7X.js";
-import "./chunk-GHEWAGPJ.js";
+import "./chunk-AQACEZTT.js";
+import "./chunk-H57USRQO.js";
+import "./chunk-YX3DTSOG.js";
 
 // src/index.ts
 import { existsSync as existsSync2, readdirSync } from "fs";
@@ -638,6 +638,10 @@ async function runMigrateCommand() {
     yes,
     skipValidation: flags.includes("--skip-validation")
   });
+  console.log("");
+  console.log(`  Migrated docs: ${result.projectDir}`);
+  const quotedDir = process.platform === "win32" ? `"${result.projectDir.replace(/"/g, '""')}"` : `'${result.projectDir.replace(/'/g, "'\\''")}'`;
+  console.log(`  To preview: cd ${quotedDir} && npm run dev`);
   if (result.validation.content === "failed" || result.validation.build === "failed") process.exitCode = 1;
 }
 async function runScaffoldCommand() {

package/dist/migrate/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-PJXWW3KP.js";
-import "../chunk-D5MH737V.js";
+} from "../chunk-MCC5PVLL.js";
+import "../chunk-45YUNA3U.js";
 import "../chunk-XYRM4GAT.js";
-import "../chunk-WH4YY5EW.js";
-import "../chunk-AUF4NC7X.js";
-import "../chunk-GHEWAGPJ.js";
+import "../chunk-AQACEZTT.js";
+import "../chunk-H57USRQO.js";
+import "../chunk-YX3DTSOG.js";
 export {
   migrateDocs
 };

package/dist/release.js

@@ -3,7 +3,7 @@ import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES,
   isStableScaffoldRelease
-} from "./chunk-GHEWAGPJ.js";
+} from "./chunk-YX3DTSOG.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES,

package/dist/scaffold.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-D5MH737V.js";
+} from "./chunk-45YUNA3U.js";
 import "./chunk-XYRM4GAT.js";
 import {
   STARTER_ARCHIVE_ROOT,
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-WH4YY5EW.js";
-import "./chunk-AUF4NC7X.js";
+} from "./chunk-AQACEZTT.js";
+import "./chunk-H57USRQO.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-GHEWAGPJ.js";
+} from "./chunk-YX3DTSOG.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   STARTER_ARCHIVE_ROOT,

package/dist/starter-sync.js

@@ -8,8 +8,8 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-AUF4NC7X.js";
-import "./chunk-GHEWAGPJ.js";
+} from "./chunk-H57USRQO.js";
+import "./chunk-YX3DTSOG.js";
 export {
   applyStarterRuntimeSyncPlan,
   classifyStarterPath,

package/dist/starter-update.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   downloadStarter
-} from "./chunk-WH4YY5EW.js";
+} from "./chunk-AQACEZTT.js";
 import {
   applyStarterRuntimeSyncPlan,
   mergeStarterOwnershipContracts,
@@ -9,11 +9,11 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-AUF4NC7X.js";
+} from "./chunk-H57USRQO.js";
 import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
-} from "./chunk-GHEWAGPJ.js";
+} from "./chunk-YX3DTSOG.js";
 
 // src/starter-update.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.55",
+  "version": "0.10.57",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -45,7 +45,7 @@
     "@anthropic-ai/sdk": "^0.36.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.8",
-    "@thallylabs/migrate": "0.2.8",
+    "@thallylabs/migrate": "0.2.9",
     "p-limit": "^6.1.0",
     "tar": "^7.5.22",
     "yaml": "^2.6.0"