@lukoweb/apitogo 0.2.16 → 0.2.18

package/dist/cli/cli.js

@@ -836,7 +836,7 @@ import { stat as stat4 } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path101) => stat4(path101).then(() => true).catch(() => false);
+    fileExists = (path102) => stat4(path102).then(() => true).catch(() => false);
   }
 });
 
@@ -5809,7 +5809,7 @@ init_package_json();
 import yargs from "yargs/yargs";
 
 // src/cli/services/handler.ts
-import path50 from "node:path";
+import path52 from "node:path";
 import { createInterface as createInterface2 } from "node:readline/promises";
 
 // src/config/v2/errors.ts
@@ -6189,8 +6189,8 @@ var ConfigV2Schema = z.strictObject({
 var REMOVED_KEYS = {
   "plans.provider": "plans.provider was removed. Only plans.billing.provider (stripe or none) is selectable."
 };
-function pathToString(path101) {
-  return path101.reduce(
+function pathToString(path102) {
+  return path102.reduce(
     (acc, segment) => typeof segment === "number" ? `${acc}[${segment}]` : acc === "" ? String(segment) : `${acc}.${String(segment)}`,
     ""
   );
@@ -6210,9 +6210,9 @@ function step(schema2, segment) {
   }
   return void 0;
 }
-function knownKeysAt(path101) {
+function knownKeysAt(path102) {
   let current = ConfigV2Schema;
-  for (const segment of path101) {
+  for (const segment of path102) {
     if (!current) return [];
     current = step(current, segment);
   }
@@ -6248,7 +6248,7 @@ function unknownKeyHint(fullPath, key, known) {
   return known.length > 0 ? `Allowed keys: ${known.join(", ")}.` : void 0;
 }
 function mapIssue(issue3) {
-  const path101 = pathToString(issue3.path);
+  const path102 = pathToString(issue3.path);
   switch (issue3.code) {
     case "unrecognized_keys":
       return issue3.keys.map((key) => {
@@ -6264,20 +6264,20 @@ function mapIssue(issue3) {
       return [
         {
           code: "CONFIG_INVALID_VALUE",
-          path: path101,
+          path: path102,
           message: `must be one of: ${issue3.values.map((v) => JSON.stringify(v)).join(", ")}.`
         }
       ];
     case "custom": {
       const code = typeof issue3.params?.code === "string" ? issue3.params.code : "CONFIG_INVALID_VALUE";
-      return [{ code, path: path101, message: issue3.message ?? "is invalid." }];
+      return [{ code, path: path102, message: issue3.message ?? "is invalid." }];
     }
     case "invalid_type":
       return [
-        /received undefined/.test(issue3.message) ? { code: "CONFIG_MISSING_FIELD", path: path101, message: "is required." } : { code: "CONFIG_INVALID_VALUE", path: path101, message: issue3.message }
+        /received undefined/.test(issue3.message) ? { code: "CONFIG_MISSING_FIELD", path: path102, message: "is required." } : { code: "CONFIG_INVALID_VALUE", path: path102, message: issue3.message }
       ];
     default:
-      return [{ code: "CONFIG_INVALID_VALUE", path: path101, message: issue3.message }];
+      return [{ code: "CONFIG_INVALID_VALUE", path: path102, message: issue3.message }];
   }
 }
 function isRecord(value) {
@@ -7301,7 +7301,7 @@ var ServiceManifestSchema = z3.looseObject({
     }).optional()
   }).default({})
 });
-var issue = (code, path101, message, hint) => ({ code, path: path101, message, hint });
+var issue = (code, path102, message, hint) => ({ code, path: path102, message, hint });
 function parseManifest(raw, file = "services.json") {
   const version = typeof raw === "object" && raw !== null && "schemaVersion" in raw ? raw.schemaVersion : void 0;
   if (typeof version === "number" && version > SUPPORTED_MANIFEST_SCHEMA) {
@@ -7504,8 +7504,8 @@ var METHODS = [
   "trace"
 ];
 var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function actionKey(method, path101) {
-  const trimmed = path101.trim();
+function actionKey(method, path102) {
+  const trimmed = path102.trim();
   const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
   const normalized = withSlash.length > 1 ? withSlash.replace(/\/+$/, "") || "/" : withSlash;
   return `${method.trim().toLowerCase()}:${normalized}`;
@@ -7542,8 +7542,8 @@ var ReferenceSpecError = class extends Error {
 };
 function operationsOf(paths) {
   return Object.entries(paths).flatMap(
-    ([path101, item]) => isObject(item) ? METHODS.filter((method) => isObject(item[method])).map(
-      (method) => [path101, item, method]
+    ([path102, item]) => isObject(item) ? METHODS.filter((method) => isObject(item[method])).map(
+      (method) => [path102, item, method]
     ) : []
   );
 }
@@ -7558,14 +7558,14 @@ function buildReferenceSpec(specText, options) {
     throw new ReferenceSpecError("The OpenAPI file could not be read.");
   const doc = structuredClone(root);
   const paths = isObject(doc.paths) ? doc.paths : {};
-  for (const [path101, item, method] of operationsOf(paths))
-    if (options.deniedOperations.has(actionKey(method, path101)))
+  for (const [path102, item, method] of operationsOf(paths))
+    if (options.deniedOperations.has(actionKey(method, path102)))
       delete item[method];
-  for (const [path101, item] of Object.entries(paths))
+  for (const [path102, item] of Object.entries(paths))
     if (!isObject(item) || !METHODS.some((method) => method in item))
-      delete paths[path101];
-  for (const [path101, item, method] of operationsOf(paths))
-    if (options.publicOperations.has(actionKey(method, path101)))
+      delete paths[path102];
+  for (const [path102, item, method] of operationsOf(paths))
+    if (options.publicOperations.has(actionKey(method, path102)))
       item[method].security = [];
   doc.servers = [{ url: options.gatewayBaseUrl.replace(/\/+$/, "") }];
   for (const item of Object.values(paths)) {
@@ -7699,15 +7699,84 @@ function stableJson(value) {
 }
 
 // src/config/v2/wrapper.ts
-import { mkdir as mkdir4, readFile as readFile5, rename as rename2, rm as rm2, writeFile as writeFile5 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile6, rename as rename2, rm as rm2, writeFile as writeFile5 } from "node:fs/promises";
 import path12 from "node:path";
 
+// src/config/v2/docs-navigation.ts
+var DOCS_NAVIGATION_LABEL = "Documentation";
+var emptyBranch = () => ({ pages: /* @__PURE__ */ new Set(), folders: /* @__PURE__ */ new Map() });
+function folderLabel(name) {
+  const words = name.replace(/[-_]+/g, " ").trim();
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+var byName = (a, b) => a.localeCompare(b);
+var toItems = (branch, prefix) => {
+  const pages = [...branch.pages].sort(
+    (a, b) => a === "index" ? -1 : b === "index" ? 1 : byName(a, b)
+  );
+  const folders = [...branch.folders.keys()].sort(byName);
+  return [
+    // The index page of a folder is the folder's own address, so the sidebar also shows on `/`.
+    ...pages.map(
+      (page) => page === "index" ? {
+        type: "doc",
+        file: `${prefix}${page}`,
+        path: prefix === "" ? "/" : `/${prefix.slice(0, -1)}`
+      } : `${prefix}${page}`
+    ),
+    ...folders.map(
+      (folder) => ({
+        type: "category",
+        label: folderLabel(folder),
+        collapsible: true,
+        collapsed: false,
+        items: toItems(
+          branch.folders.get(folder) ?? emptyBranch(),
+          `${prefix}${folder}/`
+        )
+      })
+    )
+  ];
+};
+function docsNavigation(routes) {
+  const root = emptyBranch();
+  for (const route of routes) {
+    const parts = route.split("/").filter(Boolean);
+    const page = parts.pop();
+    if (!page) continue;
+    const branch = parts.reduce((current, folder) => {
+      const next = current.folders.get(folder) ?? emptyBranch();
+      current.folders.set(folder, next);
+      return next;
+    }, root);
+    branch.pages.add(page);
+  }
+  const items = toItems(root, "");
+  return items.length === 0 ? [] : [{ type: "category", label: DOCS_NAVIGATION_LABEL, items }];
+}
+
 // src/config/v2/home-redirect.ts
 import path11 from "node:path";
 import { glob as glob2 } from "glob";
 import globParent from "glob-parent";
+
+// src/lib/util/readFrontmatter.ts
+import { readFile as readFile5 } from "node:fs/promises";
+import matter from "gray-matter";
+import { parse as parse2, stringify } from "yaml";
+var yaml = {
+  parse: (input5) => parse2(input5) ?? {},
+  stringify: (obj) => stringify(obj)
+};
+var readFrontmatter = async (filePath) => {
+  const content = await readFile5(filePath, "utf-8");
+  const normalizedContent = content.replace(/\r\n/g, "\n");
+  return matter(normalizedContent, { engines: { yaml } });
+};
+
+// src/config/v2/home-redirect.ts
 var IGNORED = ["**/node_modules/**", "**/dist/**", "**/.git/**"];
-async function docRoutes(patterns) {
+async function docRoutes(patterns, options = {}) {
   const excluded = patterns.filter((pattern) => pattern.startsWith("!")).map((pattern) => pattern.slice(1));
   const included = patterns.filter((pattern) => !pattern.startsWith("!"));
   const routes = await Promise.all(
@@ -7718,7 +7787,13 @@ async function docRoutes(patterns) {
         ignore: [...IGNORED, ...excluded]
       });
       const parent = globParent(pattern);
-      return files.map(
+      const published = options.includeDrafts ? files : (await Promise.all(
+        files.map(async (file) => ({
+          file,
+          draft: (await readFrontmatter(file)).data.draft === true
+        }))
+      )).filter(({ draft }) => !draft).map(({ file }) => file);
+      return published.map(
         (file) => `/${path11.posix.relative(parent, file).replace(/\.mdx?$/, "")}`
       );
     })
@@ -7875,8 +7950,19 @@ function planPortal(profile, manifest) {
 var SITE_CONFIG_FILE = "apitogo.config.json";
 var REFERENCE_SPEC_FILE = "openapi/gateway.json";
 var API_REFERENCE_PATH = "api";
-function buildSiteConfig(resolved, plan2, theme, redirects = []) {
+function buildSiteConfig(resolved, plan2, theme, extras = {}) {
   const portal = resolved.portal;
+  const redirects = extras.redirects ?? [];
+  const navigation = [
+    ...extras.docsNavigation ?? [],
+    ...plan2.apiReference ? [
+      {
+        type: "link",
+        to: `/${API_REFERENCE_PATH}`,
+        label: "API Reference"
+      }
+    ] : []
+  ];
   return {
     site: {
       title: portal?.name ?? resolved.project.name,
@@ -7900,15 +7986,9 @@ function buildSiteConfig(resolved, plan2, theme, redirects = []) {
           input: `./${REFERENCE_SPEC_FILE}`,
           path: API_REFERENCE_PATH
         }
-      ],
-      navigation: [
-        {
-          type: "link",
-          to: `/${API_REFERENCE_PATH}`,
-          label: "API Reference"
-        }
       ]
     } : {},
+    ...navigation.length > 0 ? { navigation } : {},
     ...redirects.length > 0 ? { redirects } : {},
     ...theme !== void 0 ? { theme } : {},
     ...plan2.auth ? { authentication: { type: "openid", ...plan2.auth } } : {},
@@ -7943,7 +8023,7 @@ async function readTheme(resolved) {
   const file = resolved.portal?.theme;
   if (!file) return void 0;
   try {
-    return JSON.parse(await readFile5(file, "utf8"));
+    return JSON.parse(await readFile6(file, "utf8"));
   } catch {
     return void 0;
   }
@@ -8001,9 +8081,12 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
       });
     }
   }
+  const hostedDocRoutes = plan2.docs ? await docRoutes(profile.docs.content, {
+    includeDrafts: mode === "development"
+  }) : [];
   const home = homeRedirect({
     hostsDocs: plan2.docs,
-    docRoutes: plan2.docs ? await docRoutes(profile.docs.content) : [],
+    docRoutes: hostedDocRoutes,
     externalDocsUrl: profile.docs.url,
     apiReferencePath: plan2.apiReference ? `/${API_REFERENCE_PATH}` : void 0,
     userPanel: plan2.userPanel
@@ -8012,7 +8095,10 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
     resolved,
     plan2,
     await readTheme(resolved),
-    home ? [home] : []
+    {
+      redirects: home ? [home] : [],
+      docsNavigation: docsNavigation(hostedDocRoutes)
+    }
   );
   const wrapper = renderWrapper(plan2);
   const wrapperPath = path12.join(resolved.state.generatedDir, WRAPPER_FILE);
@@ -8057,7 +8143,7 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
 
 // src/config/v2/workspace.ts
 import { createHash as createHash2 } from "node:crypto";
-import { access as access2, lstat, readFile as readFile6, rm as rm3, symlink } from "node:fs/promises";
+import { access as access2, lstat, readFile as readFile7, rm as rm3, symlink } from "node:fs/promises";
 import path13 from "node:path";
 import { glob as glob3 } from "glob";
 var exists2 = (file) => access2(file).then(
@@ -8086,7 +8172,7 @@ async function materializeWorkspace(resolved, prepared) {
   return root;
 }
 async function configFingerprint(configPath) {
-  const text = await readFile6(configPath, "utf8");
+  const text = await readFile7(configPath, "utf8");
   try {
     const raw = JSON.parse(text);
     if (raw.project) {
@@ -8135,7 +8221,7 @@ async function portalArtifactHash(resolved, manifestText, cliVersion, wrapper =
   for (const file of files) {
     hash2.update(`file:${path13.relative(resolved.configDir, file)}
 `);
-    hash2.update(await readFile6(file));
+    hash2.update(await readFile7(file));
   }
   return hash2.digest("hex");
 }
@@ -8602,7 +8688,7 @@ async function clearProjectId(dir, projectId) {
 
 // src/config/v2/ledger.ts
 init_invariant();
-import { mkdir as mkdir6, readFile as readFile7, rename as rename4, rm as rm5, writeFile as writeFile7 } from "node:fs/promises";
+import { mkdir as mkdir6, readFile as readFile8, rename as rename4, rm as rm5, writeFile as writeFile7 } from "node:fs/promises";
 import path15 from "node:path";
 var LEDGER_VERSION = 1;
 var LedgerError = class extends ApitogoError {
@@ -8619,7 +8705,7 @@ var emptyLedger = () => ({
 async function readLedger(state) {
   let text;
   try {
-    text = await readFile7(state.file, "utf8");
+    text = await readFile8(state.file, "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return emptyLedger();
@@ -8750,8 +8836,8 @@ init_invariant();
 
 // src/cli/check/v2.ts
 init_apitogo_config_core();
-import { readFile as readFile13 } from "node:fs/promises";
-import path47 from "node:path";
+import { readFile as readFile14 } from "node:fs/promises";
+import path48 from "node:path";
 
 // src/cli/platform/client/platform-api.ts
 import { basename } from "node:path";
@@ -8864,8 +8950,8 @@ var PlatformApiClient = class {
   constructor(config2) {
     this.config = config2;
   }
-  url(path101) {
-    return `${this.config.apiUrl}${path101.startsWith("/") ? path101 : `/${path101}`}`;
+  url(path102) {
+    return `${this.config.apiUrl}${path102.startsWith("/") ? path102 : `/${path102}`}`;
   }
   headers(extra) {
     return {
@@ -8875,9 +8961,9 @@ var PlatformApiClient = class {
       ...extra
     };
   }
-  async request(method, path101, init4) {
+  async request(method, path102, init4) {
     const response = await fetchWithRetry(
-      this.url(path101),
+      this.url(path102),
       {
         method,
         ...init4,
@@ -9240,15 +9326,15 @@ var PlatformApiClient = class {
       }
     );
   }
-  deleteDevPortalPage(projectId, path101) {
-    const query = new URLSearchParams({ path: path101 });
+  deleteDevPortalPage(projectId, path102) {
+    const query = new URLSearchParams({ path: path102 });
     return this.request(
       "DELETE",
       `/api/v1/projects/${projectId}/dev-portal/pages/files?${query.toString()}`
     );
   }
-  renameDevPortalPage(projectId, path101, newName) {
-    const query = new URLSearchParams({ path: path101 });
+  renameDevPortalPage(projectId, path102, newName) {
+    const query = new URLSearchParams({ path: path102 });
     return this.request(
       "POST",
       `/api/v1/projects/${projectId}/dev-portal/pages/files/rename?${query.toString()}`,
@@ -9364,8 +9450,8 @@ var PlatformApiClient = class {
    * the project-less endpoint is used; `planTier` overrides the tier used for paid-plan checks.
    */
   validateGatewayPlans(plans, options = {}) {
-    const path101 = options.projectId ? `/api/v1/projects/${options.projectId}/gateway/plans/validate` : "/api/v1/gateway/plans/validate";
-    return this.request("POST", path101, {
+    const path102 = options.projectId ? `/api/v1/projects/${options.projectId}/gateway/plans/validate` : "/api/v1/gateway/plans/validate";
+    return this.request("POST", path102, {
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ plans, planTier: options.planTier })
     });
@@ -9466,8 +9552,8 @@ var PlatformApiClient = class {
   }
 };
 async function readFileBytes(filePath) {
-  const { readFile: readFile30 } = await import("node:fs/promises");
-  const buffer = await readFile30(filePath);
+  const { readFile: readFile31 } = await import("node:fs/promises");
+  const buffer = await readFile31(filePath);
   const arrayBuffer = new ArrayBuffer(buffer.byteLength);
   new Uint8Array(arrayBuffer).set(buffer);
   return arrayBuffer;
@@ -9564,13 +9650,13 @@ function resolveProjectId(explicit, config2) {
 import {
   access as access4,
   mkdir as mkdir12,
-  readFile as readFile11,
+  readFile as readFile12,
   rename as rename6,
   rm as rm8,
-  writeFile as writeFile13
+  writeFile as writeFile14
 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
-import path46 from "node:path";
+import path47 from "node:path";
 
 // src/vite/build.ts
 import { mkdir as mkdir11, readFile as readFile10, rename as rename5, rm as rm7, writeFile as writeFile12 } from "node:fs/promises";
@@ -9721,7 +9807,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.2.16",
+  version: "0.2.18",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -10503,14 +10589,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path101 = []) => {
-  const transformed = transform(specification, path101);
+var traverse = (specification, transform, path102 = []) => {
+  const transformed = transform(specification, path102);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path101, key];
+    const currentPath = [...path102, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -10538,9 +10624,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path101 = ref.split("/").slice(1);
+  const path102 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path101) {
+  for (const segment of path102) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -10559,7 +10645,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path101) => {
+  const resolve = async (current, path102) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -10567,7 +10653,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], `${path101}/${index}`);
+          current[index] = await resolve(current[index], `${path102}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -10578,13 +10664,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path101);
+              result2 = await resolve(resolved, path102);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path101);
+            result2 = await resolve(resolved, path102);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -10597,7 +10683,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path101}/${key}`);
+          current[key] = await resolve(current[key], `${path102}/${key}`);
         }
       }
       visited.delete(current);
@@ -10636,9 +10722,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path101) => {
+  schema2 = traverse(schema2, (sub, path102) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path101 ?? [])) {
+      if (isSchemaPath(path102 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -10651,11 +10737,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path101) => {
+  schema2 = traverse(schema2, (schema3, path102) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path101?.slice(0, -1);
+      const parentPath = path102?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path101?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path102?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -10669,8 +10755,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path101) => {
-    if (path101?.includes("content") && path101.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path102) => {
+    if (path102?.includes("content") && path102.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -10696,11 +10782,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path101) => {
+  schema2 = traverse(schema2, (schema3, path102) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path101?.slice(0, -1);
+      const parentPath = path102?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path101?.[index - 1] === "content"
+        (_, index) => path102?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -10712,7 +10798,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path101) {
+function isSchemaPath(path102) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -10725,10 +10811,10 @@ function isSchemaPath(path101) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path101[index] === segment);
+      return location.every((segment, index) => path102[index] === segment);
     }
-    return path101.includes(location);
-  }) || path101.includes("schema") || path101.some((segment) => segment.endsWith("Schema"));
+    return path102.includes(location);
+  }) || path102.includes("schema") || path102.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -10810,13 +10896,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path101 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path102 = [], 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 = path101.find((p) => !OPENAPI_PROPS.has(p)) || path101[0];
+    const circularProp = path102.find((p) => !OPENAPI_PROPS.has(p)) || path102[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -10826,7 +10912,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path101, key],
+    [...path102, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -10861,7 +10947,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path101) => HttpMethods.map((k) => path101?.[k]).filter((op) => op != null)
+    (path102) => HttpMethods.map((k) => path102?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -10916,7 +11002,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(
-    ([path101, value]) => HttpMethods.flatMap((method) => {
+    ([path102, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -10936,7 +11022,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path101,
+        path: path102,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -11294,8 +11380,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path101, value]) => ({
-        path: path101,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path102, value]) => ({
+        path: path102,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -11460,7 +11546,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path101) => path101.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path102) => path102.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -11491,23 +11577,23 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path101, filePath) => {
-  const parts = getSegmentsFromPath(path101);
+var lookup = (schema2, path102, filePath) => {
+  const parts = getSegmentsFromPath(path102);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path101 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path102 ? val : lookup(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: ${path101}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path102}`
       );
     }
     val = val[part];
   }
   return val;
 };
-var stringify = (obj, indent = 2) => JSON.stringify(obj, null, indent);
+var stringify2 = (obj, indent = 2) => JSON.stringify(obj, null, indent);
 var generateCode = (schema2, filePath) => {
   const { refMap, siblingsMap } = createLocalRefMap(schema2);
   const lines = [];
@@ -11524,7 +11610,7 @@ var generateCode = (schema2, filePath) => {
     mergedRefs.set(uniqueKey, varName);
     lines.push(`const ${varName} = {};`);
   }
-  const toCode = (obj) => replaceMarkers(stringify(setRefMarkers(obj, refMap)), mergedRefs);
+  const toCode = (obj) => replaceMarkers(stringify2(setRefMarkers(obj, refMap)), mergedRefs);
   const deferred = [];
   for (const [refPath, index] of refMap) {
     const value = lookup(schema2, refPath, filePath);
@@ -11535,7 +11621,7 @@ var generateCode = (schema2, filePath) => {
     const siblingEntry = value.__uniqueRefKey && siblingsMap.get(value.__uniqueRefKey);
     const target = siblingEntry ? deferred : lines;
     target.push(
-      siblingEntry ? `Object.assign(__refs[${index}], __refMap["${siblingEntry.refPath}"], ${stringify(siblingEntry.siblings)});` : `Object.assign(__refs[${index}], ${toCode(value)});`,
+      siblingEntry ? `Object.assign(__refs[${index}], __refMap["${siblingEntry.refPath}"], ${stringify2(siblingEntry.siblings)});` : `Object.assign(__refs[${index}], ${toCode(value)});`,
       `Object.defineProperty(__refs[${index}], "__$ref", { value: __refMapPaths[${index}], enumerable: false });`
     );
   }
@@ -11544,7 +11630,7 @@ var generateCode = (schema2, filePath) => {
     const varName = mergedRefs.get(uniqueKey);
     const refIndex = refMap.get(refPath);
     lines.push(
-      `Object.assign(${varName}, __refMap["${refPath}"], ${stringify(siblings)});`,
+      `Object.assign(${varName}, __refMap["${refPath}"], ${stringify2(siblings)});`,
       `Object.defineProperty(${varName}, "__$ref", { value: __refMapPaths[${refIndex}], enumerable: false });`
     );
   }
@@ -11745,8 +11831,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path101) => this.processedSchemas[path101]?.at(0);
-  getSchemasForPath = (path101) => this.processedSchemas[path101];
+  getLatestSchema = (path102) => this.processedSchemas[path102]?.at(0);
+  getSchemasForPath = (path102) => this.processedSchemas[path102];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -11806,22 +11892,6 @@ import { glob as glob4 } from "glob";
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { mdxFromMarkdown } from "mdast-util-mdx";
 import { mdxjs } from "micromark-extension-mdxjs";
-
-// src/lib/util/readFrontmatter.ts
-import { readFile as readFile8 } from "node:fs/promises";
-import matter from "gray-matter";
-import { parse as parse2, stringify as stringify2 } from "yaml";
-var yaml = {
-  parse: (input5) => parse2(input5) ?? {},
-  stringify: (obj) => stringify2(obj)
-};
-var readFrontmatter = async (filePath) => {
-  const content = await readFile8(filePath, "utf-8");
-  const normalizedContent = content.replace(/\r\n/g, "\n");
-  return matter(normalizedContent, { engines: { yaml } });
-};
-
-// src/config/validators/NavigationSchema.ts
 init_ZudokuConfig();
 var extractTitleFromContent = (content) => content.match(/^\s*#\s(.*)$/m)?.at(1);
 var isMdxJsxElement = (node) => node.type === "mdxJsxTextElement";
@@ -14182,14 +14252,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path101) => {
-  const segments = path101.split("/");
+var resolveRoutePath = (path102) => {
+  const segments = path102.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path101) => path101.includes("*") || /^\d+$/.test(path101);
+var isSkipped = (path102) => path102.includes("*") || /^\d+$/.test(path102);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -14545,8 +14615,60 @@ var bundleSSREntry = async (options) => {
 
 // src/cli/portal/v2.ts
 init_package_json();
+
+// src/cli/init/v2-packages.ts
+import { existsSync as existsSync5 } from "node:fs";
+import { readFile as readFile11, writeFile as writeFile13 } from "node:fs/promises";
+import path46 from "node:path";
+var CORE_PACKAGES = [
+  "@lukoweb/apitogo",
+  "react",
+  "react-dom"
+];
+var portalPackageSpecs = (version) => [
+  `@lukoweb/apitogo@${version}`,
+  "react@19",
+  "react-dom@19"
+];
+var installCommand = (version) => `npm install --save-dev ${portalPackageSpecs(version).join(" ")}`;
+function packageNameFrom(name) {
+  const slug = name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[._-]+|[._-]+$/g, "");
+  return slug || "portal";
+}
+async function ensurePackageJson(dir, name) {
+  const file = path46.join(dir, "package.json");
+  if (existsSync5(file)) return false;
+  await writeFile13(
+    file,
+    `${JSON.stringify(
+      {
+        name: packageNameFrom(name),
+        version: "0.0.1",
+        private: true,
+        type: "module"
+      },
+      null,
+      2
+    )}
+`
+  );
+  return true;
+}
+function isPackageInstalled(startDir, name) {
+  let dir = path46.resolve(startDir);
+  for (; ; ) {
+    if (existsSync5(path46.join(dir, "node_modules", name, "package.json")))
+      return true;
+    const parent = path46.dirname(dir);
+    if (parent === dir) return false;
+    dir = parent;
+  }
+}
+var missingCorePackages = (dir) => CORE_PACKAGES.filter((name) => !isPackageInstalled(dir, name));
+
+// src/cli/portal/v2.ts
 function assertPackagesInstalled(resolved, prepared) {
-  const require2 = createRequire2(path46.join(resolved.configDir, "package.json"));
+  const require2 = createRequire2(path47.join(resolved.configDir, "package.json"));
   const missing = requiredPackages(prepared.plan).filter((name) => {
     try {
       require2.resolve(name);
@@ -14555,16 +14677,22 @@ function assertPackagesInstalled(resolved, prepared) {
       return true;
     }
   });
-  if (missing.length === 0) return;
-  throw new ConfigError(
-    resolved.configPath,
-    missing.map((name) => ({
+  const missingCore = missingCorePackages(resolved.configDir);
+  if (missing.length === 0 && missingCore.length === 0) return;
+  throw new ConfigError(resolved.configPath, [
+    ...missingCore.map((name) => ({
+      code: "PORTAL_PACKAGE_MISSING",
+      path: "",
+      message: `the portal is built with ${name}, which is not installed in this project.`,
+      hint: `Run \`${installCommand(getZudokuPackageJson().version)}\` in ${resolved.configDir}.`
+    })),
+    ...missing.map((name) => ({
       code: "PORTAL_PACKAGE_MISSING",
       path: "",
       message: `the portal registers a feature that needs ${name}, which is not installed.`,
       hint: `Run \`npm install ${name}\` in ${resolved.configDir}.`
     }))
-  );
+  ]);
 }
 async function preparePortalWorkspace(dir, mode) {
   const { resolved } = loadConfigV2(dir);
@@ -14593,7 +14721,7 @@ function portalBuildStep(context, options = {}, build2 = runBuild) {
   return {
     name: "build",
     hash: () => hash2,
-    stillValid: () => access4(path46.join(buildDir, "index.html")).then(
+    stillValid: () => access4(path47.join(buildDir, "index.html")).then(
       () => true,
       () => false
     ),
@@ -14606,11 +14734,11 @@ function portalBuildStep(context, options = {}, build2 = runBuild) {
         process.chdir(originalCwd);
       }
       await rm8(buildDir, { recursive: true, force: true });
-      await mkdir12(path46.dirname(buildDir), { recursive: true });
-      await rename6(path46.join(root, "dist"), buildDir);
+      await mkdir12(path47.dirname(buildDir), { recursive: true });
+      await rename6(path47.join(root, "dist"), buildDir);
       if (prepared.publishedManifest) {
-        await writeFile13(
-          path46.join(buildDir, MANIFEST_FILE),
+        await writeFile14(
+          path47.join(buildDir, MANIFEST_FILE),
           `${JSON.stringify(prepared.publishedManifest, null, 2)}
 `
         );
@@ -14639,17 +14767,17 @@ async function buildV2(options) {
 }
 
 // src/cli/check/gateway-online.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 var SPEC_SEND_LIMIT = 5 * 1024 * 1024 + 64 * 1024;
-var issue2 = (code, path101, message, hint) => ({ code, path: path101, message, hint });
+var issue2 = (code, path102, message, hint) => ({ code, path: path102, message, hint });
 function capabilityIssues(gateway, answer) {
   const can = answer.capabilities;
   const plan2 = `your ${answer.tier} plan`;
   const found = [];
-  const unsupported = (path101, what, hint) => found.push(
+  const unsupported = (path102, what, hint) => found.push(
     issue2(
       "GATEWAY_CAPABILITY_UNSUPPORTED",
-      path101,
+      path102,
       `${what} is not available on ${plan2}.`,
       hint
     )
@@ -14695,7 +14823,7 @@ async function onlineGatewayRules(gateway, projectId, api, derivedCors = []) {
   const specFile = gateway.specs[0];
   if (specFile) {
     try {
-      const text = await readFile12(specFile, "utf8");
+      const text = await readFile13(specFile, "utf8");
       if (text.length <= SPEC_SEND_LIMIT) spec = text;
     } catch {
     }
@@ -14725,7 +14853,7 @@ async function onlineGatewayRules(gateway, projectId, api, derivedCors = []) {
 async function isConfigV2(dir) {
   try {
     return /"version"\s*:\s*2\b/.test(
-      await readFile13(path47.join(dir, APITOGO_CONFIG_FILENAME), "utf8")
+      await readFile14(path48.join(dir, APITOGO_CONFIG_FILENAME), "utf8")
     );
   } catch {
     return false;
@@ -14819,7 +14947,7 @@ async function validatePortalBuild(dir) {
   }
 }
 async function runCheckV2(dir, args = {}, deps = {}) {
-  const configPath = path47.join(dir, APITOGO_CONFIG_FILENAME);
+  const configPath = path48.join(dir, APITOGO_CONFIG_FILENAME);
   let report;
   let layout;
   try {
@@ -14908,8 +15036,155 @@ async function checkV2(dir, args, deps = platformDependencies(args)) {
 init_package_json();
 
 // src/cli/init/v2-handler.ts
-import path48 from "node:path";
+import path50 from "node:path";
 import { createInterface } from "node:readline/promises";
+init_package_json();
+
+// src/cli/platform/helpers/npm-build.ts
+import { spawn } from "node:child_process";
+import { access as access5, readFile as readFile15 } from "node:fs/promises";
+import path49 from "node:path";
+var BUILD_LOG_TAIL_BYTES = 8192;
+var MIN_NODE_MAJOR = 20;
+var NpmBuildError = class extends Error {
+  buildLog;
+  exitCode;
+  constructor(message, buildLog, exitCode) {
+    super(message);
+    this.name = "NpmBuildError";
+    this.buildLog = buildLog;
+    this.exitCode = exitCode;
+  }
+};
+function parseNodeMajor(version) {
+  const match = /^v?(\d+)/.exec(version.trim());
+  return match ? Number.parseInt(match[1], 10) : Number.NaN;
+}
+function assertNodeVersion(required) {
+  const major = parseNodeMajor(process.version);
+  if (Number.isNaN(major) || major < MIN_NODE_MAJOR) {
+    throw new Error(
+      `Node.js ${MIN_NODE_MAJOR}+ is required (current: ${process.version}).`
+    );
+  }
+  if (required) {
+    const requiredMajor = parseNodeMajor(required);
+    if (!Number.isNaN(requiredMajor) && major < requiredMajor) {
+      throw new Error(
+        `Node.js ${requiredMajor}+ is required by nodeVersion option (current: ${process.version}).`
+      );
+    }
+  }
+}
+function truncateBuildLog(log, success) {
+  if (success && log.length > BUILD_LOG_TAIL_BYTES) {
+    return log.slice(-BUILD_LOG_TAIL_BYTES);
+  }
+  return log;
+}
+async function pathExists(filePath) {
+  try {
+    await access5(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runCommand(command2, args, cwd, env) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command2, args, {
+      cwd,
+      env: env ? { ...process.env, ...env } : process.env,
+      shell: process.platform === "win32"
+    });
+    let output4 = "";
+    child.stdout.on("data", (chunk) => {
+      output4 += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      output4 += chunk.toString();
+    });
+    child.on("error", reject);
+    child.on("close", (exitCode) => resolve({ exitCode, output: output4 }));
+  });
+}
+async function runNpmCommand(args, cwd) {
+  assertNodeVersion();
+  const startedAt = Date.now();
+  const result = await runCommand("npm", args, path49.resolve(cwd));
+  if (result.exitCode !== 0) {
+    throw new NpmBuildError(
+      `npm ${args.join(" ")} exited ${result.exitCode ?? "unknown"}`,
+      result.output,
+      result.exitCode
+    );
+  }
+  return {
+    durationMs: Date.now() - startedAt,
+    log: truncateBuildLog(result.output, true)
+  };
+}
+async function runNpmInstall(sourceDirectory, options) {
+  assertNodeVersion(options?.nodeVersion);
+  const cwd = path49.resolve(sourceDirectory);
+  const packageJsonPath = path49.join(cwd, "package.json");
+  if (!await pathExists(packageJsonPath)) {
+    throw new Error(`package.json not found in sourceDirectory: ${cwd}`);
+  }
+  const startedAt = Date.now();
+  const lockPath = path49.join(cwd, "package-lock.json");
+  const installArgs = await pathExists(lockPath) ? ["ci"] : ["install"];
+  const install = await runCommand("npm", installArgs, cwd);
+  const installLog = install.output;
+  if (install.exitCode !== 0) {
+    throw new NpmBuildError(
+      `npm ${installArgs.join(" ")} exited ${install.exitCode ?? "unknown"}`,
+      installLog,
+      install.exitCode
+    );
+  }
+  return {
+    durationMs: Date.now() - startedAt,
+    installLog: truncateBuildLog(installLog, true)
+  };
+}
+async function runNpmBuild(sourceDirectory, options) {
+  assertNodeVersion(options?.nodeVersion);
+  const cwd = path49.resolve(sourceDirectory);
+  const packageJsonPath = path49.join(cwd, "package.json");
+  if (!await pathExists(packageJsonPath)) {
+    throw new Error(`package.json not found in sourceDirectory: ${cwd}`);
+  }
+  const startedAt = Date.now();
+  let buildLog = "";
+  const install = await runNpmInstall(sourceDirectory, options);
+  buildLog += install.installLog;
+  const build2 = await runCommand("npm", ["run", "build"], cwd, options?.env);
+  buildLog += build2.output;
+  if (build2.exitCode !== 0) {
+    throw new NpmBuildError(
+      `npm run build exited ${build2.exitCode ?? "unknown"}`,
+      buildLog,
+      build2.exitCode
+    );
+  }
+  const distPath = path49.join(cwd, "dist");
+  const indexPath = path49.join(distPath, "index.html");
+  if (!await pathExists(indexPath)) {
+    throw new NpmBuildError(
+      `Build completed but dist/index.html was not found at ${indexPath}`,
+      buildLog,
+      build2.exitCode
+    );
+  }
+  return {
+    distPath,
+    durationMs: Date.now() - startedAt,
+    buildLog: truncateBuildLog(buildLog, true)
+  };
+}
+
+// src/cli/init/v2-handler.ts
 function parseOnlyFlag(value) {
   const services = (value ?? "portal").split(",").map((name) => name.trim()).filter(Boolean);
   const unsupported = services.filter((name) => name !== "portal");
@@ -14961,17 +15236,34 @@ function describePlan(plan2) {
     layoutReason: plan2.layoutReason,
     docsIncluded: plan2.docsIncluded,
     willCreate: plan2.entries.map(
-      (entry) => path48.relative(plan2.dir, entry.path)
+      (entry) => path50.relative(plan2.dir, entry.path)
     ),
-    willKeep: plan2.keep.map((target) => path48.relative(plan2.dir, target)),
+    willKeep: plan2.keep.map((target) => path50.relative(plan2.dir, target)),
     replacesConfig: plan2.replacesConfig
   };
 }
+async function setUpPackages(options) {
+  const version = getZudokuPackageJson().version;
+  const command2 = installCommand(version);
+  if (options.layout !== "standalone" || !options.install) {
+    return { packageJsonCreated: false, installed: false, command: command2 };
+  }
+  const packageJsonCreated = await ensurePackageJson(options.dir, options.name);
+  await withSpinner(
+    "Installing @lukoweb/apitogo, react and react-dom\u2026",
+    () => runNpmCommand(
+      ["install", "--save-dev", ...portalPackageSpecs(version)],
+      options.dir
+    ),
+    { silent: options.quiet }
+  );
+  return { packageJsonCreated, installed: true, command: command2 };
+}
 async function initV2(argv) {
   const json = argv.json === true;
   try {
     parseOnlyFlag(argv.only);
-    const dir = path48.resolve(process.cwd(), argv.dir ?? ".");
+    const dir = path50.resolve(process.cwd(), argv.dir ?? ".");
     const options = {
       dir,
       layout: argv.layout,
@@ -15021,6 +15313,13 @@ async function initV2(argv) {
       }
     }
     const result = await applyInitPlan(plan2);
+    const packages = await setUpPackages({
+      dir,
+      layout: plan2.layout,
+      name: argv.name ?? path50.basename(dir),
+      install: argv.install === true,
+      quiet: json
+    });
     if (json) {
       console.log(
         JSON.stringify(
@@ -15028,8 +15327,9 @@ async function initV2(argv) {
             status: "created",
             dir,
             ...describePlan(plan2),
-            created: result.created.map((p) => path48.relative(dir, p)),
-            kept: result.kept.map((p) => path48.relative(dir, p))
+            created: result.created.map((p) => path50.relative(dir, p)),
+            kept: result.kept.map((p) => path50.relative(dir, p)),
+            packages
           },
           null,
           2
@@ -15038,8 +15338,16 @@ async function initV2(argv) {
       return;
     }
     printResultToConsole(
-      `Created ${path48.basename(plan2.configPath)} (config version 2, ${plan2.layout} layout) in ${dir}.`
+      `Created ${path50.basename(plan2.configPath)} (config version 2, ${plan2.layout} layout) in ${dir}.`
     );
+    if (packages.installed)
+      printResultToConsole(
+        "Installed @lukoweb/apitogo, react and react-dom (package.json was created for them)."
+      );
+    else
+      printHintToConsole(
+        `The portal needs @lukoweb/apitogo, react and react-dom in this project. Run: ${packages.command}`
+      );
     printHintToConsole(
       "Config version 2 is a preview: add, remove, check, run, build, plan, status, deploy and secrets read it."
     );
@@ -15064,9 +15372,9 @@ async function initV2(argv) {
 }
 
 // src/cli/services/packages.ts
-import { spawn } from "node:child_process";
-import { existsSync as existsSync5 } from "node:fs";
-import path49 from "node:path";
+import { spawn as spawn2 } from "node:child_process";
+import { existsSync as existsSync6 } from "node:fs";
+import path51 from "node:path";
 var USER_PANEL_PACKAGE = "@lukoweb/apitogo-module-user-panel";
 var BILLING_PLUGIN_PACKAGE = "@lukoweb/apitogo-plugin-dev-portal-billing";
 function packagesForConfig(config2) {
@@ -15081,26 +15389,26 @@ function packagesForConfig(config2) {
   ];
 }
 function isInstalled(dir, name) {
-  for (let current = path49.resolve(dir); ; current = path49.dirname(current)) {
-    if (existsSync5(path49.join(current, "node_modules", name, "package.json")))
+  for (let current = path51.resolve(dir); ; current = path51.dirname(current)) {
+    if (existsSync6(path51.join(current, "node_modules", name, "package.json")))
       return true;
-    if (path49.dirname(current) === current) return false;
+    if (path51.dirname(current) === current) return false;
   }
 }
 function missingPackages(dir, names) {
   return names.filter((name) => !isInstalled(dir, name));
 }
 function detectPackageManager(dir) {
-  if (existsSync5(path49.join(dir, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync5(path49.join(dir, "yarn.lock"))) return "yarn";
+  if (existsSync6(path51.join(dir, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync6(path51.join(dir, "yarn.lock"))) return "yarn";
   return "npm";
 }
-function installCommand(manager, names, version) {
+function installCommand2(manager, names, version) {
   const specs = names.map((name) => `${name}@${version}`);
   return manager === "npm" ? { command: "npm", args: ["install", ...specs] } : { command: manager, args: ["add", ...specs] };
 }
 var runInstaller = (dir, { command: command2, args }) => new Promise((resolve, reject) => {
-  const child = spawn(command2, args, {
+  const child = spawn2(command2, args, {
     cwd: dir,
     stdio: "inherit",
     shell: process.platform === "win32"
@@ -15118,7 +15426,7 @@ var runInstaller = (dir, { command: command2, args }) => new Promise((resolve, r
 async function installMissingPackages(dir, config2, version, options) {
   const missing = missingPackages(dir, packagesForConfig(config2));
   if (missing.length === 0) return void 0;
-  const command2 = installCommand(detectPackageManager(dir), missing, version);
+  const command2 = installCommand2(detectPackageManager(dir), missing, version);
   const shown = `${command2.command} ${command2.args.join(" ")}`;
   if (!options.install)
     return {
@@ -15127,7 +15435,7 @@ async function installMissingPackages(dir, config2, version, options) {
       reason: "--no-install was given",
       command: shown
     };
-  if (!existsSync5(path49.join(dir, "package.json")))
+  if (!existsSync6(path51.join(dir, "package.json")))
     return {
       status: "skipped",
       packages: missing,
@@ -15146,7 +15454,7 @@ var list = (value) => {
   return items.length > 0 ? items : void 0;
 };
 function addOptionsFromArguments(service, argv) {
-  const dir = path50.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path52.resolve(process.cwd(), argv.dir ?? ".");
   const issuers = list(argv.issuer);
   return {
     dir,
@@ -15205,8 +15513,8 @@ function describe(edit, dir) {
   return {
     service: edit.service,
     action: edit.action,
-    willCreate: edit.files.map((file) => path50.relative(dir, file.path)),
-    keep: edit.keep.map((file) => path50.relative(dir, file)),
+    willCreate: edit.files.map((file) => path52.relative(dir, file.path)),
+    keep: edit.keep.map((file) => path52.relative(dir, file)),
     notes: edit.notes
   };
 }
@@ -15219,7 +15527,7 @@ async function run(action, argv, plan2, deps = {}) {
         `Choose one of ${SERVICES.join(", ")}.`
       );
     }
-    const dir = path50.resolve(process.cwd(), argv.dir ?? ".");
+    const dir = path52.resolve(process.cwd(), argv.dir ?? ".");
     if (!await isConfigV2(dir)) {
       throw new ServiceEditError(
         `${action} works with a config version 2 project, and there is none in ${dir}.`,
@@ -15266,7 +15574,7 @@ async function run(action, argv, plan2, deps = {}) {
           {
             status: action === "add" ? "added" : "removed",
             ...describe(edit, dir),
-            created: created.map((file) => path50.relative(dir, file)),
+            created: created.map((file) => path52.relative(dir, file)),
             ...install ? { packages: install } : {}
           },
           null,
@@ -15276,7 +15584,7 @@ async function run(action, argv, plan2, deps = {}) {
       return;
     }
     printResultToConsole(
-      `${action === "add" ? "Added" : "Removed"} ${edit.service} in ${path50.basename(edit.configPath)}.`
+      `${action === "add" ? "Added" : "Removed"} ${edit.service} in ${path52.basename(edit.configPath)}.`
     );
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -15334,7 +15642,7 @@ var removeService = (argv) => run(
   "remove",
   argv,
   (service) => planRemoveService(service, {
-    dir: path50.resolve(process.cwd(), argv.dir ?? ".")
+    dir: path52.resolve(process.cwd(), argv.dir ?? ".")
   })
 );
 
@@ -15482,16 +15790,16 @@ var add_default = {
 };
 
 // src/cli/build/handler.ts
-import path52 from "node:path";
+import path54 from "node:path";
 init_logger();
 init_package_json();
 
 // src/cli/preview/handler.ts
-import path51 from "node:path";
+import path53 from "node:path";
 import { preview as vitePreview } from "vite";
 var DEFAULT_PREVIEW_PORT = 4e3;
 async function preview(argv) {
-  const dir = path51.resolve(process.cwd(), argv.dir);
+  const dir = path53.resolve(process.cwd(), argv.dir);
   const viteConfig = await getViteConfig(dir, {
     command: "serve",
     mode: "production",
@@ -15534,7 +15842,7 @@ async function build(argv) {
     printDiagnosticsToConsole("");
     printDiagnosticsToConsole("");
   }
-  const dir = path52.resolve(process.cwd(), argv.dir);
+  const dir = path54.resolve(process.cwd(), argv.dir);
   try {
     if (await isConfigV2(dir)) {
       const result = await buildV2({ dir, jsonOnly });
@@ -15599,10 +15907,10 @@ var build_default = {
 };
 
 // src/cli/check/handler.ts
-import path59 from "node:path";
+import path60 from "node:path";
 
 // src/cli/platform/tools/check-publish-readiness.ts
-import path58 from "node:path";
+import path59 from "node:path";
 
 // src/cli/platform/helpers/dev-portal-backend.ts
 function deriveProvisioningState(backend) {
@@ -15685,12 +15993,12 @@ function formatDevPortalBackendResponse(projectId, backend) {
 
 // src/cli/platform/helpers/dev-portal-manifest.ts
 init_gateway_limits();
-import { existsSync as existsSync6 } from "node:fs";
-import { access as access5, mkdir as mkdir13, readFile as readFile14, writeFile as writeFile14 } from "node:fs/promises";
-import path54 from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { access as access6, mkdir as mkdir13, readFile as readFile16, writeFile as writeFile15 } from "node:fs/promises";
+import path56 from "node:path";
 
 // src/cli/make-config/json-config.ts
-import path53 from "node:path";
+import path55 from "node:path";
 
 // src/cli/make-config/branding-assets.ts
 var LOGO_LIGHT = '<svg xmlns="http://www.w3.org/2000/svg" width="201.57" height="72.66" viewBox="-0.09 -46.99 201.57 72.66">\n  <path d="M13.5 0.39Q8.03 0.39 4.76 -2.09Q1.48 -4.57 1.41 -9.61H8.03Q8.14 -7.48 9.6 -6.41Q11.05 -5.33 13.42 -5.33Q15.57 -5.33 16.8 -6.2Q18.03 -7.07 18.03 -8.46Q18.03 -9.71 16.87 -10.44Q15.7 -11.17 13.32 -11.72L10.23 -12.44Q6.46 -13.3 4.32 -15.25Q2.17 -17.21 2.17 -20.49Q2.17 -23.18 3.62 -25.21Q5.08 -27.23 7.64 -28.36Q10.2 -29.49 13.5 -29.49Q16.88 -29.49 19.36 -28.35Q21.84 -27.21 23.2 -25.17Q24.57 -23.12 24.61 -20.43H17.99Q17.85 -22.01 16.7 -22.89Q15.55 -23.77 13.48 -23.77Q11.41 -23.77 10.35 -22.97Q9.3 -22.17 9.3 -20.96Q9.3 -19.61 10.47 -18.88Q11.64 -18.14 13.59 -17.71L16.11 -17.13Q20.33 -16.19 22.67 -14.06Q25 -11.93 25 -8.44Q25 -4.3 21.95 -1.95Q18.91 0.39 13.5 0.39Z M32.97 0.39Q29.82 0.39 27.8 -1.21Q25.78 -2.81 25.78 -6.05Q25.78 -8.48 26.89 -9.9Q28 -11.33 29.85 -12.01Q31.7 -12.7 33.9 -12.89Q36.68 -13.12 37.88 -13.47Q39.08 -13.81 39.08 -14.82V-14.9Q39.08 -16.04 38.29 -16.65Q37.5 -17.27 36.11 -17.27Q34.68 -17.27 33.77 -16.66Q32.85 -16.05 32.58 -15.02L26.4 -15.82Q27.05 -18.61 29.56 -20.36Q32.07 -22.11 36.17 -22.11Q38.88 -22.11 41.08 -21.27Q43.28 -20.43 44.58 -18.8Q45.88 -17.17 45.88 -14.82V0H39.47V-3.07H39.29Q37.48 0.39 32.97 0.39ZM35.04 -4.12Q36.75 -4.12 37.95 -5.14Q39.14 -6.15 39.14 -7.77V-9.86Q38.55 -9.55 37.44 -9.34Q36.33 -9.12 35.37 -8.96Q32.22 -8.5 32.22 -6.37Q32.22 -5.27 33.01 -4.7Q33.81 -4.12 35.04 -4.12Z M48.59 0V-21.84H54.86L55.17 -17.5Q56.07 -19.96 57.78 -21.04Q59.49 -22.13 61.46 -22.13Q63.53 -22.13 64.91 -20.94Q66.28 -19.75 67.08 -17.07Q68.08 -19.77 70.02 -20.95Q71.97 -22.13 74.17 -22.13Q77.24 -22.13 79.2 -20.16Q81.17 -18.18 81.17 -14.73V0H74.37V-13.18Q74.37 -14.84 73.5 -15.7Q72.63 -16.56 71.28 -16.56Q69.84 -16.56 69 -15.62Q68.16 -14.67 68.16 -13.11V0H61.61V-13.28Q61.61 -14.79 60.77 -15.67Q59.92 -16.56 58.57 -16.56Q57.18 -16.56 56.29 -15.62Q55.4 -14.69 55.4 -12.97V0Z M83.88 8.16V-21.84H90.62V-18.09H90.85Q91.26 -19.06 92.04 -19.99Q92.82 -20.92 94.05 -21.51Q95.28 -22.11 97.02 -22.11Q99.33 -22.11 101.31 -20.9Q103.29 -19.69 104.51 -17.21Q105.73 -14.73 105.73 -10.9Q105.73 -7.19 104.55 -4.7Q103.37 -2.21 101.39 -0.95Q99.4 0.31 96.98 0.31Q94.48 0.31 92.99 -0.87Q91.49 -2.05 90.85 -3.54H90.69V8.16ZM94.66 -5Q96.63 -5 97.68 -6.62Q98.72 -8.24 98.72 -10.9Q98.72 -13.55 97.68 -15.17Q96.63 -16.78 94.66 -16.78Q92.71 -16.78 91.62 -15.2Q90.54 -13.61 90.54 -10.9Q90.54 -8.22 91.62 -6.61Q92.71 -5 94.66 -5Z M114.4 -29.1V0H107.59V-29.1Z M127.29 0.41Q122.15 0.41 119.21 -2.59Q116.27 -5.59 116.27 -10.84Q116.27 -14.2 117.59 -16.74Q118.91 -19.28 121.33 -20.69Q123.75 -22.11 127.04 -22.11Q130.1 -22.11 132.47 -20.83Q134.85 -19.55 136.21 -17.06Q137.56 -14.57 137.56 -10.98V-9.26H122.97Q123.07 -6.89 124.27 -5.71Q125.47 -4.53 127.41 -4.53Q128.77 -4.53 129.77 -5.11Q130.77 -5.68 131.18 -6.78L137.25 -5.78Q136.43 -2.95 133.84 -1.27Q131.25 0.41 127.29 0.41ZM123.01 -13.22H131.1Q130.9 -15.08 129.89 -16.12Q128.87 -17.17 127.09 -17.17Q125.3 -17.17 124.25 -16.1Q123.21 -15.04 123.01 -13.22Z" fill="#202633"/>\n  <path d="M138.48 0 148.19 -29.1H157.43L167.43 0H159.69L157.72 -6.19H148.03L146.14 0ZM149.65 -11.46H156.04L155.65 -12.71Q154.89 -15.21 154.16 -17.95Q153.44 -20.68 152.74 -23.61Q152.07 -20.66 151.42 -17.93Q150.77 -15.2 150.04 -12.71Z M168.81 0V-29.1H180.72Q184 -29.1 186.39 -27.83Q188.77 -26.56 190.05 -24.3Q191.33 -22.03 191.33 -19.04Q191.33 -16.04 190.02 -13.8Q188.71 -11.56 186.29 -10.32Q183.87 -9.08 180.53 -9.08H175.7V0ZM175.7 -14.53H179.28Q181.7 -14.53 182.94 -15.77Q184.18 -17.01 184.18 -19.04Q184.18 -21.09 182.93 -22.3Q181.68 -23.52 179.26 -23.52H175.7Z M199.98 -29.1V0H193.08V-29.1Z" fill="#008A7D"/>\n</svg>\n';
@@ -16160,9 +16468,9 @@ function openapiInputForConfig(specRelativePosix) {
   return `./${specRelativePosix}`;
 }
 function toRelativeOpenApiInput(projectDir, inputPath) {
-  const resolved = path53.isAbsolute(inputPath) ? inputPath : path53.resolve(projectDir, inputPath);
-  const relative = path53.relative(projectDir, resolved);
-  const posix = relative.split(path53.sep).join(path53.posix.sep);
+  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);
   if (!posix) {
     throw new Error("OpenAPI path must point to a file.");
   }
@@ -16442,7 +16750,7 @@ function isPlanFree(plan2) {
   return (plan2.priceAmount ?? 0) <= 0;
 }
 function manifestFilePath(siteDirectory) {
-  return path54.join(path54.resolve(siteDirectory), APITOGO_CONFIG_FILENAME2);
+  return path56.join(path56.resolve(siteDirectory), APITOGO_CONFIG_FILENAME2);
 }
 var STORED_MANIFEST_KEYS = [
   "authentication",
@@ -16667,9 +16975,9 @@ function applyManifestToConfig(config2, manifest) {
 async function readLegacyManifest(_siteDirectory) {
   return null;
 }
-async function pathExists(filePath) {
+async function pathExists2(filePath) {
   try {
-    await access5(filePath);
+    await access6(filePath);
     return true;
   } catch {
     return false;
@@ -16915,39 +17223,39 @@ function resolveBackendSourceDirectory(siteDirectory, sourceDirectory) {
   if (!trimmed) {
     return void 0;
   }
-  return path54.resolve(siteDirectory, trimmed);
+  return path56.resolve(siteDirectory, trimmed);
 }
 function resolveBackendOpenApiPath(openApiPath, options) {
   const trimmed = openApiPath?.trim();
   if (!trimmed) {
     return void 0;
   }
-  if (path54.isAbsolute(trimmed)) {
+  if (path56.isAbsolute(trimmed)) {
     return trimmed;
   }
-  const siteResolved = path54.resolve(options.siteDirectory, trimmed);
-  if (existsSync6(siteResolved)) {
+  const siteResolved = path56.resolve(options.siteDirectory, trimmed);
+  if (existsSync7(siteResolved)) {
     return siteResolved;
   }
   const backendDir = options.backendSourceDirectory?.trim();
   if (backendDir) {
-    const backendResolved = path54.resolve(backendDir, trimmed);
-    if (existsSync6(backendResolved)) {
+    const backendResolved = path56.resolve(backendDir, trimmed);
+    if (existsSync7(backendResolved)) {
       return backendResolved;
     }
   }
   return siteResolved;
 }
 function toSiteRelativeOpenApiInput(siteDirectory, openApiAbsolutePath) {
-  const relative = path54.relative(
-    path54.resolve(siteDirectory),
-    path54.resolve(openApiAbsolutePath)
+  const relative = path56.relative(
+    path56.resolve(siteDirectory),
+    path56.resolve(openApiAbsolutePath)
   );
-  const posix = relative.split(path54.sep).join("/");
+  const posix = relative.split(path56.sep).join("/");
   if (!posix || posix === ".") {
     return "./";
   }
-  if (path54.isAbsolute(posix) || posix.startsWith("..")) {
+  if (path56.isAbsolute(posix) || posix.startsWith("..")) {
     return posix;
   }
   return posix.startsWith("./") ? posix : `./${posix}`;
@@ -16985,8 +17293,8 @@ function applyOpenApiToSiteConfig(config2, options) {
 }
 async function readManifest2(siteDirectory) {
   const filePath = manifestFilePath(siteDirectory);
-  if (await pathExists(filePath)) {
-    const raw = await readFile14(filePath, "utf8");
+  if (await pathExists2(filePath)) {
+    const raw = await readFile16(filePath, "utf8");
     const config2 = JSON.parse(raw);
     return extractManifestFromConfig(config2);
   }
@@ -16994,10 +17302,10 @@ async function readManifest2(siteDirectory) {
 }
 async function writeManifest2(siteDirectory, manifest) {
   const filePath = manifestFilePath(siteDirectory);
-  await mkdir13(path54.dirname(filePath), { recursive: true });
+  await mkdir13(path56.dirname(filePath), { recursive: true });
   let config2 = {};
-  if (await pathExists(filePath)) {
-    const raw = await readFile14(filePath, "utf8");
+  if (await pathExists2(filePath)) {
+    const raw = await readFile16(filePath, "utf8");
     config2 = JSON.parse(raw);
   }
   const {
@@ -17006,21 +17314,21 @@ async function writeManifest2(siteDirectory, manifest) {
     ...safeManifest
   } = manifest;
   config2 = applyManifestToConfig(config2, safeManifest);
-  await writeFile14(filePath, `${JSON.stringify(config2, null, 2)}
+  await writeFile15(filePath, `${JSON.stringify(config2, null, 2)}
 `, "utf8");
   return filePath;
 }
 
 // src/cli/platform/helpers/dev-portal-secrets.ts
 import {
-  access as access6,
+  access as access7,
   appendFile,
   mkdir as mkdir14,
-  readFile as readFile15,
+  readFile as readFile17,
   unlink,
-  writeFile as writeFile15
+  writeFile as writeFile16
 } from "node:fs/promises";
-import path55 from "node:path";
+import path57 from "node:path";
 var ENV_FILENAME = ".env";
 var COLLAPSED_UPPERCASE_ALIASES2 = {
   SECRETKEY: "secretKey",
@@ -17122,7 +17430,7 @@ function applyEnvOverrides2(config2, env) {
 }
 async function readEnvFile(filePath) {
   try {
-    const raw = await readFile15(filePath, "utf8");
+    const raw = await readFile17(filePath, "utf8");
     const env = {};
     for (const line2 of raw.split("\n")) {
       const trimmed = line2.trim();
@@ -17139,12 +17447,12 @@ async function readEnvFile(filePath) {
   }
 }
 async function loadSiteEnv(siteDirectory) {
-  const resolvedDirectory = path55.resolve(siteDirectory);
+  const resolvedDirectory = path57.resolve(siteDirectory);
   const merged = { ...process.env };
   for (const fileName of [ENV_FILENAME, ".env.local"]) {
     Object.assign(
       merged,
-      await readEnvFile(path55.join(resolvedDirectory, fileName))
+      await readEnvFile(path57.join(resolvedDirectory, fileName))
     );
   }
   return merged;
@@ -17181,7 +17489,7 @@ function buildAuthSecretsJson(secrets2, options) {
   return payload;
 }
 function envFilePath(siteDirectory) {
-  return path55.join(path55.resolve(siteDirectory), ENV_FILENAME);
+  return path57.join(path57.resolve(siteDirectory), ENV_FILENAME);
 }
 function createEnvContent() {
   return [
@@ -17245,7 +17553,7 @@ function validateSecretsForPublish(manifest, secrets2, emailOptions) {
 }
 async function siteEnvFileHasEntries(siteDirectory) {
   for (const fileName of [ENV_FILENAME, ".env.local"]) {
-    const loaded = await readEnvFile(path55.join(siteDirectory, fileName));
+    const loaded = await readEnvFile(path57.join(siteDirectory, fileName));
     if (Object.keys(loaded).length > 0) {
       return true;
     }
@@ -17253,7 +17561,7 @@ async function siteEnvFileHasEntries(siteDirectory) {
   return false;
 }
 async function resolvePublishConfig(siteDirectory, emailOptions) {
-  const resolvedDirectory = path55.resolve(siteDirectory);
+  const resolvedDirectory = path57.resolve(siteDirectory);
   const manifestRaw = await readManifest2(resolvedDirectory);
   if (!manifestRaw) {
     throw new Error("apitogo.config.json not found in sourceDirectory.");
@@ -17286,20 +17594,20 @@ function envFileHasActiveAssignments(content) {
   });
 }
 async function writeScaffoldEnv(siteDirectory) {
-  const resolvedDirectory = path55.resolve(siteDirectory);
+  const resolvedDirectory = path57.resolve(siteDirectory);
   const filesWritten = [];
   const envPath = envFilePath(resolvedDirectory);
   try {
-    await access6(envPath);
+    await access7(envPath);
   } catch {
     await mkdir14(resolvedDirectory, { recursive: true });
-    await writeFile15(envPath, createEnvContent(), "utf8");
+    await writeFile16(envPath, createEnvContent(), "utf8");
     filesWritten.push(ENV_FILENAME);
   }
   for (const legacyName of [".env.example"]) {
-    const legacyPath = path55.join(resolvedDirectory, legacyName);
+    const legacyPath = path57.join(resolvedDirectory, legacyName);
     try {
-      const legacy = await readFile15(legacyPath, "utf8");
+      const legacy = await readFile17(legacyPath, "utf8");
       if (!envFileHasActiveAssignments(legacy)) {
         await unlink(legacyPath);
         filesWritten.push(`removed:${legacyName}`);
@@ -17307,10 +17615,10 @@ async function writeScaffoldEnv(siteDirectory) {
     } catch {
     }
   }
-  const gitignorePath = path55.join(resolvedDirectory, ".gitignore");
+  const gitignorePath = path57.join(resolvedDirectory, ".gitignore");
   let gitignore = "";
   try {
-    gitignore = await readFile15(gitignorePath, "utf8");
+    gitignore = await readFile17(gitignorePath, "utf8");
   } catch {
     gitignore = "";
   }
@@ -17322,7 +17630,7 @@ async function writeScaffoldEnv(siteDirectory) {
     if (!hasEntry) {
       const suffix = gitignore.length === 0 ? "" : gitignore.endsWith("\n") ? "" : "\n";
       if (gitignore.length === 0) {
-        await writeFile15(gitignorePath, `${entry}
+        await writeFile16(gitignorePath, `${entry}
 `, "utf8");
       } else {
         await appendFile(gitignorePath, `${suffix}${entry}
@@ -17342,13 +17650,13 @@ var SECRETS_COLLECTION_INSTRUCTION = "For go-live, plans must already be in apit
 
 // src/cli/platform/helpers/dev-portal-site-validation.ts
 init_gateway_limits();
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import { createRequire as createRequire3 } from "node:module";
-import path56 from "node:path";
+import path58 from "node:path";
 var cachedFallbackTs;
 async function loadTypeScriptForSite(sourceDirectory) {
   const require2 = createRequire3(
-    path56.join(path56.resolve(sourceDirectory), "package.json")
+    path58.join(path58.resolve(sourceDirectory), "package.json")
   );
   try {
     return require2("typescript");
@@ -17394,8 +17702,8 @@ async function referencedFileExists(sourceDirectory, reference) {
   if (/^https?:\/\//i.test(reference)) {
     return true;
   }
-  return pathExists(
-    path56.resolve(sourceDirectory, reference.replace(/^\.\//, ""))
+  return pathExists2(
+    path58.resolve(sourceDirectory, reference.replace(/^\.\//, ""))
   );
 }
 async function validateSiteConfigStructure(config2, sourceDirectory) {
@@ -17510,17 +17818,17 @@ var DEFAULT_TSX_CANDIDATES = [
   "landing/LandingPage.tsx"
 ];
 async function validateDevPortalSiteConfig(sourceDirectory, options) {
-  const resolvedDir = path56.resolve(sourceDirectory);
+  const resolvedDir = path58.resolve(sourceDirectory);
   const issues = [];
   const checkedFiles = [];
   const skippedChecks = [];
-  const jsonPath = path56.join(resolvedDir, APITOGO_CONFIG_FILENAME2);
-  if (await pathExists(jsonPath)) {
+  const jsonPath = path58.join(resolvedDir, APITOGO_CONFIG_FILENAME2);
+  if (await pathExists2(jsonPath)) {
     checkedFiles.push(APITOGO_CONFIG_FILENAME2);
     let parsed;
     let parseFailed = false;
     try {
-      parsed = JSON.parse(await readFile16(jsonPath, "utf8"));
+      parsed = JSON.parse(await readFile18(jsonPath, "utf8"));
     } catch (error) {
       parseFailed = true;
       issues.push({
@@ -17546,7 +17854,7 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
   );
   const existingTsxFiles = [];
   for (const relativeFile of tsxFiles) {
-    if (await pathExists(path56.join(resolvedDir, relativeFile))) {
+    if (await pathExists2(path58.join(resolvedDir, relativeFile))) {
       existingTsxFiles.push(relativeFile);
     }
   }
@@ -17559,8 +17867,8 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
     } else {
       for (const relativeFile of existingTsxFiles) {
         checkedFiles.push(relativeFile);
-        const content = await readFile16(
-          path56.join(resolvedDir, relativeFile),
+        const content = await readFile18(
+          path58.join(resolvedDir, relativeFile),
           "utf8"
         );
         issues.push(
@@ -17595,134 +17903,6 @@ function buildSiteValidationResponseFields(result) {
   };
 }
 
-// src/cli/platform/helpers/npm-build.ts
-import { spawn as spawn2 } from "node:child_process";
-import { access as access7, readFile as readFile17 } from "node:fs/promises";
-import path57 from "node:path";
-var BUILD_LOG_TAIL_BYTES = 8192;
-var MIN_NODE_MAJOR = 20;
-var NpmBuildError = class extends Error {
-  buildLog;
-  exitCode;
-  constructor(message, buildLog, exitCode) {
-    super(message);
-    this.name = "NpmBuildError";
-    this.buildLog = buildLog;
-    this.exitCode = exitCode;
-  }
-};
-function parseNodeMajor(version) {
-  const match = /^v?(\d+)/.exec(version.trim());
-  return match ? Number.parseInt(match[1], 10) : Number.NaN;
-}
-function assertNodeVersion(required) {
-  const major = parseNodeMajor(process.version);
-  if (Number.isNaN(major) || major < MIN_NODE_MAJOR) {
-    throw new Error(
-      `Node.js ${MIN_NODE_MAJOR}+ is required (current: ${process.version}).`
-    );
-  }
-  if (required) {
-    const requiredMajor = parseNodeMajor(required);
-    if (!Number.isNaN(requiredMajor) && major < requiredMajor) {
-      throw new Error(
-        `Node.js ${requiredMajor}+ is required by nodeVersion option (current: ${process.version}).`
-      );
-    }
-  }
-}
-function truncateBuildLog(log, success) {
-  if (success && log.length > BUILD_LOG_TAIL_BYTES) {
-    return log.slice(-BUILD_LOG_TAIL_BYTES);
-  }
-  return log;
-}
-async function pathExists2(filePath) {
-  try {
-    await access7(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function runCommand(command2, args, cwd, env) {
-  return new Promise((resolve, reject) => {
-    const child = spawn2(command2, args, {
-      cwd,
-      env: env ? { ...process.env, ...env } : process.env,
-      shell: process.platform === "win32"
-    });
-    let output4 = "";
-    child.stdout.on("data", (chunk) => {
-      output4 += chunk.toString();
-    });
-    child.stderr.on("data", (chunk) => {
-      output4 += chunk.toString();
-    });
-    child.on("error", reject);
-    child.on("close", (exitCode) => resolve({ exitCode, output: output4 }));
-  });
-}
-async function runNpmInstall(sourceDirectory, options) {
-  assertNodeVersion(options?.nodeVersion);
-  const cwd = path57.resolve(sourceDirectory);
-  const packageJsonPath = path57.join(cwd, "package.json");
-  if (!await pathExists2(packageJsonPath)) {
-    throw new Error(`package.json not found in sourceDirectory: ${cwd}`);
-  }
-  const startedAt = Date.now();
-  const lockPath = path57.join(cwd, "package-lock.json");
-  const installArgs = await pathExists2(lockPath) ? ["ci"] : ["install"];
-  const install = await runCommand("npm", installArgs, cwd);
-  const installLog = install.output;
-  if (install.exitCode !== 0) {
-    throw new NpmBuildError(
-      `npm ${installArgs.join(" ")} exited ${install.exitCode ?? "unknown"}`,
-      installLog,
-      install.exitCode
-    );
-  }
-  return {
-    durationMs: Date.now() - startedAt,
-    installLog: truncateBuildLog(installLog, true)
-  };
-}
-async function runNpmBuild(sourceDirectory, options) {
-  assertNodeVersion(options?.nodeVersion);
-  const cwd = path57.resolve(sourceDirectory);
-  const packageJsonPath = path57.join(cwd, "package.json");
-  if (!await pathExists2(packageJsonPath)) {
-    throw new Error(`package.json not found in sourceDirectory: ${cwd}`);
-  }
-  const startedAt = Date.now();
-  let buildLog = "";
-  const install = await runNpmInstall(sourceDirectory, options);
-  buildLog += install.installLog;
-  const build2 = await runCommand("npm", ["run", "build"], cwd, options?.env);
-  buildLog += build2.output;
-  if (build2.exitCode !== 0) {
-    throw new NpmBuildError(
-      `npm run build exited ${build2.exitCode ?? "unknown"}`,
-      buildLog,
-      build2.exitCode
-    );
-  }
-  const distPath = path57.join(cwd, "dist");
-  const indexPath = path57.join(distPath, "index.html");
-  if (!await pathExists2(indexPath)) {
-    throw new NpmBuildError(
-      `Build completed but dist/index.html was not found at ${indexPath}`,
-      buildLog,
-      build2.exitCode
-    );
-  }
-  return {
-    distPath,
-    durationMs: Date.now() - startedAt,
-    buildLog: truncateBuildLog(buildLog, true)
-  };
-}
-
 // src/cli/platform/helpers/paid-gateway-platform-compat.ts
 function listPaidManifestPlans(plans) {
   return (plans ?? []).filter((plan2) => !isPlanFree(plan2)).map((plan2) => ({
@@ -18092,7 +18272,7 @@ function validateManifestForPlatformPublish(manifest) {
 
 // src/cli/platform/tools/check-publish-readiness.ts
 async function checkPublishReadiness(client, _config, args) {
-  const sourceDirectory = path58.resolve(args.sourceDirectory);
+  const sourceDirectory = path59.resolve(args.sourceDirectory);
   const manifest = await readManifest2(sourceDirectory) ?? createScaffoldManifest();
   const emailOptions = await resolveEmailOptionsForPublish(
     client,
@@ -18170,7 +18350,7 @@ async function checkPublishReadiness(client, _config, args) {
 
 // src/cli/check/handler.ts
 async function check(argv) {
-  const sourceDirectory = path59.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path60.resolve(process.cwd(), argv.dir);
   if (await isConfigV2(sourceDirectory)) {
     await checkV2(sourceDirectory, argv);
     return;
@@ -18234,14 +18414,14 @@ var check_default = {
 
 // src/cli/make-config/handler.ts
 import { constants as constants2 } from "node:fs";
-import { access as access12, mkdir as mkdir17, readFile as readFile22, writeFile as writeFile20 } from "node:fs/promises";
-import path69 from "node:path";
+import { access as access12, mkdir as mkdir17, readFile as readFile23, writeFile as writeFile21 } from "node:fs/promises";
+import path70 from "node:path";
 import { stdin as input2 } from "node:process";
 import { glob as glob8 } from "glob";
 
 // src/cli/platform/helpers/openapi-action-keys.ts
-import { existsSync as existsSync7, readFileSync as readFileSync4 } from "node:fs";
-import path60 from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync4 } from "node:fs";
+import path61 from "node:path";
 import YAML from "yaml";
 var HTTP_METHODS = [
   "get",
@@ -18310,7 +18490,7 @@ function extractGatewayActionKeysFromOpenApiDocument(document) {
 function extractGatewayActionKeysFromOpenApiFile(filePath) {
   try {
     const raw = readFileSync4(filePath, "utf8");
-    const ext = path60.extname(filePath).toLowerCase();
+    const ext = path61.extname(filePath).toLowerCase();
     const parsed = ext === ".json" ? JSON.parse(raw) : YAML.parse(raw);
     return extractGatewayActionKeysFromOpenApiDocument(parsed);
   } catch {
@@ -18331,8 +18511,8 @@ function resolveConfigOpenApiFilePath(siteDirectory, config2) {
     }
   }
   for (const candidate of candidates) {
-    const resolved = path60.isAbsolute(candidate) ? candidate : path60.resolve(siteDirectory, candidate);
-    if (existsSync7(resolved)) {
+    const resolved = path61.isAbsolute(candidate) ? candidate : path61.resolve(siteDirectory, candidate);
+    if (existsSync8(resolved)) {
       return resolved;
     }
   }
@@ -18346,8 +18526,8 @@ function loadOpenApiActionKeysForSite(siteDirectory, config2) {
   return extractGatewayActionKeysFromOpenApiFile(filePath);
 }
 function loadOpenApiActionKeysFromSiteDirectory(siteDirectory) {
-  const configPath = path60.join(siteDirectory, "apitogo.config.json");
-  if (!existsSync7(configPath)) {
+  const configPath = path61.join(siteDirectory, "apitogo.config.json");
+  if (!existsSync8(configPath)) {
     return [];
   }
   try {
@@ -18374,12 +18554,12 @@ function withDefaultIncludedActionKeys(plan2, actionKeys) {
 }
 
 // src/cli/scaffold/dev-portal-config-pages.ts
-import { access as access8, readFile as readFile18, rename as rename7, rm as rm9, writeFile as writeFile16 } from "node:fs/promises";
-import path61 from "node:path";
+import { access as access8, readFile as readFile19, rename as rename7, rm as rm9, writeFile as writeFile17 } from "node:fs/promises";
+import path62 from "node:path";
 async function writeConfigAtomically(filePath, content) {
   const temporaryPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
   try {
-    await writeFile16(temporaryPath, content, "utf8");
+    await writeFile17(temporaryPath, content, "utf8");
     await rename7(temporaryPath, filePath);
   } catch (error) {
     await rm9(temporaryPath, { force: true });
@@ -18388,7 +18568,7 @@ async function writeConfigAtomically(filePath, content) {
 }
 async function resolveApitogoConfigPath(sourceDirectory) {
   for (const filename of ["apitogo.config.tsx", "apitogo.config.jsx"]) {
-    const configPath = path61.join(sourceDirectory, filename);
+    const configPath = path62.join(sourceDirectory, filename);
     try {
       await access8(configPath);
       return configPath;
@@ -19139,7 +19319,7 @@ async function wireNewDevPortalPageInConfig(sourceDirectory, slug, label) {
   if (!configPath) {
     return { updated: false };
   }
-  const original = await readFile18(configPath, "utf8");
+  const original = await readFile19(configPath, "utf8");
   const patched = patchApitogoConfigForNewPage(original, slug, label, {
     typescript: configPath.endsWith(".tsx")
   });
@@ -19151,18 +19331,18 @@ async function wireNewDevPortalPageInConfig(sourceDirectory, slug, label) {
 }
 
 // src/cli/scaffold/wire-openapi.ts
-import { access as access10, readFile as readFile20, writeFile as writeFile18 } from "node:fs/promises";
-import path66 from "node:path";
+import { access as access10, readFile as readFile21, writeFile as writeFile19 } from "node:fs/promises";
+import path67 from "node:path";
 
 // src/cli/platform/helpers/openapi.ts
 import { promises as fs6 } from "node:fs";
-import path63 from "node:path";
+import path64 from "node:path";
 import SwaggerParser from "@apidevtools/swagger-parser";
 import YAML2 from "yaml";
 
 // src/cli/scaffold/discover-openapi-files.ts
 import { promises as fs5 } from "node:fs";
-import path62 from "node:path";
+import path63 from "node:path";
 var OPENAPI_BASENAMES = [
   "openapi.yaml",
   "openapi.yml",
@@ -19184,13 +19364,13 @@ var SKIP_OPENAPI_SEARCH_DIRS = /* @__PURE__ */ new Set([
   ".apitogo"
 ]);
 async function collectFromDir(dir, searchedDirectories, candidates) {
-  const resolved = path62.resolve(dir);
+  const resolved = path63.resolve(dir);
   if (searchedDirectories.includes(resolved)) {
     return;
   }
   searchedDirectories.push(resolved);
   for (const name of OPENAPI_BASENAMES) {
-    const candidate = path62.join(resolved, name);
+    const candidate = path63.join(resolved, name);
     try {
       await fs5.access(candidate);
       candidates.push(candidate);
@@ -19205,8 +19385,8 @@ async function collectSiteOpenApiFiles(siteDirectory) {
   return { candidates: [...new Set(candidates)], searchedDirectories };
 }
 async function collectNearbyOpenApiFiles(siteDirectory) {
-  const site = path62.resolve(siteDirectory);
-  const parent = path62.dirname(site);
+  const site = path63.resolve(siteDirectory);
+  const parent = path63.dirname(site);
   const searchedDirectories = [];
   const candidates = [];
   if (parent && parent !== site) {
@@ -19217,8 +19397,8 @@ async function collectNearbyOpenApiFiles(siteDirectory) {
         if (!entry.isDirectory() || SKIP_OPENAPI_SEARCH_DIRS.has(entry.name)) {
           continue;
         }
-        const sibling = path62.join(parent, entry.name);
-        if (path62.resolve(sibling) === site) {
+        const sibling = path63.join(parent, entry.name);
+        if (path63.resolve(sibling) === site) {
           continue;
         }
         await collectFromDir(sibling, searchedDirectories, candidates);
@@ -19246,7 +19426,7 @@ function parseOpenApiObject(doc) {
   };
 }
 function liteParseOpenApi(content, filePath) {
-  const ext = path62.extname(filePath).toLowerCase();
+  const ext = path63.extname(filePath).toLowerCase();
   if (ext === ".json") {
     try {
       const parsed = JSON.parse(content);
@@ -19311,9 +19491,9 @@ async function discoverNearbyOpenApi(siteDirectory) {
   };
 }
 async function validateOpenApiFile(filePath) {
-  const resolved = path63.resolve(filePath);
+  const resolved = path64.resolve(filePath);
   const content = await fs6.readFile(resolved, "utf8");
-  const ext = path63.extname(resolved).toLowerCase();
+  const ext = path64.extname(resolved).toLowerCase();
   let parsed;
   try {
     parsed = ext === ".json" ? JSON.parse(content) : YAML2.parse(content);
@@ -19355,8 +19535,8 @@ async function validateOpenApiFile(filePath) {
 }
 
 // src/cli/scaffold/scaffold-dev-portal-site.ts
-import { mkdir as mkdir15, readFile as readFile19, writeFile as writeFile17 } from "node:fs/promises";
-import path65 from "node:path";
+import { mkdir as mkdir15, readFile as readFile20, writeFile as writeFile18 } from "node:fs/promises";
+import path66 from "node:path";
 
 // src/cli/scaffold/apitogo-npm-packages.ts
 var DEFAULT_CREATE_APITOGO_PACKAGE2 = "@lukoweb/create-apitogo@latest";
@@ -19444,7 +19624,7 @@ var DOC_TOOL_LOCAL_PACKAGE_PATHS = {
 // src/cli/scaffold/create-apitogo-cli.ts
 import { spawn as spawn3 } from "node:child_process";
 import { access as access9, rm as rm10 } from "node:fs/promises";
-import path64 from "node:path";
+import path65 from "node:path";
 var SKIP_NEARBY_DISCOVERY_ENV = "APITOGO_SKIP_NEARBY_DISCOVERY";
 var CreateApitogoCliError = class extends Error {
   exitCode;
@@ -19461,9 +19641,9 @@ function resolveDocToolPath(explicit) {
   return value || void 0;
 }
 function splitOutputDirectory(outputDirectory) {
-  const resolvedOutputDirectory = path64.resolve(outputDirectory);
-  const projectName = path64.basename(resolvedOutputDirectory);
-  const parentDirectory = path64.dirname(resolvedOutputDirectory);
+  const resolvedOutputDirectory = path65.resolve(outputDirectory);
+  const projectName = path65.basename(resolvedOutputDirectory);
+  const parentDirectory = path65.dirname(resolvedOutputDirectory);
   if (!projectName || projectName === "." || projectName === "..") {
     throw new Error(
       "outputDirectory must be a named folder (e.g. ./dev-portal-site), not the current directory."
@@ -19489,7 +19669,7 @@ async function directoryHasEntries(dir) {
   }
 }
 function resolveLocalCreateApitogoEntry(docToolPath) {
-  return path64.resolve(docToolPath, "packages/create-zudoku/dist/index.js");
+  return path65.resolve(docToolPath, "packages/create-zudoku/dist/index.js");
 }
 async function resolveCreateApitogoInvocation(options) {
   const docToolPath = resolveDocToolPath(options.docToolPath);
@@ -19571,7 +19751,7 @@ async function runCreateApitogoDevPortal(options) {
       result.exitCode
     );
   }
-  if (!await pathExists3(path64.join(resolvedOutputDirectory, "package.json"))) {
+  if (!await pathExists3(path65.join(resolvedOutputDirectory, "package.json"))) {
     throw new CreateApitogoCliError(
       `create-apitogo completed but package.json was not found at ${resolvedOutputDirectory}`,
       result.output,
@@ -19630,7 +19810,7 @@ function ensureRequiredApitogoModules(pkg, options) {
     ]
   ]) {
     if (options.docToolPath) {
-      deps[moduleName] = `file:${path65.join(options.docToolPath, localPath)}`;
+      deps[moduleName] = `file:${path66.join(options.docToolPath, localPath)}`;
       continue;
     }
     deps[moduleName] = `npm:${moduleName}@${moduleAliasVersion}`;
@@ -19661,7 +19841,7 @@ function rewritePackageJson(raw, options) {
         DOC_TOOL_LOCAL_PACKAGE_PATHS
       )) {
         if (dep in deps) {
-          deps[dep] = `file:${path65.join(options.docToolPath, relativePath)}`;
+          deps[dep] = `file:${path66.join(options.docToolPath, relativePath)}`;
           linkedWorkspacePackage = true;
         }
       }
@@ -19761,24 +19941,24 @@ function patchDashboardPageConfig(content) {
   );
 }
 async function ensureAccountPlansPage(outputDirectory) {
-  const pagePath = path65.join(outputDirectory, ACCOUNT_PLANS_PAGE_PATH);
+  const pagePath = path66.join(outputDirectory, ACCOUNT_PLANS_PAGE_PATH);
   try {
-    await readFile19(pagePath, "utf8");
+    await readFile20(pagePath, "utf8");
     return void 0;
   } catch {
-    await mkdir15(path65.dirname(pagePath), { recursive: true });
-    await writeFile17(pagePath, ACCOUNT_PLANS_PAGE);
+    await mkdir15(path66.dirname(pagePath), { recursive: true });
+    await writeFile18(pagePath, ACCOUNT_PLANS_PAGE);
     return ACCOUNT_PLANS_PAGE_PATH;
   }
 }
 async function ensureDashboardPage(outputDirectory) {
-  const pagePath = path65.join(outputDirectory, DASHBOARD_PAGE_PATH);
+  const pagePath = path66.join(outputDirectory, DASHBOARD_PAGE_PATH);
   try {
-    await readFile19(pagePath, "utf8");
+    await readFile20(pagePath, "utf8");
     return void 0;
   } catch {
-    await mkdir15(path65.dirname(pagePath), { recursive: true });
-    await writeFile17(pagePath, DASHBOARD_PAGE);
+    await mkdir15(path66.dirname(pagePath), { recursive: true });
+    await writeFile18(pagePath, DASHBOARD_PAGE);
     return DASHBOARD_PAGE_PATH;
   }
 }
@@ -19834,10 +20014,10 @@ function patchApitogoConfig(content, options) {
 async function patchScaffoldedSite(outputDirectory, options) {
   const title = options.branding?.title ?? options.siteName;
   const filesWritten = [];
-  const packageJsonPath = path65.join(outputDirectory, "package.json");
+  const packageJsonPath = path66.join(outputDirectory, "package.json");
   if (options.patchPackageJson !== false) {
-    const packageJson3 = await readFile19(packageJsonPath, "utf8");
-    await writeFile17(
+    const packageJson3 = await readFile20(packageJsonPath, "utf8");
+    await writeFile18(
       packageJsonPath,
       rewritePackageJson(packageJson3, {
         siteName: options.siteName,
@@ -19847,9 +20027,9 @@ async function patchScaffoldedSite(outputDirectory, options) {
     );
     filesWritten.push("package.json");
   }
-  const configPath = path65.join(outputDirectory, "apitogo.config.tsx");
-  const configContent = await readFile19(configPath, "utf8");
-  await writeFile17(
+  const configPath = path66.join(outputDirectory, "apitogo.config.tsx");
+  const configContent = await readFile20(configPath, "utf8");
+  await writeFile18(
     configPath,
     patchDashboardPageConfig(
       patchAccountPlansPageConfig(
@@ -19942,8 +20122,8 @@ async function discoverOpenApiByMode(siteDirectory, mode) {
   return discoverNearbyOpenApi(siteDirectory);
 }
 async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
-  const resolvedSource = path66.resolve(sourceDirectory);
-  const resolvedOpenApi = path66.resolve(openApiPath);
+  const resolvedSource = path67.resolve(sourceDirectory);
+  const resolvedOpenApi = path67.resolve(openApiPath);
   const input5 = toSiteRelativeOpenApiInput(resolvedSource, resolvedOpenApi);
   const validation = await validateOpenApiFile(resolvedOpenApi);
   if (!validation.valid) {
@@ -19955,24 +20135,24 @@ async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
   }
   const jsonConfigPath = manifestFilePath(resolvedSource);
   if (await pathExists4(jsonConfigPath)) {
-    const raw = await readFile20(jsonConfigPath, "utf8");
+    const raw = await readFile21(jsonConfigPath, "utf8");
     const siteConfig = JSON.parse(raw);
     const updated = applyOpenApiToSiteConfig(siteConfig, {
       input: input5,
       apiPath: "api"
     });
-    await writeFile18(
+    await writeFile19(
       jsonConfigPath,
       `${JSON.stringify(updated, null, 2)}
 `,
       "utf8"
     );
   } else {
-    const tsxConfigPath = path66.join(resolvedSource, "apitogo.config.tsx");
-    const configContent = await readFile20(tsxConfigPath, "utf8");
+    const tsxConfigPath = path67.join(resolvedSource, "apitogo.config.tsx");
+    const configContent = await readFile21(tsxConfigPath, "utf8");
     try {
       const patched = patchApitogoConfigOpenApiToFile(configContent, input5);
-      await writeFile18(tsxConfigPath, patched);
+      await writeFile19(tsxConfigPath, patched);
     } catch (error) {
       return {
         status: "failed",
@@ -20054,7 +20234,7 @@ async function discoverAndWireOpenApi(siteDirectory, mode) {
 }
 
 // src/cli/make-config/interactive.ts
-import path67 from "node:path";
+import path68 from "node:path";
 import { stdin as input, stdout as output } from "node:process";
 import { createInterface as createInterface3 } from "node:readline/promises";
 
@@ -20230,7 +20410,7 @@ async function promptMakeConfigInteractive(options) {
           continue;
         }
         const routePath = `/${slug}`;
-        const relativePath = path67.posix.join(options.pagesDir, `${slug}.tsx`);
+        const relativePath = path68.posix.join(options.pagesDir, `${slug}.tsx`);
         const page = {
           slug,
           title: pageTitle.trim(),
@@ -20325,8 +20505,8 @@ export default function ${componentName}() {
 // src/cli/make-config/scaffold-project.ts
 init_package_json();
 import { constants } from "node:fs";
-import { access as access11, mkdir as mkdir16, readFile as readFile21, writeFile as writeFile19 } from "node:fs/promises";
-import path68 from "node:path";
+import { access as access11, mkdir as mkdir16, readFile as readFile22, writeFile as writeFile20 } from "node:fs/promises";
+import path69 from "node:path";
 import { glob as glob7 } from "glob";
 
 // src/cli/make-config/favicon-png.ts
@@ -20341,9 +20521,9 @@ var OPENAPI_GLOBS = [
   "openapi.yaml",
   "openapi.yml"
 ];
-var toPosix2 = (p) => p.split(path68.sep).join("/");
+var toPosix2 = (p) => p.split(path69.sep).join("/");
 var sanitizePackageName = (dir) => {
-  const base = path68.basename(path68.resolve(dir));
+  const base = path69.basename(path69.resolve(dir));
   const s = base.toLowerCase().replace(/[^a-z0-9-_.]/g, "-").replace(/^-+|-+$/g, "");
   return s || "apitogo-site";
 };
@@ -20353,7 +20533,7 @@ var apitogoVersionRange = () => {
 };
 async function findOpenApiSpecPath(dir) {
   for (const rel2 of OPENAPI_GLOBS) {
-    const full = path68.join(dir, rel2);
+    const full = path69.join(dir, rel2);
     try {
       await access11(full, constants.R_OK);
       return toPosix2(rel2);
@@ -20367,8 +20547,8 @@ async function findOpenApiSpecPath(dir) {
   });
   return extra[0] ? toPosix2(extra[0]) : null;
 }
-async function ensurePackageJson(dir) {
-  const pkgPath = path68.join(dir, "package.json");
+async function ensurePackageJson2(dir) {
+  const pkgPath = path69.join(dir, "package.json");
   const apitogoVer = apitogoVersionRange();
   const baseDeps = {
     react: ">=19.0.0",
@@ -20403,11 +20583,11 @@ async function ensurePackageJson(dir) {
         typescript: "^5"
       }
     };
-    await writeFile19(pkgPath, `${JSON.stringify(pkg2, null, 2)}
+    await writeFile20(pkgPath, `${JSON.stringify(pkg2, null, 2)}
 `, "utf8");
     return true;
   }
-  const raw = await readFile21(pkgPath, "utf8");
+  const raw = await readFile22(pkgPath, "utf8");
   let pkg;
   try {
     pkg = JSON.parse(raw);
@@ -20430,12 +20610,12 @@ async function ensurePackageJson(dir) {
   for (const [k, v] of Object.entries(baseDeps)) {
     if (!deps[k]) deps[k] = v;
   }
-  await writeFile19(pkgPath, `${JSON.stringify(pkg, null, 2)}
+  await writeFile20(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   return false;
 }
 async function ensureTsconfigJson(dir) {
-  const tsPath = path68.join(dir, "tsconfig.json");
+  const tsPath = path69.join(dir, "tsconfig.json");
   try {
     await access11(tsPath, constants.R_OK);
     return false;
@@ -20465,7 +20645,7 @@ async function ensureTsconfigJson(dir) {
         "user-panel"
       ]
     };
-    await writeFile19(tsPath, `${JSON.stringify(tsconfig, null, 2)}
+    await writeFile20(tsPath, `${JSON.stringify(tsconfig, null, 2)}
 `, "utf8");
     return true;
   }
@@ -20484,49 +20664,49 @@ var fileExists2 = async (filePath) => {
   }
 };
 async function ensurePortalStubFiles(dir) {
-  const landingPath = path68.join(dir, "landing", "LandingPage.tsx");
+  const landingPath = path69.join(dir, "landing", "LandingPage.tsx");
   if (!await fileExists2(landingPath)) {
-    await mkdir16(path68.join(dir, "landing"), { recursive: true });
-    await writeFile19(landingPath, LANDING_PAGE_SOURCE, "utf8");
+    await mkdir16(path69.join(dir, "landing"), { recursive: true });
+    await writeFile20(landingPath, LANDING_PAGE_SOURCE, "utf8");
   }
-  const plansPath = path68.join(dir, "user-panel", "AccountPlansPage.tsx");
+  const plansPath = path69.join(dir, "user-panel", "AccountPlansPage.tsx");
   if (!await fileExists2(plansPath)) {
-    await mkdir16(path68.join(dir, "user-panel"), { recursive: true });
-    await writeFile19(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
+    await mkdir16(path69.join(dir, "user-panel"), { recursive: true });
+    await writeFile20(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
   }
-  const dashboardPath = path68.join(dir, "user-panel", "DashboardPage.tsx");
+  const dashboardPath = path69.join(dir, "user-panel", "DashboardPage.tsx");
   if (!await fileExists2(dashboardPath)) {
-    await mkdir16(path68.join(dir, "user-panel"), { recursive: true });
-    await writeFile19(dashboardPath, DASHBOARD_PAGE_SOURCE, "utf8");
+    await mkdir16(path69.join(dir, "user-panel"), { recursive: true });
+    await writeFile20(dashboardPath, DASHBOARD_PAGE_SOURCE, "utf8");
   }
   await ensurePublicBrandingFiles(dir);
 }
 async function ensurePublicBrandingFiles(dir) {
-  const destDir = path68.join(dir, "public");
+  const destDir = path69.join(dir, "public");
   await mkdir16(destDir, { recursive: true });
   for (const { name, content } of BRANDING_ASSETS) {
-    const dest = path68.join(destDir, name);
+    const dest = path69.join(destDir, name);
     if (await fileExists2(dest)) {
       continue;
     }
-    await writeFile19(dest, content, "utf8");
+    await writeFile20(dest, content, "utf8");
   }
-  const faviconDest = path68.join(destDir, "Icon.png");
+  const faviconDest = path69.join(destDir, "Icon.png");
   if (!await fileExists2(faviconDest)) {
-    await writeFile19(faviconDest, Buffer.from(FAVICON_PNG_BASE64, "base64"));
+    await writeFile20(faviconDest, Buffer.from(FAVICON_PNG_BASE64, "base64"));
   }
 }
 async function ensureThinConfigTsx(dir) {
-  const tsxPath = path68.join(dir, "apitogo.config.tsx");
+  const tsxPath = path69.join(dir, "apitogo.config.tsx");
   if (await fileExists2(tsxPath)) {
     return false;
   }
-  await writeFile19(tsxPath, THIN_WRAPPER_SOURCE, "utf8");
+  await writeFile20(tsxPath, THIN_WRAPPER_SOURCE, "utf8");
   return true;
 }
 
 // src/cli/make-config/handler.ts
-var toPosixPath2 = (value) => value.split(path69.sep).join(path69.posix.sep);
+var toPosixPath2 = (value) => value.split(path70.sep).join(path70.posix.sep);
 var fileExists3 = async (filePath) => {
   try {
     await access12(filePath, constants2.F_OK);
@@ -20536,7 +20716,7 @@ var fileExists3 = async (filePath) => {
   }
 };
 var readJsonConfig = async (filePath) => {
-  const raw = await readFile22(filePath, "utf8");
+  const raw = await readFile23(filePath, "utf8");
   const parsed = JSON.parse(raw);
   if (!isPlainObject3(parsed)) {
     throw new Error(`${APITOGO_JSON_FILENAME} must be a JSON object.`);
@@ -20582,13 +20762,13 @@ async function persistConfig(config2, ctx) {
       force: ctx.force
     })
   };
-  await writeFile20(ctx.jsonPath, `${JSON.stringify(next, null, 2)}
+  await writeFile21(ctx.jsonPath, `${JSON.stringify(next, null, 2)}
 `, "utf8");
-  const tsxPath = path69.join(ctx.dir, "apitogo.config.tsx");
+  const tsxPath = path70.join(ctx.dir, "apitogo.config.tsx");
   if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
-    const tsxSource = await readFile22(tsxPath, "utf8");
+    const tsxSource = await readFile23(tsxPath, "utf8");
     if (isManagedConfigWrapper(tsxSource)) {
-      await writeFile20(
+      await writeFile21(
         tsxPath,
         buildThinWrapperWithCustomPages(tsxRoutes),
         "utf8"
@@ -20611,7 +20791,7 @@ function mergeBackendFlag(config2, backend) {
   return next;
 }
 async function makeConfig(argv) {
-  const dir = path69.resolve(process.cwd(), argv.dir);
+  const dir = path70.resolve(process.cwd(), argv.dir);
   const pagesDir = toPosixPath2(
     argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, "")
   );
@@ -20620,7 +20800,7 @@ async function makeConfig(argv) {
   const changes = [];
   try {
     const discoveredOpenApi = await findOpenApiSpecPath(dir);
-    const createdPackageJson = await ensurePackageJson(dir);
+    const createdPackageJson = await ensurePackageJson2(dir);
     const createdTsconfig = await ensureTsconfigJson(dir);
     if (createdPackageJson && !json) {
       printSuccessToConsole(
@@ -20631,14 +20811,14 @@ async function makeConfig(argv) {
       printSuccessToConsole("Created tsconfig.json.");
     }
     await ensurePortalStubFiles(dir);
-    const jsonPath = path69.join(dir, APITOGO_JSON_FILENAME);
+    const jsonPath = path70.join(dir, APITOGO_JSON_FILENAME);
     let createdJson = false;
     let config2;
     if (await fileExists3(jsonPath)) {
       config2 = await readJsonConfig(jsonPath);
     } else {
       config2 = createDefaultApitogoJsonConfig({
-        title: titleFromDirectoryName(path69.basename(dir)),
+        title: titleFromDirectoryName(path70.basename(dir)),
         pagesDir
       });
       createdJson = true;
@@ -20690,9 +20870,9 @@ async function makeConfig(argv) {
             return;
           }
           if (action2.kind === "page") {
-            const pagePath = path69.join(dir, action2.page.relativePath);
-            await mkdir17(path69.dirname(pagePath), { recursive: true });
-            await writeFile20(
+            const pagePath = path70.join(dir, action2.page.relativePath);
+            await mkdir17(path70.dirname(pagePath), { recursive: true });
+            await writeFile21(
               pagePath,
               buildStarterDocsPageTsx(action2.page.slug, action2.page.title),
               "utf8"
@@ -20758,7 +20938,7 @@ async function makeConfig(argv) {
       if (argv.openapi) {
         const wire = await wireDevPortalOpenApi(
           dir,
-          path69.resolve(dir, argv.openapi)
+          path70.resolve(dir, argv.openapi)
         );
         if (wire.status !== "succeeded") {
           throw new Error(
@@ -20787,7 +20967,7 @@ async function makeConfig(argv) {
         const slug = normalizePageSlug2(argv.pageSlug);
         const pageTemplate = normalizePageTemplate(argv.pageTemplate);
         const relativePagePath = pageComponentRelativePath(slug);
-        const filePath = path69.join(dir, relativePagePath);
+        const filePath = path70.join(dir, relativePagePath);
         const isUpdate = argv.pageUpdate === true;
         if (isUpdate) {
           if (!await fileExists3(filePath)) {
@@ -20801,7 +20981,7 @@ async function makeConfig(argv) {
             argv.pageContent,
             pageTemplate
           );
-          await writeFile20(filePath, tsx, "utf8");
+          await writeFile21(filePath, tsx, "utf8");
           pageResult = {
             action: "updated",
             slug,
@@ -20820,8 +21000,8 @@ async function makeConfig(argv) {
             argv.pageContent,
             pageTemplate
           );
-          await mkdir17(path69.dirname(filePath), { recursive: true });
-          await writeFile20(filePath, tsx, "utf8");
+          await mkdir17(path70.dirname(filePath), { recursive: true });
+          await writeFile21(filePath, tsx, "utf8");
           const configResult = await wireNewDevPortalPageInConfig(
             dir,
             slug,
@@ -20833,7 +21013,7 @@ async function makeConfig(argv) {
             pagePath: relativePagePath,
             pageTemplate,
             configUpdated: configResult.updated,
-            configPath: configResult.configPath ? path69.relative(dir, configResult.configPath) : null
+            configPath: configResult.configPath ? path70.relative(dir, configResult.configPath) : null
           };
           changes.push("page_add");
         }
@@ -20958,10 +21138,10 @@ var config_default = {
 };
 
 // src/cli/cmds/deploy.ts
-import path83 from "node:path";
+import path84 from "node:path";
 
 // src/cli/apply/handler.ts
-import path80 from "node:path";
+import path81 from "node:path";
 
 // src/cli/platform/helpers/gateway-plan-validation.ts
 init_gateway_limits();
@@ -21156,11 +21336,11 @@ init_gateway_limits();
 // src/cli/platform/helpers/deploy-artifact-hash.ts
 import { createHash as createHash3 } from "node:crypto";
 import { createReadStream, promises as fs8 } from "node:fs";
-import path71 from "node:path";
+import path72 from "node:path";
 
 // src/cli/platform/helpers/package-files.ts
 import { promises as fs7 } from "node:fs";
-import path70 from "node:path";
+import path71 from "node:path";
 import ignore from "ignore";
 var DEFAULT_EXCLUDES = /* @__PURE__ */ new Set([
   "node_modules",
@@ -21173,7 +21353,7 @@ var DEFAULT_EXCLUDES = /* @__PURE__ */ new Set([
 async function loadGitignore(rootDir) {
   const ig = ignore();
   ig.add(["node_modules/", ".git/", "dist/", "bin/", "obj/"]);
-  const gitignorePath = path70.join(rootDir, ".gitignore");
+  const gitignorePath = path71.join(rootDir, ".gitignore");
   try {
     const content = await fs7.readFile(gitignorePath, "utf8");
     ig.add(content);
@@ -21182,11 +21362,11 @@ async function loadGitignore(rootDir) {
   return ig;
 }
 async function collectFiles(rootDir, relativeDir, ig, files) {
-  const absDir = path70.join(rootDir, relativeDir);
+  const absDir = path71.join(rootDir, relativeDir);
   const entries = await fs7.readdir(absDir, { withFileTypes: true });
   for (const entry of entries) {
-    const rel2 = relativeDir ? path70.join(relativeDir, entry.name) : entry.name;
-    const relPosix = rel2.split(path70.sep).join("/");
+    const rel2 = relativeDir ? path71.join(relativeDir, entry.name) : entry.name;
+    const relPosix = rel2.split(path71.sep).join("/");
     if (DEFAULT_EXCLUDES.has(entry.name) && !relativeDir) {
       continue;
     }
@@ -21201,7 +21381,7 @@ async function collectFiles(rootDir, relativeDir, ig, files) {
   }
 }
 async function collectPackageableFiles(sourceDirectory) {
-  const resolved = path70.resolve(sourceDirectory);
+  const resolved = path71.resolve(sourceDirectory);
   const stat7 = await fs7.stat(resolved).catch(() => null);
   if (!stat7?.isDirectory()) {
     throw new Error(`sourceDirectory is not a directory: ${resolved}`);
@@ -21227,7 +21407,7 @@ async function sha256File(filePath) {
   return hash2.digest("hex");
 }
 async function hashDirectoryContents(rootDirectory) {
-  const resolved = path71.resolve(rootDirectory);
+  const resolved = path72.resolve(rootDirectory);
   const files = (await collectPackageableFiles(resolved)).sort(
     (a, b) => a.localeCompare(b)
   );
@@ -21235,13 +21415,13 @@ async function hashDirectoryContents(rootDirectory) {
   for (const rel2 of files) {
     hash2.update(rel2);
     hash2.update("\0");
-    hash2.update(await fs8.readFile(path71.join(resolved, rel2)));
+    hash2.update(await fs8.readFile(path72.join(resolved, rel2)));
     hash2.update("\0");
   }
   return hash2.digest("hex");
 }
 async function hashDevPortalSiteSources(siteDirectory, options) {
-  const resolved = path71.resolve(siteDirectory);
+  const resolved = path72.resolve(siteDirectory);
   const hash2 = createHash3("sha256");
   const candidates = [
     "apitogo.config.json",
@@ -21251,7 +21431,7 @@ async function hashDevPortalSiteSources(siteDirectory, options) {
     "zudoku.config.tsx"
   ];
   for (const name of candidates) {
-    const full = path71.join(resolved, name);
+    const full = path72.join(resolved, name);
     try {
       hash2.update(name);
       hash2.update("\0");
@@ -21261,7 +21441,7 @@ async function hashDevPortalSiteSources(siteDirectory, options) {
     }
   }
   for (const dir of ["pages", "landing", "src"]) {
-    const full = path71.join(resolved, dir);
+    const full = path72.join(resolved, dir);
     try {
       const st = await fs8.stat(full);
       if (!st.isDirectory()) continue;
@@ -21490,8 +21670,8 @@ function normalizeActionKey(actionKey2) {
   const trimmed = actionKey2.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path102 = pathParts.join(":").trim();
-    return `${method2?.toLowerCase()}:${path102.startsWith("/") ? path102 : `/${path102}`}`;
+    const path103 = pathParts.join(":").trim();
+    return `${method2?.toLowerCase()}:${path103.startsWith("/") ? path103 : `/${path103}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -21500,8 +21680,8 @@ function normalizeActionKey(actionKey2) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path101 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path101.startsWith("/") ? path101 : `/${path101}`}`;
+  const path102 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path102.startsWith("/") ? path102 : `/${path102}`}`;
 }
 async function applyGatewayPublicRoutes(client, projectId, routes, options) {
   const applied = [];
@@ -21979,8 +22159,8 @@ async function upsertGatewayPlansFromManifest(client, config2, projectId, plans,
 }
 
 // src/cli/platform/helpers/openapi-gateway-servers.ts
-import { mkdir as mkdir18, readFile as readFile23, writeFile as writeFile21 } from "node:fs/promises";
-import path72 from "node:path";
+import { mkdir as mkdir18, readFile as readFile24, writeFile as writeFile22 } from "node:fs/promises";
+import path73 from "node:path";
 import YAML3 from "yaml";
 var GATEWAY_URL_ENV_KEY = "APITOGO_GATEWAY_URL";
 var PUBLISH_OPENAPI_RELATIVE = ".apitogo/openapi-publish.json";
@@ -22011,8 +22191,8 @@ async function resolveProjectGatewayUrl(client, projectId) {
   return null;
 }
 async function readOpenApiDocument(filePath) {
-  const content = await readFile23(filePath, "utf8");
-  const ext = path72.extname(filePath).toLowerCase();
+  const content = await readFile24(filePath, "utf8");
+  const ext = path73.extname(filePath).toLowerCase();
   const parsed = ext === ".json" ? JSON.parse(content) : YAML3.parse(content);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error(`OpenAPI document must be an object: ${filePath}`);
@@ -22020,14 +22200,14 @@ async function readOpenApiDocument(filePath) {
   return parsed;
 }
 async function materializePublishOpenApiWithGateway(siteDirectory, sourceOpenApiPath, gatewayUrl) {
-  const site = path72.resolve(siteDirectory);
-  const source = path72.resolve(sourceOpenApiPath);
+  const site = path73.resolve(siteDirectory);
+  const source = path73.resolve(sourceOpenApiPath);
   const relativeInput = PUBLISH_OPENAPI_RELATIVE;
-  const outputPath = path72.join(site, ...relativeInput.split("/"));
+  const outputPath = path73.join(site, ...relativeInput.split("/"));
   const doc = await readOpenApiDocument(source);
   const rewritten = withGatewayServers(doc, gatewayUrl);
-  await mkdir18(path72.dirname(outputPath), { recursive: true });
-  await writeFile21(
+  await mkdir18(path73.dirname(outputPath), { recursive: true });
+  await writeFile22(
     outputPath,
     `${JSON.stringify(rewritten, null, 2)}
 `,
@@ -22036,11 +22216,11 @@ async function materializePublishOpenApiWithGateway(siteDirectory, sourceOpenApi
   return { outputPath, relativeInput };
 }
 async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
-  const configPath = path72.join(
-    path72.resolve(siteDirectory),
+  const configPath = path73.join(
+    path73.resolve(siteDirectory),
     APITOGO_CONFIG_FILENAME2
   );
-  const raw = await readFile23(configPath, "utf8");
+  const raw = await readFile24(configPath, "utf8");
   const config2 = JSON.parse(raw);
   const previousApis = config2.apis;
   const previousBackend = config2.backend;
@@ -22053,11 +22233,11 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
   const backend = config2.backend && typeof config2.backend === "object" ? { ...config2.backend } : {};
   backend.openApiPath = relativeInput;
   config2.backend = backend;
-  await writeFile21(configPath, `${JSON.stringify(config2, null, 2)}
+  await writeFile22(configPath, `${JSON.stringify(config2, null, 2)}
 `, "utf8");
   return {
     restore: async () => {
-      const currentRaw = await readFile23(configPath, "utf8");
+      const currentRaw = await readFile24(configPath, "utf8");
       const current = JSON.parse(currentRaw);
       if (previousApis === void 0) {
         delete current.apis;
@@ -22069,7 +22249,7 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
       } else {
         current.backend = previousBackend;
       }
-      await writeFile21(
+      await writeFile22(
         configPath,
         `${JSON.stringify(current, null, 2)}
 `,
@@ -22079,7 +22259,7 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
   };
 }
 async function prepareOpenApiServersForGatewayBuild(options) {
-  const siteDirectory = path72.resolve(options.siteDirectory);
+  const siteDirectory = path73.resolve(options.siteDirectory);
   let openApiPath = resolveBackendOpenApiPath(
     options.manifest?.backend?.openApiPath,
     {
@@ -22092,8 +22272,8 @@ async function prepareOpenApiServersForGatewayBuild(options) {
   );
   if (!openApiPath) {
     try {
-      const raw = await readFile23(
-        path72.join(siteDirectory, APITOGO_CONFIG_FILENAME2),
+      const raw = await readFile24(
+        path73.join(siteDirectory, APITOGO_CONFIG_FILENAME2),
         "utf8"
       );
       const config2 = JSON.parse(raw);
@@ -22122,8 +22302,8 @@ function normalizeActionKeyFormat(actionKey2) {
   const trimmed = actionKey2.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path102 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path102.startsWith("/") ? path102 : `/${path102}`}`;
+    const path103 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path103.startsWith("/") ? path103 : `/${path103}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -22132,8 +22312,8 @@ function normalizeActionKeyFormat(actionKey2) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path101 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path101.startsWith("/") ? path101 : `/${path101}`}`;
+  const path102 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path102.startsWith("/") ? path102 : `/${path102}`}`;
 }
 function normalizePublicRoute(route) {
   const trimmed = route.trim();
@@ -22166,16 +22346,16 @@ function collectManifestPublicActionKeys(gateway) {
 }
 
 // src/cli/platform/helpers/publish-ledger.ts
-import { mkdir as mkdir19, readFile as readFile24, writeFile as writeFile22 } from "node:fs/promises";
-import path73 from "node:path";
+import { mkdir as mkdir19, readFile as readFile25, writeFile as writeFile23 } from "node:fs/promises";
+import path74 from "node:path";
 var PUBLISH_LEDGER_RELATIVE_PATH = ".apitogo/publish-state.json";
 function publishLedgerPath(siteDirectory) {
-  return path73.join(path73.resolve(siteDirectory), PUBLISH_LEDGER_RELATIVE_PATH);
+  return path74.join(path74.resolve(siteDirectory), PUBLISH_LEDGER_RELATIVE_PATH);
 }
 async function readPublishLedger(siteDirectory) {
   const filePath = publishLedgerPath(siteDirectory);
   try {
-    const raw = await readFile24(filePath, "utf8");
+    const raw = await readFile25(filePath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed?.version !== 1 || !Array.isArray(parsed.steps)) {
       return null;
@@ -22187,13 +22367,13 @@ async function readPublishLedger(siteDirectory) {
 }
 async function writePublishLedger(siteDirectory, ledger) {
   const filePath = publishLedgerPath(siteDirectory);
-  await mkdir19(path73.dirname(filePath), { recursive: true });
+  await mkdir19(path74.dirname(filePath), { recursive: true });
   const next = {
     ...ledger,
     version: 1,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  await writeFile22(filePath, `${JSON.stringify(next, null, 2)}
+  await writeFile23(filePath, `${JSON.stringify(next, null, 2)}
 `, "utf8");
   return filePath;
 }
@@ -22709,9 +22889,9 @@ async function createProjectWithWarmPoolRetry(client, body, options) {
 import { spawn as spawn4 } from "node:child_process";
 import { mkdtemp, readdir as readdir2, rm as rm11 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import path74 from "node:path";
+import path75 from "node:path";
 async function directoryHasRuntimeConfig(dir) {
-  if (!await pathExists(dir)) {
+  if (!await pathExists2(dir)) {
     return false;
   }
   const entries = await readdir2(dir);
@@ -22752,20 +22932,20 @@ function runDotnetPublish(projectDir, outputDir) {
 async function findCsproj(projectDir) {
   const entries = await readdir2(projectDir);
   const csproj = entries.find((name) => name.endsWith(".csproj"));
-  return csproj ? path74.join(projectDir, csproj) : null;
+  return csproj ? path75.join(projectDir, csproj) : null;
 }
 async function prepareBackendPackagingDirectory(args) {
-  const sourceDirectory = path74.resolve(args.sourceDirectory);
+  const sourceDirectory = path75.resolve(args.sourceDirectory);
   if (args.publishDirectory?.trim()) {
     return {
-      directory: path74.resolve(args.publishDirectory),
+      directory: path75.resolve(args.publishDirectory),
       packagingMode: "published"
     };
   }
   if (await directoryHasRuntimeConfig(sourceDirectory)) {
     return { directory: sourceDirectory, packagingMode: "published" };
   }
-  const publishSubdir = path74.join(sourceDirectory, "publish");
+  const publishSubdir = path75.join(sourceDirectory, "publish");
   if (await directoryHasRuntimeConfig(publishSubdir)) {
     return { directory: publishSubdir, packagingMode: "published" };
   }
@@ -22777,9 +22957,9 @@ async function prepareBackendPackagingDirectory(args) {
     return { directory: sourceDirectory, packagingMode: "source" };
   }
   const tempRoot = await mkdtemp(
-    path74.join(tmpdir(), "apitogo-dotnet-publish-")
+    path75.join(tmpdir(), "apitogo-dotnet-publish-")
   );
-  const outputDir = path74.join(tempRoot, "publish");
+  const outputDir = path75.join(tempRoot, "publish");
   const result = await runDotnetPublish(sourceDirectory, outputDir);
   if (result.exitCode !== 0) {
     await rm11(tempRoot, { recursive: true, force: true });
@@ -22825,12 +23005,12 @@ function formatJobStatusResponse(options) {
 // src/cli/platform/helpers/zip.ts
 import { createReadStream as createReadStream2, createWriteStream as createWriteStream2, promises as fs9 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import path75 from "node:path";
+import path76 from "node:path";
 import { ZipArchive } from "archiver";
 async function packageBackendDirectory(sourceDirectory) {
-  const resolved = path75.resolve(sourceDirectory);
+  const resolved = path76.resolve(sourceDirectory);
   const files = await collectPackageableFiles(resolved);
-  const zipPath = path75.join(
+  const zipPath = path76.join(
     tmpdir2(),
     `apitogo-backend-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`
   );
@@ -22842,8 +23022,8 @@ async function packageBackendDirectory(sourceDirectory) {
     output4.on("error", reject);
     archive.pipe(output4);
     for (const rel2 of files) {
-      archive.append(createReadStream2(path75.join(resolved, rel2)), {
-        name: rel2.split(path75.sep).join("/")
+      archive.append(createReadStream2(path76.join(resolved, rel2)), {
+        name: rel2.split(path76.sep).join("/")
       });
     }
     void archive.finalize();
@@ -24344,11 +24524,11 @@ async function resolveProjectIdForPublish(client, config2, args, wait, progress,
 }
 
 // src/cli/platform/tools/dev-portal-site-build.ts
-import path79 from "node:path";
+import path80 from "node:path";
 
 // src/cli/platform/helpers/dev-portal-site-api-url.ts
-import { readdir as readdir3, readFile as readFile25, writeFile as writeFile23 } from "node:fs/promises";
-import path76 from "node:path";
+import { readdir as readdir3, readFile as readFile26, writeFile as writeFile24 } from "node:fs/promises";
+import path77 from "node:path";
 var SITE_API_BASE_URL_ENV_KEY = "VITE_APITOGO_AUTHENTICATION_API_BASE_URL";
 var PLACEHOLDER_HOST_MARKERS = [
   "dp-example.azurecontainerapps.io",
@@ -24369,10 +24549,10 @@ function isPlaceholderDevPortalApiUrl(apiBaseUrl) {
   return PLACEHOLDER_HOST_MARKERS.some((marker) => normalized.includes(marker));
 }
 async function readSiteApiBaseUrl(sourceDirectory) {
-  const resolved = path76.resolve(sourceDirectory);
+  const resolved = path77.resolve(sourceDirectory);
   for (const envFile of [".env", ".env.production"]) {
     try {
-      const content = await readFile25(path76.join(resolved, envFile), "utf8");
+      const content = await readFile26(path77.join(resolved, envFile), "utf8");
       const lines = [...content.matchAll(ENV_LINE_GLOBAL_RE)];
       if (lines.length === 0) {
         continue;
@@ -24397,25 +24577,25 @@ async function readSiteApiBaseUrl(sourceDirectory) {
   return null;
 }
 async function patchSiteApiBaseUrl(sourceDirectory, apiBaseUrl) {
-  const resolved = path76.resolve(sourceDirectory);
+  const resolved = path77.resolve(sourceDirectory);
   const line2 = `${SITE_API_BASE_URL_ENV_KEY}=${apiBaseUrl}`;
   let patchedExisting = false;
   for (const envFile of [".env.production", ".env"]) {
-    const envPath = path76.join(resolved, envFile);
+    const envPath = path77.join(resolved, envFile);
     try {
-      const content = await readFile25(envPath, "utf8");
+      const content = await readFile26(envPath, "utf8");
       const withoutAssignments = content.replace(ENV_LINE_GLOBAL_RE, "").replace(/\n{3,}/g, "\n\n").trimEnd();
       const patched = withoutAssignments ? `${withoutAssignments}
 ${line2}
 ` : `${line2}
 `;
-      await writeFile23(envPath, patched);
+      await writeFile24(envPath, patched);
       patchedExisting = true;
     } catch {
     }
   }
   if (!patchedExisting) {
-    await writeFile23(path76.join(resolved, ".env"), `${line2}
+    await writeFile24(path77.join(resolved, ".env"), `${line2}
 `);
   }
 }
@@ -24423,7 +24603,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 = path76.resolve(args.sourceDirectory);
+  const sourceDirectory = path77.resolve(args.sourceDirectory);
   const explicit = args.apiBaseUrl?.trim();
   if (explicit && !isPlaceholderDevPortalApiUrl(explicit)) {
     await patchSiteApiBaseUrl(sourceDirectory, explicit);
@@ -24459,7 +24639,7 @@ async function* walkFiles(root) {
     return;
   }
   for (const entry of entries) {
-    const full = path76.join(root, entry.name);
+    const full = path77.join(root, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name === ".git") {
         continue;
@@ -24471,8 +24651,8 @@ async function* walkFiles(root) {
   }
 }
 async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiBaseUrl) {
-  const dist = path76.resolve(distDirectory);
-  const siteRoot = path76.dirname(dist);
+  const dist = path77.resolve(distDirectory);
+  const siteRoot = path77.dirname(dist);
   const fromEnv = expectedApiBaseUrl?.trim() || await readSiteApiBaseUrl(siteRoot) || await readSiteApiBaseUrl(dist);
   if (!fromEnv || isPlaceholderDevPortalApiUrl(fromEnv)) {
     throw new Error(
@@ -24483,7 +24663,7 @@ async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiB
   let found = false;
   let foundPlaceholder = false;
   for await (const file of walkFiles(dist)) {
-    const content = await readFile25(file, "utf8");
+    const content = await readFile26(file, "utf8");
     if (content.includes(needle)) {
       found = true;
     }
@@ -24508,7 +24688,7 @@ async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiB
 
 // src/cli/platform/tools/dev-portal.ts
 import { promises as fs11 } from "node:fs";
-import path78 from "node:path";
+import path79 from "node:path";
 
 // src/cli/platform/helpers/dev-portal-backend-job.ts
 var DEV_PORTAL_BACKEND_UPDATE_RESOURCE_TYPE = "DevPortalBackendUpdate";
@@ -24618,7 +24798,7 @@ async function snapshotBackendUpdateJobIds(client, projectId) {
 // src/cli/platform/helpers/tarball.ts
 import { createReadStream as createReadStream3, createWriteStream as createWriteStream3, promises as fs10 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
-import path77 from "node:path";
+import path78 from "node:path";
 import { TarArchive } from "archiver";
 var DEV_PORTAL_DEPLOY_ARCHIVE_ROOT = "dist";
 function normalizeArchiveRoot(archiveRoot) {
@@ -24629,10 +24809,10 @@ function normalizeArchiveRoot(archiveRoot) {
   return `${trimmed}/`;
 }
 async function packageDirectoryAsTarGz(sourceDirectory, options) {
-  const resolved = path77.resolve(sourceDirectory);
+  const resolved = path78.resolve(sourceDirectory);
   const files = await collectPackageableFiles(resolved);
   const entryPrefix = options?.archiveRoot ? normalizeArchiveRoot(options.archiveRoot) : "";
-  const archivePath = path77.join(
+  const archivePath = path78.join(
     tmpdir3(),
     `apitogo-docs-${Date.now()}-${Math.random().toString(36).slice(2)}.tgz`
   );
@@ -24644,8 +24824,8 @@ async function packageDirectoryAsTarGz(sourceDirectory, options) {
     output4.on("error", reject);
     archive.pipe(output4);
     for (const rel2 of files) {
-      const entryName = entryPrefix + rel2.split(path77.sep).join("/");
-      archive.append(createReadStream3(path77.join(resolved, rel2)), {
+      const entryName = entryPrefix + rel2.split(path78.sep).join("/");
+      archive.append(createReadStream3(path78.join(resolved, rel2)), {
         name: entryName
       });
     }
@@ -24887,7 +25067,7 @@ function validateDeployArchiveInput(args) {
 async function resolveDevPortalArchive(args) {
   validateDeployArchiveInput(args);
   if (args.archivePath?.trim()) {
-    const archivePath = path78.resolve(args.archivePath.trim());
+    const archivePath = path79.resolve(args.archivePath.trim());
     const stat7 = await fs11.stat(archivePath).catch(() => null);
     if (!stat7?.isFile()) {
       throw new Error(`archivePath is not a file: ${archivePath}`);
@@ -24952,7 +25132,7 @@ async function handleDeployDevPortal(client, config2, args, progress) {
 // 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 = path79.resolve(args.sourceDirectory);
+  const sourceDirectory = path80.resolve(args.sourceDirectory);
   await buildProgress?.onStep("Ensuring live portal API URL");
   const apiBaseUrl = await ensureLiveSiteApiBaseUrlForBuild(
     client,
@@ -26448,7 +26628,7 @@ function resultLooksFailed(payload) {
   return parsed.status === "failed" || parsed.status === "blocked";
 }
 async function apply(argv) {
-  const sourceDirectory = path80.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path81.resolve(process.cwd(), argv.dir);
   let config2;
   try {
     config2 = loadConfig();
@@ -26518,7 +26698,7 @@ async function apply(argv) {
   if (canPromptInteractively && parsed?.status === "blocked" && parsed.reason === "project_not_found") {
     const resolution = await resolveProjectNotFoundInteractively(
       parsed,
-      path80.basename(sourceDirectory)
+      path81.basename(sourceDirectory)
     );
     if (resolution) {
       effectiveProjectId = void 0;
@@ -26538,7 +26718,7 @@ async function apply(argv) {
   while (canPromptInteractively && parsed?.status === "blocked" && parsed.reason === "project_name_exists") {
     const resolution = await resolveProjectNameExistsInteractively(
       parsed,
-      effectiveProjectName ?? path80.basename(sourceDirectory)
+      effectiveProjectName ?? path81.basename(sourceDirectory)
     );
     if (!resolution) {
       break;
@@ -26610,7 +26790,7 @@ async function apply(argv) {
 
 // src/cli/deploy/command.ts
 init_invariant();
-import path82 from "node:path";
+import path83 from "node:path";
 
 // src/cli/deploy/v2.ts
 import { rm as rm12 } from "node:fs/promises";
@@ -26618,11 +26798,11 @@ init_invariant();
 
 // src/cli/portal/report.ts
 import { access as access13 } from "node:fs/promises";
-import path81 from "node:path";
+import path82 from "node:path";
 
 // src/cli/deploy/gateway.ts
 import { createHash as createHash4 } from "node:crypto";
-import { readFile as readFile26 } from "node:fs/promises";
+import { readFile as readFile27 } from "node:fs/promises";
 init_invariant();
 var GatewayDeployError = class extends ApitogoError {
   constructor(code, message, developerHint) {
@@ -26662,7 +26842,7 @@ async function readSpec(gateway) {
       "Add one to gateway.specs in the config."
     );
   try {
-    return await readFile26(file);
+    return await readFile27(file);
   } catch {
     throw new GatewayDeployError(
       "GATEWAY_SPEC_UNREADABLE",
@@ -26897,7 +27077,7 @@ async function planPortalService(resolved, ledger) {
     const hash2 = await portalBuildHash(resolved, prepared);
     const previous = stepOf(ledger, "portal", "build");
     const built = await exists4(
-      path81.join(resolved.state.buildDir, "index.html")
+      path82.join(resolved.state.buildDir, "index.html")
     );
     if (previous?.status === "succeeded" && previous.hash === hash2 && built) {
       return {
@@ -27204,7 +27384,7 @@ async function statusV2(dir, only, options = {}) {
     if (service === "portal") {
       const build2 = stepOf(ledger, "portal", "build");
       const built = await exists4(
-        path81.join(resolved.state.buildDir, "index.html")
+        path82.join(resolved.state.buildDir, "index.html")
       );
       const state = build2?.status === "failed" ? "build-failed" : build2?.status === "succeeded" && built ? "built" : "not-built";
       services.push({
@@ -27215,7 +27395,7 @@ async function statusV2(dir, only, options = {}) {
           ...build2?.finishedAt ? [`last build: ${build2.finishedAt}`] : [],
           ...build2?.status === "failed" ? [`error: ${build2.error ?? "unknown"}`] : [],
           ...state === "built" ? [
-            `output: ${path81.relative(resolved.configDir, resolved.state.buildDir)}`
+            `output: ${path82.relative(resolved.configDir, resolved.state.buildDir)}`
           ] : [],
           ...url2 ? [`url: ${url2}`] : ["url: not known (portal is not deployed yet)"]
         ]
@@ -27483,7 +27663,7 @@ async function deployProject(argv) {
     const config2 = loadConfig();
     const output4 = await deployV2(
       {
-        dir: path82.resolve(process.cwd(), argv.dir),
+        dir: path83.resolve(process.cwd(), argv.dir),
         only: Array.isArray(argv.only) ? argv.only.join(",") : argv.only,
         projectId: argv.projectId,
         env: argv.env,
@@ -27564,7 +27744,7 @@ var deploy_default = {
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo deploy" });
-    if (await isConfigV2(path83.resolve(process.cwd(), argv.dir))) {
+    if (await isConfigV2(path84.resolve(process.cwd(), argv.dir))) {
       await deployProject(argv);
       return;
     }
@@ -27573,8 +27753,8 @@ var deploy_default = {
 };
 
 // src/cli/export/handler.ts
-import { mkdir as mkdir20, writeFile as writeFile24 } from "node:fs/promises";
-import path84 from "node:path";
+import { mkdir as mkdir20, writeFile as writeFile25 } from "node:fs/promises";
+import path85 from "node:path";
 init_invariant();
 var ExportError = class extends ApitogoError {
   constructor(message, developerHint) {
@@ -27588,7 +27768,7 @@ async function exportOpenApi(args, deps) {
       `Cannot export "${args.target}".`,
       "Only `apitogo export openapi` exists."
     );
-  const dir = path84.resolve(process.cwd(), args.dir ?? ".");
+  const dir = path85.resolve(process.cwd(), args.dir ?? ".");
   if (!await isConfigV2(dir))
     throw new ExportError(
       "This command needs a config version 2 project.",
@@ -27613,9 +27793,9 @@ async function exportOpenApi(args, deps) {
     throw error;
   }
   if (!args.out) return { text };
-  const file = path84.resolve(process.cwd(), args.out);
-  await mkdir20(path84.dirname(file), { recursive: true });
-  await writeFile24(file, text);
+  const file = path85.resolve(process.cwd(), args.out);
+  await mkdir20(path85.dirname(file), { recursive: true });
+  await writeFile25(file, text);
   return { text, file };
 }
 async function exportCommand(args) {
@@ -27665,15 +27845,15 @@ var export_default = {
 };
 
 // src/cli/init/handler.ts
-import path88 from "node:path";
+import path89 from "node:path";
 
 // src/cli/scaffold/run-scaffold-discovery.ts
-import { access as access15, readFile as readFile29, writeFile as writeFile26 } from "node:fs/promises";
-import path87 from "node:path";
+import { access as access15, readFile as readFile30, writeFile as writeFile27 } from "node:fs/promises";
+import path88 from "node:path";
 
 // src/cli/scaffold/detect-backend.ts
-import { readdir as readdir4, readFile as readFile27 } from "node:fs/promises";
-import path85 from "node:path";
+import { readdir as readdir4, readFile as readFile28 } from "node:fs/promises";
+import path86 from "node:path";
 var DEFAULT_RUNTIME_VERSION = {
   dotnet: "DOTNET_10",
   nodejs: "NODE_22_LTS",
@@ -27690,7 +27870,7 @@ async function listFiles(directory) {
 }
 async function readText(filePath) {
   try {
-    return await readFile27(filePath, "utf8");
+    return await readFile28(filePath, "utf8");
   } catch {
     return void 0;
   }
@@ -27719,15 +27899,15 @@ function isRunnableNodePackage(pkg) {
   return typeof scripts.start === "string" || typeof pkg.main === "string";
 }
 async function detectParentBackend(siteDirectory) {
-  const site = path85.resolve(siteDirectory);
-  const directory = path85.dirname(site);
+  const site = path86.resolve(siteDirectory);
+  const directory = path86.dirname(site);
   if (directory === site) {
     return void 0;
   }
   const files = await listFiles(directory);
   const toResult = (runtime, runtimeVersion, marker) => ({
     directory,
-    sourceDirectory: path85.relative(site, directory).split(path85.sep).join("/") || ".",
+    sourceDirectory: path86.relative(site, directory).split(path86.sep).join("/") || ".",
     runtime,
     runtimeVersion,
     marker
@@ -27735,7 +27915,7 @@ async function detectParentBackend(siteDirectory) {
   const csproj = files.find((f) => f.endsWith(".csproj"));
   const solution = files.find((f) => /\.slnx?$/.test(f));
   if (csproj || solution) {
-    const content = csproj ? await readText(path85.join(directory, csproj)) : void 0;
+    const content = csproj ? await readText(path86.join(directory, csproj)) : void 0;
     return toResult(
       "dotnet",
       dotnetVersionFromCsproj(content),
@@ -27743,7 +27923,7 @@ async function detectParentBackend(siteDirectory) {
     );
   }
   if (files.includes("package.json")) {
-    const raw = await readText(path85.join(directory, "package.json"));
+    const raw = await readText(path86.join(directory, "package.json"));
     try {
       const pkg = JSON.parse(raw ?? "");
       if (isRunnableNodePackage(pkg)) {
@@ -27758,7 +27938,7 @@ async function detectParentBackend(siteDirectory) {
   }
   const pythonMarker = PYTHON_MARKERS.find((m) => files.includes(m));
   if (pythonMarker) {
-    const versionSource = await readText(path85.join(directory, ".python-version")) ?? (pythonMarker === "pyproject.toml" ? (await readText(path85.join(directory, pythonMarker)))?.match(
+    const versionSource = await readText(path86.join(directory, ".python-version")) ?? (pythonMarker === "pyproject.toml" ? (await readText(path86.join(directory, pythonMarker)))?.match(
       /requires-python\s*=\s*"([^"]+)"/
     )?.[1] : void 0);
     return toResult(
@@ -27776,12 +27956,12 @@ import {
   lstat as lstat2,
   mkdir as mkdir21,
   readdir as readdir5,
-  readFile as readFile28,
+  readFile as readFile29,
   readlink,
   symlink as symlink2,
-  writeFile as writeFile25
+  writeFile as writeFile26
 } from "node:fs/promises";
-import path86 from "node:path";
+import path87 from "node:path";
 var DOCS_DIR_WHITELIST = [
   "docs",
   "documents",
@@ -27818,14 +27998,14 @@ async function isDirectory2(filePath) {
   }
 }
 function toPosix3(value) {
-  return value.split(path86.sep).join(path86.posix.sep);
+  return value.split(path87.sep).join(path87.posix.sep);
 }
 function isWhitelistedDirName(name) {
   return DOCS_DIR_WHITELIST.includes(name.toLowerCase());
 }
 function isInside2(parent, child) {
-  const relative = path86.relative(parent, child);
-  return relative === "" || !relative.startsWith("..") && !path86.isAbsolute(relative);
+  const relative = path87.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path87.isAbsolute(relative);
 }
 async function collectMarkdownFiles(dir, excludeDir) {
   const files = [];
@@ -27839,9 +28019,9 @@ async function collectMarkdownFiles(dir, excludeDir) {
     if (entry.name.startsWith(".")) {
       continue;
     }
-    const full = path86.join(dir, entry.name);
+    const full = path87.join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (SKIP_SEARCH_DIRS.has(entry.name) || entry.isSymbolicLink() || excludeDir && path86.resolve(full) === excludeDir) {
+      if (SKIP_SEARCH_DIRS.has(entry.name) || entry.isSymbolicLink() || excludeDir && path87.resolve(full) === excludeDir) {
         continue;
       }
       files.push(...await collectMarkdownFiles(full, excludeDir));
@@ -27854,11 +28034,11 @@ async function collectMarkdownFiles(dir, excludeDir) {
   return files;
 }
 async function collectSearchRoots(siteDirectory) {
-  const site = path86.resolve(siteDirectory);
-  const parent = path86.dirname(site);
+  const site = path87.resolve(siteDirectory);
+  const parent = path87.dirname(site);
   const roots = [];
   const add = (dir) => {
-    const resolved = path86.resolve(dir);
+    const resolved = path87.resolve(dir);
     if (!roots.includes(resolved)) {
       roots.push(resolved);
     }
@@ -27871,7 +28051,7 @@ async function collectSearchRoots(siteDirectory) {
         if (!entry.isDirectory() || SKIP_SEARCH_DIRS.has(entry.name)) {
           continue;
         }
-        add(path86.join(parent, entry.name));
+        add(path87.join(parent, entry.name));
       }
     } catch {
     }
@@ -27880,13 +28060,13 @@ async function collectSearchRoots(siteDirectory) {
   return roots;
 }
 async function discoverNearbyDocsDirectories(siteDirectory) {
-  const site = path86.resolve(siteDirectory);
-  const sitePages = path86.join(site, PAGES_DIR);
+  const site = path87.resolve(siteDirectory);
+  const sitePages = path87.join(site, PAGES_DIR);
   const searchedDirectories = await collectSearchRoots(site);
   const directories = [];
   const seen = /* @__PURE__ */ new Set();
   const consider = async (dir) => {
-    const resolved = path86.resolve(dir);
+    const resolved = path87.resolve(dir);
     if (resolved === site || seen.has(resolved) || isInside2(sitePages, resolved)) {
       return;
     }
@@ -27903,7 +28083,7 @@ async function discoverNearbyDocsDirectories(siteDirectory) {
     directories.push({ sourceDirectory: resolved, files });
   };
   for (const root of searchedDirectories) {
-    if (isWhitelistedDirName(path86.basename(root))) {
+    if (isWhitelistedDirName(path87.basename(root))) {
       await consider(root);
     }
     try {
@@ -27915,7 +28095,7 @@ async function discoverNearbyDocsDirectories(siteDirectory) {
         if (!isWhitelistedDirName(entry.name)) {
           continue;
         }
-        await consider(path86.join(root, entry.name));
+        await consider(path87.join(root, entry.name));
       }
     } catch {
     }
@@ -27934,8 +28114,8 @@ function slugifyDirName(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "docs";
 }
 async function allocateLinkName(pagesDir, sourceDirectory, used) {
-  const base = slugifyDirName(path86.basename(sourceDirectory));
-  const parent = slugifyDirName(path86.basename(path86.dirname(sourceDirectory)));
+  const base = slugifyDirName(path87.basename(sourceDirectory));
+  const parent = slugifyDirName(path87.basename(path87.dirname(sourceDirectory)));
   const candidates = [base, `${parent}-${base}`];
   let index = 2;
   while (true) {
@@ -27943,7 +28123,7 @@ async function allocateLinkName(pagesDir, sourceDirectory, used) {
     if (used.has(name)) {
       continue;
     }
-    const target = path86.join(pagesDir, name);
+    const target = path87.join(pagesDir, name);
     if (await pathExists5(target)) {
       const stat7 = await lstat2(target);
       if (!stat7.isDirectory() || !await isManagedLinkDir(target)) {
@@ -27974,8 +28154,8 @@ async function alreadyLinked(linkPath, sourcePath) {
       return false;
     }
     const current = await readlink(linkPath);
-    const resolved = path86.resolve(path86.dirname(linkPath), current);
-    return resolved === path86.resolve(sourcePath);
+    const resolved = path87.resolve(path87.dirname(linkPath), current);
+    return resolved === path87.resolve(sourcePath);
   } catch {
     return false;
   }
@@ -27987,8 +28167,8 @@ async function linkMarkdownFile(sourcePath, linkPath) {
   if (await pathExists5(linkPath)) {
     return "skipped";
   }
-  await mkdir21(path86.dirname(linkPath), { recursive: true });
-  const relativeTarget = path86.relative(path86.dirname(linkPath), sourcePath);
+  await mkdir21(path87.dirname(linkPath), { recursive: true });
+  const relativeTarget = path87.relative(path87.dirname(linkPath), sourcePath);
   await symlink2(
     relativeTarget,
     linkPath,
@@ -28003,11 +28183,11 @@ async function applyDocsNavigation(siteDirectory, routes) {
   if (routes.length === 0) {
     return;
   }
-  const configPath = path86.join(siteDirectory, CONFIG_FILENAME);
+  const configPath = path87.join(siteDirectory, CONFIG_FILENAME);
   if (!await pathExists5(configPath)) {
     return;
   }
-  const raw = await readFile28(configPath, "utf8");
+  const raw = await readFile29(configPath, "utf8");
   const parsed = JSON.parse(raw);
   if (!isPlainObject5(parsed)) {
     return;
@@ -28016,12 +28196,12 @@ async function applyDocsNavigation(siteDirectory, routes) {
     force: false
   });
   const updated = ensureHeaderDocsNavigation(parsed, routes);
-  await writeFile25(configPath, `${JSON.stringify(updated, null, 2)}
+  await writeFile26(configPath, `${JSON.stringify(updated, null, 2)}
 `, "utf8");
 }
 async function discoverAndWireDocs(siteDirectory) {
-  const site = path86.resolve(siteDirectory);
-  const pagesDir = path86.join(site, PAGES_DIR);
+  const site = path87.resolve(siteDirectory);
+  const pagesDir = path87.join(site, PAGES_DIR);
   const { directories, searchedDirectories } = await discoverNearbyDocsDirectories(site);
   if (directories.length === 0) {
     return {
@@ -28043,15 +28223,15 @@ async function discoverAndWireDocs(siteDirectory) {
       directory.sourceDirectory,
       usedNames
     );
-    const linkDirectory = path86.join(pagesDir, linkName);
+    const linkDirectory = path87.join(pagesDir, linkName);
     const linked = [];
     const skipped = [];
     for (const sourcePath of directory.files) {
       const relativeSource = toPosix3(
-        path86.relative(directory.sourceDirectory, sourcePath)
+        path87.relative(directory.sourceDirectory, sourcePath)
       );
-      const linkPath = path86.join(linkDirectory, relativeSource);
-      const relativeLink = toPosix3(path86.relative(site, linkPath));
+      const linkPath = path87.join(linkDirectory, relativeSource);
+      const relativeLink = toPosix3(path87.relative(site, linkPath));
       const route = toRoutePath(relativeLink, PAGES_DIR);
       if (routes.includes(route)) {
         skipped.push({
@@ -28099,11 +28279,11 @@ async function discoverAndWireDocs(siteDirectory) {
   };
 }
 function siteRelative(siteDirectory, filePath) {
-  const relative = toPosix3(path86.relative(siteDirectory, filePath));
+  const relative = toPosix3(path87.relative(siteDirectory, filePath));
   if (!relative) {
     return ".";
   }
-  if (path86.isAbsolute(relative)) {
+  if (path87.isAbsolute(relative)) {
     return toPosix3(filePath);
   }
   if (relative.startsWith("..")) {
@@ -28191,8 +28371,8 @@ async function pathExists6(filePath) {
 }
 async function wireOpenApiIntoJsonConfig(siteDirectory, openApiPath) {
   const input5 = toSiteRelativeOpenApiInput(siteDirectory, openApiPath);
-  const jsonConfigPath = path87.join(siteDirectory, "apitogo.config.json");
-  const raw = await readFile29(jsonConfigPath, "utf8");
+  const jsonConfigPath = path88.join(siteDirectory, "apitogo.config.json");
+  const raw = await readFile30(jsonConfigPath, "utf8");
   const siteConfig = JSON.parse(raw);
   const updated = applyOpenApiToSiteConfig(siteConfig, {
     input: input5,
@@ -28200,7 +28380,7 @@ async function wireOpenApiIntoJsonConfig(siteDirectory, openApiPath) {
   });
   const backend = updated.backend && typeof updated.backend === "object" && !Array.isArray(updated.backend) ? { ...updated.backend } : {};
   updated.backend = { ...backend, openApiPath: input5 };
-  await writeFile26(
+  await writeFile27(
     jsonConfigPath,
     `${JSON.stringify(updated, null, 2)}
 `,
@@ -28219,7 +28399,7 @@ async function discoverAndWireOpenApiLite(siteDirectory, mode) {
   const invalidCandidates = [];
   let selected;
   for (const candidate of search.candidates) {
-    const content = await readFile29(candidate, "utf8");
+    const content = await readFile30(candidate, "utf8");
     const parsed = liteParseOpenApi(content, candidate);
     if (parsed.valid) {
       selected = {
@@ -28243,7 +28423,7 @@ async function discoverAndWireOpenApiLite(siteDirectory, mode) {
       wired: false
     };
   }
-  const jsonConfigPath = path87.join(siteDirectory, "apitogo.config.json");
+  const jsonConfigPath = path88.join(siteDirectory, "apitogo.config.json");
   if (!await pathExists6(jsonConfigPath)) {
     return {
       openApiDiscovery: {
@@ -28293,13 +28473,13 @@ async function discoverAndWireBackend(siteDirectory, mode) {
   if (mode !== "nearby") {
     return { status: "skipped", mode };
   }
-  const jsonConfigPath = path87.join(siteDirectory, "apitogo.config.json");
+  const jsonConfigPath = path88.join(siteDirectory, "apitogo.config.json");
   if (!await pathExists6(jsonConfigPath)) {
     return { status: "not_found" };
   }
   try {
     const siteConfig = JSON.parse(
-      await readFile29(jsonConfigPath, "utf8")
+      await readFile30(jsonConfigPath, "utf8")
     );
     const existing = siteConfig.backend && typeof siteConfig.backend === "object" && !Array.isArray(siteConfig.backend) ? siteConfig.backend : {};
     if (typeof existing.sourceDirectory === "string" && existing.sourceDirectory.trim()) {
@@ -28320,7 +28500,7 @@ async function discoverAndWireBackend(siteDirectory, mode) {
       runtime: detected.runtime,
       runtimeVersion: detected.runtimeVersion
     };
-    await writeFile26(
+    await writeFile27(
       jsonConfigPath,
       `${JSON.stringify(siteConfig, null, 2)}
 `,
@@ -28360,8 +28540,8 @@ function slugifyName2(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "dev-portal-site";
 }
 function resolveInitOutputDirectory(dirArg, name) {
-  const resolved = path88.resolve(process.cwd(), dirArg);
-  const base = path88.basename(resolved);
+  const resolved = path89.resolve(process.cwd(), dirArg);
+  const base = path89.basename(resolved);
   const isDot = dirArg === "." || dirArg === "./" || base === "." || resolved === process.cwd();
   if (isDot) {
     const fromName = name?.trim();
@@ -28371,7 +28551,7 @@ function resolveInitOutputDirectory(dirArg, name) {
       );
     }
     return {
-      outputDirectory: path88.resolve(process.cwd(), slugifyName2(fromName)),
+      outputDirectory: path89.resolve(process.cwd(), slugifyName2(fromName)),
       siteName: fromName
     };
   }
@@ -28554,8 +28734,8 @@ import open2 from "open";
 import colors14 from "picocolors";
 
 // src/cli/platform/device-auth.ts
-function url(apiUrl, path101) {
-  return `${apiUrl}${path101.startsWith("/") ? path101 : `/${path101}`}`;
+function url(apiUrl, path102) {
+  return `${apiUrl}${path102.startsWith("/") ? path102 : `/${path102}`}`;
 }
 async function requestDeviceCode(apiUrl) {
   const response = await fetchWithRetry(
@@ -28737,7 +28917,7 @@ var logout_default = {
 };
 
 // src/cli/portal/commands.ts
-import path89 from "node:path";
+import path90 from "node:path";
 init_invariant();
 function parseOnly(value) {
   if (value === void 0) return void 0;
@@ -28754,7 +28934,7 @@ function parseOnly(value) {
 async function run2(command2, argv, compute, format) {
   const json = argv.json === true;
   try {
-    const dir = path89.resolve(process.cwd(), argv.dir ?? ".");
+    const dir = path90.resolve(process.cwd(), argv.dir ?? ".");
     if (!await isConfigV2(dir)) {
       throw new ServiceEditError(
         `${command2} works with a config version 2 project, and there is none in ${dir}.`,
@@ -28838,7 +29018,7 @@ var plan_default = {
 
 // src/cli/project/create-handler.ts
 init_invariant();
-import path90 from "node:path";
+import path91 from "node:path";
 
 // src/cli/project/v2.ts
 init_invariant();
@@ -28985,7 +29165,7 @@ async function createLinkedProject(argv, dir) {
   }
 }
 async function createProject(argv) {
-  const dir = path90.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path91.resolve(process.cwd(), argv.dir ?? ".");
   if (await isConfigV2(dir)) {
     await createLinkedProject(argv, dir);
     return;
@@ -29109,14 +29289,14 @@ var remove_default = {
 
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path93 from "node:path";
+import path94 from "node:path";
 
 // src/vite/dev-server.ts
 init_logger();
 import fs12 from "node:fs/promises";
 import http from "node:http";
 import https from "node:https";
-import path92 from "node:path";
+import path93 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -29149,7 +29329,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path91 from "node:path";
+import path92 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -29202,7 +29382,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path91.join(vite.config.publicDir, "pagefind");
+  const outputPath = path92.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -29221,9 +29401,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs12.readFile(path92.resolve(dir, config2.https.key)),
-      fs12.readFile(path92.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs12.readFile(path92.resolve(dir, config2.https.ca)) : void 0
+      fs12.readFile(path93.resolve(dir, config2.https.key)),
+      fs12.readFile(path93.resolve(dir, config2.https.cert)),
+      config2.https.ca ? fs12.readFile(path93.resolve(dir, config2.https.ca)) : void 0
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -29240,7 +29420,7 @@ var DevServer = class {
     );
     const server = await this.createNodeServer(config2);
     if (config2.search?.type === "pagefind" && viteConfig.publicDir !== false) {
-      const publicRoot = path92.resolve(
+      const publicRoot = path93.resolve(
         this.options.dir,
         typeof viteConfig.publicDir === "string" ? viteConfig.publicDir : "public"
       );
@@ -29257,7 +29437,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 = path92.posix.join(
+            const entryPath = path93.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -29422,7 +29602,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson3 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  let dir = path93.resolve(process.cwd(), argv.dir);
+  let dir = path94.resolve(process.cwd(), argv.dir);
   if (await isConfigV2(dir)) {
     const { root, prepared } = await preparePortalWorkspace(dir, "development");
     dir = root;
@@ -29521,7 +29701,7 @@ var run_default = {
 };
 
 // src/cli/secrets/handler.ts
-import path94 from "node:path";
+import path95 from "node:path";
 init_invariant();
 
 // src/cli/secrets/input.ts
@@ -29586,7 +29766,7 @@ var SecretsError = class extends ApitogoError {
 async function resolveProjectId2(argv, deps) {
   const explicit = argv.projectId?.trim();
   if (explicit) return explicit;
-  const dir = path94.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path95.resolve(process.cwd(), argv.dir ?? ".");
   if (await isConfigV2(dir)) {
     const id = loadConfigV2(dir).resolved.project.id;
     if (id) return id;
@@ -29746,12 +29926,12 @@ var secrets_default = {
 };
 
 // src/cli/cmds/status.ts
-import path96 from "node:path";
+import path97 from "node:path";
 
 // src/cli/status/handler.ts
-import path95 from "node:path";
+import path96 from "node:path";
 async function status(argv) {
-  const sourceDirectory = path95.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path96.resolve(process.cwd(), argv.dir);
   let config2;
   try {
     config2 = loadConfig();
@@ -29849,7 +30029,7 @@ var status_default = {
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo status" });
-    if (await isConfigV2(path96.resolve(process.cwd(), argv.dir))) {
+    if (await isConfigV2(path97.resolve(process.cwd(), argv.dir))) {
       await statusOfProject(argv);
       return;
     }
@@ -29858,11 +30038,11 @@ var status_default = {
 };
 
 // src/cli/cmds/teardown.ts
-import path99 from "node:path";
+import path100 from "node:path";
 
 // src/cli/teardown/command.ts
 init_invariant();
-import path97 from "node:path";
+import path98 from "node:path";
 import { createInterface as createInterface7 } from "node:readline/promises";
 
 // src/cli/teardown/v2.ts
@@ -30079,7 +30259,7 @@ async function teardownProject(argv) {
     const progress = createConsoleProgressReporter();
     const result = await teardownV2(
       {
-        dir: path97.resolve(process.cwd(), argv.dir),
+        dir: path98.resolve(process.cwd(), argv.dir),
         projectId: argv.projectId,
         only: Array.isArray(argv.only) ? argv.only.join(",") : argv.only,
         yes: argv.yes === true,
@@ -30138,7 +30318,7 @@ async function teardownProject(argv) {
 }
 
 // src/cli/teardown/handler.ts
-import path98 from "node:path";
+import path99 from "node:path";
 function resultLooksFailed3(payload) {
   try {
     const parsed = JSON.parse(payload);
@@ -30154,7 +30334,7 @@ async function teardown(argv) {
     );
     return;
   }
-  const sourceDirectory = path98.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path99.resolve(process.cwd(), argv.dir);
   let config2;
   try {
     config2 = loadConfig();
@@ -30232,7 +30412,7 @@ var teardown_default = {
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo teardown" });
-    if (await isConfigV2(path99.resolve(process.cwd(), argv.dir))) {
+    if (await isConfigV2(path100.resolve(process.cwd(), argv.dir))) {
       await teardownProject(argv);
       return;
     }
@@ -30309,37 +30489,37 @@ function createApitogoCli(argv) {
 
 // src/cli/local-handoff.ts
 import { spawn as spawn5 } from "node:child_process";
-import { existsSync as existsSync8, realpathSync } from "node:fs";
-import path100 from "node:path";
+import { existsSync as existsSync9, realpathSync } from "node:fs";
+import path101 from "node:path";
 var LOCAL_HANDOFF_ENV = "APITOGO_LOCAL_CLI";
 var PACKAGE_NAME = "@lukoweb/apitogo";
 var resolveProjectDir = (argv, cwd) => {
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     const next = argv[i + 1];
-    if (arg === "--dir" && next) return path100.resolve(cwd, next);
+    if (arg === "--dir" && next) return path101.resolve(cwd, next);
     if (arg?.startsWith("--dir=")) {
-      return path100.resolve(cwd, arg.slice("--dir=".length));
+      return path101.resolve(cwd, arg.slice("--dir=".length));
     }
   }
   return cwd;
 };
 var findLocalCli = (projectDir, runningRoot) => {
-  let dir = path100.resolve(projectDir);
+  let dir = path101.resolve(projectDir);
   let localPackageRoot;
   while (!localPackageRoot) {
-    const candidate = path100.join(dir, "node_modules", PACKAGE_NAME);
-    if (existsSync8(path100.join(candidate, "package.json"))) {
+    const candidate = path101.join(dir, "node_modules", PACKAGE_NAME);
+    if (existsSync9(path101.join(candidate, "package.json"))) {
       localPackageRoot = candidate;
-    } else if (dir === path100.dirname(dir)) {
+    } else if (dir === path101.dirname(dir)) {
       return void 0;
     } else {
-      dir = path100.dirname(dir);
+      dir = path101.dirname(dir);
     }
   }
   const localRoot = realpathSync(localPackageRoot);
   if (localRoot === realpathSync(runningRoot)) return void 0;
-  return path100.join(localRoot, "cli.js");
+  return path101.join(localRoot, "cli.js");
 };
 var handoffToLocalCli = async (argv, runningRoot) => {
   if (process.env[LOCAL_HANDOFF_ENV] || process.env.ZUDOKU_ENV === "internal") {
@@ -30351,7 +30531,7 @@ var handoffToLocalCli = async (argv, runningRoot) => {
   );
   if (!localCli) return void 0;
   printDiagnosticsToConsole(
-    `Using the project's local ${PACKAGE_NAME} (${path100.dirname(localCli)})`
+    `Using the project's local ${PACKAGE_NAME} (${path101.dirname(localCli)})`
   );
   const child = spawn5(process.execPath, [localCli, ...argv], {
     stdio: "inherit",