create-thally-docs 0.10.78 → 0.10.80

package/README.md

@@ -29,6 +29,30 @@ Dependency installation is deliberately opt-in so the scaffold finishes in
 seconds. Pass `--install` to run it immediately, or `--no-install` to skip the
 interactive question explicitly.
 
+## Terminal output
+
+Interactive terminals show the THALLY wordmark, task headings, and live progress.
+The wordmark adapts to narrow terminals. Output automatically
+uses plain text in CI, when output is not a TTY, with `TERM=dumb`, or when
+`NO_COLOR` is set.
+
+Setup and migration end with a highlighted next-action panel. The preview
+command is one copyable line, including `npm install` when needed.
+
+Scaffolding and migration keep subprocess logs quiet in interactive terminals.
+Add `--verbose` to see installation and build logs as they happen:
+
+```bash
+npx create-thally-docs my-docs --yes --install --verbose
+npx create-thally-docs migrate https://github.com/your-org/your-docs --platform auto --verbose
+```
+
+Long-running steps show their current activity and elapsed time. Plain logs report an elapsed heartbeat every 15 seconds. Conversion, rendering, and content validation run off the terminal thread so progress keeps updating during larger imports.
+
+Failures always show diagnostics, including without `--verbose`; quiet output retains the last 64 KiB. Non-interactive
+runs retain subprocess output for scripts and CI. These options also work with
+`thally init` and `thally migrate`.
+
 ## What you get
 
 - **MDX content** in `src/content/`, navigation in `docs.json`

package/dist/{chunk-VGGE6JIL.js → chunk-DIX4EUI4.js}

@@ -1,120 +1,21 @@
 #!/usr/bin/env node
 import {
-  initGit,
-  installDeps,
+  findPublicSpecs,
+  shadowNote,
+  specHasHiddenOperations
+} from "./chunk-KDLP27DS.js";
+import {
   readDocsJson,
-  scaffold,
   writeDocsJson
-} from "./chunk-QLMRRNLL.js";
-import {
-  pruneMissingSiteLinks
-} from "./chunk-4VKRBJV2.js";
-
-// src/migrate/index.ts
-import { existsSync as existsSync3, mkdirSync, mkdtempSync, readFileSync as readFileSync4, rmSync, writeFileSync } from "fs";
-import { tmpdir } from "os";
-import { basename, dirname, isAbsolute, join as join4, relative as relative3, resolve, sep } from "path";
-import {
-  cloneGitHubRepository,
-  hydrateRemoteApiSpecs,
-  migrateRepository,
-  migrateUrl,
-  parseGitHubRepositoryUrl,
-  renderMigrationFiles
-} from "@thallylabs/migrate";
-
-// src/public-specs.ts
-import { lstatSync, readFileSync, readdirSync, statSync } from "fs";
-import { join, relative } from "path";
-import { parse as parseYaml } from "yaml";
-var OPENAPI_METHODS = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
-var SPEC_EXTENSIONS = /\.(?:json|ya?ml)$/i;
-var MAX_SPEC_BYTES = 1e7;
-var MAX_DEPTH = 8;
-var MAX_ENTRIES = 5e3;
-function shadowNote(urlPath) {
-  return urlPath === "openapi.json" || urlPath === "openapi.yaml" ? ` It is also served at /${urlPath} in place of the filtered specification, so visitors get this raw file there.` : "";
-}
-var isFlagged = (value) => value === true || value === "true";
-function specHasHiddenOperations(spec, overrides) {
-  if (overrides && typeof overrides === "object" && Object.values(overrides).some((o) => o?.hidden === true)) return true;
-  const components = spec.components;
-  for (const group of [spec.paths, spec.webhooks, spec["x-webhooks"], components?.pathItems]) {
-    if (!group || typeof group !== "object") continue;
-    for (const item of Object.values(group)) {
-      if (!item || typeof item !== "object") continue;
-      const record = item;
-      if (isFlagged(record["x-excluded"]) || isFlagged(record["x-hidden"])) return true;
-      for (const method of OPENAPI_METHODS) {
-        const op = record[method];
-        if (op && typeof op === "object" && (isFlagged(op["x-excluded"]) || isFlagged(op["x-hidden"]))) return true;
-      }
-    }
-  }
-  return false;
-}
-function findPublicSpecs(projectDir) {
-  const publicDir = join(projectDir, "public");
-  const scan = { specs: [], skipped: [] };
-  let seen = 0;
-  const walk = (dir, depth) => {
-    let entries;
-    try {
-      entries = readdirSync(dir).sort();
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      if (++seen > MAX_ENTRIES) return;
-      const full = join(dir, entry);
-      let stat;
-      try {
-        stat = lstatSync(full);
-        if (stat.isSymbolicLink()) {
-          const target = statSync(full);
-          if (!target.isFile()) continue;
-          stat = target;
-        }
-      } catch {
-        continue;
-      }
-      if (stat.isDirectory()) {
-        if (depth < MAX_DEPTH && entry !== "node_modules") walk(full, depth + 1);
-        continue;
-      }
-      if (!stat.isFile() || !SPEC_EXTENSIONS.test(entry)) continue;
-      const urlPath = relative(publicDir, full).split(/[\\/]/).join("/");
-      if (stat.size > MAX_SPEC_BYTES) {
-        scan.skipped.push(`public/${urlPath}`);
-        continue;
-      }
-      try {
-        const raw = readFileSync(full, "utf8");
-        const parsed = /\.json$/i.test(entry) ? JSON.parse(raw) : parseYaml(raw);
-        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) continue;
-        const spec = parsed;
-        if (typeof spec.openapi !== "string" && typeof spec.swagger !== "string") continue;
-        scan.specs.push({ path: `public/${urlPath}`, urlPath, hasHiddenOperations: specHasHiddenOperations(spec) });
-      } catch {
-      }
-    }
-  };
-  walk(publicDir, 0);
-  return scan;
-}
-
-// src/migrate/validate.ts
-import { spawnSync } from "child_process";
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
-import { join as join3 } from "path";
+} from "./chunk-J7255UQA.js";
 
 // src/check.ts
