@lukoweb/apitogo 0.2.53 → 0.2.54

package/dist/cli/cli.js

@@ -837,7 +837,7 @@ import { stat as stat4 } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path97) => stat4(path97).then(() => true).catch(() => false);
+    fileExists = (path98) => stat4(path98).then(() => true).catch(() => false);
   }
 });
 
@@ -5523,10 +5523,10 @@ function createSpinner(initialText, { stream = process.stderr, silent = false }
     stream.write(`${initialText}
 `);
     return {
-      update(text2) {
-        if (text2 === last) return;
-        last = text2;
-        stream.write(`${text2}
+      update(text3) {
+        if (text3 === last) return;
+        last = text3;
+        stream.write(`${text3}
 `);
       },
       log: (line2) => void stream.write(`${line2}
@@ -5536,7 +5536,7 @@ function createSpinner(initialText, { stream = process.stderr, silent = false }
     };
   }
   const startedAt = Date.now();
-  let text = initialText;
+  let text2 = initialText;
   let frame = 0;
   let timer;
   const clear = () => stream.write("\r\x1B[K");
@@ -5547,7 +5547,7 @@ function createSpinner(initialText, { stream = process.stderr, silent = false }
       10,
       (stream.columns || 80) - 3 - ` (${formatElapsed(elapsed)})`.length
     );
-    const shown = text.length > room ? `${text.slice(0, room - 1)}\u2026` : text;
+    const shown = text2.length > room ? `${text2.slice(0, room - 1)}\u2026` : text2;
     stream.write(
       `\r\x1B[K${colors.cyan(FRAMES[frame++ % FRAMES.length])} ${shown}${suffix}`
     );
@@ -5560,7 +5560,7 @@ function createSpinner(initialText, { stream = process.stderr, silent = false }
   timer.unref();
   const spinner = {
     update(next) {
-      text = next;
+      text2 = next;
     },
     log(line2) {
       if (!timer) {
@@ -5585,8 +5585,8 @@ function createSpinner(initialText, { stream = process.stderr, silent = false }
   active.add(spinner);
   return spinner;
 }
-async function withSpinner(text, fn, options) {
-  const spinner = createSpinner(text, options);
+async function withSpinner(text2, fn, options) {
+  const spinner = createSpinner(text2, options);
   try {
     return await fn(spinner);
   } finally {
@@ -5631,9 +5631,9 @@ function printBoxToConsole(message) {
 }
 async function printCriticalFailureToConsoleAndExit(message) {
   stopAllSpinners();
-  const text = typeof message === "string" && message.trim() === "" ? "Command failed with no further details." : message;
+  const text2 = typeof message === "string" && message.trim() === "" ? "Command failed with no further details." : message;
   console.error(
-    `${colors2.bold(colors2.red(`${withSymbol(symbols.error, process.stderr.isTTY)}Error:`))} ${colors2.red(text)}`
+    `${colors2.bold(colors2.red(`${withSymbol(symbols.error, process.stderr.isTTY)}Error:`))} ${colors2.red(text2)}`
   );
   await Sentry.close(MAX_WAIT_PENDING_TIME_MS).then(() => {
     process.exit(1);
@@ -5872,8 +5872,8 @@ function formatConfigIssue(issue4) {
   const hint = issue4.hint ? ` ${issue4.hint}` : "";
   const rest = issue4.message.slice(issue4.path.length);
   const startsWithPath = issue4.path !== "" && issue4.message.startsWith(issue4.path) && (rest === "" || /^[\s:]/.test(rest));
-  const text = startsWithPath ? issue4.message : `${issue4.path === "" ? "(root)" : issue4.path}: ${issue4.message}`;
-  return `${text}${hint} [${issue4.code}]`;
+  const text2 = startsWithPath ? issue4.message : `${issue4.path === "" ? "(root)" : issue4.path}: ${issue4.message}`;
+  return `${text2}${hint} [${issue4.code}]`;
 }
 var ConfigError = class extends ApitogoError {
   issues;
@@ -6073,8 +6073,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(path97) {
-  return path97.reduce(
+function pathToString(path98) {
+  return path98.reduce(
     (acc, segment) => typeof segment === "number" ? `${acc}[${segment}]` : acc === "" ? String(segment) : `${acc}.${String(segment)}`,
     ""
   );
@@ -6094,9 +6094,9 @@ function step(schema2, segment) {
   }
   return void 0;
 }
-function knownKeysAt(path97) {
+function knownKeysAt(path98) {
   let current = ConfigV2Schema;
-  for (const segment of path97) {
+  for (const segment of path98) {
     if (!current) return [];
     current = step(current, segment);
   }
@@ -6132,7 +6132,7 @@ function unknownKeyHint(fullPath, key, known) {
   return known.length > 0 ? `Allowed keys: ${known.join(", ")}.` : void 0;
 }
 function mapIssue(issue4) {
-  const path97 = pathToString(issue4.path);
+  const path98 = pathToString(issue4.path);
   switch (issue4.code) {
     case "unrecognized_keys":
       return issue4.keys.map((key) => {
@@ -6148,20 +6148,20 @@ function mapIssue(issue4) {
       return [
         {
           code: "CONFIG_INVALID_VALUE",
-          path: path97,
+          path: path98,
           message: `must be one of: ${issue4.values.map((v) => JSON.stringify(v)).join(", ")}.`
         }
       ];
     case "custom": {
       const code = typeof issue4.params?.code === "string" ? issue4.params.code : "CONFIG_INVALID_VALUE";
-      return [{ code, path: path97, message: issue4.message ?? "is invalid." }];
+      return [{ code, path: path98, message: issue4.message ?? "is invalid." }];
     }
     case "invalid_type":
       return [
-        /received undefined/.test(issue4.message) ? { code: "CONFIG_MISSING_FIELD", path: path97, message: "is required." } : { code: "CONFIG_INVALID_VALUE", path: path97, message: issue4.message }
+        /received undefined/.test(issue4.message) ? { code: "CONFIG_MISSING_FIELD", path: path98, message: "is required." } : { code: "CONFIG_INVALID_VALUE", path: path98, message: issue4.message }
       ];
     default:
-      return [{ code: "CONFIG_INVALID_VALUE", path: path97, message: issue4.message }];
+      return [{ code: "CONFIG_INVALID_VALUE", path: path98, message: issue4.message }];
   }
 }
 function isRecord(value) {
@@ -6391,16 +6391,16 @@ var NOT_DOCS = /^(readme|license|licence|changelog)(\.|$)/i;
 var DOCS_SEARCH_DEPTH = 2;
 var OWN_PAGES_FOLDER = "portal/pages";
 async function countDocs(dir) {
-  let count = 0;
+  let count2 = 0;
   for (const entry of await readEntries(dir)) {
     if (entry.isDirectory()) {
       if (!IGNORED_DIRS.has(entry.name))
-        count += await countDocs(path6.join(dir, entry.name));
+        count2 += await countDocs(path6.join(dir, entry.name));
     } else if (entry.isFile() && DOCS_EXTENSIONS.has(path6.extname(entry.name))) {
-      count += 1;
+      count2 += 1;
     }
   }
-  return count;
+  return count2;
 }
 async function detectExistingDocs(dir) {
   const candidates = [];
@@ -6562,14 +6562,14 @@ function resolveConfigV2(config2, configPath) {
 }
 
 // src/config/v2/load.ts
-function describeJsonError(error, text) {
+function describeJsonError(error, text2) {
   const message = error instanceof Error ? error.message : String(error);
   const lineColumn = /line (\d+) column (\d+)/.exec(message);
   if (lineColumn) return `${message}`;
   const position = /position (\d+)/.exec(message);
   if (!position) return message;
   const offset = Number(position[1]);
-  const before = text.slice(0, offset);
+  const before = text2.slice(0, offset);
   const line2 = before.split("\n").length;
   const column = offset - before.lastIndexOf("\n");
   return `${message} (line ${line2} column ${column})`;
@@ -6587,16 +6587,16 @@ function loadConfigV2(pathOrDir) {
       }
     ]);
   }
-  const text = readFileSync2(configPath, "utf8");
+  const text2 = readFileSync2(configPath, "utf8");
   let raw;
   try {
-    raw = JSON.parse(text);
+    raw = JSON.parse(text2);
   } catch (error) {
     throw new ConfigError(path8.basename(configPath), [
       {
         code: "CONFIG_INVALID_JSON",
         path: "",
-        message: describeJsonError(error, text),
+        message: describeJsonError(error, text2),
         hint: "Fix the JSON syntax; comments and trailing commas are not allowed."
       }
     ]);
@@ -6617,6 +6617,47 @@ import path9 from "node:path";
 import { glob } from "glob";
 import globParent from "glob-parent";
 
+// src/config/v2/page-order.ts
+var FIRST_PAGE_NAMES = [
+  "introduction",
+  "intro",
+  "welcome",
+  "getting-started",
+  "get-started",
+  "overview",
+  "quickstart",
+  "quick-start"
+];
+var lastSegment = (route) => route.split("/").filter(Boolean).pop() ?? "";
+var rank = (route, orders) => {
+  const name = lastSegment(route).toLowerCase();
+  if (name === "index" || route === "/") return [0, 0];
+  const order = orders.get(route);
+  if (order !== void 0) return [1, order];
+  const preferred = FIRST_PAGE_NAMES.indexOf(name);
+  return [2, preferred === -1 ? FIRST_PAGE_NAMES.length : preferred];
+};
+function comparePages(a, b, orders = /* @__PURE__ */ new Map()) {
+  const [groupA, valueA] = rank(a, orders);
+  const [groupB, valueB] = rank(b, orders);
+  return groupA - groupB || valueA - valueB || a.localeCompare(b);
+}
+function firstPage(routes, orders = /* @__PURE__ */ new Map()) {
+  const depth = (route) => route.split("/").length;
+  return [...routes].sort(
+    (a, b) => depth(a) - depth(b) || comparePages(a, b, orders)
+  )[0];
+}
+function orderValue(value) {
+  const number = typeof value === "number" ? value : typeof value === "string" && value.trim() !== "" ? Number(value) : Number.NaN;
+  return Number.isInteger(number) ? number : void 0;
+}
+var TSX_ORDER = /export\s+const\s+order\s*(?::\s*number\s*)?=\s*(-?\d+)/;
+function tsxPageOrder(source) {
+  const match = TSX_ORDER.exec(source);
+  return match?.[1] ? Number(match[1]) : void 0;
+}
+
 // src/config/v2/docs-navigation.ts
 var DOCS_NAVIGATION_LABEL = "Documentation";
 var emptyBranch = () => ({ pages: /* @__PURE__ */ new Map(), folders: /* @__PURE__ */ new Map() });
@@ -6625,9 +6666,9 @@ function folderLabel(name) {
   return words.charAt(0).toUpperCase() + words.slice(1);
 }
 var byName = (a, b) => a.localeCompare(b);
-var toItems = (branch, prefix) => {
+var toItems = (branch, prefix, orders) => {
   const names = [...branch.pages.keys()].sort(
-    (a, b) => a === "index" ? -1 : b === "index" ? 1 : byName(a, b)
+    (a, b) => comparePages(`/${prefix}${a}`, `/${prefix}${b}`, orders)
   );
   const folders = [...branch.folders.keys()].sort(byName);
   const folderPath = prefix === "" ? "/" : `/${prefix.slice(0, -1)}`;
@@ -6653,7 +6694,8 @@ var toItems = (branch, prefix) => {
         collapsed: false,
         items: toItems(
           branch.folders.get(folder) ?? emptyBranch(),
-          `${prefix}${folder}/`
+          `${prefix}${folder}/`,
+          orders
         )
       })
     )
@@ -6669,7 +6711,7 @@ var branchOf = (root, route) => {
   }, root);
   return { branch, page };
 };
-function docsNavigation(routes, customPages = []) {
+function docsNavigation(routes, customPages = [], orders = /* @__PURE__ */ new Map()) {
   const root = emptyBranch();
   for (const route of routes) {
     const { branch, page } = branchOf(root, route);
@@ -6680,7 +6722,7 @@ function docsNavigation(routes, customPages = []) {
     if (page && !branch.pages.has(page))
       branch.pages.set(page, { kind: "custom", ...custom });
   }
-  const items = toItems(root, "");
+  const items = toItems(root, "", orders);
   return items.length === 0 ? [] : [{ type: "category", label: DOCS_NAVIGATION_LABEL, items }];
 }
 
@@ -6733,7 +6775,13 @@ async function findTsxPages(contentGlobs) {
       const route = `/${relative.replace(/\.tsx$/, "")}`;
       if (found.has(route)) continue;
       const source = await readFile3(file, "utf8").catch(() => "");
-      found.set(route, { route, file, label: tsxPageLabel(source, file) });
+      const order = tsxPageOrder(source);
+      found.set(route, {
+        route,
+        file,
+        label: tsxPageLabel(source, file),
+        ...order !== void 0 ? { order } : {}
+      });
     }
   }
   return [...found.values()].sort((a, b) => a.route.localeCompare(b.route));
@@ -7087,8 +7135,8 @@ async function specRule(spec, index, resolved, out) {
   }
   let document;
   try {
-    const text = await readFile4(spec, "utf8");
-    document = spec.toLowerCase().endsWith(".json") ? JSON.parse(text) : parseYaml(text);
+    const text2 = await readFile4(spec, "utf8");
+    document = spec.toLowerCase().endsWith(".json") ? JSON.parse(text2) : parseYaml(text2);
   } catch (error) {
     out.error({
       code: "GATEWAY_SPEC_INVALID",
@@ -7126,8 +7174,8 @@ function authRule(resolved, out) {
     issuers: auth.issuers?.length ?? 0,
     audiences: auth.audiences?.length ?? 0
   };
-  const present = Object.entries(parts).filter(([, count]) => count > 0).map(([name]) => name);
-  const missing = Object.entries(parts).filter(([, count]) => count === 0).map(([name]) => name);
+  const present = Object.entries(parts).filter(([, count2]) => count2 > 0).map(([name]) => name);
+  const missing = Object.entries(parts).filter(([, count2]) => count2 === 0).map(([name]) => name);
   if (missing.length === 0) return;
   const blocked = "Token validation would be skipped, so deploy is blocked.";
   if (present.length === 0) {
@@ -7407,7 +7455,7 @@ var ServiceManifestSchema = z3.looseObject({
     }).optional()
   }).default({})
 });
-var issue = (code, path97, message, hint) => ({ code, path: path97, message, hint });
+var issue = (code, path98, message, hint) => ({ code, path: path98, 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) {
@@ -7438,15 +7486,15 @@ function parseManifest(raw, file = "services.json") {
 }
 async function readManifest(state) {
   const file = manifestPathFor(state);
-  let text;
+  let text2;
   try {
-    text = await readFile5(file, "utf8");
+    text2 = await readFile5(file, "utf8");
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
     throw error;
   }
   try {
-    return parseManifest(JSON.parse(text), file);
+    return parseManifest(JSON.parse(text2), file);
   } catch (error) {
     if (error instanceof SyntaxError) {
       throw new ConfigError(file, [
@@ -7670,8 +7718,8 @@ var METHODS = [
   "trace"
 ];
 var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function actionKey(method, path97) {
-  const trimmed = path97.trim();
+function actionKey(method, path98) {
+  const trimmed = path98.trim();
   const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
   const normalized = withSlash.length > 1 ? withSlash.replace(/\/+$/, "") || "/" : withSlash;
   return `${method.trim().toLowerCase()}:${normalized}`;
@@ -7708,8 +7756,8 @@ var ReferenceSpecError = class extends Error {
 };
 function operationsOf(paths) {
   return Object.entries(paths).flatMap(
-    ([path97, item]) => isObject(item) ? METHODS.filter((method) => isObject(item[method])).map(
-      (method) => [path97, item, method]
+    ([path98, item]) => isObject(item) ? METHODS.filter((method) => isObject(item[method])).map(
+      (method) => [path98, item, method]
     ) : []
   );
 }
@@ -7724,14 +7772,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 [path97, item, method] of operationsOf(paths))
-    if (options.deniedOperations.has(actionKey(method, path97)))
+  for (const [path98, item, method] of operationsOf(paths))
+    if (options.deniedOperations.has(actionKey(method, path98)))
       delete item[method];
-  for (const [path97, item] of Object.entries(paths))
+  for (const [path98, item] of Object.entries(paths))
     if (!isObject(item) || !METHODS.some((method) => method in item))
-      delete paths[path97];
-  for (const [path97, item, method] of operationsOf(paths))
-    if (options.publicOperations.has(actionKey(method, path97)))
+      delete paths[path98];
+  for (const [path98, item, method] of operationsOf(paths))
+    if (options.publicOperations.has(actionKey(method, path98)))
       item[method].security = [];
   doc.servers = [{ url: options.gatewayBaseUrl.replace(/\/+$/, "") }];
   for (const item of Object.values(paths)) {
@@ -7771,38 +7819,38 @@ function buildReferenceSpec(specText, options) {
   if (Object.keys(components).length > 0) doc.components = components;
   else delete doc.components;
   doc.security = Object.keys(requirement).length > 0 ? [requirement] : [];
-  for (const [path97, item, method] of operationsOf(paths)) {
+  for (const [path98, item, method] of operationsOf(paths)) {
     const operation = item[method];
     if (Array.isArray(operation.security) && operation.security.length > 0)
       delete operation.security;
-    if (options.apiKeyRequired && !options.publicOperations.has(actionKey(method, path97)))
+    if (options.apiKeyRequired && !options.publicOperations.has(actionKey(method, path98)))
       operation[KEY_HEADER_EXTENSION] = options.apiKeyHeader;
     else delete operation[KEY_HEADER_EXTENSION];
   }
   return JSON.parse(hideOrigin(JSON.stringify(doc), options));
 }
-function hideOrigin(text, options) {
+function hideOrigin(text2, options) {
   const origin = options.originUrl?.trim().replace(/\/+$/, "");
-  if (!origin) return text;
+  if (!origin) return text2;
   const gateway = options.gatewayBaseUrl.trim().replace(/\/+$/, "");
   const pattern = new RegExp(
     origin.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&"),
     "gi"
   );
-  return text.replace(pattern, () => gateway);
+  return text2.replace(pattern, () => gateway);
 }
 async function renderReferenceSpec(gateway, gatewayBaseUrl, keyHeaderName) {
   const file = gateway.specs[0];
   if (!file)
     throw new ReferenceSpecError("gateway.specs lists no OpenAPI file.");
-  let text;
+  let text2;
   try {
-    text = await readFile6(file, "utf8");
+    text2 = await readFile6(file, "utf8");
   } catch {
     throw new ReferenceSpecError(`Cannot read the OpenAPI file ${file}.`);
   }
   const spec = buildReferenceSpec(
-    text,
+    text2,
     referenceOptions(gateway, gatewayBaseUrl, keyHeaderName)
   );
   return `${JSON.stringify(spec, null, 2)}
@@ -7917,17 +7965,34 @@ async function docRoutes(patterns, options = {}) {
   );
   return [...new Set(routes.flat())].sort();
 }
-function pickLandingRoute(routes) {
-  const depth = (route) => route.split("/").length;
-  return [...routes].sort(
-    (a, b) => depth(a) - depth(b) || a.localeCompare(b)
-  )[0];
+function pickLandingRoute(routes, orders) {
+  return firstPage(routes, orders);
+}
+async function docPageOrders(patterns) {
+  const globs = patterns.map(toGlobPath);
+  const excluded = globs.filter((pattern) => pattern.startsWith("!")).map((pattern) => pattern.slice(1));
+  const orders = /* @__PURE__ */ new Map();
+  for (const pattern of globs.filter((p) => !p.startsWith("!"))) {
+    const parent = globParent2(pattern);
+    const files = await glob3(pattern, {
+      absolute: true,
+      posix: true,
+      ignore: [...IGNORED2, ...excluded]
+    });
+    for (const raw of files) {
+      const order = orderValue((await readFrontmatter(raw)).data.order);
+      if (order === void 0) continue;
+      const route = `/${path12.posix.relative(parent, raw.replace(/^\/\/\?\//, "")).replace(/\.mdx?$/, "")}`;
+      if (!orders.has(route)) orders.set(route, order);
+    }
+  }
+  return orders;
 }
 function homeRedirect(input5) {
   if (input5.hostsDocs) {
     if (input5.docRoutes.some((route) => route === "/" || route === "/index"))
       return void 0;
-    const landing = pickLandingRoute(input5.docRoutes);
+    const landing = pickLandingRoute(input5.docRoutes, input5.pageOrders);
     if (landing) return { from: "/", to: landing };
     return input5.apiReferencePath ? { from: "/", to: input5.apiReferencePath } : void 0;
   }
@@ -8349,10 +8414,14 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
   const hostedDocRoutes = [
     .../* @__PURE__ */ new Set([...markdownRoutes, ...tsxPages.map((page) => page.route)])
   ].sort();
+  const pageOrders = plan2.docs ? await docPageOrders(profile.docs.content) : /* @__PURE__ */ new Map();
+  for (const page of tsxPages)
+    if (page.order !== void 0 && !pageOrders.has(page.route))
+      pageOrders.set(page.route, page.order);
   if (plan2.plansPlugin && plan2.docs) {
     const landing = hostedDocRoutes.some(
       (route) => route === "/" || route === "/index"
-    ) ? "/" : pickLandingRoute(hostedDocRoutes);
+    ) ? "/" : pickLandingRoute(hostedDocRoutes, pageOrders);
     if (landing)
       plan2.plansPlugin.links = { ...plan2.plansPlugin.links, docs: landing };
   }
@@ -8362,7 +8431,8 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
     externalDocsUrl: profile.docs.url,
     apiReferencePath: plan2.apiReference ? `/${API_REFERENCE_PATH}` : void 0,
     userPanel: plan2.userPanel,
-    pricingPath: plan2.plansPlugin && hasCapability(effective.services.plans, "catalog") ? CONSOLE_ROUTES.pricing : void 0
+    pricingPath: plan2.plansPlugin && hasCapability(effective.services.plans, "catalog") ? CONSOLE_ROUTES.pricing : void 0,
+    pageOrders
   });
   const siteConfig = buildSiteConfig(
     resolved,
@@ -8376,9 +8446,10 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
           route: page.route,
           label: page.label,
           element: wrapperPages[index]?.id ?? ""
-        }))
+        })),
+        pageOrders
       ),
-      docsPath: pickLandingRoute(hostedDocRoutes),
+      docsPath: pickLandingRoute(hostedDocRoutes, pageOrders),
       demoPlans: plan2.demo && plan2.plansPlugin ? await readDemoPlans(resolved.plans?.file) : void 0,
       protectedRoutes: protectedRoutesFor({
         requireAuth: resolved.portal?.requireAuth,
@@ -8486,16 +8557,16 @@ async function materializeWorkspace(resolved, prepared) {
   return root;
 }
 async function configFingerprint(configPath) {
-  const text = await readFile9(configPath, "utf8");
+  const text2 = await readFile9(configPath, "utf8");
   try {
-    const raw = JSON.parse(text);
+    const raw = JSON.parse(text2);
     if (raw.project) {
       delete raw.project.id;
       if (Object.keys(raw.project).length === 0) delete raw.project;
     }
     return JSON.stringify(raw);
   } catch {
-    return text;
+    return text2;
   }
 }
 async function portalArtifactHash(resolved, manifestText, cliVersion, wrapper = "") {
@@ -8588,7 +8659,7 @@ const items = [
   { id: "3", name: "Third item" },
 ];
 
-// Lets the portal's API page call this server while you run it locally (\`apitogo dev\`). Once deployed, the gateway
+// Lets the portal's API page call this server while you run it locally (\`apitogo run\`). Once deployed, the gateway
 // answers browsers itself and keeps its own list of allowed sites.
 const cors = {
   "access-control-allow-origin": "*",
@@ -9282,7 +9353,10 @@ async function buildGateway(context) {
   const policies = {
     ...rateLimit ? { rateLimit: { calls: rateLimit[0], periodSeconds: rateLimit[1] } } : {},
     ...quota ? { quota: { calls: quota[0], periodDays: quota[1] } } : {},
-    ...o.cors?.length ? { cors: o.cors } : {}
+    ...o.cors?.length ? { cors: o.cors } : {},
+    // The sample server's health check needs no key: monitors and the platform call it, and it is not something a
+    // plan sells, so it stays out of the plans' feature lists (API-126).
+    ...sampleServer ? { operations: { public: [`GET ${FULL_SERVER_HEALTH_PATH}`] } } : {}
   };
   return {
     ...options.disabled ? { enabled: false } : {},
@@ -9573,9 +9647,9 @@ var emptyLedger = () => ({
   services: {}
 });
 async function readLedger(state) {
-  let text;
+  let text2;
   try {
-    text = await readFile10(state.file, "utf8");
+    text2 = await readFile10(state.file, "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return emptyLedger();
@@ -9583,7 +9657,7 @@ async function readLedger(state) {
   }
   let raw;
   try {
-    raw = JSON.parse(text);
+    raw = JSON.parse(text2);
   } catch {
     throw corrupt(state.file, "is not valid JSON");
   }
@@ -9824,8 +9898,8 @@ var PlatformApiClient = class {
   constructor(config2) {
     this.config = config2;
   }
-  url(path97) {
-    return `${this.config.apiUrl}${path97.startsWith("/") ? path97 : `/${path97}`}`;
+  url(path98) {
+    return `${this.config.apiUrl}${path98.startsWith("/") ? path98 : `/${path98}`}`;
   }
   headers(extra) {
     return {
@@ -9835,9 +9909,9 @@ var PlatformApiClient = class {
       ...extra
     };
   }
-  async request(method, path97, init3) {
+  async request(method, path98, init3) {
     const response = await fetchWithRetry(
-      this.url(path97),
+      this.url(path98),
       {
         method,
         ...init3,
@@ -10283,15 +10357,15 @@ var PlatformApiClient = class {
       }
     );
   }
-  deleteDevPortalPage(projectId, path97) {
-    const query = new URLSearchParams({ path: path97 });
+  deleteDevPortalPage(projectId, path98) {
+    const query = new URLSearchParams({ path: path98 });
     return this.request(
       "DELETE",
       `/api/v1/projects/${projectId}/dev-portal/pages/files?${query.toString()}`
     );
   }
-  renameDevPortalPage(projectId, path97, newName) {
-    const query = new URLSearchParams({ path: path97 });
+  renameDevPortalPage(projectId, path98, newName) {
+    const query = new URLSearchParams({ path: path98 });
     return this.request(
       "POST",
       `/api/v1/projects/${projectId}/dev-portal/pages/files/rename?${query.toString()}`,
@@ -10407,8 +10481,8 @@ var PlatformApiClient = class {
    * the project-less endpoint is used; `planTier` overrides the tier used for paid-plan checks.
    */
   validateGatewayPlans(plans, options = {}) {
-    const path97 = options.projectId ? `/api/v1/projects/${options.projectId}/gateway/plans/validate` : "/api/v1/gateway/plans/validate";
-    return this.request("POST", path97, {
+    const path98 = options.projectId ? `/api/v1/projects/${options.projectId}/gateway/plans/validate` : "/api/v1/gateway/plans/validate";
+    return this.request("POST", path98, {
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ plans, planTier: options.planTier })
     });
@@ -10787,7 +10861,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.2.53",
+  version: "0.2.54",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -11505,9 +11579,9 @@ var slugifyWithCounter = () => {
   const counts = /* @__PURE__ */ new Map();
   return (str) => {
     const base = slugify(str);
-    const count = counts.get(base) ?? 0;
-    counts.set(base, count + 1);
-    return count === 0 ? base : `${base}-${count + 1}`;
+    const count2 = counts.get(base) ?? 0;
+    counts.set(base, count2 + 1);
+    return count2 === 0 ? base : `${base}-${count2 + 1}`;
   };
 };
 
@@ -11572,14 +11646,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path97 = []) => {
-  const transformed = transform(specification, path97);
+var traverse = (specification, transform, path98 = []) => {
+  const transformed = transform(specification, path98);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path97, key];
+    const currentPath = [...path98, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -11607,9 +11681,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path97 = ref.split("/").slice(1);
+  const path98 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path97) {
+  for (const segment of path98) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -11628,7 +11702,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path97) => {
+  const resolve = async (current, path98) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -11636,7 +11710,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], `${path97}/${index}`);
+          current[index] = await resolve(current[index], `${path98}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -11647,13 +11721,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path97);
+              result2 = await resolve(resolved, path98);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path97);
+            result2 = await resolve(resolved, path98);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -11666,7 +11740,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path97}/${key}`);
+          current[key] = await resolve(current[key], `${path98}/${key}`);
         }
       }
       visited.delete(current);
@@ -11705,9 +11779,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path97) => {
+  schema2 = traverse(schema2, (sub, path98) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path97 ?? [])) {
+      if (isSchemaPath(path98 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -11720,11 +11794,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path97) => {
+  schema2 = traverse(schema2, (schema3, path98) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path97?.slice(0, -1);
+      const parentPath = path98?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path97?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path98?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -11738,8 +11812,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path97) => {
-    if (path97?.includes("content") && path97.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path98) => {
+    if (path98?.includes("content") && path98.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -11765,11 +11839,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path97) => {
+  schema2 = traverse(schema2, (schema3, path98) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path97?.slice(0, -1);
+      const parentPath = path98?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path97?.[index - 1] === "content"
+        (_, index) => path98?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -11781,7 +11855,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path97) {
+function isSchemaPath(path98) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -11794,10 +11868,10 @@ function isSchemaPath(path97) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path97[index] === segment);
+      return location.every((segment, index) => path98[index] === segment);
     }
-    return path97.includes(location);
-  }) || path97.includes("schema") || path97.some((segment) => segment.endsWith("Schema"));
+    return path98.includes(location);
+  }) || path98.includes("schema") || path98.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -11879,13 +11953,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path97 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path98 = [], 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 = path97.find((p) => !OPENAPI_PROPS.has(p)) || path97[0];
+    const circularProp = path98.find((p) => !OPENAPI_PROPS.has(p)) || path98[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -11895,7 +11969,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path97, key],
+    [...path98, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -11930,7 +12004,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path97) => HttpMethods.map((k) => path97?.[k]).filter((op) => op != null)
+    (path98) => HttpMethods.map((k) => path98?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -11985,7 +12059,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(
-    ([path97, value]) => HttpMethods.flatMap((method) => {
+    ([path98, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -12005,7 +12079,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path97,
+        path: path98,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -12363,8 +12437,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path97, value]) => ({
-        path: path97,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path98, value]) => ({
+        path: path98,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -12529,7 +12603,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path97) => path97.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path98) => path98.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -12560,16 +12634,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path97, filePath) => {
-  const parts = getSegmentsFromPath(path97);
+var lookup = (schema2, path98, filePath) => {
+  const parts = getSegmentsFromPath(path98);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path97 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path98 ? 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: ${path97}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path98}`
       );
     }
     val = val[part];
@@ -12816,8 +12890,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path97) => this.processedSchemas[path97]?.at(0);
-  getSchemasForPath = (path97) => this.processedSchemas[path97];
+  getLatestSchema = (path98) => this.processedSchemas[path98]?.at(0);
+  getSchemasForPath = (path98) => this.processedSchemas[path98];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -15309,14 +15383,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path97) => {
-  const segments = path97.split("/");
+var resolveRoutePath = (path98) => {
+  const segments = path98.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path97) => path97.includes("*") || /^\d+$/.test(path97);
+var isSkipped = (path98) => path98.includes("*") || /^\d+$/.test(path98);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -15393,9 +15467,9 @@ var prerender = async ({
   let lastLogTime = start;
   const quietDeployJson = process.env.APITOGO_JSON_ONLY === "1";
   const writeProgress = throttle(
-    (count, total, urlPath) => {
+    (count2, total, urlPath) => {
       if (quietDeployJson) return;
-      writeLine(`prerendering (${count}/${total}) ${colors11.dim(urlPath)}`);
+      writeLine(`prerendering (${count2}/${total}) ${colors11.dim(urlPath)}`);
     }
   );
   if (!isTTY() && !quietDeployJson) {
@@ -15759,11 +15833,12 @@ async function preparePortalWorkspace(dir, mode) {
   return { resolved, prepared, root };
 }
 async function portalBuildHash(resolved, prepared) {
+  const { generatedAt: _generatedAt, ...manifest } = prepared.publishedManifest ?? {};
   return portalArtifactHash(
     resolved,
     void 0,
     getZudokuPackageJson().version,
-    prepared.wrapper + JSON.stringify(prepared.siteConfig) + JSON.stringify(prepared.publishedManifest ?? null) + (prepared.referenceSpec ?? "")
+    prepared.wrapper + JSON.stringify(prepared.siteConfig) + JSON.stringify(prepared.publishedManifest ? manifest : null) + (prepared.referenceSpec ?? "")
   );
 }
 function portalBuildStep(context, options = {}, build2 = runBuild) {
@@ -15824,15 +15899,15 @@ async function buildV2(options) {
 // src/cli/check/gateway-online.ts
 import { readFile as readFile16 } from "node:fs/promises";
 var SPEC_SEND_LIMIT = 5 * 1024 * 1024 + 64 * 1024;
-var issue2 = (code, path97, message, hint) => ({ code, path: path97, message, hint });
+var issue2 = (code, path98, message, hint) => ({ code, path: path98, message, hint });
 function capabilityIssues(gateway, answer) {
   const can = answer.capabilities;
   const plan2 = `your ${answer.tier} plan`;
   const found = [];
-  const unsupported = (path97, what, hint) => found.push(
+  const unsupported = (path98, what, hint) => found.push(
     issue2(
       "GATEWAY_CAPABILITY_UNSUPPORTED",
-      path97,
+      path98,
       `${what} is not available on ${plan2}.`,
       hint
     )
@@ -15886,8 +15961,8 @@ async function onlineGatewayRules(gateway, projectId, api, derivedCors = []) {
   const specFile = gateway.specs[0];
   if (specFile) {
     try {
-      const text = await readFile16(specFile, "utf8");
-      if (text.length <= SPEC_SEND_LIMIT) spec = text;
+      const text2 = await readFile16(specFile, "utf8");
+      if (text2.length <= SPEC_SEND_LIMIT) spec = text2;
     } catch {
     }
   }
@@ -15956,9 +16031,9 @@ var issuesOf = (error) => error.issues.map(
   (issue4) => `${issue4.path.join(".") || "(file)"}: ${issue4.message}`
 );
 async function readPlansFile(file) {
-  let text;
+  let text2;
   try {
-    text = await readFile17(file, "utf8");
+    text2 = await readFile17(file, "utf8");
   } catch {
     throw new PlansFileError(
       "PLANS_FILE_UNREADABLE",
@@ -15968,7 +16043,7 @@ async function readPlansFile(file) {
   }
   let raw;
   try {
-    raw = JSON.parse(text);
+    raw = JSON.parse(text2);
   } catch (error) {
     throw new PlansFileError(
       "PLANS_FILE_INVALID",
@@ -16036,9 +16111,9 @@ function toPlatformPlans(plans, options = {}) {
 }
 
 // src/cli/check/services-online.ts
-var issue3 = (code, path97, message, hint) => ({
+var issue3 = (code, path98, message, hint) => ({
   code,
-  path: path97,
+  path: path98,
   message,
   hint
 });
@@ -16396,7 +16471,7 @@ function platformDependencies(args) {
 async function checkV2(dir, args, deps = platformDependencies(args)) {
   const output4 = await runCheckV2(dir, args, deps);
   if (args.json === false) {
-    for (const text of formatCheckV2(output4)) console.log(text);
+    for (const text2 of formatCheckV2(output4)) console.log(text2);
   } else {
     console.log(JSON.stringify(output4, null, 2));
   }
@@ -16514,9 +16589,23 @@ async function initV2(argv) {
 }
 
 // src/cli/services/packages.ts
-import { spawn } from "node:child_process";
 import { existsSync as existsSync6 } from "node:fs";
 import path52 from "node:path";
+
+// src/cli/common/spawn-command.ts
+import {
+  spawn
+} from "node:child_process";
+function quoteForWindowsShell(arg) {
+  return /[\s"^&|<>()%!]/.test(arg) ? `"${arg.replace(/"/g, '""')}"` : arg;
+}
+function spawnCommand(command2, args, options = {}) {
+  if (process.platform !== "win32") return spawn(command2, [...args], options);
+  const line2 = [command2, ...args.map(quoteForWindowsShell)].join(" ");
+  return spawn(line2, { ...options, shell: true });
+}
+
+// src/cli/services/packages.ts
 var USER_PANEL_PACKAGE = "@lukoweb/apitogo-module-user-panel";
 var BILLING_PLUGIN_PACKAGE = "@lukoweb/apitogo-plugin-dev-portal-billing";
 var LANDING_PACKAGE = "@lukoweb/apitogo-module-landing";
@@ -16563,10 +16652,9 @@ function installSpecsCommand(manager, specs) {
 }
 var specName = (spec) => spec.slice(0, spec.lastIndexOf("@"));
 var runInstaller = (dir, { command: command2, args }) => new Promise((resolve, reject) => {
-  const child = spawn(command2, args, {
+  const child = spawnCommand(command2, args, {
     cwd: dir,
-    stdio: "inherit",
-    shell: process.platform === "win32"
+    stdio: "inherit"
   });
   child.on("error", reject);
   child.on(
@@ -18319,7 +18407,6 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
 }
 
 // src/cli/platform/helpers/npm-build.ts
-import { spawn as spawn2 } from "node:child_process";
 import { access as access7, readFile as readFile22 } from "node:fs/promises";
 import path59 from "node:path";
 var BUILD_LOG_TAIL_BYTES = 8192;
@@ -18370,10 +18457,9 @@ async function pathExists2(filePath) {
 }
 function runCommand(command2, args, cwd, env) {
   return new Promise((resolve, reject) => {
-    const child = spawn2(command2, args, {
+    const child = spawnCommand(command2, args, {
       cwd,
-      env: env ? { ...process.env, ...env } : process.env,
-      shell: process.platform === "win32"
+      env: env ? { ...process.env, ...env } : process.env
     });
     let output4 = "";
     child.stdout.on("data", (chunk) => {
@@ -18929,7 +19015,7 @@ async function check(argv) {
 
 // src/cli/cmds/check.ts
 var check_default = {
-  desc: "Check the local project: config version 2 is validated offline; version 1 also checks publish readiness (secrets, manifest, validation)",
+  desc: "Check the project before a deploy: apitogo.config.json, its files and, when you are logged in, the platform's rules",
   command: "check",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
@@ -18942,12 +19028,12 @@ var check_default = {
     default: false
   }).option("offline", {
     type: "boolean",
-    describe: "Config version 2: do not ask the platform anything (secret names and the gateway's online rules are then not checked)",
+    describe: "Do not ask the platform anything (secret names and the gateway's online rules are then not checked)",
     default: false
   }).option("json", {
     type: "boolean",
-    describe: "Print raw JSON only (use --no-json for readable text with a version 2 config)",
-    default: true
+    describe: "Print JSON instead of text",
+    default: false
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo check" });
@@ -19119,13 +19205,17 @@ function normalizeDocsSlug(value) {
     (part) => part.toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "")
   ).filter(Boolean).join("/");
 }
-function buildDocsPage(title, content) {
-  const body = content?.trim() || "Write this page in Markdown. Every `.md` or `.mdx` file under `portal/pages/` becomes a page of your portal.";
+function withoutLeadingH1(content) {
+  return content.replace(/^\s*#\s+[^\n]*(\r?\n)*/, "").trim();
+}
+function buildDocsPage(title, content, order) {
+  const given = content?.trim() ? withoutLeadingH1(content) : "";
+  const body = given || "{/* Write this page in Markdown. Every .md or .mdx file in the pages folder becomes a page of your portal. */}\n\nComing soon.";
+  const orderLine = order === void 0 ? "" : `order: ${order}
+`;
   return `---
 title: ${JSON.stringify(title)}
----
-
-# ${title}
+${orderLine}---
 
 ${body}
 `;
@@ -19134,20 +19224,26 @@ function pageComponentName(slug) {
   const name = slug.split(/[^A-Za-z0-9]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
   return `${/^[0-9]/.test(name) ? "Page" : ""}${name || "Docs"}Page`;
 }
-function buildTsxDocsPage(slug, title, file, content) {
-  const text = content?.trim() ? `{${JSON.stringify(content.trim())}}` : "This page is a React component. Change it like any other component: add state, fetch data, or use the portal's components.";
+function buildTsxDocsPage(slug, title, file, content, order) {
+  const given = content?.trim() ? withoutLeadingH1(content) : "";
+  const orderExport = order === void 0 ? "" : `
+/** Where the page sits in the sidebar: lower numbers come first. */
+export const order = ${order};
+`;
+  const text2 = given ? `{${JSON.stringify(given)}}` : "Coming soon.";
   return `import { Callout, Heading, Typography } from "@lukoweb/apitogo/components";
 
 /** The page's label in the sidebar. */
 export const title = ${JSON.stringify(title)};
-
+${orderExport}
+// This page is a React component: change it like any other one (add state, fetch data, use the portal's components).
 export default function ${pageComponentName(slug)}() {
   return (
     <section className="mx-auto max-w-screen-lg px-4 py-12 pt-(--padding-content-top)">
       <Typography>
         <Heading level={1}>{title}</Heading>
-        <p>${text}</p>
-        {/* A note for you while you run the portal locally (\`apitogo dev\`); the deployed portal does not show it. */}
+        <p>${text2}</p>
+        {/* A note for you while you run the portal locally (\`apitogo run\`); the deployed portal does not show it. */}
         {import.meta.env.DEV && (
           <Callout type="info" title="Where this page lives">
             Edit <code>${file}</code>. Files whose name starts with <code>_</code> are not pages, so you can keep
@@ -19177,6 +19273,12 @@ async function writeDocsPage(project, input5) {
   }
   const slug = normalizeDocsSlug(input5.slug);
   if (!slug) throw new ConfigEditError("The page path must not be empty.");
+  if (input5.order !== void 0 && !Number.isInteger(input5.order)) {
+    throw new ConfigEditError(
+      `--page-order must be a whole number, not ${input5.order}.`,
+      "For example --page-order 1 puts the page first in the sidebar."
+    );
+  }
   const base = path62.join(portal.dir, "pages", ...slug.split("/"));
   const existing = (await Promise.all(
     [`${base}.tsx`, `${base}.mdx`, `${base}.md`].map(
@@ -19184,9 +19286,9 @@ async function writeDocsPage(project, input5) {
     )
   )).find((file2) => file2 !== null);
   const relative = (file2) => toPosix2(path62.relative(project.dir, file2));
-  const write = (file2, title) => writeFile18(
+  const write = (file2, title, order = input5.order) => writeFile18(
     file2,
-    file2.endsWith(".tsx") ? buildTsxDocsPage(slug, title, relative(file2), input5.content) : buildDocsPage(title, input5.content),
+    file2.endsWith(".tsx") ? buildTsxDocsPage(slug, title, relative(file2), input5.content, order) : buildDocsPage(title, input5.content, order),
     "utf8"
   );
   let file;
@@ -19202,7 +19304,8 @@ async function writeDocsPage(project, input5) {
     const title = input5.title?.trim() || (existing.endsWith(".tsx") ? tsxPageLabel(source, existing) : titleOf(source));
     file = existing;
     action = "updated";
-    await write(file, title ?? slug);
+    const keptOrder = input5.order ?? (existing.endsWith(".tsx") ? tsxPageOrder(source) : orderValue(/^order:\s*(.+?)\s*$/m.exec(source)?.[1]));
+    await write(file, title ?? slug, keptOrder);
   } else {
     if (existing) {
       throw new ConfigEditError(
@@ -19640,7 +19743,8 @@ async function makeConfig(argv) {
           title: argv.pageTitle,
           content: argv.pageContent,
           update: argv.pageUpdate === true,
-          format: argv.pageFormat
+          format: argv.pageFormat,
+          order: argv.pageOrder
         });
         changes.push(page.action === "added" ? "page_add" : "page_update");
       }
@@ -19652,7 +19756,10 @@ async function makeConfig(argv) {
         }
       }
     }
-    const message = changes.length === 0 ? "Nothing to change." : `Updated the project (${changes.join(", ")}).`;
+    const message = changes.length === 0 ? "Nothing to change." : (
+      // The change codes (page_add, plan_update, ...) are for scripts: they stay in the JSON output (API-126).
+      "Done."
+    );
     if (json) {
       console.log(
         JSON.stringify(
@@ -19738,6 +19845,9 @@ function addConfigOptions(yargs2) {
     type: "string",
     choices: ["tsx", "mdx"],
     describe: "Format of a new page: tsx (a React component, the default) or mdx (Markdown)"
+  }).option("page-order", {
+    type: "number",
+    describe: "Place of --page-slug in the sidebar: lower numbers come first (pages without one follow, by name)"
   }).option("page-update", {
     type: "boolean",
     default: false,
@@ -19747,11 +19857,11 @@ function addConfigOptions(yargs2) {
     describe: "JSON plan added to the plans file (plans.file, default apitogo/plans.json), or replacing the one with the same sku"
   }).option("patch", {
     type: "string",
-    describe: "JSON object deep-merged into apitogo.config.json; the result must be a valid version 2 config"
+    describe: "JSON object deep-merged into apitogo.config.json; the result must still be a valid config"
   });
 }
 var config_default = {
-  desc: "Change a config version 2 project: portal name, API code, OpenAPI files, docs pages and plans (interactive on TTY)",
+  desc: "Change the project: portal name, API code, OpenAPI files, docs pages and plans (asks in a terminal)",
   command: "config",
   builder: (yargs2) => addConfigOptions(yargs2),
   handler: async (argv) => {
@@ -19764,14 +19874,62 @@ var config_default = {
 init_apitogo_config_core();
 import { execFile } from "node:child_process";
 import { readFile as readFile24 } from "node:fs/promises";
-import path64 from "node:path";
+import path65 from "node:path";
 import { promisify } from "node:util";
+
+// src/cli/create/dry-run.ts
+import { mkdir as mkdir16, mkdtemp, readdir as readdir4, rm as rm9 } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path64 from "node:path";
+async function listFiles(root, dir = root) {
+  const entries = await readdir4(dir, { withFileTypes: true });
+  const nested = await Promise.all(
+    entries.map(async (entry) => {
+      const full = path64.join(dir, entry.name);
+      if (entry.isDirectory()) return listFiles(root, full);
+      return [path64.relative(root, full).split(path64.sep).join("/")];
+    })
+  );
+  return nested.flat();
+}
+async function previewCreate(input5) {
+  const scratch = await mkdtemp(path64.join(tmpdir(), "apitogo-create-"));
+  const dir = path64.join(scratch, "project");
+  try {
+    await mkdir16(dir);
+    await applyInitPlan(await planInit({ dir, name: input5.name }));
+    const packages = /* @__PURE__ */ new Set();
+    for (const service of input5.services) {
+      const edit = await planAddService(service, {
+        ...addOptionsFromArguments(service, {
+          service,
+          dir,
+          template: input5.template,
+          yes: true
+        })
+      });
+      for (const pkg of Object.values(
+        packagesToInstall(dir, edit.config)
+      ).flat())
+        packages.add(pkg);
+      await applyServiceEdit(edit);
+    }
+    return {
+      files: (await listFiles(dir)).sort(),
+      packages: [...packages].sort()
+    };
+  } finally {
+    await rm9(scratch, { recursive: true, force: true });
+  }
+}
+
+// src/cli/create/handler.ts
 var execFileAsync = promisify(execFile);
 function nextStepHint(dir) {
   const linked = loadConfigV2(dir).resolved.project.id;
-  const cd = path64.resolve(dir) === path64.resolve(process.cwd());
+  const cd = path65.resolve(dir) === path65.resolve(process.cwd());
   const steps = linked ? "apitogo deploy" : "apitogo project create, then apitogo deploy";
-  return cd ? `Next: ${steps}` : `Next: cd ${JSON.stringify(path64.relative(process.cwd(), dir))}, then ${steps}`;
+  return cd ? `Next: ${steps}` : `Next: cd ${JSON.stringify(path65.relative(process.cwd(), dir))}, then ${steps}`;
 }
 function projectFolderName(name) {
   return name.trim().replace(/[<>:"/\\|?*\s]+/g, "-").replace(/^[-.]+|[-.]+$/g, "") || "apitogo-project";
@@ -19797,13 +19955,13 @@ async function gitHasUncommittedChanges(dir) {
 async function defaultName(dir) {
   try {
     const parsed = JSON.parse(
-      await readFile24(path64.join(dir, "package.json"), "utf8")
+      await readFile24(path65.join(dir, "package.json"), "utf8")
     );
     if (typeof parsed.name === "string" && parsed.name.trim())
       return parsed.name.replace(/^@[^/]+\//, "");
   } catch {
   }
-  return path64.basename(dir);
+  return path65.basename(dir);
 }
 function parseServicesFlag(value) {
   const names = (value ?? "").split(",").map((name) => name.trim()).filter(Boolean);
@@ -19829,7 +19987,7 @@ async function createProject(argv, deps = {}) {
     if (!json) printDiagnosticsToConsole(line2);
   };
   try {
-    const base = path64.resolve(process.cwd(), argv.dir ?? ".");
+    const base = path65.resolve(process.cwd(), argv.dir ?? ".");
     let dir = base;
     let requested = parseServicesFlag(argv.services);
     let template = argv.template;
@@ -19852,8 +20010,8 @@ async function createProject(argv, deps = {}) {
         default: await defaultName(base)
       }) : await defaultName(base));
       const folder = projectFolderName(name);
-      if (argv.dir === void 0 && folder !== path64.basename(base))
-        dir = path64.join(base, folder);
+      if (argv.dir === void 0 && folder !== path65.basename(base))
+        dir = path65.join(base, folder);
     }
     if (await (deps.hasUncommittedChanges ?? gitHasUncommittedChanges)(dir))
       say(
@@ -19861,26 +20019,45 @@ async function createProject(argv, deps = {}) {
       );
     if (name !== void 0 && !await isConfigV2(dir)) {
       const plan2 = await planInit({ dir, name });
-      for (const line2 of formatInitPlan(plan2)) say(line2);
+      if (!argv.dryRun) for (const line2 of formatInitPlan(plan2)) say(line2);
       commands.push(`apitogo init --name ${JSON.stringify(name)}`);
       if (argv.dryRun) {
+        const services = requested.length > 0 ? requested : templateServices ? STARTER_SERVICES : [];
+        const preview2 = services.length > 0 ? await previewCreate({ name, template, services }) : void 0;
+        const folder = path65.relative(process.cwd(), dir) || ".";
         if (json)
           console.log(
             JSON.stringify({
               status: "dry-run",
-              services: requested,
+              dir: folder,
+              services,
+              files: preview2?.files ?? [],
+              packages: preview2?.packages ?? [],
               commands: [
                 ...commands,
-                ...requested.map((service) => `apitogo add ${service}`)
+                ...services.map((service) => `apitogo add ${service}`)
               ]
             })
           );
-        else printResultToConsole("Dry run: nothing was written.");
+        else {
+          say(`Folder: ${folder}${dir === base ? "" : " (new)"}`);
+          if (preview2) {
+            say(`Files (${preview2.files.length}):`);
+            for (const file of preview2.files) say(`  ${file}`);
+            if (preview2.packages.length > 0 && argv.install !== false)
+              say(`Packages to install: ${preview2.packages.join(", ")}`);
+          } else {
+            say(
+              "The services are chosen one by one in a real run; pass --template full or --services to see their files."
+            );
+          }
+          printResultToConsole("Dry run: nothing was written.");
+        }
         return;
       }
       await applyInitPlan(plan2);
       say(
-        dir === base ? `Created ${APITOGO_CONFIG_FILENAME}.` : `Created ${path64.relative(base, dir)}${path64.sep}${APITOGO_CONFIG_FILENAME}.`
+        dir === base ? `Created ${APITOGO_CONFIG_FILENAME}.` : `Created ${path65.relative(base, dir)}${path65.sep}${APITOGO_CONFIG_FILENAME}.`
       );
     } else {
       say(`${APITOGO_CONFIG_FILENAME} exists: continuing from it.`);
@@ -19981,9 +20158,8 @@ var create_default = {
   command: "create",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
-    describe: "Project directory (default: a new folder named after the project)",
-    normalize: true,
-    hidden: true
+    describe: "Project folder (default: a new folder named after the project, inside the current one)",
+    normalize: true
   }).option("name", {
     type: "string",
     describe: "Project name (default: folder name or package.json name)"
@@ -20005,7 +20181,7 @@ var create_default = {
   }).option("dry-run", {
     type: "boolean",
     default: false,
-    describe: "Print the will-create list and exit"
+    describe: "Show the folder, every file and the packages a real run makes, and write nothing"
   }).option("yes", {
     alias: "y",
     type: "boolean",
@@ -20023,10 +20199,10 @@ var create_default = {
 };
 
 // src/cli/cmds/deploy.ts
-import path82 from "node:path";
+import path83 from "node:path";
 
 // src/cli/apply/handler.ts
-import path76 from "node:path";
+import path77 from "node:path";
 
 // src/cli/platform/helpers/gateway-plan-validation.ts
 init_gateway_limits();
@@ -20147,14 +20323,22 @@ var MODULE_DISPLAY_NAMES = {
   "dev-portal": "Developer website",
   apihub: "API hosting"
 };
-function friendlyModuleNames(text) {
-  return text.replace(
+function friendlyModuleNames(text2) {
+  return text2.replace(
     /(?:Module|module) (dev-portal|apihub)(?![\w-])/g,
     (_match, id) => MODULE_DISPLAY_NAMES[id] ?? id
   );
 }
-function createConsoleProgressReporter(stream = process.stderr) {
-  const shared = { spinner: void 0 };
+var INFRASTRUCTURE_MESSAGE = /front ?door|\bapim\b|api management|fabric|container app|origin group|\borigin\b|binding|\bdns\b|static web app|\bswa\b|\bacr\b|resource group|revision|warm pool|capacity pool|pooled/i;
+function isInfrastructureMessage(message) {
+  return INFRASTRUCTURE_MESSAGE.test(message);
+}
+function createConsoleProgressReporter(stream = process.stderr, options = {}) {
+  const shared = {
+    spinner: void 0,
+    verbose: options.verbose === true,
+    printed: /* @__PURE__ */ new Set()
+  };
   return {
     ...createScopedConsoleProgressReporter(stream, void 0, shared),
     stop() {
@@ -20192,11 +20376,13 @@ function createScopedConsoleProgressReporter(stream, stepLabel, shared) {
     },
     async onNewMessages(messages) {
       for (const entry of messages) {
-        writeLine2(
-          friendlyModuleNames(
-            stepLabel ? `[${stepLabel}] ${entry.message}` : entry.message
-          )
+        if (!shared.verbose && isInfrastructureMessage(entry.message)) continue;
+        const line2 = friendlyModuleNames(
+          stepLabel ? `[${stepLabel}] ${entry.message}` : entry.message
         );
+        if (shared.printed.has(line2)) continue;
+        shared.printed.add(line2);
+        writeLine2(line2);
       }
     },
     isCancelled: () => false,
@@ -20235,11 +20421,11 @@ init_gateway_limits();
 // src/cli/platform/helpers/deploy-artifact-hash.ts
 import { createHash as createHash3 } from "node:crypto";
 import { createReadStream, promises as fs6 } from "node:fs";
-import path66 from "node:path";
+import path67 from "node:path";
 
 // src/cli/platform/helpers/package-files.ts
 import { promises as fs5 } from "node:fs";
-import path65 from "node:path";
+import path66 from "node:path";
 import ignore from "ignore";
 var DEFAULT_EXCLUDES = /* @__PURE__ */ new Set([
   "node_modules",
@@ -20253,7 +20439,7 @@ async function loadGitignore(rootDir, extraExcludes = []) {
   const ig = ignore();
   ig.add(["node_modules/", ".git/", "dist/", "bin/", "obj/"]);
   if (extraExcludes.length > 0) ig.add([...extraExcludes]);
-  const gitignorePath = path65.join(rootDir, ".gitignore");
+  const gitignorePath = path66.join(rootDir, ".gitignore");
   try {
     const content = await fs5.readFile(gitignorePath, "utf8");
     ig.add(content);
@@ -20262,11 +20448,11 @@ async function loadGitignore(rootDir, extraExcludes = []) {
   return ig;
 }
 async function collectFiles(rootDir, relativeDir, ig, files) {
-  const absDir = path65.join(rootDir, relativeDir);
+  const absDir = path66.join(rootDir, relativeDir);
   const entries = await fs5.readdir(absDir, { withFileTypes: true });
   for (const entry of entries) {
-    const rel2 = relativeDir ? path65.join(relativeDir, entry.name) : entry.name;
-    const relPosix = rel2.split(path65.sep).join("/");
+    const rel2 = relativeDir ? path66.join(relativeDir, entry.name) : entry.name;
+    const relPosix = rel2.split(path66.sep).join("/");
     if (DEFAULT_EXCLUDES.has(entry.name) && !relativeDir) {
       continue;
     }
@@ -20281,7 +20467,7 @@ async function collectFiles(rootDir, relativeDir, ig, files) {
   }
 }
 async function collectPackageableFiles(sourceDirectory, extraExcludes = []) {
-  const resolved = path65.resolve(sourceDirectory);
+  const resolved = path66.resolve(sourceDirectory);
   const stat7 = await fs5.stat(resolved).catch(() => null);
   if (!stat7?.isDirectory()) {
     throw new Error(`sourceDirectory is not a directory: ${resolved}`);
@@ -20307,7 +20493,7 @@ async function sha256File(filePath) {
   return hash2.digest("hex");
 }
 async function hashDirectoryContents(rootDirectory, extraExcludes = []) {
-  const resolved = path66.resolve(rootDirectory);
+  const resolved = path67.resolve(rootDirectory);
   const files = (await collectPackageableFiles(resolved, extraExcludes)).sort(
     (a, b) => a.localeCompare(b)
   );
@@ -20315,13 +20501,13 @@ async function hashDirectoryContents(rootDirectory, extraExcludes = []) {
   for (const rel2 of files) {
     hash2.update(rel2);
     hash2.update("\0");
-    hash2.update(await fs6.readFile(path66.join(resolved, rel2)));
+    hash2.update(await fs6.readFile(path67.join(resolved, rel2)));
     hash2.update("\0");
   }
   return hash2.digest("hex");
 }
 async function hashDevPortalSiteSources(siteDirectory, options) {
-  const resolved = path66.resolve(siteDirectory);
+  const resolved = path67.resolve(siteDirectory);
   const hash2 = createHash3("sha256");
   const candidates = [
     "apitogo.config.json",
@@ -20331,7 +20517,7 @@ async function hashDevPortalSiteSources(siteDirectory, options) {
     "zudoku.config.tsx"
   ];
   for (const name of candidates) {
-    const full = path66.join(resolved, name);
+    const full = path67.join(resolved, name);
     try {
       hash2.update(name);
       hash2.update("\0");
@@ -20341,7 +20527,7 @@ async function hashDevPortalSiteSources(siteDirectory, options) {
     }
   }
   for (const dir of ["pages", "landing", "src"]) {
-    const full = path66.join(resolved, dir);
+    const full = path67.join(resolved, dir);
     try {
       const st = await fs6.stat(full);
       if (!st.isDirectory()) continue;
@@ -20570,8 +20756,8 @@ function normalizeActionKey(actionKey2) {
   const trimmed = actionKey2.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path98 = pathParts.join(":").trim();
-    return `${method2?.toLowerCase()}:${path98.startsWith("/") ? path98 : `/${path98}`}`;
+    const path99 = pathParts.join(":").trim();
+    return `${method2?.toLowerCase()}:${path99.startsWith("/") ? path99 : `/${path99}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -20580,8 +20766,8 @@ function normalizeActionKey(actionKey2) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path97 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path97.startsWith("/") ? path97 : `/${path97}`}`;
+  const path98 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path98.startsWith("/") ? path98 : `/${path98}`}`;
 }
 async function applyGatewayPublicRoutes(client, projectId, routes, options) {
   const applied = [];
@@ -21059,8 +21245,8 @@ async function upsertGatewayPlansFromManifest(client, config2, projectId, plans,
 }
 
 // src/cli/platform/helpers/openapi-gateway-servers.ts
-import { mkdir as mkdir16, readFile as readFile25, writeFile as writeFile19 } from "node:fs/promises";
-import path67 from "node:path";
+import { mkdir as mkdir17, readFile as readFile25, writeFile as writeFile19 } from "node:fs/promises";
+import path68 from "node:path";
 import YAML from "yaml";
 var GATEWAY_URL_ENV_KEY = "APITOGO_GATEWAY_URL";
 var PUBLISH_OPENAPI_RELATIVE = ".apitogo/openapi-publish.json";
@@ -21092,7 +21278,7 @@ async function resolveProjectGatewayUrl(client, projectId) {
 }
 async function readOpenApiDocument(filePath) {
   const content = await readFile25(filePath, "utf8");
-  const ext = path67.extname(filePath).toLowerCase();
+  const ext = path68.extname(filePath).toLowerCase();
   const parsed = ext === ".json" ? JSON.parse(content) : YAML.parse(content);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error(`OpenAPI document must be an object: ${filePath}`);
@@ -21100,13 +21286,13 @@ async function readOpenApiDocument(filePath) {
   return parsed;
 }
 async function materializePublishOpenApiWithGateway(siteDirectory, sourceOpenApiPath, gatewayUrl) {
-  const site = path67.resolve(siteDirectory);
-  const source = path67.resolve(sourceOpenApiPath);
+  const site = path68.resolve(siteDirectory);
+  const source = path68.resolve(sourceOpenApiPath);
   const relativeInput = PUBLISH_OPENAPI_RELATIVE;
-  const outputPath = path67.join(site, ...relativeInput.split("/"));
+  const outputPath = path68.join(site, ...relativeInput.split("/"));
   const doc = await readOpenApiDocument(source);
   const rewritten = withGatewayServers(doc, gatewayUrl);
-  await mkdir16(path67.dirname(outputPath), { recursive: true });
+  await mkdir17(path68.dirname(outputPath), { recursive: true });
   await writeFile19(
     outputPath,
     `${JSON.stringify(rewritten, null, 2)}
@@ -21116,8 +21302,8 @@ async function materializePublishOpenApiWithGateway(siteDirectory, sourceOpenApi
   return { outputPath, relativeInput };
 }
 async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
-  const configPath = path67.join(
-    path67.resolve(siteDirectory),
+  const configPath = path68.join(
+    path68.resolve(siteDirectory),
     APITOGO_CONFIG_FILENAME2
   );
   const raw = await readFile25(configPath, "utf8");
@@ -21159,7 +21345,7 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
   };
 }
 async function prepareOpenApiServersForGatewayBuild(options) {
-  const siteDirectory = path67.resolve(options.siteDirectory);
+  const siteDirectory = path68.resolve(options.siteDirectory);
   let openApiPath = resolveBackendOpenApiPath(
     options.manifest?.backend?.openApiPath,
     {
@@ -21173,7 +21359,7 @@ async function prepareOpenApiServersForGatewayBuild(options) {
   if (!openApiPath) {
     try {
       const raw = await readFile25(
-        path67.join(siteDirectory, APITOGO_CONFIG_FILENAME2),
+        path68.join(siteDirectory, APITOGO_CONFIG_FILENAME2),
         "utf8"
       );
       const config2 = JSON.parse(raw);
@@ -21202,8 +21388,8 @@ function normalizeActionKeyFormat(actionKey2) {
   const trimmed = actionKey2.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path98 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path98.startsWith("/") ? path98 : `/${path98}`}`;
+    const path99 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path99.startsWith("/") ? path99 : `/${path99}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -21212,8 +21398,8 @@ function normalizeActionKeyFormat(actionKey2) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path97 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path97.startsWith("/") ? path97 : `/${path97}`}`;
+  const path98 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path98.startsWith("/") ? path98 : `/${path98}`}`;
 }
 function normalizePublicRoute(route) {
   const trimmed = route.trim();
@@ -21246,11 +21432,11 @@ function collectManifestPublicActionKeys(gateway) {
 }
 
 // src/cli/platform/helpers/publish-ledger.ts
-import { mkdir as mkdir17, readFile as readFile26, writeFile as writeFile20 } from "node:fs/promises";
-import path68 from "node:path";
+import { mkdir as mkdir18, readFile as readFile26, writeFile as writeFile20 } from "node:fs/promises";
+import path69 from "node:path";
 var PUBLISH_LEDGER_RELATIVE_PATH = ".apitogo/publish-state.json";
 function publishLedgerPath(siteDirectory) {
-  return path68.join(path68.resolve(siteDirectory), PUBLISH_LEDGER_RELATIVE_PATH);
+  return path69.join(path69.resolve(siteDirectory), PUBLISH_LEDGER_RELATIVE_PATH);
 }
 async function readPublishLedger(siteDirectory) {
   const filePath = publishLedgerPath(siteDirectory);
@@ -21267,7 +21453,7 @@ async function readPublishLedger(siteDirectory) {
 }
 async function writePublishLedger(siteDirectory, ledger) {
   const filePath = publishLedgerPath(siteDirectory);
-  await mkdir17(path68.dirname(filePath), { recursive: true });
+  await mkdir18(path69.dirname(filePath), { recursive: true });
   const next = {
     ...ledger,
     version: 1,
@@ -21786,20 +21972,19 @@ async function createProjectWithWarmPoolRetry(client, body, options) {
 }
 
 // src/cli/platform/helpers/backend-packaging.ts
-import { spawn as spawn3 } from "node:child_process";
-import { mkdtemp, readdir as readdir4, rm as rm9 } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path69 from "node:path";
+import { mkdtemp as mkdtemp2, readdir as readdir5, rm as rm10 } from "node:fs/promises";
+import { tmpdir as tmpdir2 } from "node:os";
+import path70 from "node:path";
 async function directoryHasRuntimeConfig(dir) {
   if (!await pathExists(dir)) {
     return false;
   }
-  const entries = await readdir4(dir);
+  const entries = await readdir5(dir);
   return entries.some((name) => name.endsWith(".runtimeconfig.json"));
 }
 function runDotnetPublish(projectDir, outputDir) {
   return new Promise((resolve, reject) => {
-    const child = spawn3(
+    const child = spawnCommand(
       "dotnet",
       [
         "publish",
@@ -21814,8 +21999,7 @@ function runDotnetPublish(projectDir, outputDir) {
       ],
       {
         cwd: projectDir,
-        env: process.env,
-        shell: process.platform === "win32"
+        env: process.env
       }
     );
     let output4 = "";
@@ -21830,22 +22014,22 @@ function runDotnetPublish(projectDir, outputDir) {
   });
 }
 async function findCsproj(projectDir) {
-  const entries = await readdir4(projectDir);
+  const entries = await readdir5(projectDir);
   const csproj = entries.find((name) => name.endsWith(".csproj"));
-  return csproj ? path69.join(projectDir, csproj) : null;
+  return csproj ? path70.join(projectDir, csproj) : null;
 }
 async function prepareBackendPackagingDirectory(args) {
-  const sourceDirectory = path69.resolve(args.sourceDirectory);
+  const sourceDirectory = path70.resolve(args.sourceDirectory);
   if (args.publishDirectory?.trim()) {
     return {
-      directory: path69.resolve(args.publishDirectory),
+      directory: path70.resolve(args.publishDirectory),
       packagingMode: "published"
     };
   }
   if (await directoryHasRuntimeConfig(sourceDirectory)) {
     return { directory: sourceDirectory, packagingMode: "published" };
   }
-  const publishSubdir = path69.join(sourceDirectory, "publish");
+  const publishSubdir = path70.join(sourceDirectory, "publish");
   if (await directoryHasRuntimeConfig(publishSubdir)) {
     return { directory: publishSubdir, packagingMode: "published" };
   }
@@ -21856,19 +22040,19 @@ async function prepareBackendPackagingDirectory(args) {
   if (!csproj) {
     return { directory: sourceDirectory, packagingMode: "source" };
   }
-  const tempRoot = await mkdtemp(
-    path69.join(tmpdir(), "apitogo-dotnet-publish-")
+  const tempRoot = await mkdtemp2(
+    path70.join(tmpdir2(), "apitogo-dotnet-publish-")
   );
-  const outputDir = path69.join(tempRoot, "publish");
+  const outputDir = path70.join(tempRoot, "publish");
   const result = await runDotnetPublish(sourceDirectory, outputDir);
   if (result.exitCode !== 0) {
-    await rm9(tempRoot, { recursive: true, force: true });
+    await rm10(tempRoot, { recursive: true, force: true });
     throw new Error(
       `dotnet publish failed (exit ${result.exitCode ?? "unknown"}): ${result.output.slice(-2e3)}`
     );
   }
   if (!await directoryHasRuntimeConfig(outputDir)) {
-    await rm9(tempRoot, { recursive: true, force: true });
+    await rm10(tempRoot, { recursive: true, force: true });
     throw new Error(
       "dotnet publish completed but no *.runtimeconfig.json was found in the output directory."
     );
@@ -21877,7 +22061,7 @@ async function prepareBackendPackagingDirectory(args) {
     directory: outputDir,
     packagingMode: "published",
     cleanup: async () => {
-      await rm9(tempRoot, { recursive: true, force: true });
+      await rm10(tempRoot, { recursive: true, force: true });
     }
   };
 }
@@ -21904,13 +22088,13 @@ function formatJobStatusResponse(options) {
 
 // src/cli/platform/helpers/openapi.ts
 import { promises as fs7 } from "node:fs";
-import path70 from "node:path";
+import path71 from "node:path";
 import SwaggerParser from "@apidevtools/swagger-parser";
 import YAML2 from "yaml";
 async function validateOpenApiFile(filePath) {
-  const resolved = path70.resolve(filePath);
+  const resolved = path71.resolve(filePath);
   const content = await fs7.readFile(resolved, "utf8");
-  const ext = path70.extname(resolved).toLowerCase();
+  const ext = path71.extname(resolved).toLowerCase();
   let parsed;
   try {
     parsed = ext === ".json" ? JSON.parse(content) : YAML2.parse(content);
@@ -21953,14 +22137,14 @@ async function validateOpenApiFile(filePath) {
 
 // src/cli/platform/helpers/zip.ts
 import { createReadStream as createReadStream2, createWriteStream as createWriteStream2, promises as fs8 } from "node:fs";
-import { tmpdir as tmpdir2 } from "node:os";
-import path71 from "node:path";
+import { tmpdir as tmpdir3 } from "node:os";
+import path72 from "node:path";
 import { ZipArchive } from "archiver";
 async function packageBackendDirectory(sourceDirectory, extraExcludes = []) {
-  const resolved = path71.resolve(sourceDirectory);
+  const resolved = path72.resolve(sourceDirectory);
   const files = await collectPackageableFiles(resolved, extraExcludes);
-  const zipPath = path71.join(
-    tmpdir2(),
+  const zipPath = path72.join(
+    tmpdir3(),
     `apitogo-backend-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`
   );
   await new Promise((resolve, reject) => {
@@ -21971,8 +22155,8 @@ async function packageBackendDirectory(sourceDirectory, extraExcludes = []) {
     output4.on("error", reject);
     archive.pipe(output4);
     for (const rel2 of files) {
-      archive.append(createReadStream2(path71.join(resolved, rel2)), {
-        name: rel2.split(path71.sep).join("/")
+      archive.append(createReadStream2(path72.join(resolved, rel2)), {
+        name: rel2.split(path72.sep).join("/")
       });
     }
     void archive.finalize();
@@ -23523,11 +23707,11 @@ async function resolveProjectIdForPublish(client, config2, args, wait, progress,
 }
 
 // src/cli/platform/tools/dev-portal-site-build.ts
-import path75 from "node:path";
+import path76 from "node:path";
 
 // src/cli/platform/helpers/dev-portal-site-api-url.ts
-import { readdir as readdir5, readFile as readFile27, writeFile as writeFile21 } from "node:fs/promises";
-import path72 from "node:path";
+import { readdir as readdir6, readFile as readFile27, writeFile as writeFile21 } from "node:fs/promises";
+import path73 from "node:path";
 var SITE_API_BASE_URL_ENV_KEY = "VITE_APITOGO_AUTHENTICATION_API_BASE_URL";
 var PLACEHOLDER_HOST_MARKERS = [
   "dp-example.azurecontainerapps.io",
@@ -23548,10 +23732,10 @@ function isPlaceholderDevPortalApiUrl(apiBaseUrl) {
   return PLACEHOLDER_HOST_MARKERS.some((marker) => normalized.includes(marker));
 }
 async function readSiteApiBaseUrl(sourceDirectory) {
-  const resolved = path72.resolve(sourceDirectory);
+  const resolved = path73.resolve(sourceDirectory);
   for (const envFile of [".env", ".env.production"]) {
     try {
-      const content = await readFile27(path72.join(resolved, envFile), "utf8");
+      const content = await readFile27(path73.join(resolved, envFile), "utf8");
       const lines = [...content.matchAll(ENV_LINE_GLOBAL_RE)];
       if (lines.length === 0) {
         continue;
@@ -23576,11 +23760,11 @@ async function readSiteApiBaseUrl(sourceDirectory) {
   return null;
 }
 async function patchSiteApiBaseUrl(sourceDirectory, apiBaseUrl) {
-  const resolved = path72.resolve(sourceDirectory);
+  const resolved = path73.resolve(sourceDirectory);
   const line2 = `${SITE_API_BASE_URL_ENV_KEY}=${apiBaseUrl}`;
   let patchedExisting = false;
   for (const envFile of [".env.production", ".env"]) {
-    const envPath = path72.join(resolved, envFile);
+    const envPath = path73.join(resolved, envFile);
     try {
       const content = await readFile27(envPath, "utf8");
       const withoutAssignments = content.replace(ENV_LINE_GLOBAL_RE, "").replace(/\n{3,}/g, "\n\n").trimEnd();
@@ -23594,7 +23778,7 @@ ${line2}
     }
   }
   if (!patchedExisting) {
-    await writeFile21(path72.join(resolved, ".env"), `${line2}
+    await writeFile21(path73.join(resolved, ".env"), `${line2}
 `);
   }
 }
@@ -23602,7 +23786,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 = path72.resolve(args.sourceDirectory);
+  const sourceDirectory = path73.resolve(args.sourceDirectory);
   const explicit = args.apiBaseUrl?.trim();
   if (explicit && !isPlaceholderDevPortalApiUrl(explicit)) {
     await patchSiteApiBaseUrl(sourceDirectory, explicit);
@@ -23633,12 +23817,12 @@ async function ensureLiveSiteApiBaseUrlForBuild(_client, config2, args, resolveF
 async function* walkFiles(root) {
   let entries;
   try {
-    entries = await readdir5(root, { withFileTypes: true });
+    entries = await readdir6(root, { withFileTypes: true });
   } catch {
     return;
   }
   for (const entry of entries) {
-    const full = path72.join(root, entry.name);
+    const full = path73.join(root, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name === ".git") {
         continue;
@@ -23650,8 +23834,8 @@ async function* walkFiles(root) {
   }
 }
 async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiBaseUrl) {
-  const dist = path72.resolve(distDirectory);
-  const siteRoot = path72.dirname(dist);
+  const dist = path73.resolve(distDirectory);
+  const siteRoot = path73.dirname(dist);
   const fromEnv = expectedApiBaseUrl?.trim() || await readSiteApiBaseUrl(siteRoot) || await readSiteApiBaseUrl(dist);
   if (!fromEnv || isPlaceholderDevPortalApiUrl(fromEnv)) {
     throw new Error(
@@ -23687,7 +23871,7 @@ async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiB
 
 // src/cli/platform/tools/dev-portal.ts
 import { promises as fs10 } from "node:fs";
-import path74 from "node:path";
+import path75 from "node:path";
 
 // src/cli/platform/helpers/dev-portal-backend-job.ts
 var DEV_PORTAL_BACKEND_UPDATE_RESOURCE_TYPE = "DevPortalBackendUpdate";
@@ -23796,8 +23980,8 @@ async function snapshotBackendUpdateJobIds(client, projectId) {
 
 // src/cli/platform/helpers/tarball.ts
 import { createReadStream as createReadStream3, createWriteStream as createWriteStream3, promises as fs9 } from "node:fs";
-import { tmpdir as tmpdir3 } from "node:os";
-import path73 from "node:path";
+import { tmpdir as tmpdir4 } from "node:os";
+import path74 from "node:path";
 import { TarArchive } from "archiver";
 var DEV_PORTAL_DEPLOY_ARCHIVE_ROOT = "dist";
 function normalizeArchiveRoot(archiveRoot) {
@@ -23808,11 +23992,11 @@ function normalizeArchiveRoot(archiveRoot) {
   return `${trimmed}/`;
 }
 async function packageDirectoryAsTarGz(sourceDirectory, options) {
-  const resolved = path73.resolve(sourceDirectory);
+  const resolved = path74.resolve(sourceDirectory);
   const files = await collectPackageableFiles(resolved);
   const entryPrefix = options?.archiveRoot ? normalizeArchiveRoot(options.archiveRoot) : "";
-  const archivePath = path73.join(
-    tmpdir3(),
+  const archivePath = path74.join(
+    tmpdir4(),
     `apitogo-docs-${Date.now()}-${Math.random().toString(36).slice(2)}.tgz`
   );
   await new Promise((resolve, reject) => {
@@ -23823,8 +24007,8 @@ async function packageDirectoryAsTarGz(sourceDirectory, options) {
     output4.on("error", reject);
     archive.pipe(output4);
     for (const rel2 of files) {
-      const entryName = entryPrefix + rel2.split(path73.sep).join("/");
-      archive.append(createReadStream3(path73.join(resolved, rel2)), {
+      const entryName = entryPrefix + rel2.split(path74.sep).join("/");
+      archive.append(createReadStream3(path74.join(resolved, rel2)), {
         name: entryName
       });
     }
@@ -24066,7 +24250,7 @@ function validateDeployArchiveInput(args) {
 async function resolveDevPortalArchive(args) {
   validateDeployArchiveInput(args);
   if (args.archivePath?.trim()) {
-    const archivePath = path74.resolve(args.archivePath.trim());
+    const archivePath = path75.resolve(args.archivePath.trim());
     const stat7 = await fs10.stat(archivePath).catch(() => null);
     if (!stat7?.isFile()) {
       throw new Error(`archivePath is not a file: ${archivePath}`);
@@ -24131,7 +24315,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 = path75.resolve(args.sourceDirectory);
+  const sourceDirectory = path76.resolve(args.sourceDirectory);
   await buildProgress?.onStep("Ensuring live portal API URL");
   const apiBaseUrl = await ensureLiveSiteApiBaseUrlForBuild(
     client,
@@ -25637,7 +25821,7 @@ function resultLooksFailed(payload) {
   return parsed.status === "failed" || parsed.status === "blocked";
 }
 async function apply(argv) {
-  const sourceDirectory = path76.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path77.resolve(process.cwd(), argv.dir);
   let config2;
   try {
     config2 = loadConfig();
@@ -25707,7 +25891,7 @@ async function apply(argv) {
   if (canPromptInteractively && parsed?.status === "blocked" && parsed.reason === "project_not_found") {
     const resolution = await resolveProjectNotFoundInteractively(
       parsed,
-      path76.basename(sourceDirectory)
+      path77.basename(sourceDirectory)
     );
     if (resolution) {
       effectiveProjectId = void 0;
@@ -25727,7 +25911,7 @@ async function apply(argv) {
   while (canPromptInteractively && parsed?.status === "blocked" && parsed.reason === "project_name_exists") {
     const resolution = await resolveProjectNameExistsInteractively(
       parsed,
-      effectiveProjectName ?? path76.basename(sourceDirectory)
+      effectiveProjectName ?? path77.basename(sourceDirectory)
     );
     if (!resolution) {
       break;
@@ -25798,11 +25982,11 @@ async function apply(argv) {
 }
 
 // src/cli/deploy/command.ts
-import path81 from "node:path";
+import path82 from "node:path";
 init_invariant();
 
 // src/cli/project/create-handler.ts
-import path77 from "node:path";
+import path78 from "node:path";
 import open2 from "open";
 init_invariant();
 
@@ -25825,13 +26009,13 @@ function modulesForConfig(config2) {
 }
 function assertConfigChecksOut(output4) {
   if (output4.status === "ok") return;
-  const count = output4.errors.length;
+  const count2 = output4.errors.length;
   throw new ProjectCreateError(
     "CONFIG_INVALID",
-    `The config has ${count} error${count === 1 ? "" : "s"}, so no project is created.`,
+    `The config has ${count2} error${count2 === 1 ? "" : "s"}, so no project is created.`,
     [
       ...output4.errors.slice(0, 5).map((issue4) => `- ${formatConfigIssue(issue4)}`),
-      ...count > 5 ? [`- and ${count - 5} more`] : [],
+      ...count2 > 5 ? [`- and ${count2 - 5} more`] : [],
       "Fix them (`apitogo check` lists everything), then run `apitogo project create` again."
     ].join("\n")
   );
@@ -26028,7 +26212,13 @@ async function createLinkedProject(argv, dir, options = {}) {
     }
     const config2 = loadConfig();
     const client = new PlatformApiClient(config2);
-    const progress = createConsoleProgressReporter();
+    const progress = createConsoleProgressReporter(process.stderr, {
+      verbose: argv.verbose === true
+    });
+    if (!json)
+      printDiagnosticsToConsole(
+        `Creating your project: reserving hosting, setting up its addresses, then getting the website ready. This usually takes 1 to 3 minutes.${plan2 && plan2 !== "free" ? " Paying for the plan on the dashboard works too: this command goes on once the payment is in." : ""} Add --verbose to see every step.`
+      );
     const result = await createProjectV2(
       {
         dir,
@@ -26106,7 +26296,7 @@ async function createLinkedProject(argv, dir, options = {}) {
   }
 }
 async function createProject2(argv) {
-  const dir = path77.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path78.resolve(process.cwd(), argv.dir ?? ".");
   if (await isConfigV2(dir)) {
     await createLinkedProject(argv, dir);
     return;
@@ -26217,7 +26407,7 @@ async function confirm(question) {
 }
 
 // src/cli/deploy/stripe-key.ts
-import path78 from "node:path";
+import path79 from "node:path";
 init_invariant();
 var StripeKeyError = class extends ApitogoError {
   constructor(message, developerHint) {
@@ -26235,7 +26425,7 @@ async function ensureStripeKey(argv, deps) {
   if (!wantsPlans(argv.only)) return { status: "not-needed" };
   let resolved;
   try {
-    resolved = loadConfigV2(path78.resolve(process.cwd(), argv.dir)).resolved;
+    resolved = loadConfigV2(path79.resolve(process.cwd(), argv.dir)).resolved;
   } catch {
     return { status: "not-needed" };
   }
@@ -26278,12 +26468,12 @@ async function ensureStripeKey(argv, deps) {
 }
 
 // src/cli/deploy/v2.ts
-import { rm as rm10 } from "node:fs/promises";
+import { rm as rm11 } from "node:fs/promises";
 init_invariant();
 
 // src/cli/portal/report.ts
 import { access as access9 } from "node:fs/promises";
-import path79 from "node:path";
+import path80 from "node:path";
 
 // src/cli/deploy/gateway.ts
 import { createHash as createHash4 } from "node:crypto";
@@ -26302,7 +26492,7 @@ function isHostingNotActivated(error) {
     `${error.message} ${error.problem?.detail ?? ""}`
   );
 }
-var sha256 = (text) => createHash4("sha256").update(text).digest("hex");
+var sha256 = (text2) => createHash4("sha256").update(text2).digest("hex");
 function gatewayNotDeployableReason(gateway) {
   if (gateway.specs.length > 1)
     return "the platform takes one OpenAPI file per gateway, but the config lists several";
@@ -27751,7 +27941,7 @@ async function planPortalService(resolved, ledger) {
     const hash2 = await portalBuildHash(resolved, prepared);
     const previous = stepOf(ledger, "portal", "build");
     const built = await exists5(
-      path79.join(resolved.state.buildDir, "index.html")
+      path80.join(resolved.state.buildDir, "index.html")
     );
     if (previous?.status === "succeeded" && previous.hash === hash2 && built) {
       return {
@@ -27772,6 +27962,18 @@ async function planPortalService(resolved, ledger) {
     };
   } catch (error) {
     if (!(error instanceof ConfigError)) throw error;
+    const waitingFor = error.issues.every(
+      (item) => item.code === "PORTAL_MANIFEST_MISSING"
+    ) ? error.issues.map((item) => item.path.replace(/^services\./, "")) : [];
+    if (waitingFor.length > 0) {
+      return {
+        ...base,
+        action: "build",
+        reason: `will build after ${joinNames(waitingFor)} ${waitingFor.length === 1 ? "is" : "are"} deployed (deploy does this in order)`,
+        details: [],
+        issues: []
+      };
+    }
     return {
       ...base,
       action: "blocked",
@@ -27781,15 +27983,30 @@ async function planPortalService(resolved, ledger) {
     };
   }
 }
+function joinNames(names) {
+  if (names.length <= 1) return names[0] ?? "";
+  return `${names.slice(0, -1).join(", ")} and ${names.at(-1)}`;
+}
+function callersNeed(gateway) {
+  const access11 = gateway.policies.access;
+  const token = access11?.jwt ?? gateway.auth !== void 0;
+  const key = access11?.apiKey ?? true;
+  if (token && key) return "a sign-in token and an API key";
+  if (token) return "a sign-in token";
+  if (key) return "an API key";
+  return "nothing (the API is public)";
+}
+var count = (value) => value.toLocaleString("en-US");
+function perPeriod(calls, seconds) {
+  const period = seconds === 60 ? "minute" : seconds === 3600 ? "hour" : seconds === 86400 ? "day" : `${count(seconds)} seconds`;
+  return `${count(calls)} calls per ${period}`;
+}
 function describePolicies(gateway) {
   const policies = gateway.policies;
   return [
-    policies.access ? `access: ${[
-      policies.access.jwt === void 0 ? void 0 : `jwt ${policies.access.jwt ? "on" : "off"}`,
-      policies.access.apiKey === void 0 ? void 0 : `api key ${policies.access.apiKey ? "on" : "off"}`
-    ].filter(Boolean).join(", ")}` : void 0,
-    policies.rateLimit ? `rate limit: ${policies.rateLimit.calls} per ${policies.rateLimit.periodSeconds} s` : void 0,
-    policies.quota ? `quota: ${policies.quota.calls} per ${policies.quota.periodDays} day(s)` : void 0,
+    `callers need: ${callersNeed(gateway)}`,
+    policies.rateLimit ? `rate limit: ${perPeriod(policies.rateLimit.calls, policies.rateLimit.periodSeconds)}` : void 0,
+    policies.quota ? `quota: ${count(policies.quota.calls)} calls per ${policies.quota.periodDays === 1 ? "day" : `${policies.quota.periodDays} days`}` : void 0,
     policies.cors ? `cors: ${policies.cors.length} origin(s)` : void 0,
     policies.operations?.public ? `public operations: ${policies.operations.public.length}` : void 0
   ].filter((line2) => line2 !== void 0);
@@ -28110,7 +28327,7 @@ async function statusV2(dir, only, options = {}) {
     if (service === "portal") {
       const build2 = stepOf(ledger, "portal", "build");
       const built = await exists5(
-        path79.join(resolved.state.buildDir, "index.html")
+        path80.join(resolved.state.buildDir, "index.html")
       );
       const state = build2?.status === "failed" ? "build-failed" : build2?.status === "succeeded" && built ? "built" : "not-built";
       services.push({
@@ -28121,7 +28338,7 @@ async function statusV2(dir, only, options = {}) {
           ...build2?.finishedAt ? [`last build: ${build2.finishedAt}`] : [],
           ...build2?.status === "failed" ? [`error: ${build2.error ?? "unknown"}`] : [],
           ...state === "built" ? [
-            `output: ${path79.relative(resolved.configDir, resolved.state.buildDir)}`
+            `output: ${path80.relative(resolved.configDir, resolved.state.buildDir)}`
           ] : [],
           ...url2 ? [`url: ${url2}`] : ["url: not known (portal is not deployed yet)"],
           ...await hostingLine(resolved, manifest, options.hostingRemote)
@@ -28167,10 +28384,10 @@ async function statusV2(dir, only, options = {}) {
     services
   };
 }
-function formatPlan(output4) {
+function formatPlan(output4, options = {}) {
   return output4.services.flatMap((svc) => [
     `${svc.service}: ${svc.reason}`,
-    ...svc.details.map((line2) => `  ${line2}`),
+    ...svc.details.filter((line2) => options.verbose === true || !line2.startsWith("step ")).map((line2) => `  ${line2}`),
     ...svc.issues.map(
       (issue4) => `  problem: ${issue4.message}${issue4.hint ? ` ${issue4.hint}` : ""} [${issue4.code}]`
     )
@@ -28188,7 +28405,7 @@ function formatStatus(output4) {
 
 // src/cli/deploy/static-web-config.ts
 import { access as access10, writeFile as writeFile22 } from "node:fs/promises";
-import path80 from "node:path";
+import path81 from "node:path";
 var STATIC_WEB_CONFIG_FILE = "staticwebapp.config.json";
 var STATIC_WEB_CONFIG_VERSION = 3;
 var CLIENT_ONLY_ROUTES = [
@@ -28206,7 +28423,7 @@ var DEFAULT_STATIC_WEB_CONFIG = {
   }
 };
 async function ensureStaticWebConfig(buildDir) {
-  const file = path80.join(buildDir, STATIC_WEB_CONFIG_FILE);
+  const file = path81.join(buildDir, STATIC_WEB_CONFIG_FILE);
   try {
     await access10(file);
     return false;
@@ -28276,7 +28493,7 @@ function publishStep(deps, options) {
           );
         throw error;
       } finally {
-        await rm10(archive.archivePath, { force: true });
+        await rm11(archive.archivePath, { force: true });
       }
     }
   };
@@ -28455,11 +28672,14 @@ async function deployPlansService(options, deps, projectId, named) {
     { ...deps.plans, client },
     { force: options.force }
   );
+  const planCount = resolved.plans?.file ? (await readPlansFile(resolved.plans.file).catch(() => [])).length : 0;
+  const billing = resolved.plans?.billing.provider;
   return {
     service: "plans",
     status: result.status,
     steps: result.steps,
     url: result.apiBaseUrl,
+    summary: `${planCount} plan${planCount === 1 ? "" : "s"}${billing && billing !== "none" ? `, billing: ${billing}` : ""}`,
     ...result.notes ? { notes: result.notes } : {}
   };
 }
@@ -28541,7 +28761,7 @@ async function deployPortal(options, deps, projectId) {
 }
 function formatDeploy(output4) {
   return output4.services.flatMap((result) => {
-    const url2 = result.url ? ` (${result.url})` : "";
+    const url2 = result.summary ? `, ${result.summary}` : result.url ? ` (${result.url})` : "";
     const ops = result.operationCount !== void 0 ? `, ${result.operationCount} operation(s)` : "";
     const head = result.status === "deployed" ? `${result.service}: deployed${result.environment ? ` to ${result.environment}` : ""}${url2}${ops}` : result.status === "unchanged" ? `${result.service}: unchanged, nothing to publish${url2}` : `${result.service}: skipped, ${result.reason}`;
     return [
@@ -28557,7 +28777,7 @@ function formatDeploy(output4) {
 // src/cli/deploy/command.ts
 async function ensureLinkedProject(argv, deps) {
   if (argv.projectId?.trim() || deps.envProjectId?.trim()) return true;
-  const dir = path81.resolve(process.cwd(), argv.dir);
+  const dir = path82.resolve(process.cwd(), argv.dir);
   let linked;
   try {
     linked = Boolean(loadConfigV2(dir).resolved.project.id);
@@ -28609,7 +28829,7 @@ async function deployProject(argv) {
     const config2 = loadConfig();
     const output4 = await deployV2(
       {
-        dir: path81.resolve(process.cwd(), argv.dir),
+        dir: path82.resolve(process.cwd(), argv.dir),
         only: Array.isArray(argv.only) ? argv.only.join(",") : argv.only,
         projectId: argv.projectId,
         env: argv.env,
@@ -28653,7 +28873,7 @@ async function reportFailure(error, json) {
 
 // src/cli/cmds/deploy.ts
 var deploy_default = {
-  desc: "Deploy to the API ToGo platform: config version 2 publishes the portal; version 1 deploys apihub, portal backend and portal frontend",
+  desc: "Deploy the project to API ToGo: the services in apitogo.config.json (identity, gateway, plans, portal), each only when it changed",
   command: "deploy",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
@@ -28665,17 +28885,19 @@ var deploy_default = {
     describe: "Override project GUID"
   }).option("project-name", {
     type: "string",
-    describe: "Version 1: display name when creating a project. Version 2 ignores it: the project is made by `apitogo project create` and named by project.name"
+    describe: "Older projects only. The project's name is project.name in apitogo.config.json",
+    hidden: true
   }).option("platform-plan", {
     type: "string",
-    describe: "Version 1: platform hosting tier. Version 2 ignores it: a project made by `apitogo project create` is on the Free plan",
+    describe: "Older projects only. Choose the project's plan with `apitogo project create --plan`, or change it on the dashboard",
+    hidden: true,
     choices: ["free", "starter", "professional"]
   }).option("only", {
     type: "string",
-    describe: "Limit to resources. Version 1: apihub, portal-backend, portal-frontend. Version 2: portal, gateway, identity, plans (comma-separated)"
+    describe: "Deploy only these services, comma separated: portal, gateway, identity, plans"
   }).option("env", {
     type: "string",
-    describe: "Config version 2: Static Web App environment (default: production)"
+    describe: "Portal environment to publish to (default: production)"
   }).option("force", {
     type: "boolean",
     describe: "Force redeploy of selected resources even when healthy",
@@ -28683,7 +28905,7 @@ var deploy_default = {
   }).option("yes", {
     alias: "y",
     type: "boolean",
-    describe: "Config version 2: confirm a change that cannot be undone, such as switching the identity provider",
+    describe: "Confirm a change that cannot be undone, such as switching the identity provider",
     default: false
   }).option("resume-from", {
     type: "string",
@@ -28694,7 +28916,7 @@ var deploy_default = {
     default: true
   }).option("verbose", {
     type: "boolean",
-    describe: "Config version 2: show the full build log (by default only the result of each service is printed)",
+    describe: "Show the full build log (by default only the result of each service is printed)",
     default: false
   }).option("json", {
     type: "boolean",
@@ -28703,7 +28925,7 @@ var deploy_default = {
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo deploy" });
-    if (await isConfigV2(path82.resolve(process.cwd(), argv.dir))) {
+    if (await isConfigV2(path83.resolve(process.cwd(), argv.dir))) {
       await deployProject(argv);
       return;
     }
@@ -28712,8 +28934,8 @@ var deploy_default = {
 };
 
 // src/cli/export/handler.ts
-import { mkdir as mkdir18, writeFile as writeFile23 } from "node:fs/promises";
-import path83 from "node:path";
+import { mkdir as mkdir19, writeFile as writeFile23 } from "node:fs/promises";
+import path84 from "node:path";
 init_invariant();
 var ExportError = class extends ApitogoError {
   constructor(message, developerHint) {
@@ -28727,7 +28949,7 @@ async function exportOpenApi(args, deps) {
       `Cannot export "${args.target}".`,
       "Only `apitogo export openapi` exists."
     );
-  const dir = path83.resolve(process.cwd(), args.dir ?? ".");
+  const dir = path84.resolve(process.cwd(), args.dir ?? ".");
   if (!await isConfigV2(dir))
     throw new ExportError(
       "This command needs a config version 2 project.",
@@ -28740,9 +28962,9 @@ async function exportOpenApi(args, deps) {
       "This folder is not linked to a project.",
       "Run `apitogo project create`, or pass --project-id."
     );
-  let text;
+  let text2;
   try {
-    text = await deps.client.getGatewayOpenApi(projectId);
+    text2 = await deps.client.getGatewayOpenApi(projectId);
   } catch (error) {
     if (error instanceof PlatformApiError && error.status === 404)
       throw new ExportError(
@@ -28751,11 +28973,11 @@ async function exportOpenApi(args, deps) {
       );
     throw error;
   }
-  if (!args.out) return { text };
-  const file = path83.resolve(process.cwd(), args.out);
-  await mkdir18(path83.dirname(file), { recursive: true });
-  await writeFile23(file, text);
-  return { text, file };
+  if (!args.out) return { text: text2 };
+  const file = path84.resolve(process.cwd(), args.out);
+  await mkdir19(path84.dirname(file), { recursive: true });
+  await writeFile23(file, text2);
+  return { text: text2, file };
 }
 async function exportCommand(args) {
   try {
@@ -28777,7 +28999,7 @@ async function exportCommand(args) {
 
 // src/cli/cmds/export.ts
 var export_default = {
-  desc: "Print or save the OpenAPI file the platform publishes for your gateway (config version 2)",
+  desc: "Print or save the OpenAPI file the platform publishes for your gateway",
   command: "export <target>",
   builder: (yargs2) => yargs2.positional("target", {
     type: "string",
@@ -28846,8 +29068,8 @@ import open3 from "open";
 import colors14 from "picocolors";
 
 // src/cli/platform/device-auth.ts
-function url(apiUrl, path97) {
-  return `${apiUrl}${path97.startsWith("/") ? path97 : `/${path97}`}`;
+function url(apiUrl, path98) {
+  return `${apiUrl}${path98.startsWith("/") ? path98 : `/${path98}`}`;
 }
 async function requestDeviceCode(apiUrl) {
   const response = await fetchWithRetry(
@@ -29029,7 +29251,7 @@ var logout_default = {
 };
 
 // src/cli/portal/commands.ts
-import path84 from "node:path";
+import path85 from "node:path";
 init_invariant();
 function parseOnly(value) {
   if (value === void 0) return void 0;
@@ -29046,7 +29268,7 @@ function parseOnly(value) {
 async function run2(command2, argv, compute, format) {
   const json = argv.json === true;
   try {
-    const dir = path84.resolve(process.cwd(), argv.dir ?? ".");
+    const dir = path85.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}.`,
@@ -29082,7 +29304,7 @@ var plan = (argv) => run2(
     gatewayDryRun: gatewayDryRun(),
     plansRemote: plansRemote()
   }),
-  formatPlan
+  (output4) => formatPlan(output4, { verbose: argv.verbose === true })
 );
 function gatewayRemote() {
   try {
@@ -29152,7 +29374,7 @@ var statusOfProject = (argv) => run2(
 
 // src/cli/cmds/plan.ts
 var plan_default = {
-  desc: "Show what deploy would do for each service of a config version 2 project (changes nothing)",
+  desc: "Show what deploy would do for each service (changes nothing)",
   command: "plan",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
@@ -29163,6 +29385,10 @@ var plan_default = {
   }).option("only", {
     type: "string",
     describe: "Only these services, comma separated (portal, gateway, identity, plans)"
+  }).option("verbose", {
+    type: "boolean",
+    default: false,
+    describe: "Also show each service's steps and their state"
   }).option("json", {
     type: "boolean",
     default: false,
@@ -29176,11 +29402,11 @@ var plan_default = {
 
 // src/cli/cmds/project-create.ts
 var project_create_default = {
-  desc: "Create an API ToGo platform project. In a config version 2 folder: free plan, hosting for the enabled services, and project.id written into the config",
+  desc: "Create the API ToGo project for this folder: hosting for its services on the plan you choose, and project.id written into apitogo.config.json",
   command: "project create",
   builder: (yargs2) => yargs2.option("name", {
     type: "string",
-    describe: "Project display name (required for version 1; version 2 defaults to project.name)"
+    describe: "Project display name (default: project.name in apitogo.config.json)"
   }).option("dir", {
     type: "string",
     describe: "Project directory",
@@ -29192,12 +29418,13 @@ var project_create_default = {
     describe: "Optional project description"
   }).option("modules", {
     type: "string",
-    describe: "Version 1 only: comma-separated modules to activate (default: apihub). Version 2 takes them from the config (the portal needs dev-portal) and ignores this option",
+    describe: "Older projects only: comma-separated modules to activate. The services in apitogo.config.json decide them",
+    hidden: true,
     default: "apihub"
   }).option("plan", {
     type: "string",
     choices: ["free", "starter", "professional"],
-    describe: "Version 2: the platform plan of the new project (default: free). Starter and Professional are paid through the platform's own checkout, and a project needs one of them to sell paid plans"
+    describe: "The plan of the new project: free (default), starter or professional. Starter and Professional are paid through the platform's checkout, and a project needs one of them to sell paid plans"
   }).option("open", {
     type: "boolean",
     describe: "Open the checkout page in the browser for a paid plan (use --no-open to only print the link)",
@@ -29209,8 +29436,12 @@ var project_create_default = {
     hidden: true
   }).option("wait", {
     type: "boolean",
-    describe: "Wait until the hosting from the warm pool is ready before returning, once a platform plan is selected (always so in version 2). Use --no-wait to return sooner",
+    describe: "Wait until the hosting is ready before returning. Use --no-wait to return sooner",
     default: true
+  }).option("verbose", {
+    type: "boolean",
+    default: false,
+    describe: "Show every platform step, including hosting details"
   }).option("json", {
     type: "boolean",
     describe: "Print raw JSON only",
@@ -29224,7 +29455,7 @@ var project_create_default = {
 
 // src/cli/cmds/remove.ts
 var remove_default = {
-  desc: "Remove a service section from a config version 2 project (its files are kept unless --delete-files)",
+  desc: "Remove a service from the project (its files are kept unless --delete-files)",
   command: "remove <service>",
   builder: (yargs2) => yargs2.positional("service", {
     type: "string",
@@ -29262,14 +29493,14 @@ var remove_default = {
 
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path87 from "node:path";
+import path88 from "node:path";
 
 // src/vite/dev-server.ts
 init_logger();
 import fs11 from "node:fs/promises";
 import http from "node:http";
 import https from "node:https";
-import path86 from "node:path";
+import path87 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -29302,7 +29533,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path85 from "node:path";
+import path86 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -29355,7 +29586,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path85.join(vite.config.publicDir, "pagefind");
+  const outputPath = path86.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -29374,9 +29605,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs11.readFile(path86.resolve(dir, config2.https.key)),
-      fs11.readFile(path86.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs11.readFile(path86.resolve(dir, config2.https.ca)) : void 0
+      fs11.readFile(path87.resolve(dir, config2.https.key)),
+      fs11.readFile(path87.resolve(dir, config2.https.cert)),
+      config2.https.ca ? fs11.readFile(path87.resolve(dir, config2.https.ca)) : void 0
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -29393,7 +29624,7 @@ var DevServer = class {
     );
     const server = await this.createNodeServer(config2);
     if (config2.search?.type === "pagefind" && viteConfig.publicDir !== false) {
-      const publicRoot = path86.resolve(
+      const publicRoot = path87.resolve(
         this.options.dir,
         typeof viteConfig.publicDir === "string" ? viteConfig.publicDir : "public"
       );
@@ -29410,7 +29641,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 = path86.posix.join(
+            const entryPath = path87.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -29575,7 +29806,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson3 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  let dir = path87.resolve(process.cwd(), argv.dir);
+  let dir = path88.resolve(process.cwd(), argv.dir);
   if (await isConfigV2(dir)) {
     const { root, prepared } = await preparePortalWorkspace(dir, "development");
     dir = root;
@@ -29674,7 +29905,7 @@ var run_default = {
 };
 
 // src/cli/secrets/handler.ts
-import path88 from "node:path";
+import path89 from "node:path";
 init_invariant();
 var SECRET_NAME = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
 var SecretsError = class extends ApitogoError {
@@ -29686,7 +29917,7 @@ var SecretsError = class extends ApitogoError {
 async function resolveProjectId2(argv, deps) {
   const explicit = argv.projectId?.trim();
   if (explicit) return explicit;
-  const dir = path88.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path89.resolve(process.cwd(), argv.dir ?? ".");
   if (await isConfigV2(dir)) {
     const id = loadConfigV2(dir).resolved.project.id;
     if (id) return id;
@@ -29846,12 +30077,12 @@ var secrets_default = {
 };
 
 // src/cli/cmds/status.ts
-import path90 from "node:path";
+import path91 from "node:path";
 
 // src/cli/status/handler.ts
-import path89 from "node:path";
+import path90 from "node:path";
 async function status(argv) {
-  const sourceDirectory = path89.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path90.resolve(process.cwd(), argv.dir);
   let config2;
   try {
     config2 = loadConfig();
@@ -29920,12 +30151,40 @@ async function status(argv) {
     liveError,
     sourceDirectory
   };
-  console.log(JSON.stringify(payload, null, argv.json ? void 0 : 2));
+  if (argv.json) {
+    console.log(JSON.stringify(payload));
+    return;
+  }
+  for (const line2 of formatAccountStatus(payload)) console.log(line2);
+}
+var text = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+function formatAccountStatus(payload) {
+  const tenant = payload.account.tenant ?? {};
+  const who = text(tenant.email) ?? text(tenant.displayName) ?? "unknown";
+  const lines = [`Signed in as ${who}.`];
+  if (!payload.projectId) {
+    lines.push(
+      "No project here. Run `apitogo create` to start one, or run this in a project folder."
+    );
+    return lines;
+  }
+  const project = payload.project ?? {};
+  const name = text(project.name) ?? payload.projectId;
+  const state = text(project.status);
+  lines.push(`Project: ${name}${state ? ` (${state})` : ""}`);
+  if (payload.liveError) lines.push(`Live check: ${payload.liveError}`);
+  else if (payload.live) {
+    const ok = payload.live.ok ?? payload.live.healthy ?? payload.live.status;
+    lines.push(
+      `Live check: ${typeof ok === "boolean" ? ok ? "online" : "not reachable" : String(ok ?? "done")}`
+    );
+  }
+  return lines;
 }
 
 // src/cli/cmds/status.ts
 var status_default = {
-  desc: "Show the state of each service (config version 2), or account, project and live readiness (version 1)",
+  desc: "Show the state of each service of the project, or of your account outside a project",
   command: "status",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
@@ -29941,15 +30200,15 @@ var status_default = {
     default: false
   }).option("only", {
     type: "string",
-    describe: "Config version 2: only these services, comma separated (portal, gateway, identity, plans)"
+    describe: "Only these services, comma separated (portal, gateway, identity, plans)"
   }).option("json", {
     type: "boolean",
-    describe: "Print raw JSON only",
+    describe: "Print JSON instead of text",
     default: false
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo status" });
-    if (await isConfigV2(path90.resolve(process.cwd(), argv.dir))) {
+    if (await isConfigV2(path91.resolve(process.cwd(), argv.dir))) {
       await statusOfProject(argv);
       return;
     }
@@ -29958,11 +30217,11 @@ var status_default = {
 };
 
 // src/cli/cmds/teardown.ts
-import path93 from "node:path";
+import path94 from "node:path";
 
 // src/cli/teardown/command.ts
 init_invariant();
-import path91 from "node:path";
+import path92 from "node:path";
 import { createInterface as createInterface7 } from "node:readline/promises";
 
 // src/cli/teardown/v2.ts
@@ -30323,7 +30582,7 @@ async function teardownProject(argv) {
     const progress = createConsoleProgressReporter();
     const result = await teardownV2(
       {
-        dir: path91.resolve(process.cwd(), argv.dir),
+        dir: path92.resolve(process.cwd(), argv.dir),
         projectId: argv.projectId,
         only: Array.isArray(argv.only) ? argv.only.join(",") : argv.only,
         yes: argv.yes === true,
@@ -30382,7 +30641,7 @@ async function teardownProject(argv) {
 }
 
 // src/cli/teardown/handler.ts
-import path92 from "node:path";
+import path93 from "node:path";
 function resultLooksFailed3(payload) {
   try {
     const parsed = JSON.parse(payload);
@@ -30398,7 +30657,7 @@ async function teardown(argv) {
     );
     return;
   }
-  const sourceDirectory = path92.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path93.resolve(process.cwd(), argv.dir);
   let config2;
   try {
     config2 = loadConfig();
@@ -30447,7 +30706,7 @@ async function teardown(argv) {
 
 // src/cli/cmds/teardown.ts
 var teardown_default = {
-  desc: "Delete the linked API ToGo project. Config version 2 asks you to type the project name; local files are kept",
+  desc: "Delete the linked API ToGo project. You type the project name to confirm; local files are kept",
   command: "teardown",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
@@ -30459,11 +30718,11 @@ var teardown_default = {
     describe: "Override project GUID"
   }).option("only", {
     type: "string",
-    describe: "Config version 2: `gateway`, `identity` or `plans` removes just that service and keeps the project (`identity` deletes every user in it); other hosting is released only by deleting the whole project"
+    describe: "`gateway`, `identity` or `plans` removes just that service and keeps the project (`identity` deletes every user in it); other hosting is released only by deleting the whole project"
   }).option("yes", {
     alias: "y",
     type: "boolean",
-    describe: "Confirm without asking (version 1: required)",
+    describe: "Confirm without asking",
     default: false
   }).option("wait", {
     type: "boolean",
@@ -30476,7 +30735,7 @@ var teardown_default = {
   }),
   handler: async (argv) => {
     await captureEvent({ argv, event: "apitogo teardown" });
-    if (await isConfigV2(path93.resolve(process.cwd(), argv.dir))) {
+    if (await isConfigV2(path94.resolve(process.cwd(), argv.dir))) {
       await teardownProject(argv);
       return;
     }
@@ -30486,7 +30745,7 @@ var teardown_default = {
 
 // src/cli/teardown/reset-command.ts
 init_invariant();
-import path94 from "node:path";
+import path95 from "node:path";
 
 // src/cli/teardown/reset.ts
 init_invariant();
@@ -30609,7 +30868,7 @@ async function resetProject(argv) {
     const config2 = loadConfig();
     const result = await resetProjectV2(
       {
-        dir: path94.resolve(process.cwd(), argv.dir),
+        dir: path95.resolve(process.cwd(), argv.dir),
         projectId: argv.projectId,
         yes: argv.yes === true
       },
@@ -30673,7 +30932,7 @@ var test_reset_default = {
 };
 
 // src/cli/test-sign-in/handler.ts
-import path95 from "node:path";
+import path96 from "node:path";
 init_invariant();
 var TestSignInError = class extends ApitogoError {
   constructor(message, developerHint) {
@@ -30684,7 +30943,7 @@ var TestSignInError = class extends ApitogoError {
 async function resolveProjectId3(argv) {
   const explicit = argv.projectId?.trim();
   if (explicit) return explicit;
-  const dir = path95.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path96.resolve(process.cwd(), argv.dir ?? ".");
   if (await isConfigV2(dir)) {
     const id = loadConfigV2(dir).resolved.project.id;
     if (id) return id;
@@ -30822,38 +31081,38 @@ function createApitogoCli(argv) {
 }
 
 // src/cli/local-handoff.ts
-import { spawn as spawn4 } from "node:child_process";
+import { spawn as spawn2 } from "node:child_process";
 import { existsSync as existsSync8, realpathSync as realpathSync2 } from "node:fs";
-import path96 from "node:path";
+import path97 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 path96.resolve(cwd, next);
+    if (arg === "--dir" && next) return path97.resolve(cwd, next);
     if (arg?.startsWith("--dir=")) {
-      return path96.resolve(cwd, arg.slice("--dir=".length));
+      return path97.resolve(cwd, arg.slice("--dir=".length));
     }
   }
   return cwd;
 };
 var findLocalCli = (projectDir, runningRoot) => {
-  let dir = path96.resolve(projectDir);
+  let dir = path97.resolve(projectDir);
   let localPackageRoot;
   while (!localPackageRoot) {
-    const candidate = path96.join(dir, "node_modules", PACKAGE_NAME);
-    if (existsSync8(path96.join(candidate, "package.json"))) {
+    const candidate = path97.join(dir, "node_modules", PACKAGE_NAME);
+    if (existsSync8(path97.join(candidate, "package.json"))) {
       localPackageRoot = candidate;
-    } else if (dir === path96.dirname(dir)) {
+    } else if (dir === path97.dirname(dir)) {
       return void 0;
     } else {
-      dir = path96.dirname(dir);
+      dir = path97.dirname(dir);
     }
   }
   const localRoot = realpathSync2(localPackageRoot);
   if (localRoot === realpathSync2(runningRoot)) return void 0;
-  return path96.join(localRoot, "cli.js");
+  return path97.join(localRoot, "cli.js");
 };
 var handoffToLocalCli = async (argv, runningRoot) => {
   if (process.env[LOCAL_HANDOFF_ENV] || process.env.ZUDOKU_ENV === "internal") {
@@ -30865,9 +31124,9 @@ var handoffToLocalCli = async (argv, runningRoot) => {
   );
   if (!localCli) return void 0;
   printDiagnosticsToConsole(
-    `Using the project's local ${PACKAGE_NAME} (${path96.dirname(localCli)})`
+    `Using the project's local ${PACKAGE_NAME} (${path97.dirname(localCli)})`
   );
-  const child = spawn4(process.execPath, [localCli, ...argv], {
+  const child = spawn2(process.execPath, [localCli, ...argv], {
     stdio: "inherit",
     env: { ...process.env, [LOCAL_HANDOFF_ENV]: "1" }
   });