@lukoweb/apitogo 0.1.93 → 0.1.95

package/dist/cli/cli.js

@@ -734,7 +734,7 @@ import { stat } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path66) => stat(path66).then(() => true).catch(() => false);
+    fileExists = (path67) => stat(path67).then(() => true).catch(() => false);
   }
 });
 
@@ -5504,8 +5504,8 @@ var PlatformApiClient = class {
   constructor(config2) {
     this.config = config2;
   }
-  url(path66) {
-    return `${this.config.apiUrl}${path66.startsWith("/") ? path66 : `/${path66}`}`;
+  url(path67) {
+    return `${this.config.apiUrl}${path67.startsWith("/") ? path67 : `/${path67}`}`;
   }
   headers(extra) {
     return {
@@ -5515,9 +5515,9 @@ var PlatformApiClient = class {
       ...extra
     };
   }
-  async request(method, path66, init4) {
+  async request(method, path67, init4) {
     const response = await fetchWithRetry(
-      this.url(path66),
+      this.url(path67),
       {
         method,
         ...init4,
@@ -5717,15 +5717,15 @@ var PlatformApiClient = class {
       }
     );
   }
-  deleteDevPortalPage(projectId, path66) {
-    const query = new URLSearchParams({ path: path66 });
+  deleteDevPortalPage(projectId, path67) {
+    const query = new URLSearchParams({ path: path67 });
     return this.request(
       "DELETE",
       `/api/v1/projects/${projectId}/dev-portal/pages/files?${query.toString()}`
     );
   }
-  renameDevPortalPage(projectId, path66, newName) {
-    const query = new URLSearchParams({ path: path66 });
+  renameDevPortalPage(projectId, path67, newName) {
+    const query = new URLSearchParams({ path: path67 });
     return this.request(
       "POST",
       `/api/v1/projects/${projectId}/dev-portal/pages/files/rename?${query.toString()}`,
@@ -5896,8 +5896,8 @@ var PlatformApiClient = class {
   }
 };
 async function readFileBytes(filePath) {
-  const { readFile: readFile18 } = await import("node:fs/promises");
-  const buffer = await readFile18(filePath);
+  const { readFile: readFile19 } = await import("node:fs/promises");
+  const buffer = await readFile19(filePath);
   const arrayBuffer = new ArrayBuffer(buffer.byteLength);
   new Uint8Array(arrayBuffer).set(buffer);
   return arrayBuffer;
@@ -7317,8 +7317,8 @@ function normalizeActionKey(actionKey) {
   const trimmed = actionKey.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path67 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path67.startsWith("/") ? path67 : `/${path67}`}`;
+    const path68 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path68.startsWith("/") ? path68 : `/${path68}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -7327,8 +7327,8 @@ function normalizeActionKey(actionKey) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path66 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path66.startsWith("/") ? path66 : `/${path66}`}`;
+  const path67 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path67.startsWith("/") ? path67 : `/${path67}`}`;
 }
 async function applyGatewayPublicRoutes(client, projectId, routes, options) {
   const applied = [];
@@ -9395,7 +9395,8 @@ var PLATFORM_PLAN_CATALOG = [
       "Paid end-user gateway plans (Stripe checkout for API subscribers)",
       "1 custom domain on the dev portal",
       "100k requests included; up to 1M requests / month",
-      "Stripe subscription billing with promotion codes at checkout"
+      "Stripe subscription billing with promotion codes at checkout",
+      "Standard support"
     ],
     limitations: [
       "Requires Stripe checkout to activate",
@@ -9415,7 +9416,8 @@ var PLATFORM_PLAN_CATALOG = [
       "3 custom domains",
       "1M requests included; up to 10M requests / month",
       "Advanced analytics and CDN for your API",
-      "Extended monitoring history and alerts"
+      "Extended monitoring history and alerts",
+      "Enterprise support"
     ],
     limitations: [
       "Requires Stripe checkout to activate",
@@ -9434,8 +9436,8 @@ function buildPlatformPlanSelectionAgentInstruction(quota) {
   const lines = [
     "Before calling ensure_platform_plan, explain the platform hosting tiers to the user using platformPlanCatalog from the bootstrap response or list_platform_plans.",
     "Free: $0/month, dev portal + API hub, no custom domain, free ($0) gateway/API plans only.",
-    "Starter: $99/month via Stripe, custom domain, paid gateway plans, production hosting.",
-    "Professional: $999/month via Stripe, higher limits, multiple domains, advanced analytics.",
+    "Starter: $99/month via Stripe, custom domain, paid gateway plans, production hosting, standard support.",
+    "Professional: $999/month via Stripe, higher limits, multiple domains, advanced analytics, enterprise support.",
     "This is separate from gateway/API plans (what end users pay for API access) configured in apitogo.config.json.",
     "If apitogo.config.json already has paid gateway plans (priceAmount > 0), warn before they pick Free: Free cannot publish paid API plans \u2014 they must choose Starter/Professional, or remove/zero those paid plans first. Never silently strip paid plans."
   ];
@@ -11405,8 +11407,8 @@ function normalizeActionKeyFormat(actionKey) {
   const trimmed = actionKey.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path67 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path67.startsWith("/") ? path67 : `/${path67}`}`;
+    const path68 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path68.startsWith("/") ? path68 : `/${path68}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -11415,8 +11417,8 @@ function normalizeActionKeyFormat(actionKey) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path66 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path66.startsWith("/") ? path66 : `/${path66}`}`;
+  const path67 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path67.startsWith("/") ? path67 : `/${path67}`}`;
 }
 function normalizePublicRoute(route) {
   const trimmed = route.trim();
@@ -12533,7 +12535,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.93",
+  version: "0.1.95",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -13311,14 +13313,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path66 = []) => {
-  const transformed = transform(specification, path66);
+var traverse = (specification, transform, path67 = []) => {
+  const transformed = transform(specification, path67);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path66, key];
+    const currentPath = [...path67, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -13346,9 +13348,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path66 = ref.split("/").slice(1);
+  const path67 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path66) {
+  for (const segment of path67) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -13367,7 +13369,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path66) => {
+  const resolve = async (current, path67) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -13375,7 +13377,7 @@ var dereference = async (schema2, resolvers = []) => {
       visited.add(current);
       if (Array.isArray(current)) {
         for (let index = 0; index < current.length; index++) {
-          current[index] = await resolve(current[index], `${path66}/${index}`);
+          current[index] = await resolve(current[index], `${path67}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -13386,13 +13388,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path66);
+              result2 = await resolve(resolved, path67);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path66);
+            result2 = await resolve(resolved, path67);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -13405,7 +13407,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path66}/${key}`);
+          current[key] = await resolve(current[key], `${path67}/${key}`);
         }
       }
       visited.delete(current);
@@ -13444,9 +13446,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path66) => {
+  schema2 = traverse(schema2, (sub, path67) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path66 ?? [])) {
+      if (isSchemaPath(path67 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -13459,11 +13461,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path66) => {
+  schema2 = traverse(schema2, (schema3, path67) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path66?.slice(0, -1);
+      const parentPath = path67?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path66?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path67?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -13477,8 +13479,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path66) => {
-    if (path66?.includes("content") && path66.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path67) => {
+    if (path67?.includes("content") && path67.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -13504,11 +13506,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path66) => {
+  schema2 = traverse(schema2, (schema3, path67) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path66?.slice(0, -1);
+      const parentPath = path67?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path66?.[index - 1] === "content"
+        (_, index) => path67?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -13520,7 +13522,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path66) {
+function isSchemaPath(path67) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -13533,10 +13535,10 @@ function isSchemaPath(path66) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path66[index] === segment);
+      return location.every((segment, index) => path67[index] === segment);
     }
-    return path66.includes(location);
-  }) || path66.includes("schema") || path66.some((segment) => segment.endsWith("Schema"));
+    return path67.includes(location);
+  }) || path67.includes("schema") || path67.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -13618,13 +13620,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path66 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path67 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
   if (obj === null || typeof obj !== "object") return obj;
   const refPath = obj.__$ref;
   const isCircular = currentPath.has(obj) || typeof refPath === "string" && currentRefPaths.has(refPath);
   if (isCircular) {
     if (typeof refPath === "string") return SCHEMA_REF_PREFIX + refPath;
-    const circularProp = path66.find((p) => !OPENAPI_PROPS.has(p)) || path66[0];
+    const circularProp = path67.find((p) => !OPENAPI_PROPS.has(p)) || path67[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -13634,7 +13636,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path66, key],
+    [...path67, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -13669,7 +13671,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path66) => HttpMethods.map((k) => path66?.[k]).filter((op) => op != null)
+    (path67) => HttpMethods.map((k) => path67?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -13724,7 +13726,7 @@ var getAllSlugs = (ops, schemaTags = []) => {
 var getOperationSlugKey = (op) => [op.path, op.method, op.operationId, op.summary].filter(Boolean).join("-");
 var getAllOperations = (paths) => {
   const operations = Object.entries(paths ?? {}).flatMap(
-    ([path66, value]) => HttpMethods.flatMap((method) => {
+    ([path67, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -13744,7 +13746,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path66,
+        path: path67,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -14102,8 +14104,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path66, value]) => ({
-        path: path66,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path67, value]) => ({
+        path: path67,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -14268,7 +14270,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path66) => path66.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path67) => path67.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -14299,16 +14301,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup2 = (schema2, path66, filePath) => {
-  const parts = getSegmentsFromPath(path66);
+var lookup2 = (schema2, path67, filePath) => {
+  const parts = getSegmentsFromPath(path67);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path66 ? val : lookup2(schema2, val.$ref, filePath);
+      val = val.$ref === path67 ? val : lookup2(schema2, val.$ref, filePath);
     }
     if (val[part] === void 0) {
       throw new Error(
-        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path66}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path67}`
       );
     }
     val = val[part];
@@ -14553,8 +14555,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path66) => this.processedSchemas[path66]?.at(0);
-  getSchemasForPath = (path66) => this.processedSchemas[path66];
+  getLatestSchema = (path67) => this.processedSchemas[path67]?.at(0);
+  getSchemasForPath = (path67) => this.processedSchemas[path67];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -16964,14 +16966,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path66) => {
-  const segments = path66.split("/");
+var resolveRoutePath = (path67) => {
+  const segments = path67.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path66) => path66.includes("*") || /^\d+$/.test(path66);
+var isSkipped = (path67) => path67.includes("*") || /^\d+$/.test(path67);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -18449,8 +18451,8 @@ async function pathExists3(filePath) {
 }
 async function directoryHasEntries(dir) {
   try {
-    const { readdir: readdir3 } = await import("node:fs/promises");
-    const entries = await readdir3(dir);
+    const { readdir: readdir4 } = await import("node:fs/promises");
+    const entries = await readdir4(dir);
     return entries.length > 0;
   } catch {
     return false;
@@ -18504,12 +18506,13 @@ function buildCreateApitogoCliArgs(invocationArgs, projectName, options) {
   const cliArgs = [
     ...invocationArgs,
     projectName,
-    "--yes",
+    "--typescript",
+    "--eslint",
     "--skip-install",
     "--use-npm"
   ];
   if (options?.withExamples) {
-    cliArgs.push("--with-examples");
+    cliArgs.push("--include-examples");
   }
   return cliArgs;
 }
@@ -20892,13 +20895,388 @@ var dev_default = {
 };
 
 // src/cli/init/handler.ts
+import path63 from "node:path";
+
+// src/cli/scaffold/wire-docs.ts
+import {
+  access as access9,
+  lstat,
+  mkdir as mkdir13,
+  readdir as readdir3,
+  readFile as readFile17,
+  readlink,
+  symlink,
+  writeFile as writeFile16
+} from "node:fs/promises";
 import path62 from "node:path";
+var DOCS_DIR_WHITELIST = [
+  "docs",
+  "documents",
+  "documentation",
+  "doc"
+];
+var SKIP_SEARCH_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  ".next",
+  "coverage",
+  ".turbo",
+  ".cache",
+  ".apitogo"
+]);
+var PAGES_DIR = "pages";
+var CONFIG_FILENAME = "apitogo.config.json";
+async function pathExists5(filePath) {
+  try {
+    await access9(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isDirectory(filePath) {
+  try {
+    const stat4 = await lstat(filePath);
+    return stat4.isDirectory();
+  } catch {
+    return false;
+  }
+}
+function toPosix2(value) {
+  return value.split(path62.sep).join(path62.posix.sep);
+}
+function isWhitelistedDirName(name) {
+  return DOCS_DIR_WHITELIST.includes(name.toLowerCase());
+}
+function isInside(parent, child) {
+  const relative = path62.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path62.isAbsolute(relative);
+}
+async function collectMarkdownFiles(dir) {
+  const files = [];
+  let entries;
+  try {
+    entries = await readdir3(dir, { withFileTypes: true });
+  } catch {
+    return files;
+  }
+  for (const entry of entries) {
+    if (entry.name.startsWith(".")) {
+      continue;
+    }
+    const full = path62.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (SKIP_SEARCH_DIRS.has(entry.name) || entry.isSymbolicLink()) {
+        continue;
+      }
+      files.push(...await collectMarkdownFiles(full));
+      continue;
+    }
+    if ((entry.isFile() || entry.isSymbolicLink()) && /\.mdx?$/i.test(entry.name)) {
+      files.push(full);
+    }
+  }
+  return files;
+}
+async function collectSearchRoots(siteDirectory) {
+  const site = path62.resolve(siteDirectory);
+  const parent = path62.dirname(site);
+  const roots = [];
+  const add = (dir) => {
+    const resolved = path62.resolve(dir);
+    if (!roots.includes(resolved)) {
+      roots.push(resolved);
+    }
+  };
+  if (parent && parent !== site) {
+    add(parent);
+    try {
+      const entries = await readdir3(parent, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory() || SKIP_SEARCH_DIRS.has(entry.name)) {
+          continue;
+        }
+        add(path62.join(parent, entry.name));
+      }
+    } catch {
+    }
+  }
+  add(site);
+  return roots;
+}
+async function discoverNearbyDocsDirectories(siteDirectory) {
+  const site = path62.resolve(siteDirectory);
+  const sitePages = path62.join(site, PAGES_DIR);
+  const searchedDirectories = await collectSearchRoots(site);
+  const directories = [];
+  const seen = /* @__PURE__ */ new Set();
+  const consider = async (dir) => {
+    const resolved = path62.resolve(dir);
+    if (resolved === site || seen.has(resolved) || isInside(sitePages, resolved)) {
+      return;
+    }
+    if (!await isDirectory(resolved)) {
+      return;
+    }
+    const files = (await collectMarkdownFiles(resolved)).sort(
+      (a, b) => a.localeCompare(b)
+    );
+    if (files.length === 0) {
+      return;
+    }
+    seen.add(resolved);
+    directories.push({ sourceDirectory: resolved, files });
+  };
+  for (const root of searchedDirectories) {
+    if (isWhitelistedDirName(path62.basename(root))) {
+      await consider(root);
+    }
+    try {
+      const entries = await readdir3(root, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory() || SKIP_SEARCH_DIRS.has(entry.name)) {
+          continue;
+        }
+        if (!isWhitelistedDirName(entry.name)) {
+          continue;
+        }
+        await consider(path62.join(root, entry.name));
+      }
+    } catch {
+    }
+  }
+  return { directories, searchedDirectories };
+}
+function slugifyDirName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "docs";
+}
+async function allocateLinkName(pagesDir, sourceDirectory, used) {
+  const base = slugifyDirName(path62.basename(sourceDirectory));
+  const parent = slugifyDirName(path62.basename(path62.dirname(sourceDirectory)));
+  const candidates = [base, `${parent}-${base}`];
+  let index = 2;
+  while (true) {
+    const name = candidates.shift() ?? `${base}-${index++}`;
+    if (used.has(name)) {
+      continue;
+    }
+    const target = path62.join(pagesDir, name);
+    if (await pathExists5(target)) {
+      const stat4 = await lstat(target);
+      if (!stat4.isDirectory() || !await isManagedLinkDir(target)) {
+        continue;
+      }
+    }
+    used.add(name);
+    return name;
+  }
+}
+async function isManagedLinkDir(dir) {
+  try {
+    const entries = await readdir3(dir, { withFileTypes: true });
+    if (entries.length === 0) {
+      return true;
+    }
+    return entries.every(
+      (entry) => entry.isSymbolicLink() || entry.isDirectory()
+    );
+  } catch {
+    return false;
+  }
+}
+async function alreadyLinked(linkPath, sourcePath) {
+  try {
+    const stat4 = await lstat(linkPath);
+    if (!stat4.isSymbolicLink()) {
+      return false;
+    }
+    const current = await readlink(linkPath);
+    const resolved = path62.resolve(path62.dirname(linkPath), current);
+    return resolved === path62.resolve(sourcePath);
+  } catch {
+    return false;
+  }
+}
+async function linkMarkdownFile(sourcePath, linkPath) {
+  if (await alreadyLinked(linkPath, sourcePath)) {
+    return "exists";
+  }
+  if (await pathExists5(linkPath)) {
+    return "skipped";
+  }
+  await mkdir13(path62.dirname(linkPath), { recursive: true });
+  const relativeTarget = path62.relative(path62.dirname(linkPath), sourcePath);
+  await symlink(
+    relativeTarget,
+    linkPath,
+    process.platform === "win32" ? "file" : void 0
+  );
+  return "linked";
+}
+function isPlainObject4(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+async function applyDocsNavigation(siteDirectory, routes) {
+  if (routes.length === 0) {
+    return;
+  }
+  const configPath = path62.join(siteDirectory, CONFIG_FILENAME);
+  if (!await pathExists5(configPath)) {
+    return;
+  }
+  const raw = await readFile17(configPath, "utf8");
+  const parsed = JSON.parse(raw);
+  if (!isPlainObject4(parsed)) {
+    return;
+  }
+  parsed.navigation = mergeDocumentationNavigation(parsed.navigation, routes, {
+    force: false
+  });
+  await writeFile16(configPath, `${JSON.stringify(parsed, null, 2)}
+`, "utf8");
+}
+async function discoverAndWireDocs(siteDirectory) {
+  const site = path62.resolve(siteDirectory);
+  const pagesDir = path62.join(site, PAGES_DIR);
+  const { directories, searchedDirectories } = await discoverNearbyDocsDirectories(site);
+  if (directories.length === 0) {
+    return {
+      status: "not_found",
+      whitelist: DOCS_DIR_WHITELIST,
+      searchedDirectories,
+      sources: [],
+      fileCount: 0,
+      skippedCount: 0
+    };
+  }
+  await mkdir13(pagesDir, { recursive: true });
+  const usedNames = /* @__PURE__ */ new Set();
+  const sources = [];
+  const routes = [];
+  for (const directory of directories) {
+    const linkName = await allocateLinkName(
+      pagesDir,
+      directory.sourceDirectory,
+      usedNames
+    );
+    const linkDirectory = path62.join(pagesDir, linkName);
+    const linked = [];
+    const skipped = [];
+    for (const sourcePath of directory.files) {
+      const relativeSource = toPosix2(
+        path62.relative(directory.sourceDirectory, sourcePath)
+      );
+      const linkPath = path62.join(linkDirectory, relativeSource);
+      const result = await linkMarkdownFile(sourcePath, linkPath);
+      if (result === "skipped") {
+        skipped.push({
+          sourcePath,
+          reason: "target already exists and is not this source"
+        });
+        continue;
+      }
+      const relativeLink = toPosix2(path62.relative(site, linkPath));
+      const route = toRoutePath(relativeLink, PAGES_DIR);
+      linked.push({ sourcePath, linkPath, route, relativeSource });
+      routes.push(route);
+    }
+    sources.push({
+      sourceDirectory: directory.sourceDirectory,
+      linkDirectory,
+      linkName,
+      files: linked,
+      skipped
+    });
+  }
+  await applyDocsNavigation(site, routes);
+  const fileCount = sources.reduce(
+    (sum, source) => sum + source.files.length,
+    0
+  );
+  const skippedCount = sources.reduce(
+    (sum, source) => sum + source.skipped.length,
+    0
+  );
+  const status2 = fileCount === 0 ? "not_found" : skippedCount > 0 ? "partial" : "wired";
+  return {
+    status: status2,
+    whitelist: DOCS_DIR_WHITELIST,
+    searchedDirectories,
+    sources,
+    fileCount,
+    skippedCount
+  };
+}
+function siteRelative(siteDirectory, filePath) {
+  const relative = toPosix2(path62.relative(siteDirectory, filePath));
+  if (!relative) {
+    return ".";
+  }
+  if (path62.isAbsolute(relative)) {
+    return toPosix2(filePath);
+  }
+  if (relative.startsWith("..")) {
+    return relative;
+  }
+  return `./${relative}`;
+}
+function formatOpenApiDiscoveryLines(siteDirectory, openApiDiscovery) {
+  const status2 = String(openApiDiscovery.status ?? "unknown");
+  if (status2 === "wired") {
+    const input3 = typeof openApiDiscovery.openApiInput === "string" ? openApiDiscovery.openApiInput : typeof openApiDiscovery.openApiPath === "string" ? siteRelative(siteDirectory, openApiDiscovery.openApiPath) : "OpenAPI";
+    const title = typeof openApiDiscovery.openApiTitle === "string" ? ` (${openApiDiscovery.openApiTitle})` : "";
+    const apiPath = typeof openApiDiscovery.apiReferencePath === "string" ? openApiDiscovery.apiReferencePath : "/api";
+    return [`OpenAPI: wired ${input3}${title} \u2192 ${apiPath}`];
+  }
+  if (status2 === "skipped") {
+    return ["OpenAPI: search skipped"];
+  }
+  if (status2 === "invalid" || status2 === "wire_failed") {
+    const error = typeof openApiDiscovery.error === "string" ? `: ${openApiDiscovery.error}` : "";
+    return [`OpenAPI: found a spec but did not wire it${error}`];
+  }
+  return ["OpenAPI: none found nearby"];
+}
+function formatDocsDiscoveryLines(siteDirectory, docsDiscovery) {
+  if (docsDiscovery.status === "not_found") {
+    return [
+      `Docs: none found in ${DOCS_DIR_WHITELIST.join("/")}/ folders nearby`
+    ];
+  }
+  const lines = [
+    `Docs: linked ${docsDiscovery.fileCount} markdown file${docsDiscovery.fileCount === 1 ? "" : "s"} (not copied)`
+  ];
+  for (const source of docsDiscovery.sources) {
+    const from = siteRelative(siteDirectory, source.sourceDirectory);
+    const to = siteRelative(siteDirectory, source.linkDirectory);
+    lines.push(`  ${from} \u2192 ${to}`);
+    for (const file of source.files) {
+      lines.push(`    ${file.relativeSource} \u2192 ${file.route}`);
+    }
+    for (const skipped of source.skipped) {
+      lines.push(
+        `    skipped ${siteRelative(siteDirectory, skipped.sourcePath)}`
+      );
+    }
+  }
+  return lines;
+}
+function formatInitDiscoveryReport(siteDirectory, openApiDiscovery, docsDiscovery) {
+  return [
+    ...formatOpenApiDiscoveryLines(siteDirectory, openApiDiscovery),
+    ...formatDocsDiscoveryLines(siteDirectory, docsDiscovery)
+  ];
+}
+
+// src/cli/init/handler.ts
 function slugifyName2(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "dev-portal-site";
 }
 function resolveInitOutputDirectory(dirArg, name) {
-  const resolved = path62.resolve(process.cwd(), dirArg);
-  const base = path62.basename(resolved);
+  const resolved = path63.resolve(process.cwd(), dirArg);
+  const base = path63.basename(resolved);
   const isDot = dirArg === "." || dirArg === "./" || base === "." || resolved === process.cwd();
   if (isDot) {
     const fromName = name?.trim();
@@ -20908,7 +21286,7 @@ function resolveInitOutputDirectory(dirArg, name) {
       );
     }
     return {
-      outputDirectory: path62.resolve(process.cwd(), slugifyName2(fromName)),
+      outputDirectory: path63.resolve(process.cwd(), slugifyName2(fromName)),
       siteName: fromName
     };
   }
@@ -20942,10 +21320,7 @@ async function init2(argv) {
       siteName,
       includeDefaultPlans: false
     });
-    const manifestPath = await writeManifest(
-      result.outputDirectory,
-      manifest
-    );
+    const manifestPath = await writeManifest(result.outputDirectory, manifest);
     const secretsArtifacts = await writeScaffoldSecretsArtifacts(
       result.outputDirectory
     );
@@ -20960,9 +21335,15 @@ async function init2(argv) {
       result.outputDirectory,
       openapiSearch
     );
+    const docsDiscovery = await discoverAndWireDocs(result.outputDirectory);
     const siteValidation = await validateDevPortalSiteConfig(
       result.outputDirectory
     );
+    const discoveryReport = formatInitDiscoveryReport(
+      result.outputDirectory,
+      openApiDiscovery,
+      docsDiscovery
+    );
     const devCommand = "npm run dev";
     const response = {
       status: "succeeded",
@@ -20980,9 +21361,11 @@ async function init2(argv) {
       npmInstallCompleted: install,
       npmInstallDurationMs: npmInstall?.durationMs ?? null,
       openApiDiscovery,
+      docsDiscovery,
       openapiSearch,
       previewStarted: false,
       devCommand,
+      discoveryReport,
       message: `Dev portal created in ${result.outputDirectory}. Run \`${devCommand}\` there to preview locally.`,
       ...buildSiteValidationResponseFields(siteValidation)
     };
@@ -20995,6 +21378,9 @@ async function init2(argv) {
       printResultToConsole(
         `Portal scaffolded in ${result.outputDirectory}. Next: apitogo config, apitogo dev, then apitogo apply.`
       );
+      for (const line of discoveryReport) {
+        printDiagnosticsToConsole(line);
+      }
       if (!install) {
         printDiagnosticsToConsole(
           "Skipped npm install (--no-install). Run npm install before npm run dev."
@@ -21145,9 +21531,9 @@ var remove_default = {
 };
 
 // src/cli/status/handler.ts
-import path63 from "node:path";
+import path64 from "node:path";
 async function status(argv) {
-  const sourceDirectory = path63.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path64.resolve(process.cwd(), argv.dir);
   const config2 = loadConfig();
   const client = new PlatformApiClient(config2);
   let whoamiJson;
@@ -21227,7 +21613,7 @@ var status_default = {
 };
 
 // src/cli/teardown/handler.ts
-import path64 from "node:path";
+import path65 from "node:path";
 function resultLooksFailed3(payload) {
   try {
     const parsed = JSON.parse(payload);
@@ -21243,7 +21629,7 @@ async function teardown(argv) {
     );
     return;
   }
-  const sourceDirectory = path64.resolve(process.cwd(), argv.dir);
+  const sourceDirectory = path65.resolve(process.cwd(), argv.dir);
   const config2 = loadConfig();
   const client = new PlatformApiClient(config2);
   let projectId = argv.projectId?.trim();
@@ -21309,7 +21695,7 @@ var teardown_default = {
 
 // src/cli/common/outdated.ts
 import { existsSync as existsSync4, mkdirSync } from "node:fs";
-import { readFile as readFile17, writeFile as writeFile16 } from "node:fs/promises";
+import { readFile as readFile18, writeFile as writeFile17 } from "node:fs/promises";
 import { join } from "node:path";
 import colors10 from "picocolors";
 import { gt } from "semver";
@@ -21376,12 +21762,12 @@ function box(message, {
 
 // src/cli/common/xdg/lib.ts
 import { homedir } from "node:os";
-import path65 from "node:path";
+import path66 from "node:path";
 function defineDirectoryWithFallback(xdgName, fallback) {
   if (process.env[xdgName]) {
     return process.env[xdgName];
   } else {
-    return path65.join(homedir(), fallback);
+    return path66.join(homedir(), fallback);
   }
 }
 var XDG_CONFIG_HOME = defineDirectoryWithFallback(
@@ -21396,15 +21782,15 @@ var XDG_STATE_HOME = defineDirectoryWithFallback(
   "XDG_DATA_HOME",
   ".local/state"
 );
-var ZUDOKU_XDG_CONFIG_HOME = path65.join(
+var ZUDOKU_XDG_CONFIG_HOME = path66.join(
   XDG_CONFIG_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_DATA_HOME = path65.join(
+var ZUDOKU_XDG_DATA_HOME = path66.join(
   XDG_DATA_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_STATE_HOME = path65.join(
+var ZUDOKU_XDG_STATE_HOME = path66.join(
   XDG_STATE_HOME,
   CLI_XDG_FOLDER_NAME
 );
@@ -21456,7 +21842,7 @@ async function getVersionCheckInfo() {
   let versionCheckInfo;
   if (existsSync4(versionCheckPath)) {
     try {
-      versionCheckInfo = await readFile17(versionCheckPath, "utf-8").then(
+      versionCheckInfo = await readFile18(versionCheckPath, "utf-8").then(
         JSON.parse
       );
     } catch {
@@ -21481,7 +21867,7 @@ async function getVersionCheckInfo() {
       lastCheck: Date.now(),
       latestVersion
     };
-    await writeFile16(
+    await writeFile17(
       versionCheckPath,
       JSON.stringify(versionCheckInfo),
       "utf-8"

package/docs/cli/commands.md

@@ -29,7 +29,8 @@ same commands so agents and humans get identical behavior.
 | `init [dir]` | Named folder; `--install` (default), `--overwrite`, `--json`, `--openapi-search` |
 | `config` | Interactive on TTY; flags: `--openapi`, `--page-*`, `--plan`, `--backend`, `--theme`, `--patch`, `--json` |
 
-`npm create @lukoweb/apitogo@latest` remains an interactive alternative for new folders.
+`npx @lukoweb/create-apitogo@latest` remains an interactive alternative for new folders.
+Pass `--typescript --eslint` to skip those prompts. See [Install the CLI](./setup.md#scaffold-options).
 
 See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags.
 

package/docs/cli/overview.md

@@ -13,7 +13,7 @@ local files, preview with `apitogo dev`, and publish to APItoGo hosting with `ap
 
 ## What you get
 
-- Scaffold a local portal site (`npm create @lukoweb/apitogo@latest` or `apitogo init`)
+- Scaffold a local portal site (`npx @lukoweb/create-apitogo@latest` or `apitogo init`)
 - Shape backend, OpenAPI, plans, and docs pages via `apitogo config` and file edits
 - Preview locally (`apitogo dev`)
 - Publish to APItoGo hosting (`apitogo apply`) with platform plans **Free**, **Starter**, or

package/docs/cli/setup.md

@@ -23,10 +23,10 @@ need a global install — scaffold commands add it to your project and `npm inst
 
 ### New project (recommended)
 
-`npm create` scaffolds the site **and** installs `@lukoweb/apitogo` locally:
+`npx @lukoweb/create-apitogo` scaffolds the site **and** installs `@lukoweb/apitogo` locally:
 
 ```bash
-npm create @lukoweb/apitogo@latest
+npx @lukoweb/create-apitogo@latest
 cd your-project-name
 npx apitogo config       # interactive: backend, OpenAPI, pages, plans
 npm run dev
@@ -35,14 +35,28 @@ npm run dev
 Also works with `pnpm create @lukoweb/apitogo`, `yarn create @lukoweb/apitogo`, or
 `bunx @lukoweb/create-apitogo`.
 
-Non-interactive example:
+Non-interactive:
 
 ```bash
-npm create @lukoweb/apitogo@latest my-portal -- --yes --typescript
+npx @lukoweb/create-apitogo@latest my-portal --typescript --eslint
 cd my-portal
 npx apitogo config
 ```
 
+#### Scaffold options
+
+| Flag | Effect |
+| ---- | ------ |
+| `--typescript` / `--ts` | TypeScript project |
+| `--javascript` / `--js` | JavaScript project |
+| `--eslint` | Add ESLint config |
+| `--no-eslint` | Skip ESLint |
+| `--include-examples` | Add starter docs and a sample OpenAPI spec (off unless passed) |
+
+Omit flags to be prompted for TypeScript and ESLint. Example files are never prompted.
+
+See `@lukoweb/create-apitogo --help` for package manager and install flags.
+
 ### Scaffold into an existing folder
 
 `apitogo init` writes `package.json` with `@lukoweb/apitogo` as a dependency. Run **`npm install`**
@@ -63,7 +77,7 @@ to preview, then `apitogo apply` when ready to go live.
 
 | Situation | Command |
 | --------- | ------- |
-| After `npm create` or `npm install` in the project | `npx apitogo <command>` (e.g. `npx apitogo config`) |
+| After `npx @lukoweb/create-apitogo` or `npm install` in the project | `npx apitogo <command>` (e.g. `npx apitogo config`) |
 | Same, if `node_modules/.bin` is on your PATH | `apitogo <command>` |
 | One-off, no project yet | `npx @lukoweb/apitogo <command>` |
 | Optional global install | `npm install -g @lukoweb/apitogo` then `apitogo <command>` anywhere |

package/docs/cli/shape.md

@@ -13,10 +13,10 @@ Requires the **`apitogo`** CLI (`@lukoweb/apitogo`). If you have not installed i
 
 ## Happy path
 
-`npm create` installs `@lukoweb/apitogo` into the new project. Then run config via `npx`:
+`npx @lukoweb/create-apitogo` installs `@lukoweb/apitogo` into the new project. Then run config via `npx`:
 
 ```bash
-npm create @lukoweb/apitogo@latest my-portal -- --yes
+npx @lukoweb/create-apitogo@latest my-portal --typescript --eslint
 cd my-portal
 npx apitogo config         # backend, OpenAPI, pages, plans (apply each immediately)
 npm run dev                # http://localhost:3000

package/docs/configuration/make-config.mdx

@@ -20,7 +20,7 @@ on new scaffolds. The command does **not** change `redirects`.
 
 Install the CLI first — see [Install the CLI](../cli/setup.md). In short:
 
-- **New site:** `npm create @lukoweb/apitogo@latest` (installs `@lukoweb/apitogo` into the project)
+- **New site:** `npx @lukoweb/create-apitogo@latest` (installs `@lukoweb/apitogo` into the project)
 - **Existing folder:** `npx @lukoweb/apitogo init .` then `npm install`
 
 Run config from the project root with `npx apitogo config` (or `apitogo config` if

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.93",
+  "version": "0.1.95",
   "type": "module",
   "sideEffects": [
     "**/*.css",