create-zudo-doc 3.3.0 → 4.0.0

package/dist/prompts.js

@@ -1,5 +1,5 @@
 import * as p from "@clack/prompts";
-import { SINGLE_SCHEMES, FEATURES, SUPPORTED_LANGS } from "./constants.js";
+import { SINGLE_SCHEMES, FEATURES, SUPPORTED_LANGS, THEME_PACKS } from "./constants.js";
 import { validateProjectName } from "./utils.js";
 export async function runPrompts(prefilled = {}) {
     // 1. Project name
@@ -124,6 +124,26 @@ export async function runPrompts(prefilled = {}) {
             respectPrefersColorScheme = respect;
         }
     }
+    // 3.5 Theme pack (ADR #2818 Decision 7) — placed between the color-scheme
+    // block above and the features multiselect below (locked spec, #2823).
+    let themePack;
+    if (prefilled.themePack) {
+        themePack = prefilled.themePack;
+    }
+    else {
+        const result = await p.select({
+            message: "Theme pack:",
+            options: THEME_PACKS.map((t) => ({
+                value: t.slug,
+                label: t.label,
+                hint: t.hint,
+            })),
+            initialValue: "default",
+        });
+        if (p.isCancel(result))
+            process.exit(0);
+        themePack = result;
+    }
     // 4. Features
     let features;
     if (prefilled.features) {
@@ -196,6 +216,7 @@ export async function runPrompts(prefilled = {}) {
         darkScheme,
         respectPrefersColorScheme,
         defaultMode,
+        themePack,
         features,
         explicitlyDisabledFeatures: prefilled.explicitlyDisabledFeatures,
         githubUrl,

package/dist/scaffold.d.ts

@@ -18,5 +18,5 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^3.3.0";
+export declare const ZUDO_DOC_PIN = "^4.0.0";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -24,7 +24,7 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^3.3.0";
+export const ZUDO_DOC_PIN = "^4.0.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -415,9 +415,9 @@ function generatePackageJson(choices) {
         // disabled, reproducible CSS-Modules scoped names (project-relative paths),
         // dev-mode git-restore detection, Tailwind temp-file cleanup, and a
         // near-miss `"use client"` directive scanner.
-        // next.33 added the opt-in hierarchical heading-ID strategy
+        // next.33 added hierarchical heading IDs
         // (Takazudo/zudo-front-builder#871): `markdown.features.headingIds.strategy`.
-        // The generated config + TOC builder use it via settings.headingIdStrategy.
+        // zudo-doc now uses that strategy unconditionally in its package preset.
         // next.35 fixes resolve_links rewriting bare same-page `[text](#anchor)` /
         // `[text](?query)` links to `/<parent-dir>/#anchor` (zudolab/zudo-doc#1948,
         // upstream Takazudo/zudo-front-builder#875).
@@ -447,23 +447,24 @@ function generatePackageJson(choices) {
         // extraWatchPaths rebuilds, and TS-config-loader path canonicalization
         // (Takazudo/zudo-front-builder#1036–#1043). next.45: docs-only. next.46:
         // opt-in dev boot-lazy mode (#1057) + client-router timer lifecycle fixes —
-        // dev-server-only. next.47: dual light/dark syntect themes (themeLight/
+        // dev-server-only. Historical dual light/dark theme support (themeLight/
         // themeDark on CodeHighlightConfig, --shiki-light/--shiki-dark, #1067) plus
         // stricter build-start validation that rejects unknown theme names. next.48:
         // re-export @takazudo/zfb/config from the zfb-shim.d.ts type shim — type-only
         // fix, additive. next.49: client-router WebKit bfcache fix —
         // re-sync the history index + originalLocation on a bfcache restore so
         // browser Back after an SPA navigation returns to the previous page instead
-        // of skipping an entry — runtime-only bug fix, additive. next.50 (current
-        // pin): client-router fix to commit the SPA history entry BEFORE the View
+        // of skipping an entry — runtime-only bug fix, additive. next.50:
+        // client-router fix to commit the SPA history entry BEFORE the View
         // Transition, so on WebKit/iOS a single browser Back after an SPA navigation
         // creates a distinct history entry instead of falling off the site —
-        // runtime-only bug fix, additive. next.51 (current pin): additive public-API
+        // runtime-only bug fix, additive. next.51: additive public-API
         // surface — VNode/VNodeArray/VNodeObject are now exported from
         // "@takazudo/zfb" (#972) — plus removal of the no-op linkValidation.allowExternal
-        // knob (#925); both are non-breaking for a fresh scaffold. A fresh scaffold
-        // sets codeHighlight.themeLight/themeDark for dual-theme syntect output. No
-        // consumer-facing / CLI breaking change. next.52: adds the
+        // knob (#925); both are non-breaking for a fresh scaffold. Highlight config
+        // is package-preset-owned: fresh scaffolds delegate to zudoDoc(), whose
+        // preset selects class mode without emitting theme names project-side.
+        // next.52 adds the
         // `ClientRouter({ preserveHtmlAttrs })` option (zfb#1104) — consumers can
         // declare runtime `<html>` attribute names to preserve across SPA swaps so
         // e.g. `data-sidebar-hidden` / `data-theme` survive (zudolab/zudo-doc#2200).
@@ -501,14 +502,22 @@ function generatePackageJson(choices) {
         // next.76: routine toolchain bump from next.75, adopted in
         // lockstep with the root package.json pins. No consumer-facing / CLI change.
         // next.77: router persistence/history fixes and runtime island remount
-        // support, adopted in lockstep with the root package.json pins. No
-        // scaffold API change. next.78 (current pin): production HTML minification
-        // support via minifyHtml, adopted as a zudo-doc default through settings.
-        "@takazudo/zfb": "0.1.0-next.78",
-        "@takazudo/zfb-runtime": "0.1.0-next.78",
+        // support. next.78 added production HTML minification. next.81 added the
+        // package-root semantic highlight API plus island resource delivery
+        // (zfb#1633/#1643). next.83 completes bundle.exclude dependency staging
+        // for package-owned overlay routes (zfb#1645/#1649); next.84 canonicalizes
+        // linked package-route identity so SSR shares one framework singleton
+        // (zfb#1650/#1651). next.85 also remaps absolute project imports from
+        // virtual host modules into the staged project graph, preserving that
+        // singleton across host-callable wiring (zfb#1652/#1653). The zfb family
+        // must stay in lockstep because the WASM browser entry depends on its
+        // resource-aware island pipeline.
+        "@takazudo/zfb": "0.1.0-next.87",
+        "@takazudo/zfb-runtime": "0.1.0-next.87",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.78",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.87",
+        "@takazudo/zfb-md-wasm": "0.1.0-next.87",
         // @takazudo/zudo-doc — published from this monorepo via
         // .github/workflows/publish-zudo-doc.yml. The pin here is bumped in
         // lockstep by scripts/release-create-zudo-doc.sh whenever zudo-doc's
@@ -543,6 +552,7 @@ function generatePackageJson(choices) {
         // compiles. Same pin as host. Caught by W6B (#1735) consumer-build
         // verification.
         "preact-render-to-string": "^6.6.6",
+        // Retained until #2742 atomically moves HTML Preview to zfb-md-wasm.
         shiki: "^4.0.2",
         "@shikijs/transformers": "^4.0.0",
         "gray-matter": "^4.0.0",
@@ -587,7 +597,7 @@ function generatePackageJson(choices) {
         // same reason. This is the ACCEPTED, permanent contract per #2668 — see
         // the "@takazudo/zdtp dep implication" note in
         // packages/zudo-doc/docs/adr/route-injection-seam.md.
-        "@takazudo/zdtp": "0.4.6",
+        "@takazudo/zdtp": "0.4.9",
     };
     const devDeps = {
         "@tailwindcss/vite": "^4.2.0",
@@ -608,11 +618,11 @@ function generatePackageJson(choices) {
         // required regardless of this feature flag.)
         // @takazudo/zudo-doc has @takazudo/zudo-doc-history-server as an optional
         // peer dep. When docHistory is selected the zfb plugin
-        // (@takazudo/zudo-doc/plugins/doc-history) eagerly imports
-        // @takazudo/zudo-doc/integrations/doc-history which in turn imports
+        // (@takazudo/zudo-doc/plugins/doc-history) eagerly imports its internal
+        // doc-history helpers, which in turn import
         // @takazudo/zudo-doc-history-server/git-history. Without this dep the
         // plugin host fails at init with ERR_MODULE_NOT_FOUND — W8A (#1739).
-        deps["@takazudo/zudo-doc-history-server"] = "^3.3.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^4.0.0";
         // tsx is no longer needed here: the relocated package plugin imports the
         // runner directly (no `tsx -e` spawn) since the package ships compiled
         // dist/ — package-first migration #2321 (#2337).
@@ -620,17 +630,6 @@ function generatePackageJson(choices) {
     // claudeResources: tsx is no longer needed. The relocated package plugin
     // (@takazudo/zudo-doc/plugins/claude-resources) imports the runner directly
     // since the package ships compiled dist/ — package-first migration #2321 (#2337).
-    if (choices.features.includes("tagGovernance")) {
-        // gray-matter is already in `deps` unconditionally (base template uses it),
-        // so we only add the tooling deps specific to tags:audit / tags:suggest.
-        devDeps["string-similarity"] = "^4.0.4";
-        devDeps["@types/string-similarity"] = "^4.0.2";
-        devDeps["pluralize"] = "^8.0.0";
-        devDeps["@types/pluralize"] = "^0.0.33";
-        devDeps["picocolors"] = "^1.1.1";
-        devDeps["@inquirer/prompts"] = "^8.4.2";
-        devDeps["tsx"] = "^4.21.0";
-    }
     // check:html and gen:z-index/check:z-index are DROPPED from the default
     // scaffold (locked decision, epic #2651 #2660 work item 6):
     //   - `.htmlvalidate.json` no longer ships — html-validate becomes an
@@ -646,11 +645,12 @@ function generatePackageJson(choices) {
         check: "zfb check",
     };
     if (choices.features.includes("tagGovernance")) {
-        // tags-audit bin is provided by @takazudo/zudo-doc (S9b #2334);
-        // tsx is still required as a devDep because the bin's runner imports
-        // the project's TypeScript config files at runtime via tsx.
-        scripts["tags:audit"] = "tags-audit";
-        scripts["tags:suggest"] = "tsx scripts/tags-suggest.ts";
+        // Both package-owned bins load the same explicit project config. `--`
+        // supplied by pnpm/npm is preserved by the runners for forwarded options.
+        scripts["tags:audit"] =
+            "tags-audit --config src/config/tag-vocabulary.ts";
+        scripts["tags:suggest"] =
+            "tags-suggest --config src/config/tag-vocabulary.ts";
     }
     if (choices.features.includes("skillSymlinker")) {
         scripts["setup:doc-skill"] = "bash scripts/setup-doc-skill.sh";

package/dist/zfb-config-gen.js

@@ -32,6 +32,9 @@ export const DEFAULT_MIRROR = {
         darkScheme: "Default Dark",
         respectPrefersColorScheme: true,
     },
+    themePack: "default",
+    themePackSwitcher: false,
+    themePacks: undefined,
     siteName: "Docs",
     minifyHtml: true,
     defaultLocale: "en",
@@ -152,6 +155,12 @@ function buildDesiredConfig(choices) {
             respectPrefersColorScheme: choices.respectPrefersColorScheme ?? true,
         };
     }
+    // ── Theme pack (ADR #2818 Decision 7) ────────────────────────────────
+    // themePacks (the enabled-slugs allowlist) is intentionally NOT set here —
+    // it is an advanced, hand-edited-only field with no CLI/prompt surface
+    // (locked spec, #2823).
+    desired.themePack = choices.themePack ?? "default";
+    desired.themePackSwitcher = choices.features.includes("themePackSwitcher");
     // ── i18n ──────────────────────────────────────────────────────────────
     desired.defaultLocale = choices.defaultLang ?? "en";
     if (choices.features.includes("i18n")) {
@@ -169,7 +178,7 @@ function buildDesiredConfig(choices) {
     // ── Misc site fields ──────────────────────────────────────────────────
     desired.minifyHtml = choices.minifyHtml ?? true;
     desired.noindex = choices.features.includes("noindex");
-    const rawGithubUrl = (choices.githubUrl ?? "").trim();
+    const rawGithubUrl = typeof choices.githubUrl === "string" ? choices.githubUrl.trim() : "";
     desired.githubUrl = rawGithubUrl ? rawGithubUrl : false;
     desired.cjkFriendly = choices.cjkFriendly ?? false;
     // ── Meta tags ─────────────────────────────────────────────────────────
@@ -194,12 +203,11 @@ function buildDesiredConfig(choices) {
     // ── Tags / docs ───────────────────────────────────────────────────────
     desired.docTags = choices.features.includes("docTags");
     if (choices.features.includes("tagGovernance")) {
-        desired.tagGovernance = "warn";
-        desired.tagVocabulary = true;
-        // Wired to the src/config/tag-vocabulary.ts starter file the
-        // tagGovernance feature module emits (single source of truth shared
-        // with scripts/tags-audit.ts and scripts/tags-suggest.ts).
-        desired.tagVocabularyEntries = raw("tagVocabulary");
+        // The explicit tag CLI config is also the zfb source of truth, so the
+        // package-owned bins and runtime settings cannot drift.
+        desired.tagGovernance = raw("tagCliConfig.governance");
+        desired.tagVocabulary = raw("tagCliConfig.vocabularyActive");
+        desired.tagVocabularyEntries = raw("tagCliConfig.vocabulary");
     }
     else {
         desired.tagGovernance = "off";
@@ -295,11 +303,8 @@ function buildDesiredConfig(choices) {
     }
     desired.headerNav = headerNav;
     if (choices.headerRightItems !== undefined) {
-        // User-supplied override (including empty array) — emit verbatim, minus
-        // a defensive strip of "design-token-panel" when the feature is off.
-        desired.headerRightItems = choices.headerRightItems.filter((item) => !(item.type === "trigger" &&
-            item.trigger === "design-token-panel" &&
-            !choices.features.includes("designTokenPanel")));
+        // User-supplied override (including empty array) — emit verbatim.
+        desired.headerRightItems = choices.headerRightItems;
     }
     else {
         const items = [];
@@ -309,7 +314,9 @@ function buildDesiredConfig(choices) {
         if (choices.features.includes("versioning")) {
             items.push({ type: "component", component: "version-switcher" });
         }
-        items.push({ type: "component", component: "github-link" });
+        if (rawGithubUrl) {
+            items.push({ type: "component", component: "github-link" });
+        }
         items.push({ type: "component", component: "theme-toggle" });
         if (choices.features.includes("search")) {
             items.push({ type: "component", component: "search" });
@@ -332,6 +339,9 @@ function buildDesiredConfig(choices) {
 const FIELD_ORDER = [
     "colorScheme",
     "colorMode",
+    "themePack",
+    "themePackSwitcher",
+    "themePacks",
     "siteName",
     "defaultLocale",
     "locales",
@@ -395,7 +405,7 @@ export function generateZfbConfig(choices) {
     lines.push(`import { defineConfig } from "zfb/config";`);
     lines.push(`import { zudoDoc } from "@takazudo/zudo-doc/config";`);
     if (choices.features.includes("tagGovernance")) {
-        lines.push(`import { tagVocabulary } from "./src/config/tag-vocabulary";`);
+        lines.push(`import tagCliConfig from "./src/config/tag-vocabulary";`);
     }
     lines.push(``);
     lines.push(`export default defineConfig(`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zudo-doc",
-  "version": "3.3.0",
+  "version": "4.0.0",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",

package/templates/base/pages/docs/[[...slug]].tsx

@@ -5,19 +5,23 @@
 // `zfb dev` (real pre-existing gap in zfb's dev-mode dynamic-route rendering,
 // distinct from the `/`-injection gap zfb#1227; empirically confirmed on
 // #2653). This stub reconstructs the doc route from scratch using ONLY the
-// three sanctioned package entrypoints — no `pages/lib`, no `@/config`:
+// sanctioned package entrypoints — no `pages/lib`, no `@/config`:
 //   1. the `virtual:zudo-doc-route-context` virtual module (serializable
 //      settings/translations/tagVocabulary/colorSchemes payload),
-//   2. `@takazudo/zudo-doc/route-context` (`createRouteContext`), and
-//   3. `@takazudo/zudo-doc/chrome` (`createChrome`).
+//   2. `@takazudo/zudo-doc/route-context` (`createRouteContext`),
+//   3. `@takazudo/zudo-doc/chrome` (`createChrome`), and
+//   4. `virtual:zudo-doc-chrome-bindings` (the host-callables channel).
+// The bindings import is unconditional: the routes plugin supplies an empty
+// object when `chromeBindingsModule` is unset, while configured projects get
+// their MDX/chrome bindings without editing this stub.
 // Makes `/docs/getting-started/` return 200 in BOTH `zfb dev` and `zfb build`
 // (see the "TM negative guard" case in route-injection-build.slow.test.ts for
 // the no-stub 404 proof this fixes).
 //
 // docHistory note: when the docHistory feature is selected, the generator
 // patches this file to statically import DocHistory from
-// "@takazudo/zudo-doc/doc-history" and pass it to createChrome's hostBindings
-// (second) argument via defineChromeBindings({ DocHistory }) —
+// "@takazudo/zudo-doc/doc-history" and merge it over chromeBindings in
+// createChrome's hostBindings (second) argument —
 // DocHistory's chrome-derive default is a no-op stub (unlike
 // DesignTokenPanelBootstrap, which the package auto-defaults), so without
 // that patch the doc-history button never hydrates on this route.
@@ -29,10 +33,11 @@ import {
   type RouteContextPayload,
 } from "@takazudo/zudo-doc/route-context";
 import { createChrome } from "@takazudo/zudo-doc/chrome";
+import { chromeBindings } from "virtual:zudo-doc-chrome-bindings";
 
 const ctx = routeContext as unknown as RouteContextPayload;
 const routeCtx = createRouteContext(ctx);
-const { renderDocPage } = createChrome(routeCtx);
+const { renderDocPage } = createChrome(routeCtx, chromeBindings);
 
 export const frontmatter = { title: "Docs" };
 

package/templates/features/i18n/files/pages/[locale]/docs/[[...slug]].tsx

@@ -2,8 +2,11 @@
 /** @jsxImportSource preact */
 // Locked manifest (#2653 Decision 4, i18n addendum): the locale-prefixed
 // counterpart of pages/docs/[[...slug]].tsx — required for the same reason
-// (injected DYNAMIC routes 404 in `zfb dev`). Self-contained: only the three
-// sanctioned package entrypoints — no `pages/lib`, no `@/config`. Mirrors
+// (injected DYNAMIC routes 404 in `zfb dev`). Self-contained: only the
+// sanctioned package entrypoints — no `pages/lib`, no `@/config`. The
+// `virtual:zudo-doc-chrome-bindings` import is unconditional, just like the
+// default-locale stub: the routes plugin supplies `{}` when no host module is
+// configured. Mirrors
 // the package's own `routes/locale-docs-slug.tsx` shape, rebuilt from the
 // route-context payload instead of the package-internal `_context.js`.
 //
@@ -28,10 +31,11 @@ import {
   type RouteContextPayload,
 } from "@takazudo/zudo-doc/route-context";
 import { createChrome } from "@takazudo/zudo-doc/chrome";
+import { chromeBindings } from "virtual:zudo-doc-chrome-bindings";
 
 const ctx = routeContext as unknown as RouteContextPayload;
 const routeCtx = createRouteContext(ctx);
-const { renderDocPage } = createChrome(routeCtx);
+const { renderDocPage } = createChrome(routeCtx, chromeBindings);
 
 export const frontmatter = { title: "Docs" };
 
@@ -59,7 +63,7 @@ export function paths(): Array<{
       result.push({
         params: { locale, slug: item.slugParams },
         props: {
-          ...(item.props as Record<string, unknown>),
+          ...(item.props as unknown as Record<string, unknown>),
           // Fallback pages exist only in the default locale, so their
           // doc-history lives under the EN docsDir; translated pages read
           // their own locale dir.

package/templates/features/tagGovernance/files/scripts/tags-audit.ts

@@ -1,131 +0,0 @@
-#!/usr/bin/env -S tsx
-/**
- * scripts/tags-audit.ts
- *
- * Thin re-export shim — the audit logic lives in @takazudo/zudo-doc/tags-audit
- * (S9b #2334). This file exists for backward-compat with any project-side
- * imports of these functions (e.g. custom scripts that import helpers from here).
- *
- * The `tags:audit` package.json script does not invoke this file directly;
- * it uses the `tags-audit` package bin from @takazudo/zudo-doc instead.
- *
- * CLI usage (still works via tsx for debugging):
- *   tsx scripts/tags-audit.ts [--fix] [--ci] [--json]
- */
-
-import { join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import pc from "picocolors";
-import pluralize from "pluralize";
-import stringSimilarity from "string-similarity";
-
-import { settings } from "../src/config/settings";
-import { tagVocabulary } from "../src/config/tag-vocabulary";
-
-// Re-export everything from the package core so existing callers continue
-// to work unchanged.
-export {
-  audit,
-  applyFixes,
-  buildIndex,
-  collectMdxFiles,
-  computeRewrites,
-  formatTextReport,
-  hasHardIssues,
-  normalizeTags,
-  rewriteAliasesByteStable,
-} from "@takazudo/zudo-doc/tags-audit";
-export type {
-  AliasIssue,
-  AuditOptions,
-  AuditReport,
-  DeprecatedIssue,
-  NearDuplicatePair,
-  NearDupHelpers,
-  TagVocabularyEntry,
-  UnknownIssue,
-} from "@takazudo/zudo-doc/tags-audit";
-
-// Backward-compat: expose findNearDuplicates with project helpers pre-bound.
-import { findNearDuplicates as _findNearDuplicates } from "@takazudo/zudo-doc/tags-audit";
-export function findNearDuplicates(
-  tags: string[],
-): import("@takazudo/zudo-doc/tags-audit").NearDuplicatePair[] {
-  return _findNearDuplicates(tags, {
-    singular: pluralize.singular,
-    compareTwoStrings: stringSimilarity.compareTwoStrings,
-  });
-}
-
-// ── CLI runner (legacy — package bin is preferred) ─────────────────────────
-
-const __filename = fileURLToPath(import.meta.url);
-const isMain =
-  process.argv[1] !== undefined &&
-  resolve(process.argv[1]) === resolve(__filename);
-
-if (isMain) {
-  const { audit: coreAudit, computeRewrites: coreComputeRewrites, applyFixes: coreApplyFixes, hasHardIssues: coreHasHardIssues, formatTextReport: coreFormatReport } =
-    await import("@takazudo/zudo-doc/tags-audit");
-
-  const argv = process.argv.slice(2);
-  const flags = {
-    fix: argv.includes("--fix"),
-    ci: argv.includes("--ci"),
-    json: argv.includes("--json"),
-  };
-
-  const ROOT_DIR = resolve(__filename, "..", "..");
-  const docsDir = join(ROOT_DIR, settings.docsDir);
-  const localeDirs = Object.values(settings.locales ?? {}).map((l) =>
-    join(ROOT_DIR, l.dir),
-  );
-  const contentDirs = [docsDir, ...localeDirs];
-  const vocabularyActive =
-    Boolean(settings.tagVocabulary) && settings.tagGovernance !== "off";
-
-  if (flags.fix) {
-    const rewrites = coreComputeRewrites(tagVocabulary);
-    const touched = await coreApplyFixes(contentDirs, rewrites, ROOT_DIR);
-    if (flags.json) {
-      process.stdout.write(JSON.stringify({ fixed: touched }, null, 2) + "\n");
-    } else if (touched.length === 0) {
-      console.log(pc.green("✓ No alias rewrites needed"));
-    } else {
-      console.log(pc.green(`✓ Rewrote aliases in ${touched.length} file(s):`));
-      for (const f of touched) console.log(`  ${f}`);
-    }
-    process.exit(0);
-  }
-
-  const report = await coreAudit({
-    rootDir: ROOT_DIR,
-    contentDirs,
-    vocabulary: tagVocabulary,
-    governance: settings.tagGovernance,
-    vocabularyActive,
-    nearDupHelpers: {
-      singular: pluralize.singular,
-      compareTwoStrings: stringSimilarity.compareTwoStrings,
-    },
-  });
-
-  if (flags.json) {
-    process.stdout.write(JSON.stringify(report, null, 2) + "\n");
-  } else {
-    console.log(coreFormatReport(report, settings.tagGovernance, vocabularyActive, pc));
-  }
-
-  const hardIssues = coreHasHardIssues(report);
-  if (hardIssues && (flags.ci || settings.tagGovernance === "strict")) {
-    process.exit(1);
-  }
-  if (hardIssues) {
-    console.error(
-      pc.yellow(
-        "Note: tag issues found but running in non-strict mode (exit 0). Use --ci to fail.",
-      ),
-    );
-  }
-}