@lukoweb/apitogo 0.1.94 → 0.1.96

package/dist/cli/cli.js

@@ -10,18 +10,18 @@ var __export = (target, all) => {
 
 // src/cli/common/package-json.ts
 import { readFileSync } from "node:fs";
-import path18 from "node:path";
+import path19 from "node:path";
 import { fileURLToPath } from "node:url";
 var getPackageJsonPath, getPackageJson, getZudokuPackageJson, getZudokuRootDir;
 var init_package_json = __esm({
   "src/cli/common/package-json.ts"() {
     getPackageJsonPath = (pkg) => fileURLToPath(import.meta.resolve(`${pkg}/package.json`)).replaceAll(
-      path18.sep,
-      path18.posix.sep
+      path19.sep,
+      path19.posix.sep
     );
     getPackageJson = (pkgPath) => JSON.parse(readFileSync(pkgPath, "utf-8"));
     getZudokuPackageJson = () => getPackageJson(getPackageJsonPath("@lukoweb/apitogo"));
-    getZudokuRootDir = () => path18.dirname(getPackageJsonPath("@lukoweb/apitogo"));
+    getZudokuRootDir = () => path19.dirname(getPackageJsonPath("@lukoweb/apitogo"));
   }
 });
 
@@ -654,12 +654,12 @@ var init_apitogo_config_core = __esm({
 
 // src/config/apitogo-config-loader.node.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import path19 from "node:path";
+import path20 from "node:path";
 function loadApitogoConfig(rootDir = process.cwd()) {
-  const configPath = path19.join(path19.resolve(rootDir), APITOGO_CONFIG_FILENAME2);
+  const configPath = path20.join(path20.resolve(rootDir), APITOGO_CONFIG_FILENAME2);
   if (!existsSync2(configPath)) {
     throw new Error(
-      `Missing ${APITOGO_CONFIG_FILENAME2} in ${path19.resolve(rootDir)}`
+      `Missing ${APITOGO_CONFIG_FILENAME2} in ${path20.resolve(rootDir)}`
     );
   }
   const raw = readFileSync2(configPath, "utf8");
@@ -734,7 +734,7 @@ import { stat } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path66) => stat(path66).then(() => true).catch(() => false);
+    fileExists = (path69) => stat(path69).then(() => true).catch(() => false);
   }
 });
 
@@ -978,7 +978,7 @@ var init_landing_manifest = __esm({
 });
 
 // src/config/local-manifest.ts
