@squadbase/vantage 0.2.3 → 0.3.1

package/dist/cli.js

@@ -1,1598 +1,17 @@
 #!/usr/bin/env node
-import { PAGE_EXTENSIONS, scanProject, vantagePlugin, generateArtifacts, VANTAGE_DIR, MANIFEST_SCHEMA_VERSION, FORBIDDEN_FILES, API_METHODS, PUBLIC_ENV_PREFIX, extractPageMeta } from './chunk-3QKPNWKJ.js';
-import './chunk-46QI6GFC.js';
-import './chunk-B7LLBNLV.js';
-import path2 from 'path';
-import pc3 from 'picocolors';
-import fs2 from 'fs';
-import { createRequire } from 'module';
-import { loadEnv, createServer, build as build$1 } from 'vite';
-import { build as build$2 } from 'esbuild';
-import { fileURLToPath } from 'url';
-import { spawn } from 'child_process';
+import { parseArgs, frameworkVersion, resolveQuickRoot, log, resolveRoot } from './chunk-OFFJ3OL5.js';
+import './chunk-C4MQRWXS.js';
+import path from 'path';
+import pc from 'picocolors';
 
 // @squadbase/vantage — generated build. Do not edit.
-var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
-  "json",
-  "help",
-  "force",
-  "verbose",
-  "version",
-  "all",
-  "list",
-  "regex",
-  "pages",
-  "apis",
-  "detail",
-  "h",
-  "v"
-]);
-function parseArgs(argv) {
-  const positionals = [];
-  const flags = {};
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg.startsWith("--")) {
-      const eq = arg.indexOf("=");
-      if (eq !== -1) {
-        flags[arg.slice(2, eq)] = arg.slice(eq + 1);
-        continue;
-      }
-      const key = arg.slice(2);
-      if (BOOLEAN_FLAGS.has(key)) {
-        flags[key] = true;
-        continue;
-      }
-      const next = argv[i + 1];
-      if (next !== void 0 && !next.startsWith("-")) {
-        flags[key] = next;
-        i++;
-      } else {
-        flags[key] = true;
-      }
-    } else if (arg.length > 1 && arg.startsWith("-") && !/^-\d/.test(arg)) {
-      for (const ch of arg.slice(1)) flags[ch] = true;
-    } else {
-      positionals.push(arg);
-    }
-  }
-  return { positionals, flags };
-}
-function applyApiBaseUrlFlag(args) {
-  const value = args.flags["api-base-url"];
-  if (typeof value === "string" && value.length) {
-    process.env.PUBLIC_API_BASE_URL = value;
-  }
-}
-function parsePort(value, fallback) {
-  if (typeof value === "string") {
-    const n = Number(value);
-    if (Number.isInteger(n) && n > 0 && n < 65536) return n;
-  }
-  return fallback;
-}
-function resolveRoot(flags) {
-  const raw = typeof flags.root === "string" ? flags.root : process.cwd();
-  return path2.resolve(raw);
-}
-function resolveQuickRoot(target) {
-  try {
-    const abs = path2.resolve(target);
-    const stat = fs2.statSync(abs);
-    if (stat.isDirectory()) return abs;
-    if (stat.isFile() && PAGE_EXTENSIONS.some((ext) => abs.endsWith(ext))) {
-      return path2.dirname(abs);
-    }
-  } catch {
-  }
-  return null;
-}
-var log = {
-  info: (msg) => console.log(msg),
-  step: (msg) => console.log(pc3.cyan("\u2192 ") + msg),
-  ok: (msg) => console.log(pc3.green("\u2713 ") + msg),
-  warn: (msg) => console.log(pc3.yellow("! ") + msg),
-  error: (msg) => console.error(pc3.red("\u2717 ") + msg),
-  brand: (msg) => console.log(pc3.bold(pc3.magenta("vantage ")) + msg)
-};
-function printDiagnostics(diags) {
-  for (const d of diags) {
-    const badge = d.severity === "error" ? pc3.red(pc3.bold(" ERROR ")) : pc3.yellow(pc3.bold(" WARN "));
-    console.log(`${badge} ${pc3.dim(d.code)} ${d.message}`);
-    if (d.files?.length) console.log(`        ${pc3.dim("files:")} ${d.files.join(", ")}`);
-    if (d.fix) console.log(`        ${pc3.dim("fix:")} ${d.fix}`);
-  }
-}
-function printJson(payload) {
-  process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
-}
-function frameworkVersion() {
-  try {
-    const url = new URL("../package.json", import.meta.url);
-    const pkg = JSON.parse(fs2.readFileSync(url, "utf8"));
-    return pkg.version;
-  } catch {
-    return "0.0.0";
-  }
-}
-
-// src/cli/add.ts
-var PKG = "@squadbase/vantage";
-function toPascalCase(segment) {
-  const cleaned = segment.replace(/\[|\]|\./g, "").replace(/\.\.\./g, "");
-  const words = cleaned.split(/[^a-zA-Z0-9]+/).filter(Boolean);
-  const pascal = words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
-  return /^[A-Za-z]/.test(pascal) ? pascal : "Page";
-}
-function pageTemplate(name) {
-  const last = name.split("/").pop() ?? name;
-  const component = last === "index" ? toPascalCase(name.split("/").slice(-2)[0] ?? "Home") : toPascalCase(last);
-  const title = last.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-  return `import { definePage } from "${PKG}"
-
-export const page = definePage({ title: ${JSON.stringify(title)} })
-
-export default function ${component}() {
-  return (
-    <main className="p-6">
-      <h1 className="text-2xl font-semibold">${title}</h1>
-    </main>
-  )
-}
-`;
-}
-function apiTemplate() {
-  return `import type { ApiContext } from "${PKG}/server"
-
-export async function GET({ request, params }: ApiContext) {
-  return Response.json({ ok: true, params })
-}
-`;
-}
-function resolvePackageDir(root, sub) {
-  try {
-    const require2 = createRequire(path2.join(root, "noop.js"));
-    const pkgJson = require2.resolve(`${PKG}/package.json`);
-    return path2.join(path2.dirname(pkgJson), sub);
-  } catch {
-    return null;
-  }
-}
-function resolveRegistryDir(root) {
-  return resolvePackageDir(root, "registry");
-}
-var SKILL_FILE = "SKILL.md";
-var SKILL_SCAN_SKIP = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  ".vantage",
-  "dist",
-  "build",
-  "out",
-  "coverage",
-  ".next",
-  ".turbo",
-  ".cache",
-  ".vercel"
-]);
-var SKILL_SCAN_DEPTH = 4;
-function listBundledSkills(skillsDir) {
-  try {
-    return fs2.readdirSync(skillsDir, { withFileTypes: true }).filter((e) => e.isDirectory() && fs2.existsSync(path2.join(skillsDir, e.name, SKILL_FILE))).map((e) => e.name).sort();
-  } catch {
-    return [];
-  }
-}
-function displayPath(root, target) {
-  const rel2 = path2.relative(root, target);
-  return !rel2 ? "." : rel2.startsWith("..") ? target : rel2;
-}
-function findPlacedSkills(root, names, skillsDir) {
-  const wanted = new Set(names);
-  const found = /* @__PURE__ */ new Map();
-  const isSource = (p) => !path2.relative(skillsDir, p).startsWith("..");
-  const walk = (dir, depth) => {
-    let entries;
-    try {
-      entries = fs2.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      if (!entry.isDirectory() || SKILL_SCAN_SKIP.has(entry.name)) continue;
-      const abs = path2.join(dir, entry.name);
-      if (wanted.has(entry.name) && fs2.existsSync(path2.join(abs, SKILL_FILE))) {
-        if (!isSource(abs)) found.set(entry.name, [...found.get(entry.name) ?? [], abs]);
-        continue;
-      }
-      if (depth < SKILL_SCAN_DEPTH) walk(abs, depth + 1);
-    }
-  };
-  walk(root, 1);
-  for (const list of found.values()) list.sort();
-  return found;
-}
-function writeSkill(root, skillsDir, name, dest, verb) {
-  fs2.mkdirSync(path2.dirname(dest), { recursive: true });
-  fs2.cpSync(path2.join(skillsDir, name), dest, { recursive: true, force: true });
-  log.ok(`${verb} skill ${displayPath(root, dest)}/`);
-}
-function printSkillList(root, available, placed) {
-  const width = Math.max(...available.map((n) => n.length));
-  log.info("Bundled skills:");
-  for (const name of available) {
-    const where = placed.get(name);
-    const status = where?.length ? where.map((p) => displayPath(root, p) + "/").join(", ") : "not placed";
-    log.info(`  ${name.padEnd(width)}  ${status}`);
-  }
-  const missing = available.filter((n) => !placed.get(n)?.length);
-  if (missing.length) {
-    log.info("");
-    log.info("Place the missing ones with: vantage add skill --all [--dir <path>]");
-  }
-  return 0;
-}
-function addSkill(root, name, all, force, dir) {
-  const skillsDir = resolvePackageDir(root, "skills");
-  if (!skillsDir) {
-    log.error("Could not resolve the Vantage skills directory.");
-    return 1;
-  }
-  const available = listBundledSkills(skillsDir);
-  if (available.length === 0) {
-    log.error("No skills are bundled with this version of Vantage.");
-    return 1;
-  }
-  const placed = findPlacedSkills(root, available, skillsDir);
-  if (!all && !name) return printSkillList(root, available, placed);
-  const destDir = path2.resolve(root, dir ?? ".");
-  const targets = all ? available : [name];
-  let failed = 0;
-  for (const target of targets) {
-    if (!available.includes(target)) {
-      log.error(`Unknown skill "${target}". Available: ${available.join(", ")}`);
-      failed++;
-      continue;
-    }
-    const existing = placed.get(target) ?? [];
-    if (existing.length > 0 && !force) {
-      const where = existing.map((p) => displayPath(root, p) + "/").join(", ");
-      log.info(`Skill ${target} is already placed at ${where} \u2014 skipped (--force to refresh).`);
-      continue;
-    }
-    const inDestDir = existing.filter((p) => path2.dirname(p) === destDir);
-    const refresh = dir === void 0 ? existing : inDestDir;
-    if (refresh.length > 0) {
-      for (const dest of refresh) writeSkill(root, skillsDir, target, dest, "Updated");
-      continue;
-    }
-    if (existing.length > 0) {
-      const where = existing.map((p) => displayPath(root, p) + "/").join(", ");
-      log.warn(`Skill ${target} is also placed at ${where} \u2014 left untouched.`);
-    }
-    writeSkill(root, skillsDir, target, path2.join(destDir, target), "Added");
-  }
-  return failed === 0 ? 0 : 1;
-}
-var AGENTS_FILE = "AGENTS.md";
-function bundledAgentsPath(root) {
-  const dir = resolvePackageDir(root, "templates");
-  if (!dir) return null;
-  const src = path2.join(dir, AGENTS_FILE);
-  return fs2.existsSync(src) ? src : null;
-}
-function addAgents(root, force) {
-  const src = bundledAgentsPath(root);
-  if (!src) {
-    log.error("AGENTS.md is not bundled with this version of Vantage.");
-    return 1;
-  }
-  const dest = path2.join(root, AGENTS_FILE);
-  if (fs2.existsSync(dest) && !force) {
-    log.error(`${AGENTS_FILE} already exists. Use --force to overwrite.`);
-    return 1;
-  }
-  fs2.copyFileSync(src, dest);
-  log.ok(`Added ${path2.relative(root, dest) || AGENTS_FILE}`);
-  return 0;
-}
-function syncAgentsFile(root) {
-  const dest = path2.join(root, AGENTS_FILE);
-  if (!fs2.existsSync(dest)) return "absent";
-  const src = bundledAgentsPath(root);
-  if (!src) return "unchanged";
-  const next = fs2.readFileSync(src, "utf8");
-  if (fs2.readFileSync(dest, "utf8") === next) return "unchanged";
-  fs2.writeFileSync(dest, next);
-  return "updated";
-}
-function copyFromRegistry(root, kind, name, force) {
-  const registry = resolveRegistryDir(root);
-  if (!registry) {
-    log.error("Could not resolve the Vantage registry.");
-    return 1;
-  }
-  const sub = kind === "ui" ? "ui" : "blocks";
-  const src = path2.join(registry, sub, `${name}.tsx`);
-  if (!fs2.existsSync(src)) {
-    const available = fs2.existsSync(path2.join(registry, sub)) ? fs2.readdirSync(path2.join(registry, sub)).map((f) => f.replace(/\.tsx$/, "")) : [];
-    log.error(`Unknown ${kind} "${name}". Available: ${available.join(", ") || "(none)"}`);
-    return 1;
-  }
-  const destDir = path2.join(root, "components", kind === "ui" ? "ui" : "blocks");
-  const dest = path2.join(destDir, `${name}.tsx`);
-  if (fs2.existsSync(dest) && !force) {
-    log.error(`${path2.relative(root, dest)} already exists. Use --force to overwrite.`);
-    return 1;
-  }
-  fs2.mkdirSync(destDir, { recursive: true });
-  fs2.copyFileSync(src, dest);
-  log.ok(`Added ${path2.relative(root, dest)}`);
-  return 0;
-}
-async function add(root, args) {
-  const kind = args.positionals[1];
-  const name = args.positionals[2];
-  const force = Boolean(args.flags.force);
-  const all = Boolean(args.flags.all);
-  if (kind === "skill") {
-    const dir = typeof args.flags.dir === "string" ? args.flags.dir : void 0;
-    return addSkill(root, name, all, force, dir);
-  }
-  if (kind === "agents") return addAgents(root, force);
-  if (!kind || !name) {
-    log.error("Usage: vantage add <page|api|ui|block|skill|agents> <name>");
-    return 1;
-  }
-  if (kind === "page") {
-    const file = path2.join(root, name.endsWith(".tsx") ? name : `${name}.tsx`);
-    if (fs2.existsSync(file) && !force) {
-      log.error(`${path2.relative(root, file)} already exists. Use --force to overwrite.`);
-      return 1;
-    }
-    fs2.mkdirSync(path2.dirname(file), { recursive: true });
-    fs2.writeFileSync(file, pageTemplate(name));
-    log.ok(`Added page ${path2.relative(root, file)}`);
-    return 0;
-  }
-  if (kind === "api") {
-    const rel2 = name.startsWith("server/api/") ? name : path2.join("server", "api", name);
-    const file = path2.join(root, rel2.endsWith(".ts") ? rel2 : `${rel2}.ts`);
-    if (fs2.existsSync(file) && !force) {
-      log.error(`${path2.relative(root, file)} already exists. Use --force to overwrite.`);
-      return 1;
-    }
-    fs2.mkdirSync(path2.dirname(file), { recursive: true });
-    fs2.writeFileSync(file, apiTemplate());
-    log.ok(`Added API ${path2.relative(root, file)}`);
-    return 0;
-  }
-  if (kind === "ui") return copyFromRegistry(root, "ui", name, force);
-  if (kind === "block") return copyFromRegistry(root, "block", name, force);
-  log.error(`Unknown add target "${kind}". Use one of: page, api, ui, block, skill, agents.`);
-  return 1;
-}
-
-// src/core/source.ts
-function stripComments(src) {
-  return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:"'`\\])\/\/[^\n]*/g, "$1");
-}
-var OPENERS = { "(": ")", "[": "]", "{": "}" };
-function readBracketBody(src, openIndex) {
-  const open = src[openIndex];
-  if (!open || !OPENERS[open]) return null;
-  let depth = 0;
-  let quote = null;
-  for (let i = openIndex; i < src.length; i++) {
-    const c = src[i];
-    if (quote) {
-      if (c === "\\") i++;
-      else if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") {
-      quote = c;
-      continue;
-    }
-    if (OPENERS[c]) depth++;
-    else if (c === ")" || c === "]" || c === "}") {
-      if (--depth === 0) return src.slice(openIndex + 1, i);
-    }
-  }
-  return null;
-}
-function splitTopLevel(body) {
-  const parts = [];
-  let depth = 0;
-  let quote = null;
-  let start = 0;
-  for (let i = 0; i < body.length; i++) {
-    const c = body[i];
-    if (quote) {
-      if (c === "\\") i++;
-      else if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") {
-      quote = c;
-      continue;
-    }
-    if (OPENERS[c]) depth++;
-    else if (c === ")" || c === "]" || c === "}") depth--;
-    else if (c === "," && depth === 0) {
-      parts.push(body.slice(start, i));
-      start = i + 1;
-    }
-  }
-  parts.push(body.slice(start));
-  return parts.map((p) => p.trim()).filter(Boolean);
-}
-
-// src/core/route-spec.ts
-function detectApiMethods(src) {
-  return API_METHODS.filter(
-    (m) => new RegExp(`export\\s+(async\\s+)?(function|const|let|var)\\s+${m}\\b`).test(src) || new RegExp(`export\\s*\\{[^}]*\\b${m}\\b[^}]*\\}`).test(src)
-  );
-}
-function methodRegions(src) {
-  const re = new RegExp(
-    `export\\s+(?:async\\s+)?(?:function|const|let|var)\\s+(${API_METHODS.join("|")})\\b`,
-    "g"
-  );
-  const decls = [];
-  let m;
-  while (m = re.exec(src)) decls.push({ method: m[1], index: m.index });
-  const regions = /* @__PURE__ */ new Map();
-  decls.forEach((d, i) => {
-    regions.set(d.method, src.slice(d.index, decls[i + 1]?.index ?? src.length));
-  });
-  for (const method of detectApiMethods(src)) {
-    if (!regions.has(method)) regions.set(method, src);
-  }
-  return regions;
-}
-function objectKeys(expr) {
-  const trimmed = expr.trim();
-  if (!trimmed.startsWith("{")) return void 0;
-  const body = readBracketBody(trimmed, 0);
-  if (body == null) return void 0;
-  const keys = [];
-  for (const part of splitTopLevel(body)) {
-    if (part.startsWith("...")) {
-      keys.push("\u2026");
-      continue;
-    }
-    const name = part.match(/^["'`]?([A-Za-z0-9_$]+)/);
-    if (name) keys.push(name[1]);
-  }
-  return keys.length ? keys : void 0;
-}
-function initStatus(init) {
-  const m = init?.match(/\bstatus\s*:\s*(\d{3})\b/);
-  return m ? Number(m[1]) : void 0;
-}
-function initContentType(init) {
-  const m = init?.match(/["']?content-type["']?\s*:\s*["']([^"';]+)/i);
-  return m ? m[1].trim() : void 0;
-}
-function extractResponses(region) {
-  const re = /\bnew\s+Response\s*\(|\bResponse\s*\.\s*json\s*\(|(?<![.\w$])json\s*\(/g;
-  const out = [];
-  const seen = /* @__PURE__ */ new Set();
-  let m;
-  while (m = re.exec(region)) {
-    const isJson = !m[0].startsWith("new");
-    const args = readBracketBody(region, m.index + m[0].length - 1);
-    if (args == null) continue;
-    const [payload, init] = splitTopLevel(args);
-    const contentType = isJson ? "application/json" : initContentType(init) ?? (payload?.startsWith("JSON.stringify") ? "application/json" : void 0);
-    const keys = isJson && payload ? objectKeys(payload) : void 0;
-    const spec = {
-      status: initStatus(init) ?? 200,
-      ...contentType ? { contentType } : {},
-      ...keys ? { keys } : {}
-    };
-    const key = JSON.stringify(spec);
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(spec);
-  }
-  return out;
-}
-function extractErrors(region) {
-  const re = /\bHttpError\s*\(\s*(\d{3})\s*(?:,\s*(?:(["'`])((?:\\.|(?!\2)[\s\S])*)\2))?/g;
-  const out = [];
-  const seen = /* @__PURE__ */ new Set();
-  let m;
-  while (m = re.exec(region)) {
-    const message = m[3]?.replace(/\\(.)/g, "$1");
-    const spec = { status: Number(m[1]), ...message ? { message } : {} };
-    const key = JSON.stringify(spec);
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(spec);
-  }
-  return out;
-}
-function extractQuery(region) {
-  const re = /searchParams\s*\.\s*(?:get|getAll|has)\s*\(\s*["'`]([^"'`]+)["'`]/g;
-  const out = /* @__PURE__ */ new Set();
-  let m;
-  while (m = re.exec(region)) out.add(m[1]);
-  return [...out];
-}
-function extractBody(region) {
-  const read = region.match(/\b(?:request|req)\s*\.\s*(json|formData|text|arrayBuffer|blob)\s*\(/);
-  if (!read) return void 0;
-  const method = read[1];
-  const format = method === "json" || method === "formData" || method === "text" ? method : "binary";
-  const destructured = region.match(
-    /(?:const|let|var)\s*(\{[\s\S]*?\})\s*=\s*(?:await\s+)?[\w.]*\.json\s*\(/
-  );
-  const keys = format === "json" && destructured ? objectKeys(destructured[1]) : void 0;
-  return { format, ...keys ? { keys } : {} };
-}
-function toParams(segments) {
-  const out = [];
-  for (const s of segments) {
-    if (s.kind === "static") continue;
-    out.push({ name: s.name, kind: s.kind });
-  }
-  return out;
-}
-function extractPageSpec(page) {
-  return { params: toParams(page.segments), ...extractPageMeta(page.absFile) };
-}
-function extractApiSpec(api) {
-  const params = toParams(api.segments);
-  let src;
-  try {
-    src = stripComments(fs2.readFileSync(api.absFile, "utf8"));
-  } catch {
-    return { params, methods: [] };
-  }
-  const regions = methodRegions(src);
-  const methods = API_METHODS.filter((m) => regions.has(m)).map((method) => {
-    const region = regions.get(method);
-    const body = extractBody(region);
-    return {
-      method,
-      query: extractQuery(region),
-      ...body ? { body } : {},
-      responses: extractResponses(region),
-      errors: extractErrors(region)
-    };
-  });
-  return { params, methods };
-}
-
-// src/core/diagnostics.ts
-var ALLOWED_ENV_KEYS = /* @__PURE__ */ new Set(["MODE", "DEV", "PROD", "SSR", "BASE_URL", "PUBLIC_"]);
-function hasDefaultExport(src) {
-  return /\bexport\s+default\b/.test(src) || /\bexport\s*\{[^}]*\bas\s+default\b[^}]*\}/.test(src) || /\bexport\s*\{[^}]*\bdefault\b[^}]*\}\s*from\b/.test(src);
-}
-function collectClientFiles(root) {
-  const out = [];
-  const skipDirs = /* @__PURE__ */ new Set(["node_modules", ".vantage", "dist", "server", "public"]);
-  const walk = (dir) => {
-    let entries;
-    try {
-      entries = fs2.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      if (entry.name.startsWith(".")) continue;
-      const abs = path2.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (skipDirs.has(entry.name)) continue;
-        walk(abs);
-      } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
-        out.push(abs);
-      }
-    }
-  };
-  walk(root);
-  return out;
-}
-function rel(root, abs) {
-  return path2.relative(root, abs).split(path2.sep).join("/");
-}
-function checkForbiddenFiles(root) {
-  const diags = [];
-  let entries = [];
-  try {
-    entries = fs2.readdirSync(root);
-  } catch {
-    return diags;
-  }
-  for (const name of entries) {
-    for (const rule of FORBIDDEN_FILES) {
-      if (rule.pattern.test(name)) {
-        diags.push({
-          code: "FORBIDDEN_FILE",
-          severity: "error",
-          message: `${rule.label} file "${name}" is not allowed in a Vantage project.`,
-          files: [name],
-          fix: rule.remedy
-        });
-      }
-    }
-  }
-  return diags;
-}
-function checkRouteConflicts(model) {
-  const byPath = /* @__PURE__ */ new Map();
-  for (const page of model.pages) {
-    const list = byPath.get(page.routePath) ?? [];
-    list.push(page.file);
-    byPath.set(page.routePath, list);
-  }
-  const diags = [];
-  for (const [routePath, files] of byPath) {
-    if (files.length > 1) {
-      diags.push({
-        code: "ROUTE_CONFLICT",
-        severity: "error",
-        message: `${files.length} files resolve to ${routePath}`,
-        files,
-        fix: "Rename or remove one route file so each route is unique."
-      });
-    }
-  }
-  return diags;
-}
-function checkPageExports(root, model) {
-  const diags = [];
-  const pageFiles = [
-    ...model.pages.map((p) => p.absFile),
-    ...model.layouts.map((l) => l.absFile),
-    model.notFound && path2.join(root, model.notFound),
-    model.error && path2.join(root, model.error)
-  ].filter((x) => Boolean(x));
-  for (const abs of pageFiles) {
-    let src;
-    try {
-      src = stripComments(fs2.readFileSync(abs, "utf8"));
-    } catch {
-      continue;
-    }
-    if (!hasDefaultExport(src)) {
-      diags.push({
-        code: "MISSING_DEFAULT_EXPORT",
-        severity: "error",
-        message: `Page module has no default export.`,
-        files: [rel(root, abs)],
-        fix: "A page/layout must `export default` a React component."
-      });
-    }
-  }
-  return diags;
-}
-function checkApiExports(root, model) {
-  const diags = [];
-  for (const api of model.apis) {
-    let src;
-    try {
-      src = stripComments(fs2.readFileSync(api.absFile, "utf8"));
-    } catch {
-      continue;
-    }
-    const exported = detectApiMethods(src);
-    if (exported.length === 0) {
-      const lower = ["get", "post", "put", "patch", "delete", "options"].filter(
-        (m) => new RegExp(`export\\s+(async\\s+)?function\\s+${m}\\b`).test(src)
-      );
-      diags.push({
-        code: "INVALID_API_EXPORT",
-        severity: "error",
-        message: `API module exports no HTTP method handler${lower.length ? ` (found lowercase "${lower.join(", ")}")` : ""}.`,
-        files: [api.file],
-        fix: `Export one of: ${API_METHODS.join(", ")} (uppercase).`
-      });
-    }
-  }
-  return diags;
-}
-function checkClientServerBoundary(root) {
-  const diags = [];
-  const importRe = /(?:import|export)[^'"]*?from\s+["']([^"']+)["']|import\s*\(\s*["']([^"']+)["']\s*\)/g;
-  for (const abs of collectClientFiles(root)) {
-    let src;
-    try {
-      src = stripComments(fs2.readFileSync(abs, "utf8"));
-    } catch {
-      continue;
-    }
-    let m;
-    importRe.lastIndex = 0;
-    while (m = importRe.exec(src)) {
-      const spec = m[1] ?? m[2];
-      if (!spec) continue;
-      const isServer = spec === "server" || spec.startsWith("server/") || /(^|\/)\.\.?\/server(\/|$)/.test(spec) || /\/server\//.test(spec);
-      if (isServer) {
-        diags.push({
-          code: "CLIENT_IMPORTS_SERVER",
-          severity: "error",
-          message: `Client module imports from server/ ("${spec}").`,
-          files: [rel(root, abs)],
-          fix: "server/ code must never be imported by the client. Move shared code to lib/."
-        });
-      }
-    }
-  }
-  return diags;
-}
-function checkPublicEnv(root) {
-  const diags = [];
-  const envRe = /import\.meta\.env\.([A-Za-z_][A-Za-z0-9_]*)/g;
-  for (const abs of collectClientFiles(root)) {
-    let src;
-    try {
-      src = stripComments(fs2.readFileSync(abs, "utf8"));
-    } catch {
-      continue;
-    }
-    let m;
-    envRe.lastIndex = 0;
-    const bad = /* @__PURE__ */ new Set();
-    while (m = envRe.exec(src)) {
-      const key = m[1];
-      if (ALLOWED_ENV_KEYS.has(key)) continue;
-      if (key.startsWith(PUBLIC_ENV_PREFIX)) continue;
-      bad.add(key);
-    }
-    for (const key of bad) {
-      diags.push({
-        code: "PUBLIC_ENV_MISUSE",
-        severity: "warning",
-        message: `Client reads non-public env "import.meta.env.${key}".`,
-        files: [rel(root, abs)],
-        fix: `Only ${PUBLIC_ENV_PREFIX}* vars reach the client. Read secrets via ApiContext.env in server/.`
-      });
-    }
-  }
-  return diags;
-}
-function runDiagnostics(root, model) {
-  return [
-    ...checkForbiddenFiles(root),
-    ...checkRouteConflicts(model),
-    ...checkPageExports(root, model),
-    ...checkApiExports(root, model),
-    ...checkClientServerBoundary(root),
-    ...checkPublicEnv(root)
-  ];
-}
-
-// src/cli/build.ts
-var SERVER_ENTRY = `// AUTO-GENERATED by @squadbase/vantage.
-import path from "node:path"
-import { fileURLToPath } from "node:url"
-import { startNodeServer } from "@squadbase/vantage/server/node"
-import { apiRoutes } from "./server-routes.gen"
-
-const clientDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../client")
-startNodeServer({ apiRoutes, clientDir })
-`;
-async function build(root, args) {
-  const model = scanProject(root);
-  const errors = runDiagnostics(root, model).filter((d) => d.severity === "error");
-  if (errors.length) {
-    printDiagnostics(errors);
-    log.error("Fix the errors above before building.");
-    return 1;
-  }
-  const mode = "production";
-  applyApiBaseUrlFlag(args);
-  const env = { ...process.env, ...loadEnv(mode, root, "") };
-  const quiet = Boolean(args.flags.json);
-  if (!quiet) log.step("Building client\u2026");
-  await build$1({
-    configFile: false,
-    root,
-    mode,
-    plugins: [vantagePlugin({ root, env })],
-    logLevel: quiet ? "silent" : args.flags.verbose ? "info" : "warn"
-  });
-  relocateClientHtml(root);
-  if (model.hasServer) {
-    if (!quiet) log.step("Building server\u2026");
-    await buildServer(root);
-  }
-  writeDeployManifest(root, model);
-  if (!quiet) log.ok(`Build complete \u2192 ${path2.relative(process.cwd(), path2.join(root, "dist")) || "dist"}/`);
-  if (args.flags.json) {
-    process.stdout.write(
-      JSON.stringify({
-        ok: true,
-        mode: model.hasServer ? "fullstack" : "spa",
-        output: "dist",
-        pages: model.pages.length,
-        apis: model.apis.length
-      }) + "\n"
-    );
-  }
-  return 0;
-}
-function relocateClientHtml(root) {
-  const clientDir = path2.join(root, "dist", "client");
-  const nested = path2.join(clientDir, VANTAGE_DIR, "index.html");
-  const target = path2.join(clientDir, "index.html");
-  if (fs2.existsSync(nested)) {
-    fs2.mkdirSync(clientDir, { recursive: true });
-    fs2.renameSync(nested, target);
-    fs2.rmSync(path2.join(clientDir, VANTAGE_DIR), { recursive: true, force: true });
-  }
-}
-async function buildServer(root) {
-  const vantageDir = path2.join(root, VANTAGE_DIR);
-  const entry = path2.join(vantageDir, "server-entry.ts");
-  fs2.writeFileSync(entry, SERVER_ENTRY);
-  await build$2({
-    entryPoints: [entry],
-    outfile: path2.join(root, "dist", "server", "index.mjs"),
-    bundle: true,
-    platform: "node",
-    format: "esm",
-    target: "node20",
-    logLevel: "warning",
-    banner: { js: "// @squadbase/vantage server bundle" }
-  });
-}
-function writeDeployManifest(root, model) {
-  const dist = path2.join(root, "dist");
-  fs2.mkdirSync(dist, { recursive: true });
-  const manifest = {
-    schemaVersion: MANIFEST_SCHEMA_VERSION,
-    mode: model.hasServer ? "fullstack" : "spa",
-    client: "./client",
-    ...model.hasServer ? { server: "./server/index.mjs" } : {},
-    spaFallback: "./client/index.html",
-    runtime: "node"
-  };
-  fs2.writeFileSync(path2.join(dist, "vantage-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
-}
-
-// src/cli/check.ts
-async function check(root, args) {
-  const model = scanProject(root);
-  const diags = runDiagnostics(root, model);
-  const errors = diags.filter((d) => d.severity === "error");
-  const warnings = diags.filter((d) => d.severity === "warning");
-  if (args.flags.json) {
-    printJson({
-      ok: errors.length === 0,
-      errorCount: errors.length,
-      warningCount: warnings.length,
-      diagnostics: diags
-    });
-    return errors.length ? 1 : 0;
-  }
-  if (diags.length === 0) {
-    log.ok("No problems found.");
-    return 0;
-  }
-  printDiagnostics(diags);
-  console.log("");
-  if (errors.length) log.error(`${errors.length} error(s), ${warnings.length} warning(s).`);
-  else log.warn(`${warnings.length} warning(s).`);
-  return errors.length ? 1 : 0;
-}
-async function dev(root, args) {
-  const model = scanProject(root);
-  const errors = runDiagnostics(root, model).filter((d) => d.severity === "error");
-  if (errors.length) {
-    printDiagnostics(errors);
-    log.error("Fix the errors above before starting the dev server.");
-    return 1;
-  }
-  const mode = "development";
-  applyApiBaseUrlFlag(args);
-  const env = { ...process.env, ...loadEnv(mode, root, "") };
-  const port = parsePort(args.flags.port, 5173);
-  const server = await createServer({
-    configFile: false,
-    root,
-    mode,
-    plugins: [vantagePlugin({ root, env })],
-    server: { port },
-    clearScreen: false
-  });
-  await server.listen();
-  log.brand("dev server ready");
-  server.printUrls();
-  if (model.hasServer) log.info("  server/api enabled");
-  const shutdown = async () => {
-    await server.close();
-    process.exit(0);
-  };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
-  return new Promise(() => {
-  });
-}
-var SUPPORTED_SCHEMA_VERSION = 2;
-var DOC_LANGS = ["ja", "en"];
-var DEFAULT_DOC_LANG = "ja";
-function isDocLang(value) {
-  return typeof value === "string" && DOC_LANGS.includes(value);
-}
-function docsDir() {
-  return fileURLToPath(new URL("../docs/", import.meta.url));
-}
-function loadCatalog() {
-  try {
-    const raw = fs2.readFileSync(path2.join(docsDir(), "index.json"), "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed.schemaVersion !== SUPPORTED_SCHEMA_VERSION) return null;
-    return Array.isArray(parsed.docs) ? parsed.docs : null;
-  } catch {
-    return null;
-  }
-}
-function docsForLang(catalog, lang) {
-  return catalog.filter((doc) => doc.lang === lang);
-}
-function readDoc(entry) {
-  return fs2.readFileSync(path2.join(docsDir(), entry.file), "utf8");
-}
-function resolveDoc(entries, query) {
-  const needle = query.toLowerCase().replace(/^\/+|\/+$/g, "").replace(/\.mdx?$/, "");
-  const exact = entries.filter((doc) => doc.slug.toLowerCase() === needle);
-  if (exact.length === 1) return { kind: "found", doc: exact[0] };
-  const byLeaf = entries.filter((doc) => (doc.slug.split("/").pop() ?? "").toLowerCase() === needle);
-  if (byLeaf.length === 1) return { kind: "found", doc: byLeaf[0] };
-  if (byLeaf.length > 1) return { kind: "ambiguous", matches: byLeaf };
-  const partial = entries.filter(
-    (doc) => doc.slug.toLowerCase().includes(needle) || doc.title.toLowerCase().includes(needle)
-  );
-  return { kind: "missing", suggestions: partial };
-}
-function groupBySection(entries) {
-  const groups = [];
-  for (const doc of entries) {
-    const last = groups[groups.length - 1];
-    if (last && last.section === doc.section) last.docs.push(doc);
-    else groups.push({ section: doc.section, title: doc.sectionTitle, docs: [doc] });
-  }
-  return groups;
-}
-
-// src/cli/docs.ts
-function paint(markdown) {
-  if (!process.stdout.isTTY) return markdown;
-  let inFence = false;
-  return markdown.split("\n").map((line) => {
-    if (/^\s*(```|~~~)/.test(line)) {
-      inFence = !inFence;
-      return pc3.dim(line);
-    }
-    if (inFence) return line;
-    if (/^#{1,6}\s/.test(line)) return pc3.bold(pc3.magenta(line));
-    if (/^>\s?/.test(line)) return pc3.dim(line);
-    return line;
-  }).join("\n");
-}
-function printList(entries) {
-  const width = Math.max(...entries.map((doc) => doc.slug.length), 0);
-  for (const group of groupBySection(entries)) {
-    console.log("");
-    console.log(pc3.bold(group.title));
-    for (const doc of group.docs) {
-      const slug = doc.slug.padEnd(width);
-      console.log(`  ${pc3.cyan(slug)}  ${doc.description || doc.title}`);
-    }
-  }
-  console.log("");
-  console.log(pc3.dim("vantage docs <name>   show one page      --json   machine-readable"));
-  console.log(pc3.dim("vantage docs --all    show every page    --lang   ja | en"));
-}
-function toJson(doc, content) {
-  return {
-    slug: doc.slug,
-    lang: doc.lang,
-    title: doc.title,
-    description: doc.description,
-    section: doc.section,
-    sectionTitle: doc.sectionTitle,
-    content
-  };
-}
-async function docs(_root, args) {
-  const catalog = loadCatalog();
-  if (!catalog) {
-    log.error("The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.");
-    return 1;
-  }
-  const langFlag = args.flags.lang;
-  if (langFlag !== void 0 && !isDocLang(langFlag)) {
-    log.error(`Unknown --lang "${String(langFlag)}". Available: ${DOC_LANGS.join(", ")}`);
-    return 1;
-  }
-  const lang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG;
-  const entries = docsForLang(catalog, lang);
-  if (entries.length === 0) {
-    log.error(`No documentation bundled for "${lang}".`);
-    return 1;
-  }
-  const json = Boolean(args.flags.json);
-  const name = args.positionals[1];
-  if (args.flags.all) {
-    const pages = entries.map((doc) => ({ doc, content: readDoc(doc) }));
-    if (json) {
-      printJson({ lang, docs: pages.map(({ doc, content: content2 }) => toJson(doc, content2)) });
-      return 0;
-    }
-    process.stdout.write(pages.map(({ content: content2 }) => content2.trimEnd()).join("\n\n---\n\n") + "\n");
-    return 0;
-  }
-  if (!name || args.flags.list) {
-    if (json) {
-      printJson({
-        lang,
-        docs: entries.map(({ slug, title, description, section, sectionTitle }) => ({
-          slug,
-          title,
-          description,
-          section,
-          sectionTitle
-        }))
-      });
-      return 0;
-    }
-    printList(entries);
-    return 0;
-  }
-  const found = resolveDoc(entries, name);
-  if (found.kind === "ambiguous") {
-    log.error(`"${name}" matches several pages: ${found.matches.map((d) => d.slug).join(", ")}`);
-    return 1;
-  }
-  if (found.kind === "missing") {
-    const suggestions = found.suggestions.map((d) => d.slug);
-    log.error(
-      suggestions.length ? `No page named "${name}". Did you mean: ${suggestions.slice(0, 8).join(", ")}?` : `No page named "${name}". Run \`vantage docs\` to list every page.`
-    );
-    return 1;
-  }
-  const content = readDoc(found.doc);
-  if (json) {
-    printJson(toJson(found.doc, content));
-    return 0;
-  }
-  process.stdout.write(paint(content.trimEnd()) + "\n");
-  return 0;
-}
-async function doctor(root, args) {
-  const facets = [];
-  const nodeMajor = Number(process.versions.node.split(".")[0]);
-  facets.push({
-    name: "node",
-    ok: nodeMajor >= 20,
-    detail: `v${process.versions.node}${nodeMajor >= 20 ? "" : " (requires >= 20)"}`
-  });
-  const pkgPath = path2.join(root, "package.json");
-  facets.push({ name: "package.json", ok: fs2.existsSync(pkgPath), detail: fs2.existsSync(pkgPath) ? "found" : "missing" });
-  const lockfiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock"];
-  const lock = lockfiles.find((f) => fs2.existsSync(path2.join(root, f)) || fs2.existsSync(path2.join(root, "..", f)) || fs2.existsSync(path2.join(root, "..", "..", f)));
-  facets.push({ name: "lockfile", ok: Boolean(lock), detail: lock ?? "none found" });
-  let installedVantage = "not installed";
-  let vantageOk = false;
-  try {
-    const require2 = createRequire(path2.join(root, "noop.js"));
-    const p = require2.resolve("@squadbase/vantage/package.json");
-    installedVantage = JSON.parse(fs2.readFileSync(p, "utf8")).version;
-    vantageOk = true;
-  } catch {
-  }
-  facets.push({ name: "@squadbase/vantage", ok: vantageOk, detail: installedVantage });
-  const model = scanProject(root);
-  const errors = runDiagnostics(root, model).filter((d) => d.severity === "error");
-  facets.push({
-    name: "project",
-    ok: errors.length === 0,
-    detail: errors.length === 0 ? "no blocking errors" : `${errors.length} error(s) (run \`vantage check\`)`
-  });
-  const allOk = facets.every((f) => f.ok);
-  if (args.flags.json) {
-    printJson({ ok: allOk, cli: frameworkVersion(), facets });
-    return allOk ? 0 : 1;
-  }
-  log.brand(`doctor (cli v${frameworkVersion()})`);
-  for (const f of facets) {
-    const line = `${f.name.padEnd(22)} ${f.detail}`;
-    if (f.ok) log.ok(line);
-    else log.error(line);
-  }
-  return allOk ? 0 : 1;
-}
-async function preview(root, args) {
-  const manifestPath = path2.join(root, "dist", "vantage-manifest.json");
-  if (!fs2.existsSync(manifestPath)) {
-    log.error("No build found. Run `vantage build` first.");
-    return 1;
-  }
-  const manifest = JSON.parse(fs2.readFileSync(manifestPath, "utf8"));
-  const port = parsePort(args.flags.port, 4173);
-  if (manifest.mode === "fullstack") {
-    const serverPath = path2.join(root, "dist", "server", "index.mjs");
-    if (!fs2.existsSync(serverPath)) {
-      log.error("Server bundle missing. Re-run `vantage build`.");
-      return 1;
-    }
-    log.brand(`preview (fullstack) \u2192 http://localhost:${port}`);
-    const child = spawn(process.execPath, [serverPath], {
-      stdio: "inherit",
-      env: { ...process.env, PORT: String(port) }
-    });
-    return new Promise((resolve) => {
-      child.on("exit", (code) => resolve(code ?? 0));
-      const stop = () => child.kill("SIGINT");
-      process.on("SIGINT", stop);
-      process.on("SIGTERM", stop);
-    });
-  }
-  const { preview: vitePreview } = await import('vite');
-  const server = await vitePreview({
-    configFile: false,
-    root,
-    build: { outDir: path2.join(root, "dist", "client") },
-    preview: { port }
-  });
-  log.brand("preview (spa)");
-  server.printUrls();
-  return new Promise(() => {
-  });
-}
-var ROUTE_COLUMN = 28;
-var LABEL_COLUMN = 9;
-function detailLine(indent, label, value) {
-  console.log(`${indent}${pc3.dim(label.padEnd(LABEL_COLUMN))}${value}`);
-}
-function formatParams(params) {
-  return params.map((p) => p.kind === "catchall" ? `*${p.name}` : `:${p.name}`).join(", ");
-}
-function formatKeys(keys) {
-  return keys?.length ? ` { ${keys.join(", ")} }` : "";
-}
-function printPageSpec(spec) {
-  const indent = "      ";
-  if (spec.title) detailLine(indent, "title", spec.title);
-  if (spec.navLabel) detailLine(indent, "nav", spec.navLabel);
-  if (spec.description) detailLine(indent, "desc", spec.description);
-  if (spec.params.length) detailLine(indent, "params", formatParams(spec.params));
-}
-function printApiMethodSpec(method, params) {
-  const indent = "        ";
-  console.log(`      ${pc3.bold(method.method)}`);
-  if (params.length) detailLine(indent, "path", formatParams(params));
-  if (method.query.length) detailLine(indent, "query", method.query.join(", "));
-  if (method.body) detailLine(indent, "body", method.body.format + formatKeys(method.body.keys));
-  for (const res of method.responses) {
-    const parts = [String(res.status), res.contentType].filter(Boolean).join(" ");
-    detailLine(indent, "response", parts + formatKeys(res.keys));
-  }
-  for (const err of method.errors) {
-    detailLine(indent, "error", `${err.status}${err.message ? ` "${err.message}"` : ""}`);
-  }
-}
-function printPages(model, detail) {
-  console.log(pc3.bold("\nPages"));
-  if (model.pages.length === 0) console.log(pc3.dim("  (none)"));
-  for (const p of model.pages) {
-    console.log(`  ${pc3.green(p.routePath.padEnd(ROUTE_COLUMN))} ${pc3.dim(p.file)}`);
-    if (detail) printPageSpec(extractPageSpec(p));
-  }
-  if (model.layouts.length || model.notFound || model.error) {
-    console.log(pc3.bold("\nSpecial"));
-    for (const l of model.layouts) {
-      const label = "layout " + (l.dir === "" ? "/" : "/" + l.dir);
-      console.log(`  ${pc3.cyan(label.padEnd(ROUTE_COLUMN))} ${pc3.dim(l.file)}`);
-    }
-    if (model.notFound) console.log(`  ${pc3.cyan("404".padEnd(ROUTE_COLUMN))} ${pc3.dim(model.notFound)}`);
-    if (model.error) console.log(`  ${pc3.cyan("error".padEnd(ROUTE_COLUMN))} ${pc3.dim(model.error)}`);
-  }
-}
-function printApis(model, detail) {
-  console.log(pc3.bold("\nAPI"));
-  if (!model.hasServer) {
-    console.log(pc3.dim("  (none \u2014 this project has no server/ directory)"));
-    return;
-  }
-  if (model.apis.length === 0) console.log(pc3.dim("  (none)"));
-  for (const a of model.apis) {
-    console.log(`  ${pc3.yellow(a.routePath.padEnd(ROUTE_COLUMN))} ${pc3.dim(a.file)}`);
-    if (!detail) continue;
-    const spec = extractApiSpec(a);
-    if (spec.methods.length === 0) console.log(`      ${pc3.dim("(no HTTP method handler exported)")}`);
-    for (const method of spec.methods) printApiMethodSpec(method, spec.params);
-  }
-}
-function pageJson(p, detail) {
-  return {
-    route: p.routePath,
-    file: p.file,
-    dynamic: p.dynamic,
-    ...detail ? { spec: extractPageSpec(p) } : {}
-  };
-}
-function apiJson(a, detail) {
-  return {
-    route: a.routePath,
-    file: a.file,
-    params: a.params,
-    ...detail ? { spec: extractApiSpec(a) } : {}
-  };
-}
-async function routes(root, args) {
-  const model = scanProject(root);
-  const onlyPages = Boolean(args.flags.pages);
-  const onlyApis = Boolean(args.flags.apis);
-  const showPages = onlyPages || !onlyApis;
-  const showApis = onlyApis || !onlyPages;
-  const detail = Boolean(args.flags.detail);
-  if (args.flags.json) {
-    const payload = {};
-    if (showPages) {
-      payload.pages = model.pages.map((p) => pageJson(p, detail));
-      payload.layouts = model.layouts.map((l) => ({ dir: l.dir === "" ? "/" : l.dir, file: l.file }));
-      payload.notFound = model.notFound;
-      payload.error = model.error;
-    }
-    if (showApis) {
-      payload.apis = model.apis.map((a) => apiJson(a, detail));
-      payload.hasServer = model.hasServer;
-    }
-    printJson(payload);
-    return 0;
-  }
-  if (showPages) printPages(model, detail);
-  if (showApis && (model.hasServer || onlyApis)) printApis(model, detail);
-  console.log("");
-  return 0;
-}
-
-// src/cli/search-index.ts
-var FIELD_WEIGHTS = { slug: 3, title: 3, description: 2, body: 1 };
-var K1 = 1.2;
-var B = 0.75;
-var TOKEN_RE = /[a-z0-9]+|[぀-ヿ㐀-䶿一-鿿]+/g;
-var LATIN_RE = /^[a-z0-9]+$/;
-var TOKEN_RE_ANYCASE = /[a-zA-Z0-9]+|[぀-ヿ㐀-䶿一-鿿]+/g;
-var CJK_RE = /[぀-ヿ㐀-䶿一-鿿]/;
-var SCRIPT_RE = /[ぁ-ゟ]+|[゠-ヿ]+|[㐀-䶿一-鿿]+/g;
-var HIRAGANA_RE = /^[ぁ-ゟ]$/;
-function singular(word) {
-  if (word.length >= 5 && word.endsWith("ies")) return `${word.slice(0, -3)}y`;
-  if (word.length >= 4 && word.endsWith("s") && !/(ss|us|is)$/.test(word)) return word.slice(0, -1);
-  return word;
-}
-function tokenize(text) {
-  const normalized = text.normalize("NFKC").replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase();
-  const tokens = [];
-  for (const match of normalized.matchAll(TOKEN_RE)) {
-    const run = match[0];
-    if (LATIN_RE.test(run)) {
-      tokens.push(singular(run));
-      continue;
-    }
-    for (const segment of run.match(SCRIPT_RE) ?? []) {
-      if (segment.length === 1 && HIRAGANA_RE.test(segment)) continue;
-      if (segment.length <= 2) {
-        tokens.push(segment);
-        continue;
-      }
-      tokens.push(segment);
-      for (let i = 0; i < segment.length - 1; i++) tokens.push(segment.slice(i, i + 2));
-    }
-  }
-  return tokens;
-}
-function queryPhrases(query) {
-  const phrases = [];
-  for (const match of query.normalize("NFKC").matchAll(TOKEN_RE_ANYCASE)) {
-    const run = match[0];
-    if (!CJK_RE.test(run)) {
-      phrases.push(run);
-      continue;
-    }
-    for (const segment of run.match(SCRIPT_RE) ?? []) {
-      if (segment.length === 1 && HIRAGANA_RE.test(segment)) continue;
-      phrases.push(segment);
-    }
-  }
-  return [...new Set(phrases)];
-}
-function buildIndex(entries) {
-  const docs2 = entries.map((entry) => {
-    const body = readDoc(entry);
-    const tf = /* @__PURE__ */ new Map();
-    let length = 0;
-    const add2 = (text, weight) => {
-      for (const token of tokenize(text)) {
-        tf.set(token, (tf.get(token) ?? 0) + weight);
-        length += weight;
-      }
-    };
-    add2(entry.slug, FIELD_WEIGHTS.slug);
-    add2(entry.title, FIELD_WEIGHTS.title);
-    add2(entry.description, FIELD_WEIGHTS.description);
-    add2(body, FIELD_WEIGHTS.body);
-    return { entry, body, tf, length };
-  });
-  const df = /* @__PURE__ */ new Map();
-  for (const doc of docs2) {
-    for (const term of doc.tf.keys()) df.set(term, (df.get(term) ?? 0) + 1);
-  }
-  const total = docs2.length;
-  const avgLength = total ? docs2.reduce((sum, doc) => sum + doc.length, 0) / total : 1;
-  return {
-    search(query) {
-      const terms = [...new Set(tokenize(query))];
-      if (terms.length === 0) return [];
-      const hits = [];
-      for (const doc of docs2) {
-        let score = 0;
-        for (const term of terms) {
-          const tf = doc.tf.get(term);
-          if (!tf) continue;
-          const n = df.get(term) ?? 0;
-          const idf = Math.log(1 + (total - n + 0.5) / (n + 0.5));
-          const norm = 1 - B + B * doc.length / avgLength;
-          score += idf * (tf * (K1 + 1) / (tf + K1 * norm));
-        }
-        if (score > 0) hits.push({ entry: doc.entry, score, terms, body: doc.body });
-      }
-      hits.sort((a, b) => b.score - a.score || a.entry.slug.localeCompare(b.entry.slug));
-      return hits;
-    }
-  };
-}
-var SNIPPET_LENGTH = 150;
-function snippet(body, terms, length = SNIPPET_LENGTH) {
-  let best = "";
-  let bestHits = 0;
-  let bestIndex = 0;
-  let bestIsHeading = true;
-  for (const raw of body.split("\n").slice(1)) {
-    const line = raw.replace(/^\s*[-*]\s+/, "").replace(/\s+/g, " ").trim();
-    if (!line || /^(```|~~~|\|\s*-{2,})/.test(line)) continue;
-    const haystack = line.toLowerCase();
-    const heading = line.startsWith("#");
-    let hits = 0;
-    let first = -1;
-    for (const term of terms) {
-      const at = haystack.indexOf(term);
-      if (at === -1) continue;
-      hits++;
-      if (first === -1 || at < first) first = at;
-    }
-    if (hits > bestHits || hits === bestHits && hits > 0 && bestIsHeading && !heading) {
-      best = line;
-      bestHits = hits;
-      bestIndex = first;
-      bestIsHeading = heading;
-    }
-  }
-  if (!bestHits) return "";
-  if (best.length <= length) return best;
-  const start = Math.max(0, bestIndex - Math.floor(length / 4));
-  const text = best.slice(start, start + length).trim();
-  return `${start > 0 ? "\u2026" : ""}${text}${start + length < best.length ? "\u2026" : ""}`;
-}
-
-// src/cli/search.ts
-var DEFAULT_LIMIT = 10;
-var MAX_REGEX_LINES = 3;
-function parseLimit(value, fallback) {
-  if (typeof value === "string") {
-    const n = Number(value);
-    if (Number.isInteger(n) && n > 0) return n;
-  }
-  return fallback;
-}
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function paintMatches(text, re) {
-  if (!process.stdout.isTTY) return text;
-  let out = "";
-  let last = 0;
-  for (const match of text.matchAll(re)) {
-    const at = match.index ?? 0;
-    if (!match[0]) continue;
-    out += pc3.dim(text.slice(last, at)) + pc3.yellow(match[0]);
-    last = at + match[0].length;
-  }
-  return out + pc3.dim(text.slice(last));
-}
-function paintTerms(text, words) {
-  if (!process.stdout.isTTY) return text;
-  if (words.length === 0) return pc3.dim(text);
-  return paintMatches(text, new RegExp(words.map(escapeRegExp).join("|"), "gi"));
-}
-function header(count, query, lang, mode) {
-  const label = `${count} result${count === 1 ? "" : "s"} for "${query}"`;
-  console.log("");
-  console.log(pc3.bold(label) + pc3.dim(`  ${lang} \xB7 ${mode}`));
-  console.log("");
-}
-function footer(total, shown, lines) {
-  if (total > shown) {
-    console.log("");
-    console.log(pc3.dim(`  ${total - shown} more \u2014 raise --limit to see them`));
-  }
-  console.log("");
-  for (const line of lines) console.log(pc3.dim(line));
-}
-function noResults(query) {
-  log.warn(`Nothing matches "${query}".`);
-  console.log(pc3.dim("  Try fewer or more general words, or run `vantage docs --list` to browse every page."));
-}
-function meta(entry) {
-  return {
-    slug: entry.slug,
-    title: entry.title,
-    description: entry.description,
-    section: entry.section,
-    sectionTitle: entry.sectionTitle,
-    command: `vantage docs ${entry.slug}`
-  };
-}
-function runRanked(entries, query, lang, limit, json) {
-  const hits = buildIndex(entries).search(query);
-  const shown = hits.slice(0, limit);
-  const passage = (hit) => snippet(hit.body, hit.terms);
-  if (json) {
-    printJson({
-      query,
-      mode: "bm25",
-      lang,
-      count: hits.length,
-      results: shown.map((hit) => ({
-        ...meta(hit.entry),
-        score: Math.round(hit.score * 1e3) / 1e3,
-        snippet: passage(hit)
-      }))
-    });
-    return 0;
-  }
-  if (hits.length === 0) {
-    noResults(query);
-    return 0;
-  }
-  const words = queryPhrases(query);
-  const width = Math.max(...shown.map((hit) => hit.entry.slug.length));
-  header(hits.length, query, lang, "bm25");
-  for (const hit of shown) {
-    const title = `${hit.entry.title}${pc3.dim(` \xB7 ${hit.entry.sectionTitle}`)}`;
-    console.log(`  ${pc3.cyan(hit.entry.slug.padEnd(width))}  ${title}`);
-    const text = passage(hit);
-    if (text) console.log(`  ${" ".repeat(width)}  ${paintTerms(text, words)}`);
-  }
-  footer(hits.length, shown.length, [
-    "vantage docs <name>      open one result       --regex   treat the query as a regular expression",
-    "vantage search --json    machine-readable      --limit   max results (default 10)"
-  ]);
-  return 0;
-}
-function runRegex(entries, query, lang, limit, json) {
-  let scan;
-  let probe;
-  try {
-    scan = new RegExp(query, "gi");
-    probe = new RegExp(query, "i");
-  } catch (err) {
-    log.error(err instanceof Error ? err.message : `Invalid regular expression: ${String(err)}`);
-    return 1;
-  }
-  const results = [];
-  for (const entry of entries) {
-    const lines = readDoc(entry).split("\n");
-    const matches = [];
-    let matchCount = 0;
-    for (let i = 0; i < lines.length; i++) {
-      const found = [...lines[i].matchAll(scan)];
-      if (found.length === 0) continue;
-      matchCount += found.length;
-      if (matches.length < MAX_REGEX_LINES) {
-        matches.push({ line: i + 1, text: lines[i].replace(/\s+/g, " ").trim() });
-      }
-    }
-    const inMeta = probe.test(entry.slug) || probe.test(entry.title) || probe.test(entry.description);
-    if (matchCount === 0 && !inMeta) continue;
-    results.push({ entry, matchCount, matches });
-  }
-  results.sort((a, b) => b.matchCount - a.matchCount);
-  const shown = results.slice(0, limit);
-  if (json) {
-    printJson({
-      query,
-      mode: "regex",
-      lang,
-      count: results.length,
-      results: shown.map((result) => ({
-        ...meta(result.entry),
-        matchCount: result.matchCount,
-        matches: result.matches
-      }))
-    });
-    return 0;
-  }
-  if (results.length === 0) {
-    noResults(query);
-    return 0;
-  }
-  header(results.length, query, lang, "regex");
-  for (const result of shown) {
-    const count = pc3.dim(
-      result.matchCount ? `  ${result.matchCount} match${result.matchCount === 1 ? "" : "es"}` : "  name match"
-    );
-    console.log(`  ${pc3.cyan(result.entry.slug)}  ${result.entry.title}${count}`);
-    for (const match of result.matches) {
-      console.log(`    ${pc3.dim(String(match.line).padStart(4))}  ${paintMatches(match.text, scan)}`);
-    }
-  }
-  footer(results.length, shown.length, [
-    "vantage docs <name>      open one result       --limit   max results (default 10)",
-    "vantage search --json    machine-readable      --lang    ja | en"
-  ]);
-  return 0;
-}
-async function search(_root, args) {
-  const query = args.positionals.slice(1).join(" ").trim();
-  if (!query) {
-    log.error("Usage: vantage search <query> [--regex] [--limit <n>] [--lang ja|en] [--json]");
-    return 1;
-  }
-  const catalog = loadCatalog();
-  if (!catalog) {
-    log.error("The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.");
-    return 1;
-  }
-  const langFlag = args.flags.lang;
-  if (langFlag !== void 0 && !isDocLang(langFlag)) {
-    log.error(`Unknown --lang "${String(langFlag)}". Available: ${DOC_LANGS.join(", ")}`);
-    return 1;
-  }
-  const lang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG;
-  const entries = docsForLang(catalog, lang);
-  if (entries.length === 0) {
-    log.error(`No documentation bundled for "${lang}".`);
-    return 1;
-  }
-  const searchable = entries.filter((entry) => entry.searchable !== false);
-  const limit = parseLimit(args.flags.limit, DEFAULT_LIMIT);
-  const json = Boolean(args.flags.json);
-  return args.flags.regex ? runRegex(searchable, query, lang, limit, json) : runRanked(searchable, query, lang, limit, json);
-}
-
-// src/cli/upgrade.ts
-async function upgrade(root, args) {
-  const version = frameworkVersion();
-  const model = scanProject(root);
-  generateArtifacts({ root, model });
-  const agents = syncAgentsFile(root);
-  if (args.flags.json) {
-    printJson({ ok: true, version, transforms: [], regenerated: true, agentsSynced: agents === "updated" });
-    return 0;
-  }
-  log.brand(`upgrade \u2192 v${version}`);
-  log.ok("Regenerated .vantage artifacts.");
-  if (agents === "updated") log.ok("Synced AGENTS.md from the framework.");
-  log.info("No breaking code transforms required for this version.");
-  return 0;
-}
-
-// src/cli.ts
-var HELP = `${pc3.bold(pc3.magenta("vantage"))} \u2014 data dashboard framework for Squadbase
+var HELP = `${pc.bold(pc.magenta("vantage"))} \u2014 data dashboard framework for Squadbase
 
-${pc3.bold("Usage")}
+${pc.bold("Usage")}
   vantage <command> [path] [options]
   vantage <path>                     Quick dev shortcut (folder or entry file)
 
-${pc3.bold("Commands")}
+${pc.bold("Commands")}
   dev                 Start the dev server (HMR + optional API)
   build               Build client and optional server into dist/
   preview             Run the production build locally
@@ -1605,7 +24,7 @@ ${pc3.bold("Commands")}
   doctor              Environment and installation health checks
   upgrade             Regenerate artifacts, sync AGENTS.md / apply migrations
 
-${pc3.bold("Options")}
+${pc.bold("Options")}
   --json              Machine-readable output (check, routes, doctor, build, docs, search)
   --port <n>          Port for dev/preview
   --root <dir>        Project root (default: cwd)
@@ -1623,16 +42,16 @@ ${pc3.bold("Options")}
   -h, --help          Print this help
 `;
 var COMMANDS = {
-  dev,
-  build,
-  preview,
-  check,
-  routes,
-  add,
-  docs,
-  search,
-  doctor,
-  upgrade
+  dev: () => import('./dev-NX3PMYCT.js').then((m) => m.dev),
+  build: () => import('./build-QP5BL3K7.js').then((m) => m.build),
+  preview: () => import('./preview-CLALOEFE.js').then((m) => m.preview),
+  check: () => import('./check-QPFERQLO.js').then((m) => m.check),
+  routes: () => import('./routes-YI25MKPF.js').then((m) => m.routes),
+  add: () => import('./add-DWNDA57L.js').then((m) => m.add),
+  docs: () => import('./docs-M5ZUI25V.js').then((m) => m.docs),
+  search: () => import('./search-5TYAIQ7C.js').then((m) => m.search),
+  doctor: () => import('./doctor-N6JMEWKT.js').then((m) => m.doctor),
+  upgrade: () => import('./upgrade-3P5MBGE6.js').then((m) => m.upgrade)
 };
 var NO_ROOT_POSITIONAL = /* @__PURE__ */ new Set(["add", "docs", "search"]);
 async function main() {
@@ -1646,9 +65,9 @@ async function main() {
     console.log(HELP);
     return;
   }
-  let runFn = COMMANDS[command];
+  let load = COMMANDS[command];
   let root;
-  if (runFn) {
+  if (load) {
     const targetArg = !NO_ROOT_POSITIONAL.has(command) ? args.positionals[1] : void 0;
     if (targetArg !== void 0) {
       const quick = resolveQuickRoot(targetArg);
@@ -1669,12 +88,13 @@ async function main() {
       process.exitCode = 1;
       return;
     }
-    runFn = dev;
+    load = COMMANDS.dev;
     root = quick;
-    log.brand(`quick dev \u2192 ${path2.relative(process.cwd(), root) || "."}`);
+    log.brand(`quick dev \u2192 ${path.relative(process.cwd(), root) || "."}`);
   }
   try {
-    const code = await runFn(root, args);
+    const run = await load();
+    const code = await run(root, args);
     process.exitCode = code;
   } catch (err) {
     log.error(err instanceof Error ? err.message : String(err));