create-thally-docs 0.10.115 → 0.10.117

package/dist/{chunk-WFJCCE6I.js → chunk-7UPLZRN4.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   downloadStarter
-} from "./chunk-P6WAKVEG.js";
+} from "./chunk-JKC4FXSW.js";
 import {
   applyStarterRuntimeSyncPlan,
   captureTargetPrecondition,
@@ -10,11 +10,11 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-BCULZEV4.js";
+} from "./chunk-QPHUUFSH.js";
 import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
-} from "./chunk-IE7TTBLT.js";
+} from "./chunk-FMVUFWZP.js";
 
 // src/starter-update.ts
 import {

package/dist/{chunk-IE7TTBLT.js → chunk-FMVUFWZP.js}

@@ -3,19 +3,19 @@
 // src/stable-scaffold-release.json
 var stable_scaffold_release_default = {
   schemaVersion: 1,
-  id: "2026-10-19.08f775a3.6184037a",
+  id: "2026-10-19.3eb7a615.8f80ea57",
   source: {
     repository: "thallylabs/starter",
-    commitSha: "08f775a3625a2e915c8f642ebdcb89de8b83c037",
-    treeSha: "634ceac37f7d617c12b31ec27ca929290f9e76e7",
-    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/08f775a3625a2e915c8f642ebdcb89de8b83c037",
+    commitSha: "3eb7a615dbd2025d59fa71ebd02d88c6a55ede1b",
+    treeSha: "3acac4a0666cba2ac95aadccdf6aaf3bf701ed76",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/3eb7a615dbd2025d59fa71ebd02d88c6a55ede1b",
     manifestPath: "starter-release.json",
-    manifestSha256: "b3602f7a3e82d9c394e4fa70949fe2dde03e2a0afa6454a15ad60ec193ad3ebb"
+    manifestSha256: "ffe5a8562cda5bbe2a1a73f92b5c4db57e6dd1ec6cd66686db867ea06a87a19c"
   },
   runtime: {
     repository: "thallylabs/thally",
-    commitSha: "6184037a97e007962e569d51b52d95829f3b29db",
-    treeSha: "05622ff5fd9dcaf4bfca3b8dc0eb2ff68c94a08d",
+    commitSha: "8f80ea5712a97574ad3f86975301754c3a223912",
+    treeSha: "e52a9c74d8a362e345c96e4097ce0631ede24157",
     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-10-19.08f775a3.6184037a",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "08f775a3625a2e915c8f642ebdcb89de8b83c037",
+      treeSha: "634ceac37f7d617c12b31ec27ca929290f9e76e7",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/08f775a3625a2e915c8f642ebdcb89de8b83c037",
+      manifestPath: "starter-release.json",
+      manifestSha256: "b3602f7a3e82d9c394e4fa70949fe2dde03e2a0afa6454a15ad60ec193ad3ebb"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "6184037a97e007962e569d51b52d95829f3b29db",
+      treeSha: "05622ff5fd9dcaf4bfca3b8dc0eb2ff68c94a08d",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
   {
     schemaVersion: 1,
     id: "2026-10-19.9100bd61.ea27128c",

package/dist/{chunk-3XHWWST2.js → chunk-HSPM676Z.js}

@@ -68,13 +68,16 @@ function parseDocReference(raw) {
 }
 var canonicalRef = (value) => value.trim().replace(/\\/g, "/").replace(/^(?:\.\/)+/, "").replace(/^\/+/, "").replace(/^[a-z][a-z0-9+.-]*:\/\/[^/?#]*/i, (origin) => origin.toLowerCase());
 var baseName = (value) => canonicalRef(value).split(/[?#]/, 1)[0].split("/").filter(Boolean).pop() ?? "";
+function pinnedSpec(specRef, specs) {
+  const wanted = canonicalRef(specRef);
+  if (!wanted) return void 0;
+  const wantedBase = baseName(specRef);
+  return specs.find((entry) => canonicalRef(entry.source) === wanted) ?? specs.find((entry) => canonicalRef(entry.source).toLowerCase() === wanted.toLowerCase()) ?? (wantedBase ? specs.find((entry) => baseName(entry.source) === wantedBase) : void 0) ?? (wantedBase ? specs.find((entry) => baseName(entry.source).toLowerCase() === wantedBase.toLowerCase()) : void 0);
+}
 function pageState(ref, specs) {
   const judge = (spec) => spec.document === void 0 ? "unknown" : ref.webhook ? webhookState(spec.document, ref.path, spec.overrides) : operationState(spec.document, ref.method, ref.path, spec.overrides);
   if (ref.specRef) {
-    const wanted = canonicalRef(ref.specRef);
-    if (!wanted) return "unknown";
-    const wantedBase = baseName(ref.specRef);
-    const spec = specs.find((entry) => canonicalRef(entry.source) === wanted) ?? specs.find((entry) => canonicalRef(entry.source).toLowerCase() === wanted.toLowerCase()) ?? (wantedBase ? specs.find((entry) => baseName(entry.source) === wantedBase) : void 0) ?? (wantedBase ? specs.find((entry) => baseName(entry.source).toLowerCase() === wantedBase.toLowerCase()) : void 0);
+    const spec = pinnedSpec(ref.specRef, specs);
     return spec ? judge(spec) : "unknown";
   }
   const states = specs.map(judge);
@@ -82,6 +85,39 @@ function pageState(ref, specs) {
   if (specs.some((spec) => spec.document === void 0)) return "unknown";
   return states.find((state) => state === "hidden" || state === "excluded") ?? "unknown";
 }
+var firstSet = (...values) => values.find((value) => value !== void 0 && value !== null);
+function listedOperations(ref, spec) {
+  const document = spec?.document;
+  if (!isObj(document)) return [];
+  const entries = ref.webhook ? document.webhooks : document.paths;
+  const entry = isObj(entries) && Object.hasOwn(entries, ref.path) ? entries[ref.path] : void 0;
+  if (!isObj(entry)) return [];
+  const { chain, item } = viewEntry(document, entry);
+  const overrides = isObj(spec?.overrides) ? spec.overrides : {};
+  return METHODS.flatMap((verb) => {
+    const operation = item[verb];
+    if (!isObj(operation) || !ref.webhook && verb !== ref.method.toLowerCase()) return [];
+    const override = overrides[`${ref.webhook ? "WEBHOOK " : ""}${verb.toUpperCase()} ${ref.path}`];
+    return visibility(chain, operation, override) === "visible" ? [{ verb, operation, override: isObj(override) ? override : {} }] : [];
+  });
+}
+function operationDescription(ref, specs) {
+  for (const spec of ref.specRef ? [pinnedSpec(ref.specRef, specs)] : specs) {
+    const listed = listedOperations(ref, spec);
+    if (listed.length === 0) continue;
+    const rank = ({ verb, operation, override }) => ({
+      group: String(override.group || spec?.webhookGroup || "Webhooks"),
+      title: String(firstSet(override.title, operation.summary, operation.operationId) ?? `${verb.toUpperCase()} ${ref.path}`)
+    });
+    const [first] = ref.webhook ? listed.sort((a, b) => {
+      const [left, right] = [rank(a), rank(b)];
+      return left.group === right.group ? left.title.localeCompare(right.title) : left.group.localeCompare(right.group);
+    }) : listed;
+    const description = firstSet(first.override.description, first.operation.description, first.operation.summary);
+    return typeof description === "string" && description.trim() ? description : void 0;
+  }
+  return void 0;
+}
 function resolveLocalRef(document, ref) {
   if (ref !== "#" && !ref.startsWith("#/")) return void 0;
   let node = document;
@@ -268,7 +304,7 @@ function manualApiProblems(file, data, hasOpenApiReference, mdx, docsApi) {
 
 // src/check.ts
 import { projectNavigationContract } from "@thallylabs/core/navigation";
-import { slugify } from "@thallylabs/core/slugify";
+import { plainInlineText, slugify } from "@thallylabs/core/slugify";
 import { validateIntegrations } from "@thallylabs/migrate";
 
 // src/external-links.ts
@@ -542,7 +578,7 @@ function extractStepHeadings(content) {
         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(title), explicit: !!id });
+          steps.push({ line: node.position?.start.line ?? 0, base: id || slugify(plainInlineText(title)), explicit: !!id });
         }
       }
     }
@@ -662,6 +698,7 @@ function resolveDynamicRedirectDestination(redirect, match) {
   });
 }
 var MAX_REDIRECT_HOPS = 20;
+var MISSING_DESCRIPTION = 'Missing "description" in frontmatter';
 function resolveLink(target, redirects, dynamicRedirects = []) {
   let current = target;
   let anchor;
@@ -771,12 +808,16 @@ function checkTabApiGroups(projectDir, tab, locale, versions, issues) {
     });
   }
 }
-function checkUnpublishedOperationPages(projectDir, tabs, pages, issues) {
+function checkOperationPages(projectDir, tabs, pages, issues) {
   if (pages.length === 0) return;
-  const specs = tabs.filter((tab) => !tab.hidden && typeof tab.api?.source === "string").map((tab) => loadCheckSpec(projectDir, tab.api.source, tab.api.overrides));
-  if (specs.length === 0) return;
-  for (const { file, reference } of pages) {
-    const state = pageState(reference, specs);
+  const load = (hidden) => tabs.filter((tab) => Boolean(tab.hidden) === hidden && typeof tab.api?.source === "string").map((tab) => {
+    const api = tab.api;
+    return { ...loadCheckSpec(projectDir, api.source, api.overrides), ...typeof api.webhookGroup === "string" ? { webhookGroup: api.webhookGroup } : {} };
+  });
+  const specs = load(false);
+  const described = pages.some((page) => !page.hasDescription) ? [...specs, ...load(true)] : specs;
+  for (const { file, reference, hasDescription } of pages) {
+    const state = specs.length > 0 ? pageState(reference, specs) : "unknown";
     if (state === "hidden" || state === "excluded") {
       const operation = `${reference.specRef ? `${reference.specRef} ` : ""}${reference.method} ${reference.path}`;
       issues.push({
@@ -784,6 +825,8 @@ function checkUnpublishedOperationPages(projectDir, tabs, pages, issues) {
         file,
         message: `page ${file} points at ${state} operation ${operation} and is not published: it returns 404 and is left out of navigation, search, sitemap and llms.txt. Publish the operation or point the page at another one`
       });
+    } else if (!hasDescription && operationDescription(reference, described) === void 0) {
+      issues.push({ severity: "warning", message: MISSING_DESCRIPTION, file });
     }
   }
 }
@@ -916,12 +959,12 @@ async function runCheck(projectDir, options) {
     }
     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 });
+    const reference = parseDocReference(data.openapi);
+    if (!data.description && !reference) issues.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 });
     }
-    const reference = parseDocReference(data.openapi);
-    if (reference) operationPages.push({ file: rel2, reference });
+    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 });
     }
