saturndocs 0.1.0

package/dist/chunk-OZWTXMO3.js

@@ -0,0 +1,584 @@
+import {
+  parseOpenApiFile
+} from "./chunk-S45UWCML.js";
+import {
+  loadDocsConfig,
+  loadModelsConfig,
+  navigationGroups
+} from "./chunk-R3X2DPFF.js";
+
+// src/lib/pages.ts
+import { existsSync } from "fs";
+import { join } from "path";
+function resolvePageFile(docsDir, entry) {
+  const mdxPath = join(docsDir, "pages", `${entry}.mdx`);
+  const mdPath = join(docsDir, "pages", `${entry}.md`);
+  const hasMdx = existsSync(mdxPath);
+  const hasMd = existsSync(mdPath);
+  if (hasMdx && hasMd) {
+    throw new Error(
+      `Page "${entry}" resolves to both pages/${entry}.mdx and pages/${entry}.md; keep only one.`
+    );
+  }
+  if (hasMdx) return { entry, file: mdxPath, ext: ".mdx" };
+  if (hasMd) return { entry, file: mdPath, ext: ".md" };
+  throw new Error(
+    `Page "${entry}" not found: expected pages/${entry}.mdx or pages/${entry}.md.`
+  );
+}
+function pageUrl(entry) {
+  return entry === "index" ? "/" : `/${entry}`;
+}
+function collectPageEntries(config) {
+  return navigationGroups(config).flatMap((group) => group.pages);
+}
+
+// src/lib/validate.ts
+import { existsSync as existsSync2 } from "fs";
+import { readFile } from "fs/promises";
+import { join as join2 } from "path";
+
+// ../mdx-preprocess/dist/index.js
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkMdx from "remark-mdx";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkGfm from "remark-gfm";
+import GithubSlugger from "github-slugger";
+import { parse as parseYaml } from "yaml";
+var PROSE_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "title",
+  "caption",
+  "description",
+  "summary",
+  "transcript"
+]);
+var RESOURCE_DESCRIPTION_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "description",
+  "summary",
+  "transcript"
+]);
+var buildProcessor = () => unified().use(remarkParse).use(remarkMdx).use(remarkFrontmatter, ["yaml"]).use(remarkGfm);
+function stripMdx(source) {
+  const tree = buildProcessor().parse(source);
+  const slugger = new GithubSlugger();
+  const headings = [];
+  let title;
+  let description;
+  let frontmatter = {};
+  for (const node of tree.children ?? []) {
+    if (node.type === "yaml" && typeof node.value === "string") {
+      const parsed = parseFrontmatter(node.value);
+      frontmatter = parsed.frontmatter;
+      if (parsed.title !== void 0) title = parsed.title;
+      if (parsed.description !== void 0) description = parsed.description;
+      break;
+    }
+  }
+  const renderPhrasing = (nodes) => {
+    if (!nodes) return "";
+    let out = "";
+    for (const node of nodes) {
+      out += phrasing(node);
+    }
+    return out;
+  };
+  function phrasing(node) {
+    switch (node.type) {
+      case "text":
+        return node.value ?? "";
+      case "inlineCode":
+        return "`" + (node.value ?? "") + "`";
+      case "strong":
+        return "**" + renderPhrasing(node.children) + "**";
+      case "emphasis":
+        return "*" + renderPhrasing(node.children) + "*";
+      case "delete":
+        return renderPhrasing(node.children);
+      case "link":
+        return renderMarkdownLink(
+          renderPhrasing(node.children),
+          node.url ?? ""
+        );
+      case "image": {
+        const label = node.alt?.trim() || "Image";
+        return renderMarkdownResource("Image", label, node.url ?? "");
+      }
+      case "break":
+        return "\n";
+      case "mdxTextExpression": {
+        const literal = stringLiteralValue(node.value ?? "");
+        return literal ?? "";
+      }
+      case "mdxJsxTextElement": {
+        const inner = renderPhrasing(node.children);
+        const componentText = componentMarkdownForNode(node);
+        if (componentText) return inner ? `${componentText} ${inner}` : componentText;
+        const resource = resourceMarkdownForNode(node, inner);
+        if (resource) return resource;
+        const attrText = proseAttributeValues(node.attributes).join(" ");
+        return attrText ? inner ? attrText + " " + inner : attrText : inner;
+      }
+      case "html":
+        return renderHtmlResource(node.value ?? "");
+      default:
+        return node.children ? renderPhrasing(node.children) : "";
+    }
+  }
+  const renderFlow = (nodes) => {
+    if (!nodes) return [];
+    const blocks = [];
+    for (const node of nodes) {
+      pushFlow(node, blocks);
+    }
+    return blocks;
+  };
+  function pushFlow(node, blocks) {
+    switch (node.type) {
+      case "yaml":
+      case "toml":
+      case "mdxjsEsm":
+      case "definition":
+      case "footnoteDefinition":
+      case "html": {
+        const resource = renderHtmlResource(node.value ?? "");
+        if (resource) blocks.push(resource);
+        return;
+      }
+      case "thematicBreak":
+        blocks.push("* * *");
+        return;
+      case "heading": {
+        const depth = node.depth ?? 1;
+        const text2 = renderPhrasing(node.children).trim();
+        const slug = slugger.slug(text2);
+        headings.push({ depth, text: text2, slug });
+        blocks.push("#".repeat(depth) + " " + text2);
+        return;
+      }
+      case "paragraph": {
+        const text2 = renderPhrasing(node.children).trim();
+        if (text2) blocks.push(text2);
+        return;
+      }
+      case "blockquote": {
+        const inner = renderFlow(node.children).join("\n\n");
+        if (inner) {
+          blocks.push(
+            inner.split("\n").map((line) => line ? "> " + line : ">").join("\n")
+          );
+        }
+        return;
+      }
+      case "list":
+        blocks.push(renderList(node));
+        return;
+      case "code":
+        blocks.push(renderCode(node));
+        return;
+      case "table":
+        blocks.push(renderTable(node));
+        return;
+      case "mdxFlowExpression": {
+        const literal = stringLiteralValue(node.value ?? "");
+        if (literal) blocks.push(literal);
+        return;
+      }
+      case "mdxJsxFlowElement": {
+        const componentText = componentMarkdownForNode(node);
+        if (componentText) blocks.push(componentText);
+        const resource = resourceMarkdownForNode(node);
+        if (resource) {
+          blocks.push(resource);
+          for (const value of namedAttributeValues(
+            node.attributes,
+            RESOURCE_DESCRIPTION_ATTRIBUTES
+          )) {
+            blocks.push(value);
+          }
+        } else if (!componentText) {
+          for (const value of proseAttributeValues(node.attributes)) {
+            blocks.push(value);
+          }
+        }
+        for (const block of renderFlow(node.children)) {
+          blocks.push(block);
+        }
+        return;
+      }
+      default: {
+        if (node.children) {
+          for (const block of renderFlow(node.children)) blocks.push(block);
+        }
+        return;
+      }
+    }
+  }
+  function renderList(node) {
+    const ordered = node.ordered === true;
+    let index = typeof node.start === "number" ? node.start : 1;
+    const items = [];
+    for (const item of node.children ?? []) {
+      const marker = ordered ? `${index++}. ` : "- ";
+      const pad = " ".repeat(marker.length);
+      const body = renderFlow(item.children).join("\n\n");
+      const lines = body.split("\n");
+      const rendered = lines.map((line, i) => i === 0 ? marker + line : pad + line).join("\n");
+      items.push(rendered);
+    }
+    return items.join("\n");
+  }
+  function renderCode(node) {
+    const lang = typeof node.lang === "string" ? node.lang : "";
+    const value = node.value ?? "";
+    const fence = "`".repeat(Math.max(3, longestBacktickRun(value) + 1));
+    return fence + lang + "\n" + value + "\n" + fence;
+  }
+  function renderTable(node) {
+    const rows = node.children ?? [];
+    if (rows.length === 0) return "";
+    const rendered = rows.map(
+      (row) => "| " + (row.children ?? []).map((cell) => renderPhrasing(cell.children).trim()).join(" | ") + " |"
+    );
+    const columnCount = (rows[0]?.children ?? []).length;
+    const separator = "| " + Array(columnCount).fill("---").join(" | ") + " |";
+    rendered.splice(1, 0, separator);
+    return rendered.join("\n");
+  }
+  const text = renderFlow(tree.children).filter((block) => block.trim() !== "").join("\n\n").trim();
+  const result = { text, frontmatter, headings };
+  if (title !== void 0) result.title = title;
+  if (description !== void 0) result.description = description;
+  return result;
+}
+function safeResourceUrl(raw) {
+  const value = decodeHtmlAttribute(raw).trim();
+  if (value === "" || /[\u0000-\u001f\u007f]/.test(value) || /\s/.test(value) || value.includes("\\")) {
+    return void 0;
+  }
+  if (value.startsWith("//")) return void 0;
+  if (value.startsWith("/") || value.startsWith("./") || value.startsWith("../") || value.startsWith("#") || value.startsWith("?")) {
+    return value;
+  }
+  const scheme = /^([A-Za-z][A-Za-z0-9+.-]*):/.exec(value)?.[1]?.toLowerCase();
+  if (scheme !== void 0) {
+    return scheme === "https" || scheme === "http" || scheme === "mailto" ? value : void 0;
+  }
+  return value.includes(":") ? void 0 : value;
+}
+function renderMarkdownLink(label, rawUrl) {
+  const url = safeResourceUrl(rawUrl);
+  const text = label.trim();
+  if (!url || text === "") return text;
+  return `[${escapeMarkdownLabel(text)}](${escapeMarkdownUrl(url)})`;
+}
+function renderMarkdownResource(type, label, rawUrl) {
+  const link = renderMarkdownLink(label, rawUrl);
+  if (link === "" || link === label.trim()) return label.trim();
+  return `${type}: ${link}`;
+}
+function resourceMarkdownForNode(node, childLabel = "") {
+  const href = stringAttribute(node.attributes, "href");
+  const src = stringAttribute(node.attributes, "src");
+  const rawUrl = href ?? src;
+  if (!rawUrl) return "";
+  const name = (node.name ?? "").toLowerCase();
+  const label = childLabel.trim() || stringAttribute(node.attributes, "title") || stringAttribute(node.attributes, "caption") || stringAttribute(node.attributes, "alt") || (name === "video" || name === "iframe" ? "Video" : "Resource");
+  if (href) return renderMarkdownLink(label, href);
+  const type = name === "video" || name === "iframe" || name === "source" ? "Video" : name === "img" ? "Image" : "Media";
+  return renderMarkdownResource(type, label, src ?? "");
+}
+function componentMarkdownForNode(node) {
+  if (node.name === "LandingHero" || node.name === "LandingCta") {
+    const eyebrow = stringAttribute(node.attributes, "eyebrow");
+    const title = stringAttribute(node.attributes, "title");
+    const description = stringAttribute(node.attributes, "description");
+    const primaryLabel = stringAttribute(node.attributes, "primaryLabel");
+    const primaryHref = stringAttribute(node.attributes, "primaryHref");
+    const secondaryLabel = stringAttribute(node.attributes, "secondaryLabel");
+    const secondaryHref = stringAttribute(node.attributes, "secondaryHref");
+    const terminalLabel = stringAttribute(node.attributes, "terminalLabel");
+    const previewLabel = stringAttribute(node.attributes, "previewLabel");
+    return [
+      eyebrow,
+      title,
+      description,
+      primaryLabel && primaryHref ? renderMarkdownLink(primaryLabel, primaryHref) : void 0,
+      secondaryLabel && secondaryHref ? renderMarkdownLink(secondaryLabel, secondaryHref) : void 0,
+      terminalLabel,
+      previewLabel
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "TerminalWindow") {
+    return [
+      stringAttribute(node.attributes, "title"),
+      stringAttribute(node.attributes, "command")
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "AppPreview") {
+    return [
+      stringAttribute(node.attributes, "url"),
+      stringAttribute(node.attributes, "query"),
+      stringAttribute(node.attributes, "tool"),
+      stringAttribute(node.attributes, "response"),
+      stringAttribute(node.attributes, "entities"),
+      stringAttribute(node.attributes, "relationships")
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "MemoryStage") {
+    return [
+      stringAttribute(node.attributes, "badge"),
+      stringAttribute(node.attributes, "title"),
+      stringAttribute(node.attributes, "description")
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "DomainCard") {
+    const name = stringAttribute(node.attributes, "name");
+    const emoji = stringAttribute(node.attributes, "emoji");
+    const domain = stringAttribute(node.attributes, "domain");
+    const entities = stringAttribute(node.attributes, "entities")?.split("|").map((value) => value.trim()).filter(Boolean) ?? [];
+    if (!name || !domain) return "";
+    return [
+      `### ${emoji ? `${emoji} ` : ""}${name}`,
+      entities.join(" \xB7 "),
+      `\`--domain ${domain}\``,
+      entities.map((entity) => `\`:${entity}\``).join(" ") + " `+ base POLE+O types`",
+      `\`uvx create-context-graph --domain ${domain}\``
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "FrameworkCard") {
+    return [
+      stringAttribute(node.attributes, "title"),
+      stringAttribute(node.attributes, "support")
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "CommandStep") {
+    const title = stringAttribute(node.attributes, "title");
+    const command = stringAttribute(node.attributes, "command");
+    return [title, command ? `\`$ ${command}\`` : void 0].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "LandingFooter") {
+    return [
+      stringAttribute(node.attributes, "name"),
+      stringAttribute(node.attributes, "description")
+    ].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "Stat") {
+    const value = stringOrNumberAttribute(node.attributes, "value");
+    const label = stringAttribute(node.attributes, "label");
+    const caption = stringAttribute(node.attributes, "caption");
+    return [value, label, caption].filter(Boolean).join("\n\n");
+  }
+  if (node.name === "ColorSwatch") {
+    const name = stringAttribute(node.attributes, "name");
+    const value = stringAttribute(node.attributes, "value");
+    const usage = stringAttribute(node.attributes, "usage");
+    if (!name || !value) return "";
+    return `${name}: ${value}${usage ? `. ${usage}` : ""}`;
+  }
+  if (node.name === "TypeSpecimen") {
+    const family = stringAttribute(node.attributes, "family");
+    const role = stringAttribute(node.attributes, "role");
+    const weights = stringAttribute(node.attributes, "weights");
+    const sample = stringAttribute(node.attributes, "sample");
+    if (!family || !role || !weights || !sample) return "";
+    return `${family}: ${role}. Weights: ${weights}. Sample: ${sample}`;
+  }
+  if (node.name === "UsageExample") {
+    const verdict = stringAttribute(node.attributes, "verdict");
+    const title = stringAttribute(node.attributes, "title");
+    if (!verdict || !title) return "";
+    return `${verdict === "dont" ? "Do not" : "Do"}: ${title}`;
+  }
+  return "";
+}
+function renderHtmlResource(value) {
+  const tag = /<(iframe|video|audio|source|img|a)\b([^>]*)>/i.exec(value);
+  if (!tag) return "";
+  const name = tag[1]?.toLowerCase() ?? "";
+  const attributes = tag[2] ?? "";
+  const href = htmlAttribute(attributes, "href");
+  const src = htmlAttribute(attributes, "src");
+  const rawUrl = href ?? src;
+  if (!rawUrl) return "";
+  const label = htmlAttribute(attributes, "title") || htmlAttribute(attributes, "aria-label") || htmlAttribute(attributes, "alt") || (name === "video" || name === "iframe" ? "Video" : "Resource");
+  if (href) return renderMarkdownLink(label, href);
+  const type = name === "video" || name === "iframe" || name === "source" ? "Video" : name === "img" ? "Image" : "Media";
+  return renderMarkdownResource(type, label, src ?? "");
+}
+function stringAttribute(attributes, name) {
+  const attr = attributes?.find(
+    (candidate) => candidate.type === "mdxJsxAttribute" && candidate.name === name
+  );
+  if (!attr) return void 0;
+  if (typeof attr.value === "string") return attr.value;
+  if (attr.value && typeof attr.value === "object") {
+    return stringLiteralValue(attr.value.value ?? "");
+  }
+  return void 0;
+}
+function stringOrNumberAttribute(attributes, name) {
+  const attr = attributes?.find(
+    (candidate) => candidate.type === "mdxJsxAttribute" && candidate.name === name
+  );
+  if (!attr) return void 0;
+  if (typeof attr.value === "string") return attr.value;
+  if (!attr.value || typeof attr.value !== "object") return void 0;
+  const source = attr.value.value?.trim() ?? "";
+  return stringLiteralValue(source) ?? (/^-?(?:\d+\.?\d*|\.\d+)$/.test(source) ? source : void 0);
+}
+function htmlAttribute(attributes, name) {
+  const match = new RegExp(
+    `(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
+    "i"
+  ).exec(attributes);
+  return decodeHtmlAttribute(match?.[1] ?? match?.[2] ?? "") || void 0;
+}
+function decodeHtmlAttribute(value) {
+  return value.replace(/&amp;/gi, "&").replace(/&quot;/gi, '"').replace(/&#39;|&apos;/gi, "'").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">");
+}
+function escapeMarkdownLabel(value) {
+  return value.replace(/([\\\[\]])/g, "\\$1");
+}
+function escapeMarkdownUrl(value) {
+  return value.replace(/\\/g, "%5C").replace(/\(/g, "%28").replace(/\)/g, "%29");
+}
+function proseAttributeValues(attributes) {
+  return namedAttributeValues(attributes, PROSE_ATTRIBUTES);
+}
+function namedAttributeValues(attributes, names) {
+  if (!attributes) return [];
+  const values = [];
+  for (const attr of attributes) {
+    if (attr.type !== "mdxJsxAttribute") continue;
+    if (!attr.name || !names.has(attr.name)) continue;
+    const value = attr.value;
+    if (typeof value === "string") {
+      if (value.trim()) values.push(value.trim());
+    } else if (value && typeof value === "object") {
+      const literal = stringLiteralValue(value.value ?? "");
+      if (literal && literal.trim()) values.push(literal.trim());
+    }
+  }
+  return values;
+}
+function stringLiteralValue(code) {
+  const trimmed = code.trim();
+  if (trimmed === "") return void 0;
+  if (trimmed.startsWith('"')) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      return typeof parsed === "string" ? parsed : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  if (trimmed.startsWith("'")) {
+    const match = /^'((?:[^'\\]|\\.)*)'$/.exec(trimmed);
+    if (match && match[1] !== void 0) return match[1].replace(/\\(.)/g, "$1");
+    return void 0;
+  }
+  if (trimmed.startsWith("`")) {
+    const match = /^`([^`]*)`$/.exec(trimmed);
+    if (match && match[1] !== void 0 && !match[1].includes("${"))
+      return match[1];
+    return void 0;
+  }
+  return void 0;
+}
+function longestBacktickRun(value) {
+  let longest = 0;
+  let current = 0;
+  for (const char of value) {
+    if (char === "`") {
+      current += 1;
+      if (current > longest) longest = current;
+    } else {
+      current = 0;
+    }
+  }
+  return longest;
+}
+function parseFrontmatter(raw) {
+  try {
+    const data = parseYaml(raw);
+    if (data && typeof data === "object" && !Array.isArray(data)) {
+      const record = data;
+      const out = { frontmatter: record };
+      if (typeof record.title === "string") out.title = record.title;
+      if (typeof record.description === "string")
+        out.description = record.description;
+      return out;
+    }
+  } catch {
+  }
+  return { frontmatter: {} };
+}
+
+// src/lib/validate.ts
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+async function validateDocs(docsDir) {
+  const errors = [];
+  const docsJsonPath = join2(docsDir, "docs.json");
+  if (!existsSync2(docsJsonPath)) {
+    return [`docs.json not found in ${docsDir}.`];
+  }
+  let config;
+  try {
+    config = await loadDocsConfig(docsJsonPath);
+  } catch (error) {
+    return [`docs.json: ${messageOf(error)}`];
+  }
+  const modelsTomlPath = join2(docsDir, "models.toml");
+  if (existsSync2(modelsTomlPath)) {
+    try {
+      await loadModelsConfig(modelsTomlPath);
+    } catch (error) {
+      errors.push(`models.toml: ${messageOf(error)}`);
+    }
+  }
+  for (const entry of collectPageEntries(config)) {
+    let resolved;
+    try {
+      resolved = resolvePageFile(docsDir, entry);
+    } catch (error) {
+      errors.push(messageOf(error));
+      continue;
+    }
+    try {
+      const { frontmatter } = stripMdx(await readFile(resolved.file, "utf8"));
+      const groups = frontmatter.groups;
+      const grouped = Array.isArray(groups) && groups.length > 0;
+      if (grouped && frontmatter.pagefind !== false) {
+        errors.push(
+          `Page "${entry}" restricts access with \`groups\` but is missing \`pagefind: false\`; gated content must stay out of the shared search index.`
+        );
+      }
+    } catch (error) {
+      errors.push(`Page "${entry}": ${messageOf(error)}`);
+    }
+  }
+  for (const group of navigationGroups(config)) {
+    if (!group.openapi) continue;
+    const openapiPath = join2(docsDir, group.openapi);
+    if (!existsSync2(openapiPath)) {
+      errors.push(`OpenAPI file not found: ${group.openapi}`);
+      continue;
+    }
+    try {
+      await parseOpenApiFile(openapiPath);
+    } catch (error) {
+      errors.push(`OpenAPI ${group.openapi}: ${messageOf(error)}`);
+    }
+  }
+  return errors;
+}
+
+export {
+  resolvePageFile,
+  pageUrl,
+  collectPageEntries,
+  validateDocs
+};

package/dist/chunk-QLFODLVN.js

@@ -0,0 +1,46 @@
+// src/adapter/registry.ts
+var COMMAND_GROUPS = Object.freeze([
+  { name: "manage", summary: "Call one management operation through the dashboard API", renderer: false, load: () => import("./manage-MKH27U3B.js").then((m) => m.registerManage), metadata: () => import("./manage-MKH27U3B.js").then((m) => m.MANAGE_METADATA) },
+  { name: "requests", summary: "Documentation requests and the conversations behind them", renderer: false, load: () => import("./requests-H5MIGBIS.js").then((m) => m.registerRequests), metadata: () => import("./requests-H5MIGBIS.js").then((m) => m.REQUESTS_METADATA) },
+  { name: "suggestions", summary: "Read a site's suggestions and diff the content they carry", renderer: false, load: () => import("./suggestions-4WFQ3APX.js").then((m) => m.registerSuggestions), metadata: () => import("./suggestions-4WFQ3APX.js").then((m) => m.SUGGESTIONS_METADATA) },
+  { name: "schema", summary: "Print this CLI's own command metadata, locally", renderer: false, load: () => import("./schema-XJUEZSIW.js").then((m) => m.registerSchema), metadata: () => import("./schema-XJUEZSIW.js").then((m) => m.SCHEMA_METADATA) },
+  { name: "auth", summary: "Check the management credential in the environment", renderer: false, load: () => import("./auth-FRCFGNYT.js").then((m) => m.registerAuth), metadata: () => import("./auth-FRCFGNYT.js").then((m) => m.AUTH_METADATA) },
+  { name: "sites", summary: "Discover and inspect the sites this credential reaches", renderer: false, load: () => import("./sites-I4WI2MPG.js").then((m) => m.registerSites), metadata: () => import("./sites-I4WI2MPG.js").then((m) => m.SITES_METADATA) },
+  { name: "pages", summary: "Read the published pages of the release readers are seeing", renderer: false, load: () => import("./pages-HIPXRLSY.js").then((m) => m.registerPages), metadata: () => import("./pages-HIPXRLSY.js").then((m) => m.PAGES_METADATA) },
+  { name: "releases", summary: "Read this site's release history and one release by id", renderer: false, load: () => import("./read-ZEVUZNNB.js").then((m) => m.registerReleases), metadata: () => import("./read-ZEVUZNNB.js").then((m) => m.RELEASES_METADATA) },
+  { name: "status", summary: "One bounded briefing on a site, section by section", renderer: false, load: () => import("./status-7R3NOI5H.js").then((m) => m.registerStatus), metadata: () => import("./status-7R3NOI5H.js").then((m) => m.STATUS_METADATA) },
+  { name: "activity", summary: "Read what the platform did, and one job by id", renderer: false, load: () => import("./read-DMSJUEDA.js").then((m) => m.registerActivity), metadata: () => import("./read-DMSJUEDA.js").then((m) => m.ACTIVITY_METADATA) },
+  { name: "init", summary: "Scaffold a docs project", renderer: true, load: () => import("./init-7T5TEPBH.js").then((m) => m.registerInit) },
+  { name: "validate", summary: "Validate docs.json, models.toml, page files, and OpenAPI specs", renderer: true, load: () => import("./validate-VXL4PL42.js").then((m) => m.registerValidate) },
+  { name: "dev", summary: "Start the Astro dev server for a docs directory", renderer: true, load: () => import("./dev-VDSDCBO2.js").then((m) => m.registerDev) },
+  { name: "build", summary: "Build the static site for a docs directory", renderer: true, load: () => import("./build-F5PWGP57.js").then((m) => m.registerBuild) },
+  { name: "deploy", summary: "Upload a docs bundle and follow the release job", renderer: true, load: () => import("./deploy-QU7DCKWU.js").then((m) => m.registerDeploy) },
+  { name: "broken-links", summary: "Scan the built site for broken internal links", renderer: true, load: () => import("./brokenLinks-TTOBP4P7.js").then((m) => m.registerBrokenLinks) },
+  { name: "openapi-check", summary: "Parse OpenAPI specs and print an operation table", renderer: true, load: () => import("./openapiCheck-KGBQJTIQ.js").then((m) => m.registerOpenapiCheck) }
+]);
+var COMMAND_GROUP_NAMES = Object.freeze(COMMAND_GROUPS.map((group) => group.name));
+function findCommandGroup(name) {
+  return COMMAND_GROUPS.find((group) => group.name === name);
+}
+var VALUE_FLAGS = /* @__PURE__ */ new Set(["--site", "--api", "--timeout"]);
+function selectCommandGroup(argv) {
+  for (let index = 2; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--") break;
+    if (VALUE_FLAGS.has(token)) {
+      index += 1;
+      continue;
+    }
+    if (token.startsWith("-")) continue;
+    const group = findCommandGroup(token);
+    if (group !== void 0) return group;
+  }
+  return void 0;
+}
+
+export {
+  COMMAND_GROUPS,
+  COMMAND_GROUP_NAMES,
+  findCommandGroup,
+  selectCommandGroup
+};