-import { existsSync, readFileSync as readFileSync2, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join2, extname, relative as relative2 } from "path";
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { join, extname, relative } from "path";
 import { execFileSync } from "child_process";
 
 // src/frontmatter.ts
-import { parse as parseYaml2 } from "yaml";
+import { parse as parseYaml } from "yaml";
 function parseFrontmatter(raw) {
   const source = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
   const opening = /^---([^\r\n]*)\r?\n/.exec(source);
@@ -129,7 +30,7 @@ function parseFrontmatter(raw) {
   if (matter.trim() === "" || !["", "yaml", "yml"].includes(language)) {
     return { content, data: {} };
   }
-  const parsed = parseYaml2(matter);
+  const parsed = parseYaml(matter);
   return {
     content,
     data: parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}
@@ -137,7 +38,7 @@ function parseFrontmatter(raw) {
 }
 
 // src/check.ts
-import { parse as parseYaml3 } from "yaml";
+import { parse as parseYaml2 } from "yaml";
 
 // src/openapi-publication.ts
 var METHODS = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
@@ -398,14 +299,14 @@ function checkDrift(projectDir, file, data, issues) {
 function scanMdx(dir, results) {
   let entries;
   try {
-    entries = readdirSync2(dir);
+    entries = readdirSync(dir);
   } catch {
     return;
   }
   for (const entry of entries) {
-    const fullPath = join2(dir, entry);
+    const fullPath = join(dir, entry);
     try {
-      const stat = statSync2(fullPath);
+      const stat = statSync(fullPath);
       if (stat.isDirectory()) scanMdx(fullPath, results);
       else if (extname(entry).toLowerCase() === ".mdx") results.push(fullPath);
     } catch {
@@ -621,10 +522,10 @@ function checkUnpublishedOperationPages(projectDir, tabs, pages, issues) {
     const source = tab.api.source;
     const overrides = tab.api.overrides;
     if (/^https?:/i.test(source)) return { source, overrides };
-    const specPath = source.startsWith("/") ? join2(projectDir, "public", source.slice(1)) : join2(projectDir, source);
+    const specPath = source.startsWith("/") ? join(projectDir, "public", source.slice(1)) : join(projectDir, source);
     try {
-      const raw = readFileSync2(specPath, "utf8");
-      return { source, overrides, document: /\.json$/i.test(source) ? JSON.parse(raw) : parseYaml3(raw) };
+      const raw = readFileSync(specPath, "utf8");
+      return { source, overrides, document: /\.json$/i.test(source) ? JSON.parse(raw) : parseYaml2(raw) };
     } catch {
       return { source, overrides };
     }
@@ -643,15 +544,15 @@ function checkUnpublishedOperationPages(projectDir, tabs, pages, issues) {
   }
 }
 function validateOpenApi(projectDir, source, issues, overrides) {
-  const specPath = source.startsWith("/") ? join2(projectDir, "public", source.slice(1)) : join2(projectDir, source);
+  const specPath = source.startsWith("/") ? join(projectDir, "public", source.slice(1)) : join(projectDir, source);
   if (!existsSync(specPath)) {
     issues.push({ severity: "error", message: `API reference points at "${source}" but the file does not exist`, file: source });
     return;
   }
   let spec;
   try {
-    const raw = readFileSync2(specPath, "utf8");
-    spec = source.endsWith(".json") ? JSON.parse(raw) : parseYaml3(raw);
+    const raw = readFileSync(specPath, "utf8");
+    spec = source.endsWith(".json") ? JSON.parse(raw) : parseYaml2(raw);
   } catch (err) {
     issues.push({ severity: "error", message: `OpenAPI spec is not valid ${source.endsWith(".json") ? "JSON" : "YAML"}: ${err.message}`, file: source });
     return;
@@ -693,13 +594,14 @@ function validateOpenApi(projectDir, source, issues, overrides) {
 }
 async function runCheck(projectDir, options) {
   const { fix, ci } = options;
-  if (!existsSync(join2(projectDir, "docs.json"))) {
-    console.error(`
+  if (!existsSync(join(projectDir, "docs.json"))) {
+    if (!options.silent) console.error(`
   \u274C Not a Thally project: docs.json not found in ${projectDir}
 `);
+    else options.onIssues?.([{ severity: "error", message: `docs.json not found in ${projectDir}` }]);
     return 1;
   }
-  const contentDir = join2(projectDir, "src", "content");
+  const contentDir = join(projectDir, "src", "content");
   const issues = [];
   const config = readDocsJson(projectDir);
   const secondaryLocales = new Set(
@@ -731,7 +633,7 @@ async function runCheck(projectDir, options) {
     issues.push({ severity: "warning", message: `[duplicate] "${dup}" appears more than once in docs.json` });
   }
   for (const pageId of navPageIds) {
-    const candidates = [join2(contentDir, `${pageId}.mdx`), join2(contentDir, `${pageId}/index.mdx`)];
+    const candidates = [join(contentDir, `${pageId}.mdx`), join(contentDir, `${pageId}/index.mdx`)];
     if (!candidates.some((c) => existsSync(c))) {
       issues.push({ severity: "error", message: `"${pageId}" is in docs.json but has no MDX file`, file: `src/content/${pageId}.mdx` });
     }
@@ -750,13 +652,13 @@ async function runCheck(projectDir, options) {
     let content = "";
     let lineOffset = 0;
     try {
-      const raw = readFileSync2(filePath, "utf8");
+      const raw = readFileSync(filePath, "utf8");
       const parsed = parseFrontmatter(raw);
       data = parsed.data;
       content = parsed.content;
       lineOffset = raw.slice(0, raw.indexOf(content)).split("\n").length - 1;
     } catch {
-      issues.push({ severity: "error", message: `Could not parse frontmatter`, file: relative2(projectDir, filePath) });
+      issues.push({ severity: "error", message: `Could not parse frontmatter`, file: relative(projectDir, filePath) });
       continue;
     }
     const { navPageId } = localizedPage(pageId, secondaryLocales);
@@ -765,10 +667,10 @@ async function runCheck(projectDir, options) {
         addOrphanToNav(projectDir, pageId);
         fixedOrphans.push(pageId);
       } else {
-        issues.push({ severity: "warning", message: `"${pageId}" is not in docs.json nav (orphan)`, file: relative2(projectDir, filePath) });
+        issues.push({ severity: "warning", message: `"${pageId}" is not in docs.json nav (orphan)`, file: relative(projectDir, filePath) });
       }
     }
-    const rel2 = relative2(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 });
     if (typeof data.openapi !== "string" && content.trim().length < 50) {
@@ -822,7 +724,7 @@ async function runCheck(projectDir, options) {
       }
     }
   }
-  const publicDir = join2(projectDir, "public");
+  const publicDir = join(projectDir, "public");
   for (const { file, images, offset } of linksByFile) {
     for (const { target, line: contentLine } of images) {
       const line = contentLine + offset;
@@ -835,7 +737,7 @@ async function runCheck(projectDir, options) {
       } catch {
         continue;
       }
-      if (!existsSync(join2(publicDir, decoded))) {
+      if (!existsSync(join(publicDir, decoded))) {
         issues.push({ severity: "warning", message: `Image not found: "${target}" has no file under public/`, file, line });
       }
     }
@@ -848,6 +750,7 @@ async function runCheck(projectDir, options) {
   const errors = issues.filter((i) => i.severity === "error");
   options.onIssues?.(issues);
   const warnings = issues.filter((i) => i.severity === "warning");
+  if (options.silent) return errors.length > 0 ? 1 : 0;
   if (ci) {
     for (const issue of issues) {
       const loc = issue.file ? `file=${issue.file}${issue.line ? `,line=${issue.line}` : ""}` : "";
@@ -893,231 +796,7 @@ thally check: ${errors.length} error(s), ${warnings.length} warning(s)`);
   return errors.length > 0 ? 1 : 0;
 }
 
-// src/migrate/validate.ts
-async function validateMigration(projectDir, skip = false, installationFailed = false) {
-  const result = { content: "skipped", build: "skipped", messages: [], diagnostics: [] };
-  if (skip) {
-    result.messages.push("Validation was explicitly skipped; this import is not verified.");
-    return result;
-  }
-  try {
-    result.content = await runCheck(projectDir, { fix: false, ci: true, onIssues: (issues) => {
-      result.diagnostics = issues;
-    } }) === 0 ? "passed" : "failed";
-    if (result.content === "failed") result.messages.push("Content validation failed. Review the check output; source links are not silently rewritten.");
-  } catch (error) {
-    result.content = "failed";
-    result.messages.push(`Content validation failed: ${error instanceof Error ? error.message : String(error)}`);
-  }
-  if (installationFailed) {
-    result.build = "failed";
-    result.messages.push("Dependency installation failed; production build was not attempted. Review the installation output before retrying.");
-    return result;
-  }
-  const packagePath = join3(projectDir, "package.json");
-  try {
-    const manifest = existsSync2(packagePath) ? JSON.parse(readFileSync3(packagePath, "utf8")) : void 0;
-    if (!manifest?.scripts?.build) {
-      result.messages.push("No build script is available; production rendering is not verified.");
-      return result;
-    }
-    const build = spawnSync(process.platform === "win32" ? "npm.cmd" : "npm", ["run", "build"], {
-      cwd: projectDir,
-      stdio: "inherit",
-      timeout: 10 * 60 * 1e3
-    });
-    result.build = build.status === 0 && !build.error ? "passed" : "failed";
-    if (result.build === "failed") result.messages.push("Production build failed. Review the build output before publishing.");
-  } catch (error) {
-    result.build = "failed";
-    result.messages.push(`Production build failed: ${error instanceof Error ? error.message : String(error)}`);
-  }
-  return result;
-}
-
-// src/migrate/index.ts
-function projectPath(projectDir, candidate) {
-  const target = resolve(projectDir, candidate);
-  const fromRoot = relative3(resolve(projectDir), target);
-  if (isAbsolute(fromRoot) || fromRoot === ".." || fromRoot.startsWith(`..${sep}`)) {
-    throw new Error(`Generated migration path escapes the project: ${candidate}`);
-  }
-  return target;
-}
-function ignoreQuarantineDirectory(projectDir) {
-  const ignorePath = projectPath(projectDir, ".gitignore");
-  const existing = existsSync3(ignorePath) ? readFileSync4(ignorePath, "utf8") : "";
-  const rules = existing.split(/\r?\n/).map((line) => line.trim()).filter((line) => /^!?\/?migration-quarantine(?:\/(?:\*\*?)?)?$/.test(line));
-  if (rules.length > 0 && !rules[rules.length - 1].startsWith("!")) return;
-  const separator = existing === "" || existing.endsWith("\n") ? "" : "\n";
-  writeFileSync(ignorePath, `${existing}${separator}
-# Access-restricted pages withheld by migration: local only, never commit or deploy
-/migration-quarantine/
-`);
-}
-function readExistingConfig(projectDir) {
-  const configPath = projectPath(projectDir, "docs.json");
-  if (!existsSync3(configPath)) return void 0;
-  return JSON.parse(readFileSync4(configPath, "utf8"));
-}
-function resetFreshMigrationContent(projectDir) {
-  const contentDirectory = projectPath(projectDir, "src/content");
-  rmSync(contentDirectory, { recursive: true, force: true });
-  mkdirSync(contentDirectory, { recursive: true });
-  for (const sampleSpec of ["openapi.yaml", "openapi.json"]) {
-    rmSync(projectPath(projectDir, sampleSpec), { force: true });
-  }
-}
-async function discoverMigration(options) {
-  const url = new URL(options.sourceUrl);
-  if (url.hostname.toLowerCase() !== "github.com") {
-    console.log(`  \u{1F310} Discovering public docs at ${url.origin}${url.pathname}...`);
-    return migrateUrl({
-      sourceUrl: options.sourceUrl,
-      platform: options.platform,
-      maxPages: options.maxPages,
-      fetcher: options.fetcher
-    });
-  }
-  const source = parseGitHubRepositoryUrl(options.sourceUrl);
-  if (options.branch) source.branch = options.branch;
-  const temporaryRoot = mkdtempSync(join4(tmpdir(), "thally-migrate-"));
-  const cloneDir = join4(temporaryRoot, "repository");
-  console.log(`  \u{1F4E6} Cloning ${source.owner}/${source.repo}...`);
-  try {
-    const cloneWarnings = [];
-    await cloneGitHubRepository(source, cloneDir, cloneWarnings);
-    const bundle = migrateRepository({
-      repositoryDir: cloneDir,
-      sourceUrl: options.sourceUrl,
-      docsDir: options.docsDir ?? (source.docsDir || void 0),
-      platform: options.platform
-    });
-    const hydrated = await hydrateRemoteApiSpecs(bundle, options.fetcher);
-    return cloneWarnings.length > 0 ? { ...hydrated, warnings: [...cloneWarnings, ...hydrated.warnings] } : hydrated;
-  } finally {
-    rmSync(temporaryRoot, { recursive: true, force: true });
-  }
-}
-function publicSpecWarning(projectDir, bundle) {
-  const { specs, skipped } = findPublicSpecs(projectDir);
-  if (specs.length === 0 && skipped.length === 0) return null;
-  const migrated = new Set(bundle.assets.filter((asset) => asset.projectRelative).map((asset) => basename(asset.path)));
-  const lines = [
-    ...specs.map((spec) => `${spec.path}${migrated.has(basename(spec.path)) ? " (same file name as a migrated spec)" : ""}${spec.hasHiddenOperations ? " (contains x-excluded/x-hidden operations)" : ""}${shadowNote(spec.urlPath) ? ` (answers /${spec.urlPath} in place of the filtered specification)` : ""}`),
-    ...skipped.map((path) => `${path} (too large to inspect)`)
-  ];
-  return {
-    code: "unsupported-config",
-    message: `Existing OpenAPI files under public/ are served publicly as-is: ${lines.join("; ")}. Migrated specs are written to openapi/, and re-running migration does not remove old copies from public/. Delete any old copy manually (nothing was deleted), or its hidden operations stay downloadable.`
-  };
-}
-async function migrateDocs(options) {
-  const projectDir = resolve(options.projectDir);
-  const bundle = await discoverMigration(options);
-  if (!options.into) {
-    console.log(`
-  \u{1F3D7}  Scaffolding new project at ${projectDir}...`);
-    await scaffold({
-      projectDir,
-      projectName: options.projectName ?? bundle.site?.name ?? "My Docs",
-      description: bundle.site?.description ?? `Documentation migrated from ${new URL(options.sourceUrl).hostname}`,
-      brandPreset: "primary",
-      // Source provenance is not the destination repository. Migrated pages
-      // live at new paths, so source URLs cannot power edit/issue actions.
-      repoUrl: "",
-      doInstall: false,
-      colors: bundle.site?.colors
-    });
-    resetFreshMigrationContent(projectDir);
-    pruneMissingSiteLinks(projectDir, new Set(bundle.pages.map((page) => page.id)));
-  } else if (!existsSync3(projectDir)) {
-    throw new Error(`Project directory "${projectDir}" does not exist. Use without --into to scaffold a new one.`);
-  }
-  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" }] };
-  }
-  if (options.into) {
-    const stale = publicSpecWarning(projectDir, bundle);
-    if (stale) bundle.warnings.unshift(stale);
-  }
-  const rendered = renderMigrationFiles(bundle, {
-    existingConfig: options.into ? readExistingConfig(projectDir) : void 0,
-    existingComponentRegistry: existsSync3(projectPath(projectDir, "src/mdx/custom-components.tsx")) ? readFileSync4(projectPath(projectDir, "src/mdx/custom-components.tsx"), "utf8") : void 0
-  });
-  for (const file of rendered) {
-    const destination = projectPath(projectDir, file.path);
-    mkdirSync(dirname(destination), { recursive: true });
-    writeFileSync(destination, file.content);
-  }
-  if (bundle.quarantinedFiles?.length) ignoreQuarantineDirectory(projectDir);
-  const format = (warning) => `${warning.message}${warning.source ? ` (${warning.source})` : ""}`;
-  for (const warning of bundle.warnings.filter((item) => item.code !== "gated-page")) console.warn(`  \u26A0  ${format(warning)}`);
-  const gatedWarnings = bundle.warnings.filter((item) => item.code === "gated-page");
-  if (gatedWarnings.length > 0) {
-    console.warn("\n  \u{1F512} ACCESS-RESTRICTED CONTENT \u2014 review before publishing");
-    for (const warning of gatedWarnings) console.warn(`  \u{1F512} ${format(warning)}`);
-    if (bundle.droppedGatedPages) {
-      console.warn(`  \u{1F512} ${bundle.droppedGatedPages} access-restricted page(s) were dropped by the file limit: not published and not saved under migration-quarantine/; recover them from the source repository.`);
-    }
-    if (bundle.quarantinedFiles?.length || gatedWarnings.some((warning) => !/dashboard access settings/i.test(warning.message))) {
-      console.warn("  \u{1F512} Before publishing, review migration-quarantine/assets/ and the dashboard access settings of the source site.");
-    }
-  }
-  console.log(`  \u2713 Imported ${bundle.pages.length} pages and ${bundle.assets.length} assets from ${bundle.platform}.`);
-  let installationFailed = false;
-  if (!options.skipValidation) console.log("  Migration validation runs project code locally, including imported MDX and components.");
-  if (!options.into && !options.skipValidation) {
-    try {
-      installDeps(projectDir);
-    } catch {
-      installationFailed = true;
-    }
-  }
-  console.log("\n  Validating imported documentation...");
-  const validation = await validateMigration(projectDir, options.skipValidation, installationFailed);
-  const quarantinedPages = (bundle.quarantinedFiles ?? []).filter((file) => /\.mdx?$/i.test(file.path)).length;
-  const reportPath = projectPath(projectDir, "migration-report.json");
-  writeFileSync(reportPath, `${JSON.stringify({
-    version: 1,
-    sourceUrl: `${new URL(options.sourceUrl).origin}${new URL(options.sourceUrl).pathname}`,
-    platform: bundle.platform,
-    pages: bundle.pages.length,
-    assets: bundle.assets.length,
-    components: bundle.componentFiles?.length ?? 0,
-    quarantined: quarantinedPages,
-    quarantinedAssets: (bundle.quarantinedFiles?.length ?? 0) - quarantinedPages,
-    droppedGatedPages: bundle.droppedGatedPages ?? 0,
-    warnings: bundle.warnings,
-    validation
-  }, null, 2)}
-`);
-  for (const message of validation.messages) console.warn(`  \u26A0  ${message}`);
-  console.log(`  Migration report: ${reportPath}`);
-  if (validation.content === "passed" && validation.build === "passed") {
-    console.log(`  \u2713 Content and production build passed.${bundle.warnings.length ? " Review the migration warnings for compatibility limitations." : ""}`);
-  } else {
-    console.warn("  Import retained, but validation is incomplete. Do not publish without reviewing the report.");
-  }
-  if (!options.into) initGit(projectDir);
-  return {
-    pagesWritten: bundle.pages.length,
-    assetsWritten: bundle.assets.length,
-    projectDir,
-    platform: bundle.platform,
-    warnings: bundle.warnings,
-    validation,
-    reportPath
-  };
-}
-
 export {
   parseFrontmatter,
-  runCheck,
-  migrateDocs
+  runCheck
 };

package/dist/chunk-J7255UQA.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+// src/docs-json.ts
+import { readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+function readDocsJson(projectDir) {
+  const docsPath = join(projectDir, "docs.json");
+  const raw = readFileSync(docsPath, "utf8");
+  return JSON.parse(raw);
+}
+function writeDocsJson(projectDir, config) {
+  const docsPath = join(projectDir, "docs.json");
+  writeFileSync(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+function resetTrackingConfig(projectDir) {
+  const config = readDocsJson(projectDir);
+  if (config.tracking) {
+    delete config.tracking;
+    writeDocsJson(projectDir, config);
+  }
+}
+function writeTrackingConfig(projectDir, repos) {
+  if (repos.length === 0) return;
+  const config = readDocsJson(projectDir);
+  config.tracking = { repos: repos.map((r) => ({ owner: r.owner, repo: r.repo, branch: "main" })) };
+  writeDocsJson(projectDir, config);
+}
+
+export {
+  readDocsJson,
+  writeDocsJson,
+  resetTrackingConfig,
+  writeTrackingConfig
+};

package/dist/chunk-KDLP27DS.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+// src/public-specs.ts
+import { lstatSync, readFileSync, readdirSync, statSync } from "fs";
+import { join, relative } from "path";
+import { parse as parseYaml } from "yaml";
+var OPENAPI_METHODS = ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
+var SPEC_EXTENSIONS = /\.(?:json|ya?ml)$/i;
+var MAX_SPEC_BYTES = 1e7;
+var MAX_DEPTH = 8;
+var MAX_ENTRIES = 5e3;
+function shadowNote(urlPath) {
+  return urlPath === "openapi.json" || urlPath === "openapi.yaml" ? ` It is also served at /${urlPath} in place of the filtered specification, so visitors get this raw file there.` : "";
+}
+var isFlagged = (value) => value === true || value === "true";
+function specHasHiddenOperations(spec, overrides) {
+  if (overrides && typeof overrides === "object" && Object.values(overrides).some((o) => o?.hidden === true)) return true;
+  const components = spec.components;
+  for (const group of [spec.paths, spec.webhooks, spec["x-webhooks"], components?.pathItems]) {
+    if (!group || typeof group !== "object") continue;
+    for (const item of Object.values(group)) {
+      if (!item || typeof item !== "object") continue;
+      const record = item;
+      if (isFlagged(record["x-excluded"]) || isFlagged(record["x-hidden"])) return true;
+      for (const method of OPENAPI_METHODS) {
+        const op = record[method];
+        if (op && typeof op === "object" && (isFlagged(op["x-excluded"]) || isFlagged(op["x-hidden"]))) return true;
+      }
+    }
+  }
+  return false;
+}
+function findPublicSpecs(projectDir) {
+  const publicDir = join(projectDir, "public");
+  const scan = { specs: [], skipped: [] };
+  let seen = 0;
+  const walk = (dir, depth) => {
+    let entries;
+    try {
+      entries = readdirSync(dir).sort();
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (++seen > MAX_ENTRIES) return;
+      const full = join(dir, entry);
+      let stat;
+      try {
+        stat = lstatSync(full);
+        if (stat.isSymbolicLink()) {
+          const target = statSync(full);
+          if (!target.isFile()) continue;
+          stat = target;
+        }
+      } catch {
+        continue;
+      }
+      if (stat.isDirectory()) {
+        if (depth < MAX_DEPTH && entry !== "node_modules") walk(full, depth + 1);
+        continue;
+      }
+      if (!stat.isFile() || !SPEC_EXTENSIONS.test(entry)) continue;
+      const urlPath = relative(publicDir, full).split(/[\\/]/).join("/");
+      if (stat.size > MAX_SPEC_BYTES) {
+        scan.skipped.push(`public/${urlPath}`);
+        continue;
+      }
+      try {
+        const raw = readFileSync(full, "utf8");
+        const parsed = /\.json$/i.test(entry) ? JSON.parse(raw) : parseYaml(raw);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) continue;
+        const spec = parsed;
+        if (typeof spec.openapi !== "string" && typeof spec.swagger !== "string") continue;
+        scan.specs.push({ path: `public/${urlPath}`, urlPath, hasHiddenOperations: specHasHiddenOperations(spec) });
+      } catch {
+      }
+    }
+  };
+  walk(publicDir, 0);
+  return scan;
+}
+
+export {
+  shadowNote,
+  specHasHiddenOperations,
+  findPublicSpecs
+};