@@ -994,7 +1037,7 @@ async function runCheck(projectDir, options) {
     if (tab.api?.source) validateOpenApi(projectDir, tab.api.source, issues, tab.api.overrides);
   }
   checkPublicSpecs(projectDir, config.tabs, issues);
-  checkUnpublishedOperationPages(projectDir, config.tabs, operationPages, issues);
+  checkOperationPages(projectDir, config.tabs, operationPages, issues);
   checkApiGroupKeys(projectDir, config, issues);
   if (options.external && externalLinks.length > 0) {
     issues.push(...await checkExternalLinks(externalLinks, options.externalLinkOptions));

package/dist/{chunk-P6WAKVEG.js → chunk-JKC4FXSW.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-L2YCVQBR.js";
 import {
   readStarterReleaseManifest
-} from "./chunk-BCULZEV4.js";
+} from "./chunk-QPHUUFSH.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-IE7TTBLT.js";
+} from "./chunk-FMVUFWZP.js";
 
 // src/download.ts
 import { Readable, Transform, pipeline } from "stream";

package/dist/{chunk-BCULZEV4.js → chunk-QPHUUFSH.js}

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

package/dist/{chunk-6DRDKMRW.js → chunk-SVB25WSN.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-J7255UQA.js";
 import {
   downloadStarter
-} from "./chunk-P6WAKVEG.js";
+} from "./chunk-JKC4FXSW.js";
 import {
   terminal
 } from "./chunk-L2YCVQBR.js";