-import path20 from "node:path";
+import path21 from "node:path";
 import { z as z4 } from "zod";
 function isPricingEnabled(manifest) {
   return manifest?.pricing?.enabled === true;
@@ -1028,8 +1028,8 @@ function resolveManifestEnv(viteMode) {
   return viteMode === "production" ? "production" : "development";
 }
 function manifestPathsForEnv(rootDir, _env) {
-  const resolvedRoot = path20.resolve(rootDir);
-  const configPath = path20.join(resolvedRoot, APITOGO_CONFIG_FILENAME2);
+  const resolvedRoot = path21.resolve(rootDir);
+  const configPath = path21.join(resolvedRoot, APITOGO_CONFIG_FILENAME2);
   return {
     basePath: configPath,
     overridePath: configPath,
@@ -1705,7 +1705,7 @@ var init_shadcn_registry = __esm({
 
 // src/vite/plugin-theme.ts
 import { createRequire as createRequire2 } from "node:module";
-import path21 from "node:path";
+import path22 from "node:path";
 import { normalizeTheme } from "shiki";
 var THEME_VARIABLES, uncamelize, processColorValue, generateCss, generateRegistryCss, processCustomCss, MAIN_REPLACE, DEFAULT_THEME_REPLACE, GOOGLE_FONTS, getGoogleFontUrl, processFont, processFontConfig, DEFAULT_FONT_SANS, DEFAULT_FONT_MONO, DEFAULT_FONT_HEADING, processFonts, MODULE_SOURCE_PACKAGES, resolveModuleSourceDirs, virtualModuleId, resolvedVirtualModuleId, viteThemePlugin;
 var init_plugin_theme = __esm({
@@ -1884,7 +1884,7 @@ var init_plugin_theme = __esm({
     resolveModuleSourceDirs = (config2) => {
       if (config2.__meta.mode === "internal") {
         return MODULE_SOURCE_PACKAGES.map(
-          (pkg) => path21.join(
+          (pkg) => path22.join(
             config2.__meta.moduleDir,
             "..",
             pkg.replace("@lukoweb/apitogo-", ""),
@@ -1893,12 +1893,12 @@ var init_plugin_theme = __esm({
         );
       }
       const require2 = createRequire2(
-        path21.join(config2.__meta.rootDir, "package.json")
+        path22.join(config2.__meta.rootDir, "package.json")
       );
       const dirs = [];
       for (const pkg of MODULE_SOURCE_PACKAGES) {
         try {
-          dirs.push(path21.dirname(require2.resolve(pkg)));
+          dirs.push(path22.dirname(require2.resolve(pkg)));
         } catch {
         }
       }
@@ -2024,7 +2024,7 @@ ${rootVars.join("\n")}
               ...config2.__meta.dependencies,
               ...config2.__pluginDirs ?? [],
               ...resolveModuleSourceDirs(config2)
-            ].map((file) => path21.relative(path21.dirname(id), file))
+            ].map((file) => path22.relative(path22.dirname(id), file))
           );
           const code = [...files].map((file) => `@source "${file}";`);
           code.push("@theme inline {");
@@ -4866,7 +4866,7 @@ var init_ZudokuConfig = __esm({
 
 // src/config/loader.ts
 import { stat as stat2 } from "node:fs/promises";
-import path22 from "node:path";
+import path23 from "node:path";
 import colors3 from "picocolors";
 import {
   runnerImport,
@@ -4893,7 +4893,7 @@ function mergeJsonConfigWithRuntimeOverrides(fileConfig, importedConfig) {
 }
 async function getConfigFilePath(rootDir) {
   for (const fileName of zudokuConfigFiles) {
-    const filepath = path22.join(rootDir, fileName);
+    const filepath = path23.join(rootDir, fileName);
     if (await fileExists(filepath)) {
       return filepath;
     }
@@ -5126,7 +5126,7 @@ __export(llms_exports, {
   generateLlmsTxtFiles: () => generateLlmsTxtFiles
 });
 import { writeFile as writeFile9 } from "node:fs/promises";
-import path44 from "node:path";
+import path45 from "node:path";
 import colors7 from "picocolors";
 async function generateLlmsTxtFiles({
   markdownFileInfos,
@@ -5161,7 +5161,7 @@ async function generateLlmsTxtFiles({
       }
     }
     const llmsTxt2 = llmsTxtParts.join("\n");
-    await writeFile9(path44.join(baseOutputDir, "llms.txt"), llmsTxt2, "utf-8");
+    await writeFile9(path45.join(baseOutputDir, "llms.txt"), llmsTxt2, "utf-8");
     if (process.env.APITOGO_JSON_ONLY !== "1") {
       console.log(colors7.blue("\u2713 generated llms.txt"));
     }
@@ -5189,7 +5189,7 @@ ${info.content}
     }
     const llmsFull = llmsFullParts.join("\n");
     await writeFile9(
-      path44.join(baseOutputDir, "llms-full.txt"),
+      path45.join(baseOutputDir, "llms-full.txt"),
       llmsFull,
       "utf-8"
     );
@@ -5315,7 +5315,7 @@ async function shutdownAnalytics() {
 }
 
 // src/cli/apply/handler.ts
-import path17 from "node:path";
+import path18 from "node:path";
 
 // src/cli/common/output.ts
 import * as Sentry from "@sentry/node";
@@ -5504,8 +5504,8 @@ var PlatformApiClient = class {
   constructor(config2) {
     this.config = config2;
   }
-  url(path66) {
-    return `${this.config.apiUrl}${path66.startsWith("/") ? path66 : `/${path66}`}`;
+  url(path69) {
+    return `${this.config.apiUrl}${path69.startsWith("/") ? path69 : `/${path69}`}`;
   }
   headers(extra) {
     return {
@@ -5515,9 +5515,9 @@ var PlatformApiClient = class {
       ...extra
     };
   }
-  async request(method, path66, init4) {
+  async request(method, path69, init4) {
     const response = await fetchWithRetry(
-      this.url(path66),
+      this.url(path69),
       {
         method,
         ...init4,
@@ -5717,15 +5717,15 @@ var PlatformApiClient = class {
       }
     );
   }
-  deleteDevPortalPage(projectId, path66) {
-    const query = new URLSearchParams({ path: path66 });
+  deleteDevPortalPage(projectId, path69) {
+    const query = new URLSearchParams({ path: path69 });
     return this.request(
       "DELETE",
       `/api/v1/projects/${projectId}/dev-portal/pages/files?${query.toString()}`
     );
   }
-  renameDevPortalPage(projectId, path66, newName) {
-    const query = new URLSearchParams({ path: path66 });
+  renameDevPortalPage(projectId, path69, newName) {
+    const query = new URLSearchParams({ path: path69 });
     return this.request(
       "POST",
       `/api/v1/projects/${projectId}/dev-portal/pages/files/rename?${query.toString()}`,
@@ -5896,8 +5896,8 @@ var PlatformApiClient = class {
   }
 };
 async function readFileBytes(filePath) {
-  const { readFile: readFile18 } = await import("node:fs/promises");
-  const buffer = await readFile18(filePath);
+  const { readFile: readFile20 } = await import("node:fs/promises");
+  const buffer = await readFile20(filePath);
   const arrayBuffer = new ArrayBuffer(buffer.byteLength);
   new Uint8Array(arrayBuffer).set(buffer);
   return arrayBuffer;
@@ -7317,8 +7317,8 @@ function normalizeActionKey(actionKey) {
   const trimmed = actionKey.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path67 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path67.startsWith("/") ? path67 : `/${path67}`}`;
+    const path70 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path70.startsWith("/") ? path70 : `/${path70}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -7327,8 +7327,8 @@ function normalizeActionKey(actionKey) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path66 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path66.startsWith("/") ? path66 : `/${path66}`}`;
+  const path69 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path69.startsWith("/") ? path69 : `/${path69}`}`;
 }
 async function applyGatewayPublicRoutes(client, projectId, routes, options) {
   const applied = [];
@@ -8793,10 +8793,14 @@ function formatJobStatusResponse(options) {
 }
 
 // src/cli/platform/helpers/openapi.ts
-import { promises as fs3 } from "node:fs";
-import path9 from "node:path";
+import { promises as fs4 } from "node:fs";
+import path10 from "node:path";
 import SwaggerParser from "@apidevtools/swagger-parser";
 import YAML2 from "yaml";
+
+// src/cli/scaffold/discover-openapi-files.ts
+import { promises as fs3 } from "node:fs";
+import path9 from "node:path";
 var OPENAPI_BASENAMES = [
   "openapi.yaml",
   "openapi.yml",
@@ -8805,6 +8809,7 @@ var OPENAPI_BASENAMES = [
   "swagger.yml",
   "swagger.json"
 ];
+var OPENAPI_NOT_FOUND_SUGGESTION = "No OpenAPI file found near the site (checked parent, sibling folders, and the site directory for openapi.yaml|yml|json / swagger.yaml|yml|json). Ask the user for a path, or offer to draft a starter OpenAPI 3 spec from their API description, write it next to the site (e.g. ../openapi.yaml), then call set_dev_portal_openapi.";
 var SKIP_OPENAPI_SEARCH_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -8816,28 +8821,34 @@ var SKIP_OPENAPI_SEARCH_DIRS = /* @__PURE__ */ new Set([
   ".cache",
   ".apitogo"
 ]);
-async function discoverNearbyOpenApi(siteDirectory) {
+async function collectFromDir(dir, searchedDirectories, candidates) {
+  const resolved = path9.resolve(dir);
+  if (searchedDirectories.includes(resolved)) {
+    return;
+  }
+  searchedDirectories.push(resolved);
+  for (const name of OPENAPI_BASENAMES) {
+    const candidate = path9.join(resolved, name);
+    try {
+      await fs3.access(candidate);
+      candidates.push(candidate);
+    } catch {
+    }
+  }
+}
+async function collectSiteOpenApiFiles(siteDirectory) {
+  const searchedDirectories = [];
+  const candidates = [];
+  await collectFromDir(siteDirectory, searchedDirectories, candidates);
+  return { candidates: [...new Set(candidates)], searchedDirectories };
+}
+async function collectNearbyOpenApiFiles(siteDirectory) {
   const site = path9.resolve(siteDirectory);
   const parent = path9.dirname(site);
   const searchedDirectories = [];
   const candidates = [];
-  const collectFromDir = async (dir) => {
-    const resolved = path9.resolve(dir);
-    if (searchedDirectories.includes(resolved)) {
-      return;
-    }
-    searchedDirectories.push(resolved);
-    for (const name of OPENAPI_BASENAMES) {
-      const candidate = path9.join(resolved, name);
-      try {
-        await fs3.access(candidate);
-        candidates.push(candidate);
-      } catch {
-      }
-    }
-  };
   if (parent && parent !== site) {
-    await collectFromDir(parent);
+    await collectFromDir(parent, searchedDirectories, candidates);
     try {
       const entries = await fs3.readdir(parent, { withFileTypes: true });
       for (const entry of entries) {
@@ -8848,15 +8859,75 @@ async function discoverNearbyOpenApi(siteDirectory) {
         if (path9.resolve(sibling) === site) {
           continue;
         }
-        await collectFromDir(sibling);
+        await collectFromDir(sibling, searchedDirectories, candidates);
       }
     } catch {
     }
   }
-  await collectFromDir(site);
-  const unique = [...new Set(candidates)];
+  await collectFromDir(site, searchedDirectories, candidates);
+  return { candidates: [...new Set(candidates)], searchedDirectories };
+}
+function parseOpenApiObject(doc) {
+  const openapi = doc.openapi;
+  if (typeof openapi !== "string" || !openapi.startsWith("3.")) {
+    return {
+      valid: false,
+      errors: [`OpenAPI 3.x required; found ${String(openapi ?? "missing")}.`]
+    };
+  }
+  const info = doc.info;
+  return {
+    valid: true,
+    version: openapi,
+    title: info?.title,
+    errors: []
+  };
+}
+function liteParseOpenApi(content, filePath) {
+  const ext = path9.extname(filePath).toLowerCase();
+  if (ext === ".json") {
+    try {
+      const parsed = JSON.parse(content);
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return {
+          valid: false,
+          errors: ["OpenAPI document must be a JSON object."]
+        };
+      }
+      return parseOpenApiObject(parsed);
+    } catch (err) {
+      return {
+        valid: false,
+        errors: [
+          `Failed to parse OpenAPI document: ${err instanceof Error ? err.message : String(err)}`
+        ]
+      };
+    }
+  }
+  const versionMatch = content.match(
+    /^\s*openapi:\s*['"]?(3\.\d+(?:\.\d+)?)['"]?/m
+  );
+  if (!versionMatch?.[1]) {
+    return {
+      valid: false,
+      errors: ["OpenAPI 3.x required; missing openapi: 3.x field."]
+    };
+  }
+  const infoBlock = content.match(/^\s*info:\s*\n((?:[ \t].*\n)+)/m);
+  const titleMatch = infoBlock?.[1]?.match(/^\s*title:\s*['"]?(.+?)['"]?\s*$/m);
+  return {
+    valid: true,
+    version: versionMatch[1],
+    title: titleMatch?.[1]?.trim(),
+    errors: []
+  };
+}
+
+// src/cli/platform/helpers/openapi.ts
+async function discoverNearbyOpenApi(siteDirectory) {
+  const { candidates, searchedDirectories } = await collectNearbyOpenApiFiles(siteDirectory);
   const invalidCandidates = [];
-  for (const candidate of unique) {
+  for (const candidate of candidates) {
     const validation = await validateOpenApiFile(candidate);
     if (validation.valid) {
       return {
@@ -8864,35 +8935,39 @@ async function discoverNearbyOpenApi(siteDirectory) {
         selectedPath: candidate,
         version: validation.version,
         title: validation.title,
-        candidates: unique,
+        candidates,
         searchedDirectories
       };
     }
     invalidCandidates.push({ path: candidate, errors: validation.errors });
   }
   return {
-    status: unique.length > 0 ? "invalid" : "not_found",
-    candidates: unique,
+    status: candidates.length > 0 ? "invalid" : "not_found",
+    candidates,
     searchedDirectories,
     ...invalidCandidates.length > 0 ? { invalidCandidates } : {}
   };
 }
-var OPENAPI_NOT_FOUND_SUGGESTION = "No OpenAPI file found near the site (checked parent, sibling folders, and the site directory for openapi.yaml|yml|json / swagger.yaml|yml|json). Ask the user for a path, or offer to draft a starter OpenAPI 3 spec from their API description, write it next to the site (e.g. ../openapi.yaml), then call set_dev_portal_openapi.";
 async function validateOpenApiFile(filePath) {
-  const resolved = path9.resolve(filePath);
-  const content = await fs3.readFile(resolved, "utf8");
-  const ext = path9.extname(resolved).toLowerCase();
+  const resolved = path10.resolve(filePath);
+  const content = await fs4.readFile(resolved, "utf8");
+  const ext = path10.extname(resolved).toLowerCase();
   let parsed;
   try {
     parsed = ext === ".json" ? JSON.parse(content) : YAML2.parse(content);
   } catch (err) {
     return {
       valid: false,
-      errors: [`Failed to parse OpenAPI document: ${err instanceof Error ? err.message : String(err)}`]
+      errors: [
+        `Failed to parse OpenAPI document: ${err instanceof Error ? err.message : String(err)}`
+      ]
     };
   }
   if (!parsed || typeof parsed !== "object") {
-    return { valid: false, errors: ["OpenAPI document must be a JSON or YAML object."] };
+    return {
+      valid: false,
+      errors: ["OpenAPI document must be a JSON or YAML object."]
+    };
   }
   const doc = parsed;
   const openapi = doc.openapi;
@@ -8918,14 +8993,14 @@ async function validateOpenApiFile(filePath) {
 }
 
 // src/cli/platform/helpers/zip.ts
-import { createReadStream as createReadStream2, createWriteStream, promises as fs4 } from "node:fs";
+import { createReadStream as createReadStream2, createWriteStream, promises as fs5 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import path10 from "node:path";
+import path11 from "node:path";
 import { ZipArchive } from "archiver";
 async function packageBackendDirectory(sourceDirectory) {
-  const resolved = path10.resolve(sourceDirectory);
+  const resolved = path11.resolve(sourceDirectory);
   const files = await collectPackageableFiles(resolved);
-  const zipPath = path10.join(
+  const zipPath = path11.join(
     tmpdir2(),
     `apitogo-backend-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`
   );
@@ -8937,15 +9012,15 @@ async function packageBackendDirectory(sourceDirectory) {
     output2.on("error", reject);
     archive.pipe(output2);
     for (const rel of files) {
-      archive.append(createReadStream2(path10.join(resolved, rel)), { name: rel.split(path10.sep).join("/") });
+      archive.append(createReadStream2(path11.join(resolved, rel)), { name: rel.split(path11.sep).join("/") });
     }
     void archive.finalize();
   });
-  const { size } = await fs4.stat(zipPath);
+  const { size } = await fs5.stat(zipPath);
   return { zipPath, byteSize: size };
 }
 async function cleanupZip(zipPath) {
-  await fs4.unlink(zipPath).catch(() => void 0);
+  await fs5.unlink(zipPath).catch(() => void 0);
 }
 
 // src/cli/platform/tools/infrastructure.ts
@@ -10363,13 +10438,13 @@ async function resolveProjectIdForPublish(client, config2, args, wait, progress,
 }
 
 // src/cli/platform/tools/dev-portal.ts
-import { promises as fs6 } from "node:fs";
-import path13 from "node:path";
+import { promises as fs7 } from "node:fs";
+import path14 from "node:path";
 
 // src/cli/platform/helpers/tarball.ts
-import { createReadStream as createReadStream3, createWriteStream as createWriteStream2, promises as fs5 } from "node:fs";
+import { createReadStream as createReadStream3, createWriteStream as createWriteStream2, promises as fs6 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
-import path11 from "node:path";
+import path12 from "node:path";
 import { TarArchive } from "archiver";
 var DEV_PORTAL_DEPLOY_ARCHIVE_ROOT = "dist";
 function normalizeArchiveRoot(archiveRoot) {
@@ -10380,10 +10455,10 @@ function normalizeArchiveRoot(archiveRoot) {
   return `${trimmed}/`;
 }
 async function packageDirectoryAsTarGz(sourceDirectory, options) {
-  const resolved = path11.resolve(sourceDirectory);
+  const resolved = path12.resolve(sourceDirectory);
   const files = await collectPackageableFiles(resolved);
   const entryPrefix = options?.archiveRoot ? normalizeArchiveRoot(options.archiveRoot) : "";
-  const archivePath = path11.join(
+  const archivePath = path12.join(
     tmpdir3(),
     `apitogo-docs-${Date.now()}-${Math.random().toString(36).slice(2)}.tgz`
   );
@@ -10395,16 +10470,16 @@ async function packageDirectoryAsTarGz(sourceDirectory, options) {
     output2.on("error", reject);
     archive.pipe(output2);
     for (const rel of files) {
-      const entryName = entryPrefix + rel.split(path11.sep).join("/");
-      archive.append(createReadStream3(path11.join(resolved, rel)), { name: entryName });
+      const entryName = entryPrefix + rel.split(path12.sep).join("/");
+      archive.append(createReadStream3(path12.join(resolved, rel)), { name: entryName });
     }
     void archive.finalize();
   });
-  const { size } = await fs5.stat(archivePath);
+  const { size } = await fs6.stat(archivePath);
   return { archivePath, byteSize: size };
 }
 async function cleanupArchive(archivePath) {
-  await fs5.unlink(archivePath).catch(() => void 0);
+  await fs6.unlink(archivePath).catch(() => void 0);
 }
 function isTarGzPath(filePath) {
   const normalized = filePath.toLowerCase();
@@ -10520,7 +10595,7 @@ async function snapshotBackendUpdateJobIds(client, projectId) {
 
 // src/cli/platform/helpers/dev-portal-site-api-url.ts
 import { readdir as readdir2, readFile as readFile6, writeFile as writeFile5 } from "node:fs/promises";
-import path12 from "node:path";
+import path13 from "node:path";
 var SITE_API_BASE_URL_ENV_KEY = "VITE_APITOGO_AUTHENTICATION_API_BASE_URL";
 var PLACEHOLDER_HOST_MARKERS = [
   "dp-example.azurecontainerapps.io",
@@ -10538,10 +10613,10 @@ function isPlaceholderDevPortalApiUrl(apiBaseUrl) {
   return PLACEHOLDER_HOST_MARKERS.some((marker) => normalized.includes(marker));
 }
 async function readSiteApiBaseUrl(sourceDirectory) {
-  const resolved = path12.resolve(sourceDirectory);
+  const resolved = path13.resolve(sourceDirectory);
   for (const envFile of [".env", ".env.production"]) {
     try {
-      const content = await readFile6(path12.join(resolved, envFile), "utf8");
+      const content = await readFile6(path13.join(resolved, envFile), "utf8");
       const lines = [...content.matchAll(ENV_LINE_GLOBAL_RE)];
       if (lines.length === 0) {
         continue;
@@ -10566,11 +10641,11 @@ async function readSiteApiBaseUrl(sourceDirectory) {
   return null;
 }
 async function patchSiteApiBaseUrl(sourceDirectory, apiBaseUrl) {
-  const resolved = path12.resolve(sourceDirectory);
+  const resolved = path13.resolve(sourceDirectory);
   const line = `${SITE_API_BASE_URL_ENV_KEY}=${apiBaseUrl}`;
   let patchedExisting = false;
   for (const envFile of [".env.production", ".env"]) {
-    const envPath = path12.join(resolved, envFile);
+    const envPath = path13.join(resolved, envFile);
     try {
       const content = await readFile6(envPath, "utf8");
       const withoutAssignments = content.replace(ENV_LINE_GLOBAL_RE, "").replace(/\n{3,}/g, "\n\n").trimEnd();
@@ -10584,7 +10659,7 @@ ${line}
     }
   }
   if (!patchedExisting) {
-    await writeFile5(path12.join(resolved, ".env"), `${line}
+    await writeFile5(path13.join(resolved, ".env"), `${line}
 `);
   }
 }
@@ -10592,7 +10667,7 @@ function tryProjectId(explicit, manifestProjectId, config2) {
   return explicit?.trim() || manifestProjectId?.trim() || config2.defaultProjectId?.trim() || void 0;
 }
 async function ensureLiveSiteApiBaseUrlForBuild(_client, config2, args, resolveFromProject) {
-  const sourceDirectory = path12.resolve(args.sourceDirectory);
+  const sourceDirectory = path13.resolve(args.sourceDirectory);
   const explicit = args.apiBaseUrl?.trim();
   if (explicit && !isPlaceholderDevPortalApiUrl(explicit)) {
     await patchSiteApiBaseUrl(sourceDirectory, explicit);
@@ -10628,7 +10703,7 @@ async function* walkFiles(root) {
     return;
   }
   for (const entry of entries) {
-    const full = path12.join(root, entry.name);
+    const full = path13.join(root, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name === ".git") {
         continue;
@@ -10640,8 +10715,8 @@ async function* walkFiles(root) {
   }
 }
 async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiBaseUrl) {
-  const dist = path12.resolve(distDirectory);
-  const siteRoot = path12.dirname(dist);
+  const dist = path13.resolve(distDirectory);
+  const siteRoot = path13.dirname(dist);
   const fromEnv = expectedApiBaseUrl?.trim() || await readSiteApiBaseUrl(siteRoot) || await readSiteApiBaseUrl(dist);
   if (!fromEnv || isPlaceholderDevPortalApiUrl(fromEnv)) {
     throw new Error(
@@ -10896,8 +10971,8 @@ function validateDeployArchiveInput(args) {
 async function resolveDevPortalArchive(args) {
   validateDeployArchiveInput(args);
   if (args.archivePath?.trim()) {
-    const archivePath = path13.resolve(args.archivePath.trim());
-    const stat4 = await fs6.stat(archivePath).catch(() => null);
+    const archivePath = path14.resolve(args.archivePath.trim());
+    const stat4 = await fs7.stat(archivePath).catch(() => null);
     if (!stat4?.isFile()) {
       throw new Error(`archivePath is not a file: ${archivePath}`);
     }
@@ -10964,12 +11039,12 @@ async function handleDeployDevPortal(client, config2, args, progress) {
 }
 
 // src/cli/platform/tools/dev-portal-site-build.ts
-import path15 from "node:path";
+import path16 from "node:path";
 
 // src/cli/platform/helpers/npm-build.ts
 import { spawn as spawn2 } from "node:child_process";
 import { access as access3, readFile as readFile7 } from "node:fs/promises";
-import path14 from "node:path";
+import path15 from "node:path";
 var BUILD_LOG_TAIL_BYTES = 8192;
 var MIN_NODE_MAJOR = 20;
 var NpmBuildError = class extends Error {
@@ -11034,13 +11109,13 @@ function runCommand(command, args, cwd, env) {
 }
 async function runNpmInstall(sourceDirectory, options) {
   assertNodeVersion(options?.nodeVersion);
-  const cwd = path14.resolve(sourceDirectory);
-  const packageJsonPath = path14.join(cwd, "package.json");
+  const cwd = path15.resolve(sourceDirectory);
+  const packageJsonPath = path15.join(cwd, "package.json");
   if (!await pathExists2(packageJsonPath)) {
     throw new Error(`package.json not found in sourceDirectory: ${cwd}`);
   }
   const startedAt = Date.now();
-  const lockPath = path14.join(cwd, "package-lock.json");
+  const lockPath = path15.join(cwd, "package-lock.json");
   const installArgs = await pathExists2(lockPath) ? ["ci"] : ["install"];
   const install = await runCommand("npm", installArgs, cwd);
   const installLog = install.output;
@@ -11058,8 +11133,8 @@ async function runNpmInstall(sourceDirectory, options) {
 }
 async function runNpmBuild(sourceDirectory, options) {
   assertNodeVersion(options?.nodeVersion);
-  const cwd = path14.resolve(sourceDirectory);
-  const packageJsonPath = path14.join(cwd, "package.json");
+  const cwd = path15.resolve(sourceDirectory);
+  const packageJsonPath = path15.join(cwd, "package.json");
   if (!await pathExists2(packageJsonPath)) {
     throw new Error(`package.json not found in sourceDirectory: ${cwd}`);
   }
@@ -11076,8 +11151,8 @@ async function runNpmBuild(sourceDirectory, options) {
       build2.exitCode
     );
   }
-  const distPath = path14.join(cwd, "dist");
-  const indexPath = path14.join(distPath, "index.html");
+  const distPath = path15.join(cwd, "dist");
+  const indexPath = path15.join(distPath, "index.html");
   if (!await pathExists2(indexPath)) {
     throw new NpmBuildError(
       `Build completed but dist/index.html was not found at ${indexPath}`,
@@ -11095,7 +11170,7 @@ async function runNpmBuild(sourceDirectory, options) {
 // src/cli/platform/tools/dev-portal-site-build.ts
 async function handleBuildDevPortalSite(client, config2, args, progress) {
   const buildProgress = progress?.child("Build dev portal site");
-  const sourceDirectory = path15.resolve(args.sourceDirectory);
+  const sourceDirectory = path16.resolve(args.sourceDirectory);
   await buildProgress?.onStep("Ensuring live portal API URL");
   const apiBaseUrl = await ensureLiveSiteApiBaseUrlForBuild(
     client,
@@ -11175,10 +11250,10 @@ async function handleBuildDevPortalSite(client, config2, args, progress) {
 // src/cli/platform/helpers/dev-portal-site-validation.ts
 import { readFile as readFile8 } from "node:fs/promises";
 import { createRequire } from "node:module";
-import path16 from "node:path";
+import path17 from "node:path";
 var cachedFallbackTs;
 async function loadTypeScriptForSite(sourceDirectory) {
-  const require2 = createRequire(path16.join(path16.resolve(sourceDirectory), "package.json"));
+  const require2 = createRequire(path17.join(path17.resolve(sourceDirectory), "package.json"));
   try {
     return require2("typescript");
   } catch {
@@ -11222,7 +11297,7 @@ async function referencedFileExists(sourceDirectory, reference) {
   if (/^https?:\/\//i.test(reference)) {
     return true;
   }
-  return pathExists(path16.resolve(sourceDirectory, reference.replace(/^\.\//, "")));
+  return pathExists(path17.resolve(sourceDirectory, reference.replace(/^\.\//, "")));
 }
 async function validateSiteConfigStructure(config2, sourceDirectory) {
   const errors = [];
@@ -11323,11 +11398,11 @@ var DEFAULT_TSX_CANDIDATES = [
   "landing/LandingPage.tsx"
 ];
 async function validateDevPortalSiteConfig(sourceDirectory, options) {
-  const resolvedDir = path16.resolve(sourceDirectory);
+  const resolvedDir = path17.resolve(sourceDirectory);
   const issues = [];
   const checkedFiles = [];
   const skippedChecks = [];
-  const jsonPath = path16.join(resolvedDir, APITOGO_CONFIG_FILENAME);
+  const jsonPath = path17.join(resolvedDir, APITOGO_CONFIG_FILENAME);
   if (await pathExists(jsonPath)) {
     checkedFiles.push(APITOGO_CONFIG_FILENAME);
     let parsed;
@@ -11356,7 +11431,7 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
   );
   const existingTsxFiles = [];
   for (const relativeFile of tsxFiles) {
-    if (await pathExists(path16.join(resolvedDir, relativeFile))) {
+    if (await pathExists(path17.join(resolvedDir, relativeFile))) {
       existingTsxFiles.push(relativeFile);
     }
   }
@@ -11369,7 +11444,7 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
     } else {
       for (const relativeFile of existingTsxFiles) {
         checkedFiles.push(relativeFile);
-        const content = await readFile8(path16.join(resolvedDir, relativeFile), "utf8");
+        const content = await readFile8(path17.join(resolvedDir, relativeFile), "utf8");
         issues.push(
           ...checkTsxSyntax(ts, relativeFile, content).map((message) => ({
             file: relativeFile,
@@ -11407,8 +11482,8 @@ function normalizeActionKeyFormat(actionKey) {
   const trimmed = actionKey.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path67 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path67.startsWith("/") ? path67 : `/${path67}`}`;
+    const path70 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path70.startsWith("/") ? path70 : `/${path70}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -11417,8 +11492,8 @@ function normalizeActionKeyFormat(actionKey) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path66 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path66.startsWith("/") ? path66 : `/${path66}`}`;
+  const path69 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path69.startsWith("/") ? path69 : `/${path69}`}`;
 }
 function normalizePublicRoute(route) {
   const trimmed = route.trim();
@@ -12299,7 +12374,7 @@ function resultLooksFailed(payload) {
   }
 }
 async function apply(argv) {
-  const sourceDirectory = path17.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path18.resolve(process.cwd(), argv.dir);
   const config2 = loadConfig();
   const client = new PlatformApiClient(config2);
   let only;
@@ -12384,11 +12459,11 @@ var apply_default = {
 };
 
 // src/cli/build/handler.ts
-import path48 from "node:path";
+import path49 from "node:path";
 
 // src/vite/build.ts
 import { mkdir as mkdir9, readFile as readFile11, rename, rm as rm3, writeFile as writeFile10 } from "node:fs/promises";
-import path46 from "node:path";
+import path47 from "node:path";
 import { build as esbuild } from "esbuild";
 import { build as viteBuild, mergeConfig as mergeConfig3 } from "vite";
 
@@ -12524,7 +12599,7 @@ init_invariant();
 init_joinUrl();
 
 // src/vite/config.ts
-import path41 from "node:path";
+import path42 from "node:path";
 import dotenv from "dotenv";
 import colors5 from "picocolors";
 import {
@@ -12535,7 +12610,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.94",
+  version: "0.1.96",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -12965,25 +13040,25 @@ async function loadDevPortalViteDefines(rootDir, mode) {
 
 // src/vite/package-root.ts
 init_file_exists();
-import path23 from "node:path";
+import path24 from "node:path";
 var findPackageRoot = async (startDir) => {
   let dir = startDir;
-  while (dir !== path23.dirname(dir)) {
-    if (await fileExists(path23.join(dir, "package.json"))) return dir;
-    dir = path23.dirname(dir);
+  while (dir !== path24.dirname(dir)) {
+    if (await fileExists(path24.join(dir, "package.json"))) return dir;
+    dir = path24.dirname(dir);
   }
 };
 
 // src/vite/pagefind-dev-stub.ts
-import fs7 from "node:fs/promises";
-import path24 from "node:path";
+import fs8 from "node:fs/promises";
+import path25 from "node:path";
 var NOT_BUILT_YET = 'throw new Error("NOT_BUILT_YET");';
 async function ensurePagefindDevStub(publicDir) {
-  const pagefindPath = path24.join(publicDir, "pagefind/pagefind.js");
-  const exists = await fs7.stat(pagefindPath).catch(() => false);
+  const pagefindPath = path25.join(publicDir, "pagefind/pagefind.js");
+  const exists = await fs8.stat(pagefindPath).catch(() => false);
   if (!exists) {
-    await fs7.mkdir(path24.dirname(pagefindPath), { recursive: true });
-    await fs7.writeFile(pagefindPath, NOT_BUILT_YET);
+    await fs8.mkdir(path25.dirname(pagefindPath), { recursive: true });
+    await fs8.writeFile(pagefindPath, NOT_BUILT_YET);
   }
 }
 
@@ -12994,7 +13069,7 @@ import react from "@vitejs/plugin-react";
 // src/vite/css/plugin.ts
 init_loader();
 init_plugin_theme();
-import path25 from "node:path";
+import path26 from "node:path";
 import { isCSSRequest as isCSSRequest2 } from "vite";
 
 // src/vite/css/collect.ts
@@ -13029,7 +13104,7 @@ var VIRTUAL_ENTRY = "virtual:ssr-css.css";
 function vitePluginSsrCss(pluginOpts) {
   let server;
   const config2 = getCurrentConfig();
-  const virtualHref = path25.join(
+  const virtualHref = path26.join(
     config2.basePath ?? "",
     `/@id/__x00__${VIRTUAL_ENTRY}?direct`
   );
@@ -13165,8 +13240,8 @@ var viteApiKeysPlugin = () => {
 var plugin_api_keys_default = viteApiKeysPlugin;
 
 // src/vite/plugin-api.ts
-import fs9 from "node:fs/promises";
-import path31 from "node:path";
+import fs10 from "node:fs/promises";
+import path32 from "node:path";
 import { deepEqual as deepEqual2 } from "fast-equals";
 import { runnerImport as runnerImport3 } from "vite";
 init_package_json();
@@ -13175,7 +13250,7 @@ init_loader();
 // src/config/validators/BuildSchema.ts
 init_file_exists();
 init_loader();
-import path26 from "node:path";
+import path27 from "node:path";
 import { runnerImport as runnerImport2 } from "vite";
 import { z as z10 } from "zod";
 var BuildProcessorSchema = z10.custom((val) => typeof val === "function");
@@ -13204,7 +13279,7 @@ var buildConfigFiles = [
 ];
 async function getBuildConfigFilePath(rootDir) {
   for (const fileName of buildConfigFiles) {
-    const filepath = path26.join(rootDir, fileName);
+    const filepath = path27.join(rootDir, fileName);
     if (await fileExists(filepath)) {
       return filepath;
     }
@@ -13313,14 +13388,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path66 = []) => {
-  const transformed = transform(specification, path66);
+var traverse = (specification, transform, path69 = []) => {
+  const transformed = transform(specification, path69);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path66, key];
+    const currentPath = [...path69, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -13348,9 +13423,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path66 = ref.split("/").slice(1);
+  const path69 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path66) {
+  for (const segment of path69) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -13369,7 +13444,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path66) => {
+  const resolve = async (current, path69) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -13377,7 +13452,7 @@ var dereference = async (schema2, resolvers = []) => {
       visited.add(current);
       if (Array.isArray(current)) {
         for (let index = 0; index < current.length; index++) {
-          current[index] = await resolve(current[index], `${path66}/${index}`);
+          current[index] = await resolve(current[index], `${path69}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -13388,13 +13463,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path66);
+              result2 = await resolve(resolved, path69);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path66);
+            result2 = await resolve(resolved, path69);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -13407,7 +13482,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path66}/${key}`);
+          current[key] = await resolve(current[key], `${path69}/${key}`);
         }
       }
       visited.delete(current);
@@ -13446,9 +13521,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path66) => {
+  schema2 = traverse(schema2, (sub, path69) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path66 ?? [])) {
+      if (isSchemaPath(path69 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -13461,11 +13536,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path66) => {
+  schema2 = traverse(schema2, (schema3, path69) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path66?.slice(0, -1);
+      const parentPath = path69?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path66?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path69?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -13479,8 +13554,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path66) => {
-    if (path66?.includes("content") && path66.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path69) => {
+    if (path69?.includes("content") && path69.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -13506,11 +13581,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path66) => {
+  schema2 = traverse(schema2, (schema3, path69) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path66?.slice(0, -1);
+      const parentPath = path69?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path66?.[index - 1] === "content"
+        (_, index) => path69?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -13522,7 +13597,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path66) {
+function isSchemaPath(path69) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -13535,10 +13610,10 @@ function isSchemaPath(path66) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path66[index] === segment);
+      return location.every((segment, index) => path69[index] === segment);
     }
-    return path66.includes(location);
-  }) || path66.includes("schema") || path66.some((segment) => segment.endsWith("Schema"));
+    return path69.includes(location);
+  }) || path69.includes("schema") || path69.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -13620,13 +13695,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path66 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path69 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
   if (obj === null || typeof obj !== "object") return obj;
   const refPath = obj.__$ref;
   const isCircular = currentPath.has(obj) || typeof refPath === "string" && currentRefPaths.has(refPath);
   if (isCircular) {
     if (typeof refPath === "string") return SCHEMA_REF_PREFIX + refPath;
-    const circularProp = path66.find((p) => !OPENAPI_PROPS.has(p)) || path66[0];
+    const circularProp = path69.find((p) => !OPENAPI_PROPS.has(p)) || path69[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -13636,7 +13711,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path66, key],
+    [...path69, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -13671,7 +13746,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path66) => HttpMethods.map((k) => path66?.[k]).filter((op) => op != null)
+    (path69) => HttpMethods.map((k) => path69?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -13726,7 +13801,7 @@ var getAllSlugs = (ops, schemaTags = []) => {
 var getOperationSlugKey = (op) => [op.path, op.method, op.operationId, op.summary].filter(Boolean).join("-");
 var getAllOperations = (paths) => {
   const operations = Object.entries(paths ?? {}).flatMap(
-    ([path66, value]) => HttpMethods.flatMap((method) => {
+    ([path69, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -13746,7 +13821,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path66,
+        path: path69,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -14104,8 +14179,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path66, value]) => ({
-        path: path66,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path69, value]) => ({
+        path: path69,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -14217,8 +14292,8 @@ function injectApitogoGatewayServer(options) {
 var ensureArray = (value) => Array.isArray(value) ? value : [value];
 
 // src/vite/api/SchemaManager.ts
-import fs8 from "node:fs/promises";
-import path27 from "node:path";
+import fs9 from "node:fs/promises";
+import path28 from "node:path";
 import {
   $RefParser as $RefParser2
 } from "@apidevtools/json-schema-ref-parser";
@@ -14270,7 +14345,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path66) => path66.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path69) => path69.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -14301,16 +14376,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup2 = (schema2, path66, filePath) => {
-  const parts = getSegmentsFromPath(path66);
+var lookup2 = (schema2, path69, filePath) => {
+  const parts = getSegmentsFromPath(path69);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path66 ? val : lookup2(schema2, val.$ref, filePath);
+      val = val.$ref === path69 ? val : lookup2(schema2, val.$ref, filePath);
     }
     if (val[part] === void 0) {
       throw new Error(
-        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path66}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path69}`
       );
     }
     val = val[part];
@@ -14408,18 +14483,18 @@ var SchemaManager = class {
     ];
   }
   getPathForFile = (input3, params) => {
-    const filePath = path27.resolve(this.config.__meta.rootDir, input3);
+    const filePath = path28.resolve(this.config.__meta.rootDir, input3);
     const apis = ensureArray(this.config.apis ?? []);
     for (const apiConfig of apis) {
       if (!apiConfig || apiConfig.type !== "file" || !apiConfig.path) continue;
       const match = normalizeInputs(apiConfig.input).some(
-        (i) => path27.resolve(this.config.__meta.rootDir, i.input) === filePath && deepEqual(i.params, params)
+        (i) => path28.resolve(this.config.__meta.rootDir, i.input) === filePath && deepEqual(i.params, params)
       );
       if (match) return apiConfig.path;
     }
   };
   processSchema = async (input3) => {
-    const filePath = path27.resolve(this.config.__meta.rootDir, input3.input);
+    const filePath = path28.resolve(this.config.__meta.rootDir, input3.input);
     const params = input3.params;
     const configuredPath = this.getPathForFile(input3.input, params);
     if (!configuredPath) {
@@ -14455,15 +14530,15 @@ var SchemaManager = class {
     const processedTime = Date.now();
     const code = generateCode(processedSchema, filePath);
     const prefixPath = slugify(configuredPath);
-    const processedFilePath = path27.posix.join(
+    const processedFilePath = path28.posix.join(
       this.storeDir,
-      `${prefixPath}-${path27.basename(filePath)}${paramsSuffix(params)}.js`
+      `${prefixPath}-${path28.basename(filePath)}${paramsSuffix(params)}.js`
     );
     const importKey = processedFilePath;
-    await fs8.writeFile(processedFilePath, code);
+    await fs9.writeFile(processedFilePath, code);
     const processedJsonPath = paramsSuffix(params) ? processedFilePath.replace(/\.js$/, ".json") : "";
     if (processedJsonPath) {
-      await fs8.writeFile(
+      await fs9.writeFile(
         processedJsonPath,
         JSON.stringify(processedSchema, null, 2)
       );
@@ -14506,7 +14581,7 @@ var SchemaManager = class {
   };
   getAllTrackedFiles = () => Array.from(this.referencedBy.keys());
   getFilesToReprocess = (changedFile) => {
-    const resolvedPath = path27.resolve(this.config.__meta.rootDir, changedFile);
+    const resolvedPath = path28.resolve(this.config.__meta.rootDir, changedFile);
     const referencedBy = this.referencedBy.get(resolvedPath);
     if (!referencedBy) return [];
     const filesToProcess = referencedBy.size === 0 ? [resolvedPath] : Array.from(referencedBy);
@@ -14535,7 +14610,7 @@ var SchemaManager = class {
         version: "",
         path: input3.path ?? "",
         label: input3.label,
-        inputPath: path27.resolve(this.config.__meta.rootDir, input3.input),
+        inputPath: path28.resolve(this.config.__meta.rootDir, input3.input),
         params: input3.params,
         importKey: "",
         downloadUrl: "",
@@ -14555,8 +14630,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path66) => this.processedSchemas[path66]?.at(0);
-  getSchemasForPath = (path66) => this.processedSchemas[path66];
+  getLatestSchema = (path69) => this.processedSchemas[path69]?.at(0);
+  getSchemasForPath = (path69) => this.processedSchemas[path69];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -14578,7 +14653,7 @@ var SchemaManager = class {
   };
   createSchemaPath = (inputPath, versionPath, apiPath, params) => {
     const suffix = paramsSuffix(params);
-    const extension = suffix ? ".json" : path27.extname(inputPath);
+    const extension = suffix ? ".json" : path28.extname(inputPath);
     return joinUrl(
       this.config.basePath,
       apiPath,
@@ -14601,7 +14676,7 @@ var SchemaManager = class {
 // src/vite/plugin-config-reload.ts
 init_logger();
 init_loader();
-import path30 from "node:path";
+import path31 from "node:path";
 import colors4 from "picocolors";
 
 // src/vite/plugin-navigation.ts
@@ -14611,7 +14686,7 @@ import { stringify as stringify3 } from "javascript-stringify";
 import { isElement } from "react-is";
 
 // src/config/validators/NavigationSchema.ts
-import path28 from "node:path";
+import path29 from "node:path";
 import { glob } from "glob";
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { mdxFromMarkdown } from "mdast-util-mdx";
@@ -14662,7 +14737,7 @@ var extractRichH1 = (content) => {
   }
 };
 var isNavigationItem = (item) => item !== void 0;
-var toPosixPath = (filePath) => filePath.split(path28.win32.sep).join(path28.posix.sep);
+var toPosixPath = (filePath) => filePath.split(path29.win32.sep).join(path29.posix.sep);
 var NavigationResolver = class {
   rootDir;
   globPatterns;
@@ -14795,13 +14870,13 @@ init_invariant();
 
 // src/vite/debug.ts
 import { mkdir as mkdir5, writeFile as writeFile6 } from "node:fs/promises";
-import path29 from "node:path";
+import path30 from "node:path";
 async function writePluginDebugCode(rootDir, pluginName, code, extension = "js") {
   if (process.env.ZUDOKU_BUILD_DEBUG) {
-    const debugDir = path29.join(rootDir, "dist", "debug");
+    const debugDir = path30.join(rootDir, "dist", "debug");
     await mkdir5(debugDir, { recursive: true });
     await writeFile6(
-      path29.join(debugDir, `${pluginName}.${extension}`),
+      path30.join(debugDir, `${pluginName}.${extension}`),
       typeof code === "string" ? code : code.join("\n")
     );
   }
@@ -14910,7 +14985,7 @@ var viteConfigReloadPlugin = () => ({
       reload(server);
       logger.info(
         colors4.blue(
-          `Config ${path30.basename(currentConfig.__meta.configPath)} changed. Reloading...`
+          `Config ${path31.basename(currentConfig.__meta.configPath)} changed. Reloading...`
         ),
         { timestamp: true }
       );
@@ -14924,11 +14999,11 @@ var viteApiPlugin = async () => {
   const resolvedVirtualModuleId5 = `\0${virtualModuleId4}`;
   const initialConfig = getCurrentConfig();
   const zuploProcessors = ZuploEnv.isZuplo ? await runnerImport3(
-    path31.resolve(getZudokuRootDir(), "src/zuplo/with-zuplo-processors.ts")
+    path32.resolve(getZudokuRootDir(), "src/zuplo/with-zuplo-processors.ts")
   ).then((m) => m.module.default(initialConfig.__meta.rootDir)) : [];
   const buildConfig = await getBuildConfig();
   const buildProcessors = buildConfig?.processors ?? [];
-  const tmpStoreDir = path31.posix.join(
+  const tmpStoreDir = path32.posix.join(
     initialConfig.__meta.rootDir,
     "node_modules/.apitogo/processed"
   );
@@ -14945,8 +15020,8 @@ var viteApiPlugin = async () => {
   return {
     name: "zudoku-api-plugins",
     async buildStart() {
-      await fs9.rm(tmpStoreDir, { recursive: true, force: true });
-      await fs9.mkdir(tmpStoreDir, { recursive: true });
+      await fs10.rm(tmpStoreDir, { recursive: true, force: true });
+      await fs10.mkdir(tmpStoreDir, { recursive: true });
       await schemaManager.processAllSchemas();
       schemaManager.getAllTrackedFiles().forEach((file) => this.addWatchFile(file));
     },
@@ -14959,8 +15034,8 @@ var viteApiPlugin = async () => {
         const pathMap = schemaManager.getUrlToFilePathMap();
         const inputPath = pathMap.get(req.url);
         if (!inputPath) return next();
-        const content = await fs9.readFile(inputPath, "utf-8");
-        const mimeType = path31.extname(inputPath).toLowerCase() === ".json" ? "application/json" : "application/x-yaml";
+        const content = await fs10.readFile(inputPath, "utf-8");
+        const mimeType = path32.extname(inputPath).toLowerCase() === ".json" ? "application/json" : "application/x-yaml";
         res.setHeader("Content-Type", `${mimeType}; charset=utf-8`);
         return res.end(content);
       });
@@ -15147,10 +15222,10 @@ var viteApiPlugin = async () => {
       const pathMap = schemaManager.getUrlToFilePathMap();
       if (process.env.NODE_ENV !== "production") return;
       for (const [urlPath, inputPath] of pathMap) {
-        const content = await fs9.readFile(inputPath, "utf-8");
-        const outputPath = path31.join(config2.__meta.rootDir, "dist", urlPath);
-        await fs9.mkdir(path31.dirname(outputPath), { recursive: true });
-        await fs9.writeFile(outputPath, content, "utf-8");
+        const content = await fs10.readFile(inputPath, "utf-8");
+        const outputPath = path32.join(config2.__meta.rootDir, "dist", urlPath);
+        await fs10.mkdir(path32.dirname(outputPath), { recursive: true });
+        await fs10.writeFile(outputPath, content, "utf-8");
       }
     }
   };
@@ -15192,7 +15267,7 @@ var plugin_auth_default = viteAuthPlugin;
 
 // src/vite/plugin-component.ts
 init_loader();
-import path32 from "node:path";
+import path33 from "node:path";
 var viteAliasPlugin = () => {
   return {
     name: "zudoku-component-plugin",
@@ -15220,7 +15295,7 @@ var viteAliasPlugin = () => {
       ];
       const aliases = replacements.map(([find, replacement]) => ({
         find,
-        replacement: path32.posix.join(config2.__meta.moduleDir, replacement)
+        replacement: path33.posix.join(config2.__meta.moduleDir, replacement)
       }));
       return config2.__meta.mode === "internal" || config2.__meta.mode === "standalone" ? { resolve: { alias: aliases } } : void 0;
     }
@@ -15231,11 +15306,11 @@ var plugin_component_default = viteAliasPlugin;
 // src/vite/plugin-config.ts
 init_package_json();
 init_loader();
-import path33 from "node:path";
+import path34 from "node:path";
 import { normalizePath } from "vite";
 var virtualModuleId3 = "virtual:zudoku-config";
 var resolvedVirtualModuleId3 = `\0${virtualModuleId3}`;
-var browserConfigLoaderPath = path33.join(
+var browserConfigLoaderPath = path34.join(
   getZudokuRootDir(),
   "src/config/apitogo-config-loader.browser.ts"
 );
@@ -15406,7 +15481,7 @@ var viteDocMetadataPlugin = () => ({
 
 // src/vite/plugin-docs.ts
 init_loader();
-import path34 from "node:path";
+import path35 from "node:path";
 import { glob as glob3 } from "glob";
 import globParent from "glob-parent";
 init_ZudokuConfig();
@@ -15475,7 +15550,7 @@ var globMarkdownFiles = async (config2, options = { absolute: false }) => {
     if (process.env.NODE_ENV !== "development") {
       const draftStatuses = await Promise.all(
         globbedFiles.map(async (file) => {
-          const absolutePath = path34.resolve(config2.__meta.rootDir, file);
+          const absolutePath = path35.resolve(config2.__meta.rootDir, file);
           const { data } = await readFrontmatter(absolutePath);
           return { file, isDraft: data.draft === true };
         })
@@ -15488,9 +15563,9 @@ var globMarkdownFiles = async (config2, options = { absolute: false }) => {
       if (draftFiles.has(file)) {
         continue;
       }
-      const relativePath = path34.posix.relative(parent, file);
+      const relativePath = path35.posix.relative(parent, file);
       const routePath = ensureLeadingSlash(relativePath.replace(/\.mdx?$/, ""));
-      const filePath = options.absolute ? path34.resolve(config2.__meta.rootDir, file) : file;
+      const filePath = options.absolute ? path35.resolve(config2.__meta.rootDir, file) : file;
       fileMapping[routePath] = filePath;
     }
   }
@@ -15554,7 +15629,7 @@ var viteDocsPlugin = () => {
       const globbedDocuments = {};
       for (const [routePath, file] of Object.entries(fileMapping)) {
         const importPath = ensureLeadingSlash(
-          path34.posix.join(globImportBasePath, file)
+          path35.posix.join(globImportBasePath, file)
         );
         globbedDocuments[routePath] = importPath;
       }
@@ -15580,7 +15655,7 @@ var plugin_docs_default = viteDocsPlugin;
 // src/vite/plugin-local-manifest.ts
 init_apitogo_config_loader();
 init_local_manifest();
-import path35 from "node:path";
+import path36 from "node:path";
 var APITOGO_LOCAL_MANIFEST_VIRTUAL_ID = "virtual:apitogo-local-manifest";
 var resolvedVirtualModuleId4 = `\0${APITOGO_LOCAL_MANIFEST_VIRTUAL_ID}`;
 var viteLocalManifestPlugin = () => {
@@ -15630,8 +15705,8 @@ var viteLocalManifestPlugin = () => {
         server.watcher.add(watchPath);
       }
       server.watcher.on("change", async (changedPath) => {
-        const resolvedChanged = path35.resolve(changedPath);
-        if (!watchPaths.some((p) => path35.resolve(p) === resolvedChanged)) {
+        const resolvedChanged = path36.resolve(changedPath);
+        if (!watchPaths.some((p) => path36.resolve(p) === resolvedChanged)) {
           return;
         }
         const module = server.moduleGraph.getModuleById(
@@ -15658,7 +15733,7 @@ init_loader();
 init_ProtectedRoutesSchema();
 init_joinUrl();
 import { mkdir as mkdir6, writeFile as writeFile7 } from "node:fs/promises";
-import path36 from "node:path";
+import path37 from "node:path";
 import { matchPath } from "react-router";
 var processMarkdownFile = async (filePath) => {
   const { content: markdownContent, data: frontmatter } = await readFrontmatter(filePath);
@@ -15746,7 +15821,7 @@ var viteMarkdownExportPlugin = () => {
       if (process.env.NODE_ENV !== "production" || Object.keys(markdownFiles).length === 0 || !needsMdFiles) {
         return;
       }
-      const distDir = path36.join(
+      const distDir = path37.join(
         config2.__meta.rootDir,
         "dist",
         config2.basePath ?? ""
@@ -15767,15 +15842,15 @@ var viteMarkdownExportPlugin = () => {
             content: finalMarkdown
           });
           const segments = routePath === "/" ? ["index"] : routePath.split("/").filter(Boolean);
-          const outputPath = `${path36.join(distDir, ...segments)}.md`;
-          await mkdir6(path36.dirname(outputPath), { recursive: true });
+          const outputPath = `${path37.join(distDir, ...segments)}.md`;
+          await mkdir6(path37.dirname(outputPath), { recursive: true });
           await writeFile7(outputPath, finalMarkdown, "utf-8");
         } catch (error) {
           console.warn(`Failed to export markdown for ${routePath}:`, error);
         }
       }
       if (config2.docs?.llms?.llmsTxt || config2.docs?.llms?.llmsTxtFull) {
-        const markdownInfoPath = path36.join(
+        const markdownInfoPath = path37.join(
           config2.__meta.rootDir,
           "node_modules/.apitogo/markdown-info.json"
         );
@@ -15927,9 +16002,9 @@ var remarkCodeTabs = () => (tree) => {
 };
 
 // src/vite/mdx/remark-inject-filepath.ts
-import path37 from "node:path";
+import path38 from "node:path";
 var remarkInjectFilepath = (rootDir) => (tree, vfile) => {
-  const relativePath = path37.relative(rootDir, vfile.path).split(path37.sep).join(path37.posix.sep);
+  const relativePath = path38.relative(rootDir, vfile.path).split(path38.sep).join(path38.posix.sep);
   tree.children.unshift(exportMdxjsConst("__filepath", relativePath));
 };
 
@@ -16016,18 +16091,18 @@ var remarkLastModified = () => {
 };
 
 // src/vite/mdx/remark-link-rewrite.ts
-import path38 from "node:path";
+import path39 from "node:path";
 import { visit as visit5 } from "unist-util-visit";
 var remarkLinkRewrite = (basePath = "") => (tree) => {
   visit5(tree, "link", (node) => {
     if (!node.url) return;
     if (node.url.startsWith("http") || node.url.startsWith("mailto:")) return;
     node.url = node.url.replace(/\\/g, "/");
-    const base = path38.posix.join(basePath);
+    const base = path39.posix.join(basePath);
     if (basePath && node.url.startsWith(base)) {
       node.url = node.url.slice(base.length);
     } else if (!node.url.startsWith("/") && !node.url.startsWith("#")) {
-      node.url = path38.posix.join("..", node.url);
+      node.url = path39.posix.join("..", node.url);
     }
     node.url = node.url.replace(/\.mdx?(#.*)?$/, "$1");
   });
@@ -16247,14 +16322,14 @@ var plugin_mdx_default = viteMdxPlugin;
 
 // src/vite/plugin-modules.ts
 init_loader();
-import path39 from "node:path";
+import path40 from "node:path";
 import { normalizePath as normalizePath2 } from "vite";
-var getLandingModuleImport = (moduleDir, mode) => mode === "internal" ? normalizePath2(path39.join(moduleDir, "../module-landing/src/index.tsx")) : "@lukoweb/apitogo-module-landing";
-var getUserPanelModuleImport = (moduleDir, mode) => mode === "internal" ? normalizePath2(path39.join(moduleDir, "../module-user-panel/src/index.tsx")) : "@lukoweb/apitogo-module-user-panel";
+var getLandingModuleImport = (moduleDir, mode) => mode === "internal" ? normalizePath2(path40.join(moduleDir, "../module-landing/src/index.tsx")) : "@lukoweb/apitogo-module-landing";
+var getUserPanelModuleImport = (moduleDir, mode) => mode === "internal" ? normalizePath2(path40.join(moduleDir, "../module-user-panel/src/index.tsx")) : "@lukoweb/apitogo-module-user-panel";
 var getBillingPluginImport = (moduleDir, mode) => mode === "internal" ? normalizePath2(
-  path39.join(moduleDir, "../plugin-dev-portal-billing/src/index.ts")
+  path40.join(moduleDir, "../plugin-dev-portal-billing/src/index.ts")
 ) : "@lukoweb/apitogo-plugin-dev-portal-billing";
-var resolveProjectPageImport = (rootDir, pagePath) => normalizePath2(path39.resolve(rootDir, pagePath));
+var resolveProjectPageImport = (rootDir, pagePath) => normalizePath2(path40.resolve(rootDir, pagePath));
 var viteModulesPlugin = () => {
   const virtualModuleId4 = "virtual:zudoku-modules-plugin";
   const resolvedVirtualModuleId5 = `\0${virtualModuleId4}`;
@@ -16394,7 +16469,7 @@ var plugin_modules_default = viteModulesPlugin;
 
 // src/vite/plugin-search.ts
 init_loader();
-import path40 from "node:path";
+import path41 from "node:path";
 var viteSearchPlugin = () => {
   const virtualModuleId4 = "virtual:zudoku-search-plugin";
   const resolvedVirtualModuleId5 = `\0${virtualModuleId4}`;
@@ -16412,7 +16487,7 @@ var viteSearchPlugin = () => {
         return resolvedVirtualModuleId5;
       }
       if (id === "/pagefind/pagefind.js" && resolvedViteConfig?.publicDir) {
-        return path40.join(resolvedViteConfig.publicDir, "pagefind/pagefind.js");
+        return path41.join(resolvedViteConfig.publicDir, "pagefind/pagefind.js");
       }
     },
     async load(id) {
@@ -16551,17 +16626,17 @@ function vitePlugin() {
 }
 
 // src/vite/config.ts
-var browserConfigLoaderPath2 = path41.join(
+var browserConfigLoaderPath2 = path42.join(
   getZudokuRootDir(),
   "src/config/apitogo-config-loader.browser.ts"
 );
 var resolveMergedPublicDir = (rootDir, merged) => {
   if (merged.publicDir === false) return void 0;
   const rel = typeof merged.publicDir === "string" ? merged.publicDir : "public";
-  return path41.resolve(rootDir, rel);
+  return path42.resolve(rootDir, rel);
 };
-var getAppClientEntryPath = () => path41.posix.join(getZudokuRootDir(), "src/app/entry.client.tsx");
-var getAppServerEntryPath = () => path41.posix.join(getZudokuRootDir(), "src/app/entry.server.tsx");
+var getAppClientEntryPath = () => path42.posix.join(getZudokuRootDir(), "src/app/entry.client.tsx");
+var getAppServerEntryPath = () => path42.posix.join(getZudokuRootDir(), "src/app/entry.server.tsx");
 var hasLoggedCdnInfo = false;
 var MEDIA_REGEX = /\.(a?png|jpe?g|gif|bmp|svg|webp|tiff|ico|webm|ogg|mp3|wav|m4a|avif|mp4)/i;
 var defineEnvVars = (vars) => Object.fromEntries(
@@ -16591,7 +16666,7 @@ async function getViteConfig(dir, configEnv) {
   );
   if (ZuploEnv.isZuplo) {
     dotenv.config({
-      path: path41.resolve(config2.__meta.rootDir, "../.env.zuplo"),
+      path: path42.resolve(config2.__meta.rootDir, "../.env.zuplo"),
       quiet: true
     });
   }
@@ -16616,11 +16691,11 @@ async function getViteConfig(dir, configEnv) {
       client: {
         resolve: {
           alias: {
-            [path41.join(
+            [path42.join(
               getZudokuRootDir(),
               "src/config/apitogo-config-loader.node.ts"
             )]: browserConfigLoaderPath2,
-            [path41.join(
+            [path42.join(
               getZudokuRootDir(),
               "src/config/apitogo-config-loader.node.js"
             )]: browserConfigLoaderPath2
@@ -16666,8 +16741,8 @@ async function getViteConfig(dir, configEnv) {
       ssr: configEnv.isSsrBuild,
       sourcemap: true,
       target: "es2022",
-      outDir: path41.resolve(
-        path41.join(
+      outDir: path42.resolve(
+        path42.join(
           dir,
           "dist",
           config2.basePath ?? "",
@@ -16686,7 +16761,7 @@ async function getViteConfig(dir, configEnv) {
     },
     experimental: {
       renderBuiltUrl(filename) {
-        if (cdnUrl?.base && [".js", ".css"].includes(path41.extname(filename))) {
+        if (cdnUrl?.base && [".js", ".css"].includes(path42.extname(filename))) {
           return joinUrl(cdnUrl.base, filename);
         }
         if (cdnUrl?.media && MEDIA_REGEX.test(filename)) {
@@ -16699,7 +16774,7 @@ async function getViteConfig(dir, configEnv) {
       esbuildOptions: {
         target: "es2022"
       },
-      entries: [path41.posix.join(getZudokuRootDir(), "src/{app,lib}/**")],
+      entries: [path42.posix.join(getZudokuRootDir(), "src/{app,lib}/**")],
       exclude: [
         "@lukoweb/apitogo",
         "@lukoweb/apitogo-plugin-dev-portal-billing"
@@ -16805,7 +16880,7 @@ init_package_json();
 init_joinUrl();
 import assert from "node:assert";
 import { cp, mkdir as mkdir7, writeFile as writeFile8 } from "node:fs/promises";
-import path42 from "node:path";
+import path43 from "node:path";
 var pkgJson = getZudokuPackageJson();
 function generateOutput({
   config: config2,
@@ -16862,9 +16937,9 @@ async function writeOutput(dir, {
   rewrites
 }) {
   const output2 = generateOutput({ config: config2, redirects, rewrites });
-  const outputDir = process.env.VERCEL ? path42.join(dir, ".vercel/output") : path42.join(dir, "dist/.output");
+  const outputDir = process.env.VERCEL ? path43.join(dir, ".vercel/output") : path43.join(dir, "dist/.output");
   await mkdir7(outputDir, { recursive: true });
-  const outputFile = path42.join(outputDir, "config.json");
+  const outputFile = path43.join(outputDir, "config.json");
   await writeFile8(outputFile, JSON.stringify(output2, null, 2), "utf-8");
   if (process.env.VERCEL) {
     console.log("Wrote Vercel output to", outputDir);
@@ -16876,7 +16951,7 @@ init_logger();
 init_file_exists();
 import { readFile as readFile10, rm as rm2 } from "node:fs/promises";
 import os from "node:os";
-import path45 from "node:path";
+import path46 from "node:path";
 import { pathToFileURL } from "node:url";
 import { createIndex } from "pagefind";
 import colors8 from "picocolors";
@@ -16918,7 +16993,7 @@ function throttle(fn) {
 init_joinUrl();
 import { createWriteStream as createWriteStream3, existsSync as existsSync3 } from "node:fs";
 import { mkdir as mkdir8 } from "node:fs/promises";
-import path43 from "node:path";
+import path44 from "node:path";
 import colors6 from "picocolors";
 import { SitemapStream } from "sitemap";
 async function generateSitemap({
@@ -16932,11 +17007,11 @@ async function generateSitemap({
     return;
   }
   const sitemap = new SitemapStream({ hostname: config2.siteUrl });
-  const outputDir = path43.resolve(baseOutputDir, config2.outDir ?? "");
+  const outputDir = path44.resolve(baseOutputDir, config2.outDir ?? "");
   if (!existsSync3(outputDir)) {
     await mkdir8(outputDir, { recursive: true });
   }
-  const sitemapOutputPath = path43.join(outputDir, "sitemap.xml");
+  const sitemapOutputPath = path44.join(outputDir, "sitemap.xml");
   const writeStream = createWriteStream3(sitemapOutputPath);
   sitemap.pipe(writeStream);
   let lastmod;
@@ -16966,14 +17041,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path66) => {
-  const segments = path66.split("/");
+var resolveRoutePath = (path69) => {
+  const segments = path69.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path66) => path66.includes("*") || /^\d+$/.test(path66);
+var isSkipped = (path69) => path69.includes("*") || /^\d+$/.test(path69);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -17022,12 +17097,12 @@ var prerender = async ({
   serverConfigFilename,
   writeRedirects = true
 }) => {
-  const distDir = path45.join(dir, "dist", basePath);
+  const distDir = path46.join(dir, "dist", basePath);
   const serverConfigPath = pathToFileURL(
-    path45.join(distDir, "server", serverConfigFilename)
+    path46.join(distDir, "server", serverConfigFilename)
   ).href;
   const entryServerPath = pathToFileURL(
-    path45.join(distDir, "server/entry.server.js")
+    path46.join(distDir, "server/entry.server.js")
   ).href;
   const rawConfig = await import(serverConfigPath).then(
     (m) => m.default
@@ -17112,7 +17187,7 @@ var prerender = async ({
     })
   );
   const pagefindWriteResult = await pagefindIndex?.writeFiles({
-    outputPath: path45.join(distDir, "pagefind")
+    outputPath: path46.join(distDir, "pagefind")
   });
   const seconds = ((performance.now() - start) / 1e3).toFixed(1);
   const message = `\u2713 finished prerendering ${paths.length} routes in ${seconds} seconds using ${maxThreads} workers`;
@@ -17144,7 +17219,7 @@ var prerender = async ({
     const { generateLlmsTxtFiles: generateLlmsTxtFiles2 } = await Promise.resolve().then(() => (init_llms(), llms_exports));
     const docsConfig = DocsConfigSchema2.parse(config2.docs);
     const llmsConfig = docsConfig.llms ?? {};
-    const markdownInfoPath = path45.join(
+    const markdownInfoPath = path46.join(
       dir,
       "node_modules/.apitogo/markdown-info.json"
     );
@@ -17235,7 +17310,7 @@ async function runBuild(options) {
       html,
       basePath: config2.basePath
     });
-    await rm3(path46.join(clientOutDir, "index.html"), { force: true });
+    await rm3(path47.join(clientOutDir, "index.html"), { force: true });
   } else {
     await runPrerender({
       dir,
@@ -17259,7 +17334,7 @@ var runPrerender = async (options) => {
       serverConfigFilename,
       writeRedirects: process.env.VERCEL === void 0
     });
-    const indexHtml = path46.join(clientOutDir, "index.html");
+    const indexHtml = path47.join(clientOutDir, "index.html");
     if (!workerResults.find((r) => r.outputPath === indexHtml)) {
       await writeFile10(indexHtml, html, "utf-8");
     }
@@ -17269,15 +17344,15 @@ var runPrerender = async (options) => {
     for (const statusPage of statusPages) {
       await rename(
         statusPage,
-        path46.join(dir, DIST_DIR, path46.basename(statusPage))
+        path47.join(dir, DIST_DIR, path47.basename(statusPage))
       );
     }
     await rm3(serverOutDir, { recursive: true, force: true });
     if (process.env.VERCEL) {
-      await mkdir9(path46.join(dir, ".vercel/output/static"), { recursive: true });
+      await mkdir9(path47.join(dir, ".vercel/output/static"), { recursive: true });
       await rename(
-        path46.join(dir, DIST_DIR),
-        path46.join(dir, ".vercel/output/static")
+        path47.join(dir, DIST_DIR),
+        path47.join(dir, ".vercel/output/static")
       );
     }
     await writeOutput(dir, {
@@ -17287,7 +17362,7 @@ var runPrerender = async (options) => {
     });
     if (ZuploEnv.isZuplo && issuer) {
       await writeFile10(
-        path46.join(dir, DIST_DIR, ".output/zuplo.json"),
+        path47.join(dir, DIST_DIR, ".output/zuplo.json"),
         JSON.stringify({ issuer }, null, 2),
         "utf-8"
       );
@@ -17299,10 +17374,10 @@ var runPrerender = async (options) => {
 };
 var bundleSSREntry = async (options) => {
   const { dir, adapter, serverOutDir, serverConfigFilename, html, basePath } = options;
-  const tempEntryPath = path46.join(dir, "__ssr-entry.ts");
+  const tempEntryPath = path47.join(dir, "__ssr-entry.ts");
   const packageRoot = getZudokuRootDir();
   const templateContent = await readFile11(
-    path46.join(packageRoot, "src/vite/ssr-templates", `${adapter}.ts`),
+    path47.join(packageRoot, "src/vite/ssr-templates", `${adapter}.ts`),
     "utf-8"
   );
   const entryContent = templateContent.replace('"__TEMPLATE__"', JSON.stringify(html)).replace('"__CONFIG_FILE__"', JSON.stringify(`./${serverConfigFilename}`)).replace(
@@ -17317,9 +17392,9 @@ var bundleSSREntry = async (options) => {
       platform: adapter === "node" ? "node" : "neutral",
       target: "es2022",
       format: "esm",
-      outfile: path46.join(serverOutDir, "entry.js"),
+      outfile: path47.join(serverOutDir, "entry.js"),
       external: ["./entry.server.js", `./${serverConfigFilename}`],
-      nodePaths: [path46.join(packageRoot, "node_modules")],
+      nodePaths: [path47.join(packageRoot, "node_modules")],
       banner: { js: "// Bundled SSR entry" }
     });
   } finally {
@@ -17332,11 +17407,11 @@ init_logger();
 init_package_json();
 
 // src/cli/preview/handler.ts
-import path47 from "node:path";
+import path48 from "node:path";
 import { preview as vitePreview } from "vite";
 var DEFAULT_PREVIEW_PORT = 4e3;
 async function preview(argv) {
-  const dir = path47.resolve(process.cwd(), argv.dir);
+  const dir = path48.resolve(process.cwd(), argv.dir);
   const viteConfig = await getViteConfig(dir, {
     command: "serve",
     mode: "production",
@@ -17377,7 +17452,7 @@ async function build(argv) {
     printDiagnosticsToConsole("");
     printDiagnosticsToConsole("");
   }
-  const dir = path48.resolve(process.cwd(), argv.dir);
+  const dir = path49.resolve(process.cwd(), argv.dir);
   try {
     await runBuild({
       dir,
@@ -17437,12 +17512,12 @@ var build_default = {
 };
 
 // src/cli/check/handler.ts
-import path50 from "node:path";
+import path51 from "node:path";
 
 // src/cli/platform/tools/check-publish-readiness.ts
-import path49 from "node:path";
+import path50 from "node:path";
 async function checkPublishReadiness(client, _config, args) {
-  const sourceDirectory = path49.resolve(args.sourceDirectory);
+  const sourceDirectory = path50.resolve(args.sourceDirectory);
   const manifest = await readManifest(sourceDirectory) ?? createScaffoldManifest();
   const emailOptions = await resolveEmailOptionsForPublish(
     client,
@@ -17520,7 +17595,7 @@ async function checkPublishReadiness(client, _config, args) {
 
 // src/cli/check/handler.ts
 async function check(argv) {
-  const sourceDirectory = path50.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path51.resolve(process.cwd(), argv.dir);
   const config2 = loadConfig();
   const client = new PlatformApiClient(config2);
   let result;
@@ -17565,13 +17640,13 @@ var check_default = {
 // src/cli/make-config/handler.ts
 import { constants as constants2 } from "node:fs";
 import { access as access8, mkdir as mkdir12, readFile as readFile16, writeFile as writeFile15 } from "node:fs/promises";
-import path58 from "node:path";
+import path59 from "node:path";
 import { stdin as input2 } from "node:process";
 import { glob as glob5 } from "glob";
 
 // src/cli/scaffold/dev-portal-config-pages.ts
 import { access as access4, readFile as readFile12, rename as rename2, rm as rm4, writeFile as writeFile11 } from "node:fs/promises";
-import path51 from "node:path";
+import path52 from "node:path";
 async function writeConfigAtomically(filePath, content) {
   const temporaryPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
   try {
@@ -17584,7 +17659,7 @@ async function writeConfigAtomically(filePath, content) {
 }
 async function resolveApitogoConfigPath(sourceDirectory) {
   for (const filename of ["apitogo.config.tsx", "apitogo.config.jsx"]) {
-    const configPath = path51.join(sourceDirectory, filename);
+    const configPath = path52.join(sourceDirectory, filename);
     try {
       await access4(configPath);
       return configPath;
@@ -18321,16 +18396,16 @@ async function wireNewDevPortalPageInConfig(sourceDirectory, slug, label) {
 
 // src/cli/scaffold/wire-openapi.ts
 import { access as access6, readFile as readFile14, writeFile as writeFile13 } from "node:fs/promises";
-import path54 from "node:path";
+import path55 from "node:path";
 
 // src/cli/scaffold/scaffold-dev-portal-site.ts
 import { mkdir as mkdir10, readFile as readFile13, writeFile as writeFile12 } from "node:fs/promises";
-import path53 from "node:path";
+import path54 from "node:path";
 
 // src/cli/scaffold/create-apitogo-cli.ts
 import { spawn as spawn3 } from "node:child_process";
 import { access as access5, rm as rm5 } from "node:fs/promises";
-import path52 from "node:path";
+import path53 from "node:path";
 
 // src/cli/scaffold/apitogo-npm-packages.ts
 var DEFAULT_CREATE_APITOGO_PACKAGE2 = "@lukoweb/create-apitogo@latest";
@@ -18431,9 +18506,9 @@ function resolveDocToolPath(explicit) {
   return value || void 0;
 }
 function splitOutputDirectory(outputDirectory) {
-  const resolvedOutputDirectory = path52.resolve(outputDirectory);
-  const projectName = path52.basename(resolvedOutputDirectory);
-  const parentDirectory = path52.dirname(resolvedOutputDirectory);
+  const resolvedOutputDirectory = path53.resolve(outputDirectory);
+  const projectName = path53.basename(resolvedOutputDirectory);
+  const parentDirectory = path53.dirname(resolvedOutputDirectory);
   if (!projectName || projectName === "." || projectName === "..") {
     throw new Error(
       "outputDirectory must be a named folder (e.g. ./dev-portal-site), not the current directory."
@@ -18451,15 +18526,15 @@ async function pathExists3(filePath) {
 }
 async function directoryHasEntries(dir) {
   try {
-    const { readdir: readdir3 } = await import("node:fs/promises");
-    const entries = await readdir3(dir);
+    const { readdir: readdir4 } = await import("node:fs/promises");
+    const entries = await readdir4(dir);
     return entries.length > 0;
   } catch {
     return false;
   }
 }
 function resolveLocalCreateApitogoEntry(docToolPath) {
-  return path52.resolve(docToolPath, "packages/create-zudoku/dist/index.js");
+  return path53.resolve(docToolPath, "packages/create-zudoku/dist/index.js");
 }
 async function resolveCreateApitogoInvocation(options) {
   const docToolPath = resolveDocToolPath(options.docToolPath);
@@ -18541,7 +18616,7 @@ async function runCreateApitogoDevPortal(options) {
       result.exitCode
     );
   }
-  if (!await pathExists3(path52.join(resolvedOutputDirectory, "package.json"))) {
+  if (!await pathExists3(path53.join(resolvedOutputDirectory, "package.json"))) {
     throw new CreateApitogoCliError(
       `create-apitogo completed but package.json was not found at ${resolvedOutputDirectory}`,
       result.output,
@@ -18597,7 +18672,7 @@ function ensureRequiredApitogoModules(pkg, options) {
     ]
   ]) {
     if (options.docToolPath) {
-      deps[moduleName] = `file:${path53.join(options.docToolPath, localPath)}`;
+      deps[moduleName] = `file:${path54.join(options.docToolPath, localPath)}`;
       continue;
     }
     deps[moduleName] = `npm:${moduleName}@${moduleAliasVersion}`;
@@ -18626,7 +18701,7 @@ function rewritePackageJson(raw, options) {
       if (!deps) continue;
       for (const [dep, relativePath] of Object.entries(DOC_TOOL_LOCAL_PACKAGE_PATHS)) {
         if (dep in deps) {
-          deps[dep] = `file:${path53.join(options.docToolPath, relativePath)}`;
+          deps[dep] = `file:${path54.join(options.docToolPath, relativePath)}`;
           linkedWorkspacePackage = true;
         }
       }
@@ -18723,23 +18798,23 @@ function patchDashboardPageConfig(content) {
   );
 }
 async function ensureAccountPlansPage(outputDirectory) {
-  const pagePath = path53.join(outputDirectory, ACCOUNT_PLANS_PAGE_PATH);
+  const pagePath = path54.join(outputDirectory, ACCOUNT_PLANS_PAGE_PATH);
   try {
     await readFile13(pagePath, "utf8");
     return void 0;
   } catch {
-    await mkdir10(path53.dirname(pagePath), { recursive: true });
+    await mkdir10(path54.dirname(pagePath), { recursive: true });
     await writeFile12(pagePath, ACCOUNT_PLANS_PAGE);
     return ACCOUNT_PLANS_PAGE_PATH;
   }
 }
 async function ensureDashboardPage(outputDirectory) {
-  const pagePath = path53.join(outputDirectory, DASHBOARD_PAGE_PATH);
+  const pagePath = path54.join(outputDirectory, DASHBOARD_PAGE_PATH);
   try {
     await readFile13(pagePath, "utf8");
     return void 0;
   } catch {
-    await mkdir10(path53.dirname(pagePath), { recursive: true });
+    await mkdir10(path54.dirname(pagePath), { recursive: true });
     await writeFile12(pagePath, DASHBOARD_PAGE);
     return DASHBOARD_PAGE_PATH;
   }
@@ -18790,7 +18865,7 @@ function patchApitogoConfig(content, options) {
 async function patchScaffoldedSite(outputDirectory, options) {
   const title = options.branding?.title ?? options.siteName;
   const filesWritten = [];
-  const packageJsonPath = path53.join(outputDirectory, "package.json");
+  const packageJsonPath = path54.join(outputDirectory, "package.json");
   if (options.patchPackageJson !== false) {
     const packageJson2 = await readFile13(packageJsonPath, "utf8");
     await writeFile12(
@@ -18803,7 +18878,7 @@ async function patchScaffoldedSite(outputDirectory, options) {
     );
     filesWritten.push("package.json");
   }
-  const configPath = path53.join(outputDirectory, "apitogo.config.tsx");
+  const configPath = path54.join(outputDirectory, "apitogo.config.tsx");
   const configContent = await readFile13(configPath, "utf8");
   await writeFile12(
     configPath,
@@ -18865,15 +18940,7 @@ async function pathExists4(filePath) {
   }
 }
 async function discoverSiteOpenApi(siteDirectory) {
-  const site = path54.resolve(siteDirectory);
-  const searchedDirectories = [site];
-  const candidates = [];
-  for (const name of OPENAPI_BASENAMES) {
-    const candidate = path54.join(site, name);
-    if (await pathExists4(candidate)) {
-      candidates.push(candidate);
-    }
-  }
+  const { candidates, searchedDirectories } = await collectSiteOpenApiFiles(siteDirectory);
   const invalidCandidates = [];
   for (const candidate of candidates) {
     const validation = await validateOpenApiFile(candidate);
@@ -18906,8 +18973,8 @@ async function discoverOpenApiByMode(siteDirectory, mode) {
   return discoverNearbyOpenApi(siteDirectory);
 }
 async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
-  const resolvedSource = path54.resolve(sourceDirectory);
-  const resolvedOpenApi = path54.resolve(openApiPath);
+  const resolvedSource = path55.resolve(sourceDirectory);
+  const resolvedOpenApi = path55.resolve(openApiPath);
   const input3 = toSiteRelativeOpenApiInput(resolvedSource, resolvedOpenApi);
   const validation = await validateOpenApiFile(resolvedOpenApi);
   if (!validation.valid) {
@@ -18932,7 +18999,7 @@ async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
       "utf8"
     );
   } else {
-    const tsxConfigPath = path54.join(resolvedSource, "apitogo.config.tsx");
+    const tsxConfigPath = path55.join(resolvedSource, "apitogo.config.tsx");
     const configContent = await readFile14(tsxConfigPath, "utf8");
     try {
       const patched = patchApitogoConfigOpenApiToFile(configContent, input3);
@@ -19020,10 +19087,10 @@ async function discoverAndWireOpenApi(siteDirectory, mode) {
 // src/cli/make-config/interactive.ts
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
-import path56 from "node:path";
+import path57 from "node:path";
 
 // src/cli/make-config/json-config.ts
-import path55 from "node:path";
+import path56 from "node:path";
 var APITOGO_JSON_FILENAME = "apitogo.config.json";
 var DOCUMENTATION_NAV_LABEL2 = "Documentation";
 var API_REFERENCE_PATH = "/api";
@@ -19382,9 +19449,9 @@ function openapiInputForConfig(specRelativePosix) {
   return `./${specRelativePosix}`;
 }
 function toRelativeOpenApiInput(projectDir, inputPath) {
-  const resolved = path55.isAbsolute(inputPath) ? inputPath : path55.resolve(projectDir, inputPath);
-  const relative = path55.relative(projectDir, resolved);
-  const posix = relative.split(path55.sep).join(path55.posix.sep);
+  const resolved = path56.isAbsolute(inputPath) ? inputPath : path56.resolve(projectDir, inputPath);
+  const relative = path56.relative(projectDir, resolved);
+  const posix = relative.split(path56.sep).join(path56.posix.sep);
   if (!posix) {
     throw new Error("OpenAPI path must point to a file.");
   }
@@ -19757,7 +19824,7 @@ async function promptMakeConfigInteractive(options) {
           continue;
         }
         const routePath = `/${slug}`;
-        const relativePath = path56.posix.join(options.pagesDir, `${slug}.tsx`);
+        const relativePath = path57.posix.join(options.pagesDir, `${slug}.tsx`);
         const page = {
           slug,
           title: pageTitle.trim(),
@@ -19850,7 +19917,7 @@ export default function ${componentName}() {
 init_package_json();
 import { constants } from "node:fs";
 import { access as access7, mkdir as mkdir11, readFile as readFile15, writeFile as writeFile14 } from "node:fs/promises";
-import path57 from "node:path";
+import path58 from "node:path";
 import { glob as glob4 } from "glob";
 
 // src/cli/make-config/branding-assets.ts
@@ -19874,9 +19941,9 @@ var OPENAPI_GLOBS = [
   "openapi.yaml",
   "openapi.yml"
 ];
-var toPosix = (p) => p.split(path57.sep).join("/");
+var toPosix = (p) => p.split(path58.sep).join("/");
 var sanitizePackageName = (dir) => {
-  const base = path57.basename(path57.resolve(dir));
+  const base = path58.basename(path58.resolve(dir));
   const s = base.toLowerCase().replace(/[^a-z0-9-_.]/g, "-").replace(/^-+|-+$/g, "");
   return s || "apitogo-site";
 };
@@ -19886,7 +19953,7 @@ var apitogoVersionRange = () => {
 };
 async function findOpenApiSpecPath(dir) {
   for (const rel of OPENAPI_GLOBS) {
-    const full = path57.join(dir, rel);
+    const full = path58.join(dir, rel);
     try {
       await access7(full, constants.R_OK);
       return toPosix(rel);
@@ -19901,7 +19968,7 @@ async function findOpenApiSpecPath(dir) {
   return extra[0] ? toPosix(extra[0]) : null;
 }
 async function ensurePackageJson(dir) {
-  const pkgPath = path57.join(dir, "package.json");
+  const pkgPath = path58.join(dir, "package.json");
   const apitogoVer = apitogoVersionRange();
   const baseDeps = {
     react: ">=19.0.0",
@@ -19968,7 +20035,7 @@ async function ensurePackageJson(dir) {
   return false;
 }
 async function ensureTsconfigJson(dir) {
-  const tsPath = path57.join(dir, "tsconfig.json");
+  const tsPath = path58.join(dir, "tsconfig.json");
   try {
     await access7(tsPath, constants.R_OK);
     return false;
@@ -20017,28 +20084,28 @@ var fileExists2 = async (filePath) => {
   }
 };
 async function ensurePortalStubFiles(dir) {
-  const landingPath = path57.join(dir, "landing", "LandingPage.tsx");
+  const landingPath = path58.join(dir, "landing", "LandingPage.tsx");
   if (!await fileExists2(landingPath)) {
-    await mkdir11(path57.join(dir, "landing"), { recursive: true });
+    await mkdir11(path58.join(dir, "landing"), { recursive: true });
     await writeFile14(landingPath, LANDING_PAGE_SOURCE, "utf8");
   }
-  const plansPath = path57.join(dir, "user-panel", "AccountPlansPage.tsx");
+  const plansPath = path58.join(dir, "user-panel", "AccountPlansPage.tsx");
   if (!await fileExists2(plansPath)) {
-    await mkdir11(path57.join(dir, "user-panel"), { recursive: true });
+    await mkdir11(path58.join(dir, "user-panel"), { recursive: true });
     await writeFile14(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
   }
-  const dashboardPath = path57.join(dir, "user-panel", "DashboardPage.tsx");
+  const dashboardPath = path58.join(dir, "user-panel", "DashboardPage.tsx");
   if (!await fileExists2(dashboardPath)) {
-    await mkdir11(path57.join(dir, "user-panel"), { recursive: true });
+    await mkdir11(path58.join(dir, "user-panel"), { recursive: true });
     await writeFile14(dashboardPath, DASHBOARD_PAGE_SOURCE, "utf8");
   }
   await ensurePublicBrandingFiles(dir);
 }
 async function ensurePublicBrandingFiles(dir) {
-  const destDir = path57.join(dir, "public");
+  const destDir = path58.join(dir, "public");
   await mkdir11(destDir, { recursive: true });
   for (const { name, content } of BRANDING_ASSETS) {
-    const dest = path57.join(destDir, name);
+    const dest = path58.join(destDir, name);
     if (await fileExists2(dest)) {
       continue;
     }
@@ -20046,7 +20113,7 @@ async function ensurePublicBrandingFiles(dir) {
   }
 }
 async function ensureThinConfigTsx(dir) {
-  const tsxPath = path57.join(dir, "apitogo.config.tsx");
+  const tsxPath = path58.join(dir, "apitogo.config.tsx");
   if (await fileExists2(tsxPath)) {
     return false;
   }
@@ -20055,7 +20122,7 @@ async function ensureThinConfigTsx(dir) {
 }
 
 // src/cli/make-config/handler.ts
-var toPosixPath2 = (value) => value.split(path58.sep).join(path58.posix.sep);
+var toPosixPath2 = (value) => value.split(path59.sep).join(path59.posix.sep);
 var fileExists3 = async (filePath) => {
   try {
     await access8(filePath, constants2.F_OK);
@@ -20113,7 +20180,7 @@ async function persistConfig(config2, ctx) {
   };
   await writeFile15(ctx.jsonPath, `${JSON.stringify(next, null, 2)}
 `, "utf8");
-  const tsxPath = path58.join(ctx.dir, "apitogo.config.tsx");
+  const tsxPath = path59.join(ctx.dir, "apitogo.config.tsx");
   if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
     const tsxSource = await readFile16(tsxPath, "utf8");
     if (isManagedConfigWrapper(tsxSource)) {
@@ -20140,7 +20207,7 @@ function mergeBackendFlag(config2, backend) {
   return next;
 }
 async function makeConfig(argv) {
-  const dir = path58.resolve(process.cwd(), argv.dir);
+  const dir = path59.resolve(process.cwd(), argv.dir);
   const pagesDir = toPosixPath2(
     argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, "")
   );
@@ -20160,14 +20227,14 @@ async function makeConfig(argv) {
       printDiagnosticsToConsole("Created tsconfig.json.");
     }
     await ensurePortalStubFiles(dir);
-    const jsonPath = path58.join(dir, APITOGO_JSON_FILENAME);
+    const jsonPath = path59.join(dir, APITOGO_JSON_FILENAME);
     let createdJson = false;
     let config2;
     if (await fileExists3(jsonPath)) {
       config2 = await readJsonConfig(jsonPath);
     } else {
       config2 = createDefaultApitogoJsonConfig({
-        title: titleFromDirectoryName(path58.basename(dir)),
+        title: titleFromDirectoryName(path59.basename(dir)),
         pagesDir
       });
       createdJson = true;
@@ -20216,8 +20283,8 @@ async function makeConfig(argv) {
             return;
           }
           if (action2.kind === "page") {
-            const pagePath = path58.join(dir, action2.page.relativePath);
-            await mkdir12(path58.dirname(pagePath), { recursive: true });
+            const pagePath = path59.join(dir, action2.page.relativePath);
+            await mkdir12(path59.dirname(pagePath), { recursive: true });
             await writeFile15(
               pagePath,
               buildStarterDocsPageTsx(action2.page.slug, action2.page.title),
@@ -20270,7 +20337,7 @@ async function makeConfig(argv) {
       if (argv.openapi) {
         const wire = await wireDevPortalOpenApi(
           dir,
-          path58.resolve(dir, argv.openapi)
+          path59.resolve(dir, argv.openapi)
         );
         if (wire.status !== "succeeded") {
           throw new Error(
@@ -20299,7 +20366,7 @@ async function makeConfig(argv) {
         const slug = normalizePageSlug(argv.pageSlug);
         const pageTemplate = normalizePageTemplate(argv.pageTemplate);
         const relativePagePath = pageComponentRelativePath(slug);
-        const filePath = path58.join(dir, relativePagePath);
+        const filePath = path59.join(dir, relativePagePath);
         const isUpdate = argv.pageUpdate === true;
         if (isUpdate) {
           if (!await fileExists3(filePath)) {
@@ -20332,7 +20399,7 @@ async function makeConfig(argv) {
             argv.pageContent,
             pageTemplate
           );
-          await mkdir12(path58.dirname(filePath), { recursive: true });
+          await mkdir12(path59.dirname(filePath), { recursive: true });
           await writeFile15(filePath, tsx, "utf8");
           const configResult = await wireNewDevPortalPageInConfig(
             dir,
@@ -20345,7 +20412,7 @@ async function makeConfig(argv) {
             pagePath: relativePagePath,
             pageTemplate,
             configUpdated: configResult.updated,
-            configPath: configResult.configPath ? path58.relative(dir, configResult.configPath) : null
+            configPath: configResult.configPath ? path59.relative(dir, configResult.configPath) : null
           };
           changes.push("page_add");
         }
@@ -20499,14 +20566,14 @@ var deploy_default = {
 
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path61 from "node:path";
+import path62 from "node:path";
 
 // src/vite/dev-server.ts
 init_logger();
-import fs10 from "node:fs/promises";
+import fs11 from "node:fs/promises";
 import http from "node:http";
 import https from "node:https";
-import path60 from "node:path";
+import path61 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -20539,7 +20606,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path59 from "node:path";
+import path60 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -20592,7 +20659,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path59.join(vite.config.publicDir, "pagefind");
+  const outputPath = path60.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -20611,9 +20678,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs10.readFile(path60.resolve(dir, config2.https.key)),
-      fs10.readFile(path60.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs10.readFile(path60.resolve(dir, config2.https.ca)) : void 0
+      fs11.readFile(path61.resolve(dir, config2.https.key)),
+      fs11.readFile(path61.resolve(dir, config2.https.cert)),
+      config2.https.ca ? fs11.readFile(path61.resolve(dir, config2.https.ca)) : void 0
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -20630,7 +20697,7 @@ var DevServer = class {
     );
     const server = await this.createNodeServer(config2);
     if (config2.search?.type === "pagefind" && viteConfig.publicDir !== false) {
-      const publicRoot = path60.resolve(
+      const publicRoot = path61.resolve(
         this.options.dir,
         typeof viteConfig.publicDir === "string" ? viteConfig.publicDir : "public"
       );
@@ -20647,7 +20714,7 @@ var DevServer = class {
           // built-in transform middleware which would treat the path as a static asset.
           name: "apitogo:entry-client",
           configureServer(server2) {
-            const entryPath = path60.posix.join(
+            const entryPath = path61.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -20812,7 +20879,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson2 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  const dir = path61.resolve(process.cwd(), argv.dir);
+  const dir = path62.resolve(process.cwd(), argv.dir);
   const server = new DevServer({
     dir,
     argPort: argv.port,
@@ -20895,23 +20962,521 @@ var dev_default = {
 };
 
 // src/cli/init/handler.ts
-import path62 from "node:path";
+import path65 from "node:path";
+
+// src/cli/scaffold/run-scaffold-discovery.ts
+import { access as access10, readFile as readFile18, writeFile as writeFile17 } from "node:fs/promises";
+import path64 from "node:path";
+
+// src/cli/scaffold/wire-docs.ts
+import {
+  access as access9,
+  lstat,
+  mkdir as mkdir13,
+  readdir as readdir3,
+  readFile as readFile17,
+  readlink,
+  symlink,
+  writeFile as writeFile16
+} from "node:fs/promises";
+import path63 from "node:path";
+var DOCS_DIR_WHITELIST = [
+  "docs",
+  "documents",
+  "documentation",
+  "doc"
+];
+var SKIP_SEARCH_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  ".next",
+  "coverage",
+  ".turbo",
+  ".cache",
+  ".apitogo"
+]);
+var PAGES_DIR = "pages";
+var CONFIG_FILENAME = "apitogo.config.json";
+async function pathExists5(filePath) {
+  try {
+    await access9(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isDirectory(filePath) {
+  try {
+    const stat4 = await lstat(filePath);
+    return stat4.isDirectory();
+  } catch {
+    return false;
+  }
+}
+function toPosix2(value) {
+  return value.split(path63.sep).join(path63.posix.sep);
+}
+function isWhitelistedDirName(name) {
+  return DOCS_DIR_WHITELIST.includes(name.toLowerCase());
+}
+function isInside(parent, child) {
+  const relative = path63.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path63.isAbsolute(relative);
+}
+async function collectMarkdownFiles(dir) {
+  const files = [];
+  let entries;
+  try {
+    entries = await readdir3(dir, { withFileTypes: true });
+  } catch {
+    return files;
+  }
+  for (const entry of entries) {
+    if (entry.name.startsWith(".")) {
+      continue;
+    }
+    const full = path63.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (SKIP_SEARCH_DIRS.has(entry.name) || entry.isSymbolicLink()) {
+        continue;
+      }
+      files.push(...await collectMarkdownFiles(full));
+      continue;
+    }
+    if ((entry.isFile() || entry.isSymbolicLink()) && /\.mdx?$/i.test(entry.name)) {
+      files.push(full);
+    }
+  }
+  return files;
+}
+async function collectSearchRoots(siteDirectory) {
+  const site = path63.resolve(siteDirectory);
+  const parent = path63.dirname(site);
+  const roots = [];
+  const add = (dir) => {
+    const resolved = path63.resolve(dir);
+    if (!roots.includes(resolved)) {
+      roots.push(resolved);
+    }
+  };
+  if (parent && parent !== site) {
+    add(parent);
+    try {
+      const entries = await readdir3(parent, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory() || SKIP_SEARCH_DIRS.has(entry.name)) {
+          continue;
+        }
+        add(path63.join(parent, entry.name));
+      }
+    } catch {
+    }
+  }
+  add(site);
+  return roots;
+}
+async function discoverNearbyDocsDirectories(siteDirectory) {
+  const site = path63.resolve(siteDirectory);
+  const sitePages = path63.join(site, PAGES_DIR);
+  const searchedDirectories = await collectSearchRoots(site);
+  const directories = [];
+  const seen = /* @__PURE__ */ new Set();
+  const consider = async (dir) => {
+    const resolved = path63.resolve(dir);
+    if (resolved === site || seen.has(resolved) || isInside(sitePages, resolved)) {
+      return;
+    }
+    if (!await isDirectory(resolved)) {
+      return;
+    }
+    const files = (await collectMarkdownFiles(resolved)).sort(
+      (a, b) => a.localeCompare(b)
+    );
+    if (files.length === 0) {
+      return;
+    }
+    seen.add(resolved);
+    directories.push({ sourceDirectory: resolved, files });
+  };
+  for (const root of searchedDirectories) {
+    if (isWhitelistedDirName(path63.basename(root))) {
+      await consider(root);
+    }
+    try {
+      const entries = await readdir3(root, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory() || SKIP_SEARCH_DIRS.has(entry.name)) {
+          continue;
+        }
+        if (!isWhitelistedDirName(entry.name)) {
+          continue;
+        }
+        await consider(path63.join(root, entry.name));
+      }
+    } catch {
+    }
+  }
+  return { directories, searchedDirectories };
+}
+function slugifyDirName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "docs";
+}
+async function allocateLinkName(pagesDir, sourceDirectory, used) {
+  const base = slugifyDirName(path63.basename(sourceDirectory));
+  const parent = slugifyDirName(path63.basename(path63.dirname(sourceDirectory)));
+  const candidates = [base, `${parent}-${base}`];
+  let index = 2;
+  while (true) {
+    const name = candidates.shift() ?? `${base}-${index++}`;
+    if (used.has(name)) {
+      continue;
+    }
+    const target = path63.join(pagesDir, name);
+    if (await pathExists5(target)) {
+      const stat4 = await lstat(target);
+      if (!stat4.isDirectory() || !await isManagedLinkDir(target)) {
+        continue;
+      }
+    }
+    used.add(name);
+    return name;
+  }
+}
+async function isManagedLinkDir(dir) {
+  try {
+    const entries = await readdir3(dir, { withFileTypes: true });
+    if (entries.length === 0) {
+      return true;
+    }
+    return entries.every(
+      (entry) => entry.isSymbolicLink() || entry.isDirectory()
+    );
+  } catch {
+    return false;
+  }
+}
+async function alreadyLinked(linkPath, sourcePath) {
+  try {
+    const stat4 = await lstat(linkPath);
+    if (!stat4.isSymbolicLink()) {
+      return false;
+    }
+    const current = await readlink(linkPath);
+    const resolved = path63.resolve(path63.dirname(linkPath), current);
+    return resolved === path63.resolve(sourcePath);
+  } catch {
+    return false;
+  }
+}
+async function linkMarkdownFile(sourcePath, linkPath) {
+  if (await alreadyLinked(linkPath, sourcePath)) {
+    return "exists";
+  }
+  if (await pathExists5(linkPath)) {
+    return "skipped";
+  }
+  await mkdir13(path63.dirname(linkPath), { recursive: true });
+  const relativeTarget = path63.relative(path63.dirname(linkPath), sourcePath);
+  await symlink(
+    relativeTarget,
+    linkPath,
+    process.platform === "win32" ? "file" : void 0
+  );
+  return "linked";
+}
+function isPlainObject4(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+async function applyDocsNavigation(siteDirectory, routes) {
+  if (routes.length === 0) {
+    return;
+  }
+  const configPath = path63.join(siteDirectory, CONFIG_FILENAME);
+  if (!await pathExists5(configPath)) {
+    return;
+  }
+  const raw = await readFile17(configPath, "utf8");
+  const parsed = JSON.parse(raw);
+  if (!isPlainObject4(parsed)) {
+    return;
+  }
+  parsed.navigation = mergeDocumentationNavigation(parsed.navigation, routes, {
+    force: false
+  });
+  await writeFile16(configPath, `${JSON.stringify(parsed, null, 2)}
+`, "utf8");
+}
+async function discoverAndWireDocs(siteDirectory) {
+  const site = path63.resolve(siteDirectory);
+  const pagesDir = path63.join(site, PAGES_DIR);
+  const { directories, searchedDirectories } = await discoverNearbyDocsDirectories(site);
+  if (directories.length === 0) {
+    return {
+      status: "not_found",
+      whitelist: DOCS_DIR_WHITELIST,
+      searchedDirectories,
+      sources: [],
+      fileCount: 0,
+      skippedCount: 0
+    };
+  }
+  await mkdir13(pagesDir, { recursive: true });
+  const usedNames = /* @__PURE__ */ new Set();
+  const sources = [];
+  const routes = [];
+  for (const directory of directories) {
+    const linkName = await allocateLinkName(
+      pagesDir,
+      directory.sourceDirectory,
+      usedNames
+    );
+    const linkDirectory = path63.join(pagesDir, linkName);
+    const linked = [];
+    const skipped = [];
+    for (const sourcePath of directory.files) {
+      const relativeSource = toPosix2(
+        path63.relative(directory.sourceDirectory, sourcePath)
+      );
+      const linkPath = path63.join(linkDirectory, relativeSource);
+      const result = await linkMarkdownFile(sourcePath, linkPath);
+      if (result === "skipped") {
+        skipped.push({
+          sourcePath,
+          reason: "target already exists and is not this source"
+        });
+        continue;
+      }
+      const relativeLink = toPosix2(path63.relative(site, linkPath));
+      const route = toRoutePath(relativeLink, PAGES_DIR);
+      linked.push({ sourcePath, linkPath, route, relativeSource });
+      routes.push(route);
+    }
+    sources.push({
+      sourceDirectory: directory.sourceDirectory,
+      linkDirectory,
+      linkName,
+      files: linked,
+      skipped
+    });
+  }
+  await applyDocsNavigation(site, routes);
+  const fileCount = sources.reduce(
+    (sum, source) => sum + source.files.length,
+    0
+  );
+  const skippedCount = sources.reduce(
+    (sum, source) => sum + source.skipped.length,
+    0
+  );
+  const status2 = fileCount === 0 ? "not_found" : skippedCount > 0 ? "partial" : "wired";
+  return {
+    status: status2,
+    whitelist: DOCS_DIR_WHITELIST,
+    searchedDirectories,
+    sources,
+    fileCount,
+    skippedCount
+  };
+}
+function siteRelative(siteDirectory, filePath) {
+  const relative = toPosix2(path63.relative(siteDirectory, filePath));
+  if (!relative) {
+    return ".";
+  }
+  if (path63.isAbsolute(relative)) {
+    return toPosix2(filePath);
+  }
+  if (relative.startsWith("..")) {
+    return relative;
+  }
+  return `./${relative}`;
+}
+function formatOpenApiDiscoveryLines(siteDirectory, openApiDiscovery) {
+  const status2 = String(openApiDiscovery.status ?? "unknown");
+  if (status2 === "wired") {
+    const input3 = typeof openApiDiscovery.openApiInput === "string" ? openApiDiscovery.openApiInput : typeof openApiDiscovery.openApiPath === "string" ? siteRelative(siteDirectory, openApiDiscovery.openApiPath) : "OpenAPI";
+    const title = typeof openApiDiscovery.openApiTitle === "string" ? ` (${openApiDiscovery.openApiTitle})` : "";
+    const apiPath = typeof openApiDiscovery.apiReferencePath === "string" ? openApiDiscovery.apiReferencePath : "/api";
+    return [`OpenAPI: wired ${input3}${title} \u2192 ${apiPath}`];
+  }
+  if (status2 === "skipped") {
+    return ["OpenAPI: search skipped"];
+  }
+  if (status2 === "invalid" || status2 === "wire_failed") {
+    const error = typeof openApiDiscovery.error === "string" ? `: ${openApiDiscovery.error}` : "";
+    return [`OpenAPI: found a spec but did not wire it${error}`];
+  }
+  return ["OpenAPI: none found nearby"];
+}
+function formatDocsDiscoveryLines(siteDirectory, docsDiscovery) {
+  if (docsDiscovery.status === "not_found") {
+    return [
+      `Docs: none found in ${DOCS_DIR_WHITELIST.join("/")}/ folders nearby`
+    ];
+  }
+  const lines = [
+    `Docs: linked ${docsDiscovery.fileCount} markdown file${docsDiscovery.fileCount === 1 ? "" : "s"} (not copied)`
+  ];
+  for (const source of docsDiscovery.sources) {
+    const from = siteRelative(siteDirectory, source.sourceDirectory);
+    const to = siteRelative(siteDirectory, source.linkDirectory);
+    lines.push(`  ${from} \u2192 ${to}`);
+    for (const file of source.files) {
+      lines.push(`    ${file.relativeSource} \u2192 ${file.route}`);
+    }
+    for (const skipped of source.skipped) {
+      lines.push(
+        `    skipped ${siteRelative(siteDirectory, skipped.sourcePath)}`
+      );
+    }
+  }
+  return lines;
+}
+function formatInitDiscoveryReport(siteDirectory, openApiDiscovery, docsDiscovery) {
+  return [
+    ...formatOpenApiDiscoveryLines(siteDirectory, openApiDiscovery),
+    ...formatDocsDiscoveryLines(siteDirectory, docsDiscovery)
+  ];
+}
+
+// src/cli/scaffold/run-scaffold-discovery.ts
+async function pathExists6(filePath) {
+  try {
+    await access10(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function wireOpenApiIntoJsonConfig(siteDirectory, openApiPath) {
+  const input3 = toSiteRelativeOpenApiInput(siteDirectory, openApiPath);
+  const jsonConfigPath = path64.join(siteDirectory, "apitogo.config.json");
+  const raw = await readFile18(jsonConfigPath, "utf8");
+  const siteConfig = JSON.parse(raw);
+  const updated = applyOpenApiToSiteConfig(siteConfig, {
+    input: input3,
+    apiPath: "api"
+  });
+  const backend = updated.backend && typeof updated.backend === "object" && !Array.isArray(updated.backend) ? { ...updated.backend } : {};
+  updated.backend = { ...backend, openApiPath: input3 };
+  await writeFile17(
+    jsonConfigPath,
+    `${JSON.stringify(updated, null, 2)}
+`,
+    "utf8"
+  );
+  return { input: input3 };
+}
+async function discoverAndWireOpenApiLite(siteDirectory, mode) {
+  if (mode === "none") {
+    return {
+      openApiDiscovery: { status: "skipped", mode },
+      wired: false
+    };
+  }
+  const search = mode === "site" ? await collectSiteOpenApiFiles(siteDirectory) : await collectNearbyOpenApiFiles(siteDirectory);
+  const invalidCandidates = [];
+  let selected;
+  for (const candidate of search.candidates) {
+    const content = await readFile18(candidate, "utf8");
+    const parsed = liteParseOpenApi(content, candidate);
+    if (parsed.valid) {
+      selected = {
+        path: candidate,
+        version: parsed.version,
+        title: parsed.title
+      };
+      break;
+    }
+    invalidCandidates.push({ path: candidate, errors: parsed.errors });
+  }
+  if (!selected) {
+    return {
+      openApiDiscovery: {
+        status: search.candidates.length > 0 ? "invalid" : "not_found",
+        candidates: search.candidates,
+        searchedDirectories: search.searchedDirectories,
+        ...invalidCandidates.length > 0 ? { invalidCandidates } : {},
+        suggestion: OPENAPI_NOT_FOUND_SUGGESTION
+      },
+      wired: false
+    };
+  }
+  const jsonConfigPath = path64.join(siteDirectory, "apitogo.config.json");
+  if (!await pathExists6(jsonConfigPath)) {
+    return {
+      openApiDiscovery: {
+        status: "wire_failed",
+        openApiPath: selected.path,
+        error: "apitogo.config.json not found",
+        candidates: search.candidates,
+        searchedDirectories: search.searchedDirectories,
+        suggestion: OPENAPI_NOT_FOUND_SUGGESTION
+      },
+      wired: false
+    };
+  }
+  try {
+    const { input: input3 } = await wireOpenApiIntoJsonConfig(
+      siteDirectory,
+      selected.path
+    );
+    return {
+      openApiDiscovery: {
+        status: "wired",
+        openApiPath: selected.path,
+        openApiInput: input3,
+        openApiTitle: selected.title ?? null,
+        openApiVersion: selected.version ?? null,
+        apiReferencePath: "/api",
+        candidates: search.candidates,
+        searchedDirectories: search.searchedDirectories
+      },
+      wired: true
+    };
+  } catch (error) {
+    return {
+      openApiDiscovery: {
+        status: "wire_failed",
+        openApiPath: selected.path,
+        error: error instanceof Error ? error.message : String(error),
+        candidates: search.candidates,
+        searchedDirectories: search.searchedDirectories,
+        suggestion: OPENAPI_NOT_FOUND_SUGGESTION
+      },
+      wired: false
+    };
+  }
+}
+async function runScaffoldDiscovery(siteDirectory, options) {
+  const openapiSearch = options?.openapiSearch ?? "nearby";
+  const { openApiDiscovery } = await discoverAndWireOpenApiLite(
+    siteDirectory,
+    openapiSearch
+  );
+  const docsDiscovery = await discoverAndWireDocs(siteDirectory);
+  return { openApiDiscovery, docsDiscovery };
+}
+
+// src/cli/init/handler.ts
 function slugifyName2(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "dev-portal-site";
 }
 function resolveInitOutputDirectory(dirArg, name) {
-  const resolved = path62.resolve(process.cwd(), dirArg);
-  const base = path62.basename(resolved);
+  const resolved = path65.resolve(process.cwd(), dirArg);
+  const base = path65.basename(resolved);
   const isDot = dirArg === "." || dirArg === "./" || base === "." || resolved === process.cwd();
   if (isDot) {
     const fromName = name?.trim();
     if (!fromName) {
       throw new Error(
-        "apitogo init requires a named directory (e.g. apitogo init my-portal), or pass --name when using `.`."
+        "apitogo init requires a named directory (e.g. apitogo init dev-portal), or pass --name when using `.`."
       );
     }
     return {
-      outputDirectory: path62.resolve(process.cwd(), slugifyName2(fromName)),
+      outputDirectory: path65.resolve(process.cwd(), slugifyName2(fromName)),
       siteName: fromName
     };
   }
@@ -20945,10 +21510,7 @@ async function init2(argv) {
       siteName,
       includeDefaultPlans: false
     });
-    const manifestPath = await writeManifest(
-      result.outputDirectory,
-      manifest
-    );
+    const manifestPath = await writeManifest(result.outputDirectory, manifest);
     const secretsArtifacts = await writeScaffoldSecretsArtifacts(
       result.outputDirectory
     );
@@ -20959,13 +21521,18 @@ async function init2(argv) {
       }
       npmInstall = await runNpmInstall(result.outputDirectory);
     }
-    const { openApiDiscovery } = await discoverAndWireOpenApi(
+    const { openApiDiscovery, docsDiscovery } = await runScaffoldDiscovery(
       result.outputDirectory,
-      openapiSearch
+      { openapiSearch }
     );
     const siteValidation = await validateDevPortalSiteConfig(
       result.outputDirectory
     );
+    const discoveryReport = formatInitDiscoveryReport(
+      result.outputDirectory,
+      openApiDiscovery,
+      docsDiscovery
+    );
     const devCommand = "npm run dev";
     const response = {
       status: "succeeded",
@@ -20983,9 +21550,11 @@ async function init2(argv) {
       npmInstallCompleted: install,
       npmInstallDurationMs: npmInstall?.durationMs ?? null,
       openApiDiscovery,
+      docsDiscovery,
       openapiSearch,
       previewStarted: false,
       devCommand,
+      discoveryReport,
       message: `Dev portal created in ${result.outputDirectory}. Run \`${devCommand}\` there to preview locally.`,
       ...buildSiteValidationResponseFields(siteValidation)
     };
@@ -20998,6 +21567,9 @@ async function init2(argv) {
       printResultToConsole(
         `Portal scaffolded in ${result.outputDirectory}. Next: apitogo config, apitogo dev, then apitogo apply.`
       );
+      for (const line of discoveryReport) {
+        printDiagnosticsToConsole(line);
+      }
       if (!install) {
         printDiagnosticsToConsole(
           "Skipped npm install (--no-install). Run npm install before npm run dev."
@@ -21148,9 +21720,9 @@ var remove_default = {
 };
 
 // src/cli/status/handler.ts
-import path63 from "node:path";
+import path66 from "node:path";
 async function status(argv) {
-  const sourceDirectory = path63.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path66.resolve(process.cwd(), argv.dir);
   const config2 = loadConfig();
   const client = new PlatformApiClient(config2);
   let whoamiJson;
@@ -21230,7 +21802,7 @@ var status_default = {
 };
 
 // src/cli/teardown/handler.ts
-import path64 from "node:path";
+import path67 from "node:path";
 function resultLooksFailed3(payload) {
   try {
     const parsed = JSON.parse(payload);
@@ -21246,7 +21818,7 @@ async function teardown(argv) {
     );
     return;
   }
-  const sourceDirectory = path64.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path67.resolve(process.cwd(), argv.dir);
   const config2 = loadConfig();
   const client = new PlatformApiClient(config2);
   let projectId = argv.projectId?.trim();
@@ -21312,7 +21884,7 @@ var teardown_default = {
 
 // src/cli/common/outdated.ts
 import { existsSync as existsSync4, mkdirSync } from "node:fs";
-import { readFile as readFile17, writeFile as writeFile16 } from "node:fs/promises";
+import { readFile as readFile19, writeFile as writeFile18 } from "node:fs/promises";
 import { join } from "node:path";
 import colors10 from "picocolors";
 import { gt } from "semver";
@@ -21379,12 +21951,12 @@ function box(message, {
 
 // src/cli/common/xdg/lib.ts
 import { homedir } from "node:os";
-import path65 from "node:path";
+import path68 from "node:path";
 function defineDirectoryWithFallback(xdgName, fallback) {
   if (process.env[xdgName]) {
     return process.env[xdgName];
   } else {
-    return path65.join(homedir(), fallback);
+    return path68.join(homedir(), fallback);
   }
 }
 var XDG_CONFIG_HOME = defineDirectoryWithFallback(
@@ -21399,15 +21971,15 @@ var XDG_STATE_HOME = defineDirectoryWithFallback(
   "XDG_DATA_HOME",
   ".local/state"
 );
-var ZUDOKU_XDG_CONFIG_HOME = path65.join(
+var ZUDOKU_XDG_CONFIG_HOME = path68.join(
   XDG_CONFIG_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_DATA_HOME = path65.join(
+var ZUDOKU_XDG_DATA_HOME = path68.join(
   XDG_DATA_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_STATE_HOME = path65.join(
+var ZUDOKU_XDG_STATE_HOME = path68.join(
   XDG_STATE_HOME,
   CLI_XDG_FOLDER_NAME
 );
@@ -21459,7 +22031,7 @@ async function getVersionCheckInfo() {
   let versionCheckInfo;
   if (existsSync4(versionCheckPath)) {
     try {
-      versionCheckInfo = await readFile17(versionCheckPath, "utf-8").then(
+      versionCheckInfo = await readFile19(versionCheckPath, "utf-8").then(
         JSON.parse
       );
     } catch {
@@ -21484,7 +22056,7 @@ async function getVersionCheckInfo() {
       lastCheck: Date.now(),
       latestVersion
     };
-    await writeFile16(
+    await writeFile18(
       versionCheckPath,
       JSON.stringify(versionCheckInfo),
       "utf-8"