package/dist/{chunk-BWMPANPL.js → chunk-XDSBT5EE.js}

@@ -8,7 +8,7 @@ import {
   installDeps,
   runProjectCommand,
   scaffold
-} from "./chunk-6DRDKMRW.js";
+} from "./chunk-SVB25WSN.js";
 import {
   pruneMissingSiteLinks
 } from "./chunk-UG3OXVLE.js";

package/dist/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-BWMPANPL.js";
+} from "./chunk-XDSBT5EE.js";
 import {
   parseFrontmatter,
   runCheck
-} from "./chunk-3XHWWST2.js";
+} from "./chunk-HSPM676Z.js";
 import "./chunk-KDLP27DS.js";
 import {
   logo,
@@ -13,17 +13,17 @@ import {
   scaffold,
   slugify,
   success
-} from "./chunk-6DRDKMRW.js";
+} from "./chunk-SVB25WSN.js";
 import "./chunk-UG3OXVLE.js";
 import "./chunk-J7255UQA.js";
-import "./chunk-P6WAKVEG.js";
+import "./chunk-JKC4FXSW.js";
 import {
   acquireTerminalAccent,
   formatHelp,
   terminal
 } from "./chunk-L2YCVQBR.js";
-import "./chunk-BCULZEV4.js";
-import "./chunk-IE7TTBLT.js";
+import "./chunk-QPHUUFSH.js";
+import "./chunk-FMVUFWZP.js";
 
 // src/index.ts
 import { existsSync as existsSync2, readdirSync } from "fs";

package/dist/migrate/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-BWMPANPL.js";
+} from "../chunk-XDSBT5EE.js";
 import "../chunk-KDLP27DS.js";
-import "../chunk-6DRDKMRW.js";
+import "../chunk-SVB25WSN.js";
 import "../chunk-UG3OXVLE.js";
 import "../chunk-J7255UQA.js";
-import "../chunk-P6WAKVEG.js";
+import "../chunk-JKC4FXSW.js";
 import "../chunk-L2YCVQBR.js";
-import "../chunk-BCULZEV4.js";
-import "../chunk-IE7TTBLT.js";
+import "../chunk-QPHUUFSH.js";
+import "../chunk-FMVUFWZP.js";
 export {
   migrateDocs
 };

package/dist/migration-worker.js

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

package/dist/release.js

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

package/dist/scaffold.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-6DRDKMRW.js";
+} from "./chunk-SVB25WSN.js";
 import "./chunk-UG3OXVLE.js";
 import "./chunk-J7255UQA.js";
 import {
@@ -9,12 +9,12 @@ import {
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-P6WAKVEG.js";
+} from "./chunk-JKC4FXSW.js";
 import "./chunk-L2YCVQBR.js";
-import "./chunk-BCULZEV4.js";
+import "./chunk-QPHUUFSH.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-IE7TTBLT.js";
+} from "./chunk-FMVUFWZP.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   STARTER_ARCHIVE_ROOT,

package/dist/starter-sync.js

@@ -9,8 +9,8 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-BCULZEV4.js";
-import "./chunk-IE7TTBLT.js";
+} from "./chunk-QPHUUFSH.js";
+import "./chunk-FMVUFWZP.js";
 export {
   applyStarterRuntimeSyncPlan,
   captureTargetPrecondition,

package/dist/starter-update.js

@@ -6,11 +6,11 @@ import {
   resolveStarterUpdateBase,
   starterReleaseProviderError,
   updateStarterProject
-} from "./chunk-WFJCCE6I.js";
-import "./chunk-P6WAKVEG.js";
+} from "./chunk-7UPLZRN4.js";
+import "./chunk-JKC4FXSW.js";
 import "./chunk-L2YCVQBR.js";
-import "./chunk-BCULZEV4.js";
-import "./chunk-IE7TTBLT.js";
+import "./chunk-QPHUUFSH.js";
+import "./chunk-FMVUFWZP.js";
 export {
   fetchStarterReleaseHint,
   resolveManualReviewMutations,

package/dist/starter-upgrade-canary.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   updateStarterProject
-} from "./chunk-WFJCCE6I.js";
+} from "./chunk-7UPLZRN4.js";
 import {
   downloadStarter
-} from "./chunk-P6WAKVEG.js";
+} from "./chunk-JKC4FXSW.js";
 import "./chunk-L2YCVQBR.js";
 import {
   classifyStarterPath,
   mergeStarterOwnershipContracts,
   readStarterReleaseManifest
-} from "./chunk-BCULZEV4.js";
+} from "./chunk-QPHUUFSH.js";
 import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
-} from "./chunk-IE7TTBLT.js";
+} from "./chunk-FMVUFWZP.js";
 
 // src/starter-upgrade-canary.ts
 import { createHash } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.115",
+  "version": "0.10.117",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -53,8 +53,8 @@
     "@anthropic-ai/sdk": "^0.36.0",
     "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
-    "@thallylabs/core": "0.2.16",
-    "@thallylabs/migrate": "0.2.40",
+    "@thallylabs/core": "0.2.17",
+    "@thallylabs/migrate": "0.2.41",
     "p-limit": "^6.1.0",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",