docs-ready 0.3.0 → 0.4.0

package/dist/guard-EKGLQRED.js

@@ -0,0 +1,368 @@
+#!/usr/bin/env node
+import {
+  loadConfig
+} from "./chunk-QI2AROM3.js";
+import {
+  log,
+  spinner
+} from "./chunk-7YN54Y4Y.js";
+
+// src/utils/http.ts
+async function fetchWithTimeout(url, options = {}) {
+  const { timeout = 1e4, headers = {} } = options;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers
+    });
+    return response;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+function githubHeaders() {
+  const headers = {
+    Accept: "application/vnd.github.v3+json"
+  };
+  const token = process.env.GITHUB_TOKEN;
+  if (token) {
+    headers.Authorization = `Bearer ${token}`;
+  }
+  return headers;
+}
+
+// src/guard/monitors/npm.ts
+async function checkNpmPackage(config) {
+  const url = `https://registry.npmjs.org/${encodeURIComponent(config.name).replace("%40", "@")}/latest`;
+  try {
+    const response = await fetchWithTimeout(url, { timeout: 1e4 });
+    if (response.status === 404) {
+      return {
+        monitor: "npm",
+        label: config.label,
+        status: "fail",
+        message: `Package ${config.name} not found on npm`
+      };
+    }
+    if (!response.ok) {
+      return {
+        monitor: "npm",
+        label: config.label,
+        status: "warn",
+        message: `npm registry returned ${response.status}`
+      };
+    }
+    const data = await response.json();
+    return {
+      monitor: "npm",
+      label: config.label,
+      status: "pass",
+      message: `Latest version: ${data.version}`,
+      details: { latestVersion: data.version, package: config.name }
+    };
+  } catch (error) {
+    return {
+      monitor: "npm",
+      label: config.label,
+      status: "warn",
+      message: `Failed to check npm: ${error.message}`
+    };
+  }
+}
+
+// src/guard/monitors/github.ts
+async function checkGitHubRelease(config) {
+  const headers = githubHeaders();
+  try {
+    const releaseUrl = `https://api.github.com/repos/${config.repo}/releases/latest`;
+    const response = await fetchWithTimeout(releaseUrl, { timeout: 1e4, headers });
+    if (response.status === 403) {
+      return {
+        monitor: "github",
+        label: config.label,
+        status: "warn",
+        message: "GitHub API rate limit exceeded. Set GITHUB_TOKEN for higher limits."
+      };
+    }
+    if (response.ok) {
+      const data = await response.json();
+      return {
+        monitor: "github",
+        label: config.label,
+        status: "pass",
+        message: `Latest release: ${data.tag_name} (${data.published_at.split("T")[0]})`,
+        details: { tag: data.tag_name, publishedAt: data.published_at, repo: config.repo }
+      };
+    }
+    if (response.status === 404) {
+      return await checkTags(config, headers);
+    }
+    return {
+      monitor: "github",
+      label: config.label,
+      status: "warn",
+      message: `GitHub API returned ${response.status}`
+    };
+  } catch (error) {
+    return {
+      monitor: "github",
+      label: config.label,
+      status: "warn",
+      message: `Failed to check GitHub: ${error.message}`
+    };
+  }
+}
+async function checkTags(config, headers) {
+  try {
+    const tagsUrl = `https://api.github.com/repos/${config.repo}/tags?per_page=1`;
+    const response = await fetchWithTimeout(tagsUrl, { timeout: 1e4, headers });
+    if (!response.ok) {
+      return {
+        monitor: "github",
+        label: config.label,
+        status: "warn",
+        message: `No releases or tags found for ${config.repo}`
+      };
+    }
+    const tags = await response.json();
+    if (tags.length === 0) {
+      return {
+        monitor: "github",
+        label: config.label,
+        status: "warn",
+        message: `No releases or tags found for ${config.repo}`
+      };
+    }
+    return {
+      monitor: "github",
+      label: config.label,
+      status: "pass",
+      message: `Latest tag: ${tags[0].name}`,
+      details: { tag: tags[0].name, repo: config.repo }
+    };
+  } catch {
+    return {
+      monitor: "github",
+      label: config.label,
+      status: "warn",
+      message: `Failed to check tags for ${config.repo}`
+    };
+  }
+}
+
+// src/guard/monitors/endpoints.ts
+async function checkEndpoint(config) {
+  const expectedStatuses = config.expected_status ?? [200, 301, 302];
+  const startTime = Date.now();
+  try {
+    const response = await fetchWithTimeout(config.url, { timeout: 1e4 });
+    const elapsed = Date.now() - startTime;
+    if (expectedStatuses.includes(response.status)) {
+      return {
+        monitor: "endpoint",
+        label: config.label,
+        status: "pass",
+        message: `${config.url} returned ${response.status} (${elapsed}ms)`,
+        details: { url: config.url, statusCode: response.status, responseTime: elapsed }
+      };
+    }
+    return {
+      monitor: "endpoint",
+      label: config.label,
+      status: "fail",
+      message: `${config.url} returned ${response.status} (expected ${expectedStatuses.join("|")})`,
+      details: { url: config.url, statusCode: response.status, responseTime: elapsed }
+    };
+  } catch (error) {
+    const err = error;
+    if (err.name === "AbortError") {
+      return {
+        monitor: "endpoint",
+        label: config.label,
+        status: "fail",
+        message: `${config.url} timed out after 10s`
+      };
+    }
+    return {
+      monitor: "endpoint",
+      label: config.label,
+      status: "fail",
+      message: `${config.url} failed: ${err.message}`
+    };
+  }
+}
+
+// src/guard/monitors/readme-keywords.ts
+async function scanReadme(config) {
+  const url = `https://raw.githubusercontent.com/${config.repo}/main/README.md`;
+  try {
+    const response = await fetchWithTimeout(url, { timeout: 1e4, headers: githubHeaders() });
+    if (response.status === 404) {
+      const fallbackUrl = `https://raw.githubusercontent.com/${config.repo}/master/README.md`;
+      const fallback = await fetchWithTimeout(fallbackUrl, { timeout: 1e4, headers: githubHeaders() });
+      if (!fallback.ok) {
+        return {
+          monitor: "readme",
+          label: config.repo,
+          status: "warn",
+          message: `No README found for ${config.repo}`
+        };
+      }
+      return await analyzeReadme(await fallback.text(), config);
+    }
+    if (!response.ok) {
+      return {
+        monitor: "readme",
+        label: config.repo,
+        status: "warn",
+        message: `Failed to fetch README: ${response.status}`
+      };
+    }
+    return await analyzeReadme(await response.text(), config);
+  } catch (error) {
+    return {
+      monitor: "readme",
+      label: config.repo,
+      status: "warn",
+      message: `Failed to scan README: ${error.message}`
+    };
+  }
+}
+async function analyzeReadme(content, config) {
+  const found = [];
+  for (const keyword of config.keywords) {
+    const regex = new RegExp(keyword, "gi");
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+      const start = Math.max(0, match.index - 25);
+      const end = Math.min(content.length, match.index + keyword.length + 25);
+      const context = content.slice(start, end).replace(/\n/g, " ");
+      found.push({ keyword, context });
+    }
+  }
+  if (found.length > 0) {
+    return {
+      monitor: "readme",
+      label: config.repo,
+      status: "warn",
+      message: `Found ${found.length} keyword(s): ${found.map((f) => f.keyword).join(", ")}`,
+      details: { matches: found, repo: config.repo }
+    };
+  }
+  return {
+    monitor: "readme",
+    label: config.repo,
+    status: "pass",
+    message: `No concerning keywords found in README`
+  };
+}
+
+// src/guard/runner.ts
+async function runGuard(config) {
+  const results = [];
+  for (const pkg of config.guard.npm_packages) {
+    results.push(await checkNpmPackage(pkg));
+  }
+  for (const release of config.guard.github_releases) {
+    results.push(await checkGitHubRelease(release));
+  }
+  for (const endpoint of config.guard.endpoints) {
+    results.push(await checkEndpoint(endpoint));
+  }
+  for (const scan of config.guard.readme_scans) {
+    results.push(await scanReadme(scan));
+  }
+  return results;
+}
+function getExitCode(results) {
+  return results.some((r) => r.status === "fail") ? 1 : 0;
+}
+
+// src/guard/reporters/console.ts
+import chalk from "chalk";
+var ICONS = {
+  pass: chalk.green("\u2714"),
+  warn: chalk.yellow("\u26A0"),
+  fail: chalk.red("\u2716")
+};
+function formatConsole(results) {
+  const lines = [];
+  for (const result of results) {
+    const icon = ICONS[result.status];
+    lines.push(`${icon} [${result.monitor}] ${result.label}: ${result.message}`);
+  }
+  const passed = results.filter((r) => r.status === "pass").length;
+  const warned = results.filter((r) => r.status === "warn").length;
+  const failed = results.filter((r) => r.status === "fail").length;
+  lines.push("");
+  lines.push(`Results: ${passed} passed, ${warned} warnings, ${failed} failed`);
+  return lines.join("\n");
+}
+
+// src/guard/reporters/json.ts
+function formatJson(results) {
+  return JSON.stringify(results, null, 2);
+}
+
+// src/guard/reporters/markdown.ts
+var STATUS_EMOJI = {
+  pass: "\u2705",
+  warn: "\u26A0\uFE0F",
+  fail: "\u274C"
+};
+function formatMarkdown(results) {
+  const lines = [];
+  lines.push("# docs-ready Guard Report");
+  lines.push("");
+  lines.push("| Status | Monitor | Label | Message |");
+  lines.push("|--------|---------|-------|---------|");
+  for (const result of results) {
+    const emoji = STATUS_EMOJI[result.status];
+    lines.push(`| ${emoji} ${result.status} | ${result.monitor} | ${result.label} | ${result.message} |`);
+  }
+  const failed = results.filter((r) => r.status === "fail").length;
+  lines.push("");
+  if (failed > 0) {
+    lines.push(`**${failed} check(s) failed.** Please review and update AI-facing documentation.`);
+  } else {
+    lines.push("All checks passed.");
+  }
+  return lines.join("\n");
+}
+
+// src/cli/commands/guard.ts
+async function guardCommand(options = {}) {
+  const cwd = process.cwd();
+  const config = await loadConfig(cwd);
+  const totalChecks = config.guard.npm_packages.length + config.guard.github_releases.length + config.guard.endpoints.length + config.guard.readme_scans.length;
+  if (totalChecks === 0) {
+    log.warn("No guard checks configured. Add monitors to .docs-ready.yaml");
+    return;
+  }
+  const spin = spinner(`Running ${totalChecks} guard checks...`);
+  spin.start();
+  const results = await runGuard(config);
+  spin.stop();
+  const format = options.output ?? "console";
+  switch (format) {
+    case "json":
+      console.log(formatJson(results));
+      break;
+    case "markdown":
+      console.log(formatMarkdown(results));
+      break;
+    default:
+      console.log(formatConsole(results));
+      break;
+  }
+  const exitCode = getExitCode(results);
+  if (exitCode !== 0) {
+    process.exitCode = exitCode;
+  }
+}
+export {
+  guardCommand
+};
+//# sourceMappingURL=guard-EKGLQRED.js.map

package/dist/guard-EKGLQRED.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/http.ts","../src/guard/monitors/npm.ts","../src/guard/monitors/github.ts","../src/guard/monitors/endpoints.ts","../src/guard/monitors/readme-keywords.ts","../src/guard/runner.ts","../src/guard/reporters/console.ts","../src/guard/reporters/json.ts","../src/guard/reporters/markdown.ts","../src/cli/commands/guard.ts"],"sourcesContent":["export interface FetchOptions {\n  timeout?: number;\n  headers?: Record<string, string>;\n}\n\nexport async function fetchWithTimeout(\n  url: string,\n  options: FetchOptions = {}\n): Promise<Response> {\n  const { timeout = 10000, headers = {} } = options;\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  try {\n    const response = await fetch(url, {\n      signal: controller.signal,\n      headers,\n    });\n    return response;\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n\nexport function githubHeaders(): Record<string, string> {\n  const headers: Record<string, string> = {\n    Accept: \"application/vnd.github.v3+json\",\n  };\n  const token = process.env.GITHUB_TOKEN;\n  if (token) {\n    headers.Authorization = `Bearer ${token}`;\n  }\n  return headers;\n}\n","import { fetchWithTimeout } from \"../../utils/http.js\";\nimport type { GuardResult } from \"../types.js\";\n\nexport interface NpmPackageConfig {\n  name: string;\n  label: string;\n}\n\nexport async function checkNpmPackage(config: NpmPackageConfig): Promise<GuardResult> {\n  const url = `https://registry.npmjs.org/${encodeURIComponent(config.name).replace(\"%40\", \"@\")}/latest`;\n\n  try {\n    const response = await fetchWithTimeout(url, { timeout: 10000 });\n\n    if (response.status === 404) {\n      return {\n        monitor: \"npm\",\n        label: config.label,\n        status: \"fail\",\n        message: `Package ${config.name} not found on npm`,\n      };\n    }\n\n    if (!response.ok) {\n      return {\n        monitor: \"npm\",\n        label: config.label,\n        status: \"warn\",\n        message: `npm registry returned ${response.status}`,\n      };\n    }\n\n    const data = await response.json() as { version: string };\n    return {\n      monitor: \"npm\",\n      label: config.label,\n      status: \"pass\",\n      message: `Latest version: ${data.version}`,\n      details: { latestVersion: data.version, package: config.name },\n    };\n  } catch (error) {\n    return {\n      monitor: \"npm\",\n      label: config.label,\n      status: \"warn\",\n      message: `Failed to check npm: ${(error as Error).message}`,\n    };\n  }\n}\n","import { fetchWithTimeout } from \"../../utils/http.js\";\nimport { githubHeaders } from \"../../utils/http.js\";\nimport type { GuardResult } from \"../types.js\";\n\nexport interface GitHubReleaseConfig {\n  repo: string;\n  label: string;\n}\n\nexport async function checkGitHubRelease(config: GitHubReleaseConfig): Promise<GuardResult> {\n  const headers = githubHeaders();\n\n  // Try releases API first\n  try {\n    const releaseUrl = `https://api.github.com/repos/${config.repo}/releases/latest`;\n    const response = await fetchWithTimeout(releaseUrl, { timeout: 10000, headers });\n\n    if (response.status === 403) {\n      return {\n        monitor: \"github\",\n        label: config.label,\n        status: \"warn\",\n        message: \"GitHub API rate limit exceeded. Set GITHUB_TOKEN for higher limits.\",\n      };\n    }\n\n    if (response.ok) {\n      const data = await response.json() as { tag_name: string; published_at: string };\n      return {\n        monitor: \"github\",\n        label: config.label,\n        status: \"pass\",\n        message: `Latest release: ${data.tag_name} (${data.published_at.split(\"T\")[0]})`,\n        details: { tag: data.tag_name, publishedAt: data.published_at, repo: config.repo },\n      };\n    }\n\n    // No releases — fall back to tags API\n    if (response.status === 404) {\n      return await checkTags(config, headers);\n    }\n\n    return {\n      monitor: \"github\",\n      label: config.label,\n      status: \"warn\",\n      message: `GitHub API returned ${response.status}`,\n    };\n  } catch (error) {\n    return {\n      monitor: \"github\",\n      label: config.label,\n      status: \"warn\",\n      message: `Failed to check GitHub: ${(error as Error).message}`,\n    };\n  }\n}\n\nasync function checkTags(\n  config: GitHubReleaseConfig,\n  headers: Record<string, string>\n): Promise<GuardResult> {\n  try {\n    const tagsUrl = `https://api.github.com/repos/${config.repo}/tags?per_page=1`;\n    const response = await fetchWithTimeout(tagsUrl, { timeout: 10000, headers });\n\n    if (!response.ok) {\n      return {\n        monitor: \"github\",\n        label: config.label,\n        status: \"warn\",\n        message: `No releases or tags found for ${config.repo}`,\n      };\n    }\n\n    const tags = await response.json() as Array<{ name: string }>;\n    if (tags.length === 0) {\n      return {\n        monitor: \"github\",\n        label: config.label,\n        status: \"warn\",\n        message: `No releases or tags found for ${config.repo}`,\n      };\n    }\n\n    return {\n      monitor: \"github\",\n      label: config.label,\n      status: \"pass\",\n      message: `Latest tag: ${tags[0].name}`,\n      details: { tag: tags[0].name, repo: config.repo },\n    };\n  } catch {\n    return {\n      monitor: \"github\",\n      label: config.label,\n      status: \"warn\",\n      message: `Failed to check tags for ${config.repo}`,\n    };\n  }\n}\n","import { fetchWithTimeout } from \"../../utils/http.js\";\nimport type { GuardResult } from \"../types.js\";\n\nexport interface EndpointConfig {\n  url: string;\n  label: string;\n  expected_status?: number[];\n}\n\nexport async function checkEndpoint(config: EndpointConfig): Promise<GuardResult> {\n  const expectedStatuses = config.expected_status ?? [200, 301, 302];\n  const startTime = Date.now();\n\n  try {\n    const response = await fetchWithTimeout(config.url, { timeout: 10000 });\n    const elapsed = Date.now() - startTime;\n\n    if (expectedStatuses.includes(response.status)) {\n      return {\n        monitor: \"endpoint\",\n        label: config.label,\n        status: \"pass\",\n        message: `${config.url} returned ${response.status} (${elapsed}ms)`,\n        details: { url: config.url, statusCode: response.status, responseTime: elapsed },\n      };\n    }\n\n    return {\n      monitor: \"endpoint\",\n      label: config.label,\n      status: \"fail\",\n      message: `${config.url} returned ${response.status} (expected ${expectedStatuses.join(\"|\")})`,\n      details: { url: config.url, statusCode: response.status, responseTime: elapsed },\n    };\n  } catch (error) {\n    const err = error as Error;\n    if (err.name === \"AbortError\") {\n      return {\n        monitor: \"endpoint\",\n        label: config.label,\n        status: \"fail\",\n        message: `${config.url} timed out after 10s`,\n      };\n    }\n    return {\n      monitor: \"endpoint\",\n      label: config.label,\n      status: \"fail\",\n      message: `${config.url} failed: ${err.message}`,\n    };\n  }\n}\n","import { fetchWithTimeout, githubHeaders } from \"../../utils/http.js\";\nimport type { GuardResult } from \"../types.js\";\n\nexport interface ReadmeScanConfig {\n  repo: string;\n  keywords: string[];\n}\n\nexport async function scanReadme(config: ReadmeScanConfig): Promise<GuardResult> {\n  const url = `https://raw.githubusercontent.com/${config.repo}/main/README.md`;\n\n  try {\n    const response = await fetchWithTimeout(url, { timeout: 10000, headers: githubHeaders() });\n\n    if (response.status === 404) {\n      // Try master branch\n      const fallbackUrl = `https://raw.githubusercontent.com/${config.repo}/master/README.md`;\n      const fallback = await fetchWithTimeout(fallbackUrl, { timeout: 10000, headers: githubHeaders() });\n      if (!fallback.ok) {\n        return {\n          monitor: \"readme\",\n          label: config.repo,\n          status: \"warn\",\n          message: `No README found for ${config.repo}`,\n        };\n      }\n      return await analyzeReadme(await fallback.text(), config);\n    }\n\n    if (!response.ok) {\n      return {\n        monitor: \"readme\",\n        label: config.repo,\n        status: \"warn\",\n        message: `Failed to fetch README: ${response.status}`,\n      };\n    }\n\n    return await analyzeReadme(await response.text(), config);\n  } catch (error) {\n    return {\n      monitor: \"readme\",\n      label: config.repo,\n      status: \"warn\",\n      message: `Failed to scan README: ${(error as Error).message}`,\n    };\n  }\n}\n\nasync function analyzeReadme(content: string, config: ReadmeScanConfig): Promise<GuardResult> {\n  const found: Array<{ keyword: string; context: string }> = [];\n\n  for (const keyword of config.keywords) {\n    const regex = new RegExp(keyword, \"gi\");\n    let match;\n    while ((match = regex.exec(content)) !== null) {\n      const start = Math.max(0, match.index - 25);\n      const end = Math.min(content.length, match.index + keyword.length + 25);\n      const context = content.slice(start, end).replace(/\\n/g, \" \");\n      found.push({ keyword, context });\n    }\n  }\n\n  if (found.length > 0) {\n    return {\n      monitor: \"readme\",\n      label: config.repo,\n      status: \"warn\",\n      message: `Found ${found.length} keyword(s): ${found.map((f) => f.keyword).join(\", \")}`,\n      details: { matches: found, repo: config.repo },\n    };\n  }\n\n  return {\n    monitor: \"readme\",\n    label: config.repo,\n    status: \"pass\",\n    message: `No concerning keywords found in README`,\n  };\n}\n","import type { GuardResult } from \"./types.js\";\nimport { checkNpmPackage } from \"./monitors/npm.js\";\nimport { checkGitHubRelease } from \"./monitors/github.js\";\nimport { checkEndpoint } from \"./monitors/endpoints.js\";\nimport { scanReadme } from \"./monitors/readme-keywords.js\";\nimport type { DocsReadyConfig } from \"../core/config.js\";\n\nexport async function runGuard(config: DocsReadyConfig): Promise<GuardResult[]> {\n  const results: GuardResult[] = [];\n\n  // npm monitors\n  for (const pkg of config.guard.npm_packages) {\n    results.push(await checkNpmPackage(pkg));\n  }\n\n  // GitHub release monitors\n  for (const release of config.guard.github_releases) {\n    results.push(await checkGitHubRelease(release));\n  }\n\n  // Endpoint monitors\n  for (const endpoint of config.guard.endpoints) {\n    results.push(await checkEndpoint(endpoint));\n  }\n\n  // README scans\n  for (const scan of config.guard.readme_scans) {\n    results.push(await scanReadme(scan));\n  }\n\n  return results;\n}\n\nexport function getExitCode(results: GuardResult[]): number {\n  return results.some((r) => r.status === \"fail\") ? 1 : 0;\n}\n","import chalk from \"chalk\";\nimport type { GuardResult } from \"../types.js\";\n\nconst ICONS: Record<string, string> = {\n  pass: chalk.green(\"✔\"),\n  warn: chalk.yellow(\"⚠\"),\n  fail: chalk.red(\"✖\"),\n};\n\nexport function formatConsole(results: GuardResult[]): string {\n  const lines: string[] = [];\n\n  for (const result of results) {\n    const icon = ICONS[result.status];\n    lines.push(`${icon} [${result.monitor}] ${result.label}: ${result.message}`);\n  }\n\n  const passed = results.filter((r) => r.status === \"pass\").length;\n  const warned = results.filter((r) => r.status === \"warn\").length;\n  const failed = results.filter((r) => r.status === \"fail\").length;\n  lines.push(\"\");\n  lines.push(`Results: ${passed} passed, ${warned} warnings, ${failed} failed`);\n\n  return lines.join(\"\\n\");\n}\n","import type { GuardResult } from \"../types.js\";\n\nexport function formatJson(results: GuardResult[]): string {\n  return JSON.stringify(results, null, 2);\n}\n","import type { GuardResult } from \"../types.js\";\n\nconst STATUS_EMOJI: Record<string, string> = {\n  pass: \"✅\",\n  warn: \"⚠️\",\n  fail: \"❌\",\n};\n\nexport function formatMarkdown(results: GuardResult[]): string {\n  const lines: string[] = [];\n\n  lines.push(\"# docs-ready Guard Report\");\n  lines.push(\"\");\n  lines.push(\"| Status | Monitor | Label | Message |\");\n  lines.push(\"|--------|---------|-------|---------|\");\n\n  for (const result of results) {\n    const emoji = STATUS_EMOJI[result.status];\n    lines.push(`| ${emoji} ${result.status} | ${result.monitor} | ${result.label} | ${result.message} |`);\n  }\n\n  const failed = results.filter((r) => r.status === \"fail\").length;\n  lines.push(\"\");\n  if (failed > 0) {\n    lines.push(`**${failed} check(s) failed.** Please review and update AI-facing documentation.`);\n  } else {\n    lines.push(\"All checks passed.\");\n  }\n\n  return lines.join(\"\\n\");\n}\n","import { loadConfig } from \"../../core/config.js\";\nimport { runGuard, getExitCode } from \"../../guard/runner.js\";\nimport { formatConsole } from \"../../guard/reporters/console.js\";\nimport { formatJson } from \"../../guard/reporters/json.js\";\nimport { formatMarkdown } from \"../../guard/reporters/markdown.js\";\nimport { log, spinner } from \"../../utils/logger.js\";\n\ninterface GuardOptions {\n  output?: string;\n}\n\nexport async function guardCommand(options: GuardOptions = {}): Promise<void> {\n  const cwd = process.cwd();\n  const config = await loadConfig(cwd);\n\n  const totalChecks =\n    config.guard.npm_packages.length +\n    config.guard.github_releases.length +\n    config.guard.endpoints.length +\n    config.guard.readme_scans.length;\n\n  if (totalChecks === 0) {\n    log.warn(\"No guard checks configured. Add monitors to .docs-ready.yaml\");\n    return;\n  }\n\n  const spin = spinner(`Running ${totalChecks} guard checks...`);\n  spin.start();\n\n  const results = await runGuard(config);\n  spin.stop();\n\n  // Output\n  const format = options.output ?? \"console\";\n  switch (format) {\n    case \"json\":\n      console.log(formatJson(results));\n      break;\n    case \"markdown\":\n      console.log(formatMarkdown(results));\n      break;\n    default:\n      console.log(formatConsole(results));\n      break;\n  }\n\n  // Exit code\n  const exitCode = getExitCode(results);\n  if (exitCode !== 0) {\n    process.exitCode = exitCode;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -208,11 +208,12 @@ async function main() {
     await initCommand();
   });
   program.command("generate").description("Generate AI-facing documentation files").option("--dry-run", "Show what would be generated without writing files").option("--only <type>", "Generate only: llms-txt, llms-full, or ai-context").action(async (opts) => {
-    const { generateCommand } = await import("./generate-LDVEG2WV.js");
+    const { generateCommand } = await import("./generate-N54SEQ7E.js");
     await generateCommand({ dryRun: opts.dryRun, only: opts.only });
   });
-  program.command("guard").description("Check AI-facing docs for staleness").action(() => {
-    console.log("Guard command coming in v0.4.0");
+  program.command("guard").description("Check AI-facing docs for staleness").option("--output <format>", "Output format: console, json, or markdown", "console").action(async (opts) => {
+    const { guardCommand } = await import("./guard-EKGLQRED.js");
+    await guardCommand({ output: opts.output });
   });
   program.command("validate").description("Lint and validate AI-facing docs").action(() => {
     console.log("Validate command coming in v0.6.0");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/index.ts","../src/cli/commands/init.ts","../src/frameworks/detector.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { readFile } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport path from \"node:path\";\nimport { initCommand } from \"./commands/init.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nasync function getVersion(): Promise<string> {\n  let dir = __dirname;\n  for (let i = 0; i < 5; i++) {\n    try {\n      const pkg = JSON.parse(await readFile(path.join(dir, \"package.json\"), \"utf-8\"));\n      return pkg.version;\n    } catch {\n      dir = path.dirname(dir);\n    }\n  }\n  return \"0.0.0\";\n}\n\nasync function main(): Promise<void> {\n  const version = await getVersion();\n\n  const program = new Command();\n\n  program\n    .name(\"docs-ready\")\n    .description(\"Make your docs AI-ready. Keep them that way.\")\n    .version(version);\n\n  program\n    .command(\"init\")\n    .description(\"Initialize docs-ready in your project\")\n    .action(async () => {\n      await initCommand();\n    });\n\n  program\n    .command(\"generate\")\n    .description(\"Generate AI-facing documentation files\")\n    .option(\"--dry-run\", \"Show what would be generated without writing files\")\n    .option(\"--only <type>\", \"Generate only: llms-txt, llms-full, or ai-context\")\n    .action(async (opts) => {\n      const { generateCommand } = await import(\"./commands/generate.js\");\n      await generateCommand({ dryRun: opts.dryRun, only: opts.only });\n    });\n\n  program\n    .command(\"guard\")\n    .description(\"Check AI-facing docs for staleness\")\n    .action(() => {\n      console.log(\"Guard command coming in v0.4.0\");\n    });\n\n  program\n    .command(\"validate\")\n    .description(\"Lint and validate AI-facing docs\")\n    .action(() => {\n      console.log(\"Validate command coming in v0.6.0\");\n    });\n\n  await program.parseAsync(process.argv);\n}\n\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createInterface } from \"node:readline/promises\";\nimport { stdin, stdout } from \"node:process\";\nimport { detectFramework } from \"../../frameworks/detector.js\";\nimport { log, spinner } from \"../../utils/logger.js\";\n\ninterface InitOptions {\n  cwd?: string;\n}\n\nexport async function initCommand(options: InitOptions = {}): Promise<void> {\n  const cwd = options.cwd ?? process.cwd();\n  const configPath = path.join(cwd, \".docs-ready.yaml\");\n\n  // Check if config already exists\n  try {\n    await fs.access(configPath);\n    log.warn(\".docs-ready.yaml already exists. Use --force to overwrite.\");\n    return;\n  } catch {\n    // Config doesn't exist, proceed\n  }\n\n  const spin = spinner(\"Detecting project structure...\");\n  spin.start();\n\n  // Detect framework\n  const framework = await detectFramework(cwd);\n  spin.stop();\n\n  log.info(`Detected framework: ${framework.name}`);\n  log.info(`Docs directory: ${framework.docsDir}`);\n\n  // Detect deployment platform\n  const platform = await detectPlatform(cwd);\n  if (platform !== \"none\") {\n    log.info(`Detected platform: ${platform}`);\n  }\n\n  // Detect docusaurus-plugin-llms\n  const hasLlmsPlugin = await detectLlmsPlugin(cwd);\n  if (hasLlmsPlugin) {\n    log.warn(\"Detected docusaurus-plugin-llms — disabling llms.txt/llms-full.txt generation.\");\n  }\n\n  // Prompt for project info\n  const rl = createInterface({ input: stdin, output: stdout });\n  const title = await rl.question(\"Project title: \");\n  const description = await rl.question(\"Description: \");\n  const url = await rl.question(\"Docs URL (e.g. https://docs.example.com): \");\n  rl.close();\n\n  // Render config from template (try file first, fall back to inline)\n  const templateData: Record<string, string> = {\n    title: title || \"My Project\",\n    description: description || \"Project documentation\",\n    url: url || \"https://docs.example.com\",\n    docsDir: framework.docsDir,\n    llmsTxt: String(!hasLlmsPlugin),\n    llmsFullTxt: String(!hasLlmsPlugin),\n    platform,\n  };\n\n  const template = await loadTemplate();\n  const rendered = template.replace(/\\{\\{(\\w+)\\}\\}/g, (_, key) => templateData[key] ?? \"\");\n\n  await fs.writeFile(configPath, rendered, \"utf-8\");\n  log.success(\"Created .docs-ready.yaml\");\n  log.dim(\"Next: run `docs-ready generate` to create AI-facing files.\");\n}\n\nasync function loadTemplate(): Promise<string> {\n  // Try to load the template file (works when installed as npm package)\n  const candidates = [\n    path.join(path.dirname(new URL(import.meta.url).pathname), \"../../templates/config.yaml.tmpl\"),\n    path.join(path.dirname(new URL(import.meta.url).pathname), \"../templates/config.yaml.tmpl\"),\n  ];\n\n  for (const candidate of candidates) {\n    try {\n      return await fs.readFile(candidate, \"utf-8\");\n    } catch {\n      // Try next\n    }\n  }\n\n  // Inline fallback\n  return `# docs-ready configuration\ntitle: \"{{title}}\"\ndescription: \"{{description}}\"\nurl: \"{{url}}\"\ndocs:\n  dir: \"{{docsDir}}\"\n  include:\n    - \"**/*.md\"\n    - \"**/*.mdx\"\n  exclude:\n    - \"**/node_modules/**\"\n    - \"**/_*\"\ngenerate:\n  llms_txt: {{llmsTxt}}\n  llms_full_txt: {{llmsFullTxt}}\n  ai_context: true\n  output_dir: \"./build\"\ndeploy:\n  platform: \"{{platform}}\"\n`;\n}\n\nasync function detectPlatform(\n  cwd: string\n): Promise<\"vercel\" | \"netlify\" | \"cloudflare\" | \"none\"> {\n  const checks: Array<{ file: string; platform: \"vercel\" | \"netlify\" | \"cloudflare\" }> = [\n    { file: \"vercel.json\", platform: \"vercel\" },\n    { file: \"netlify.toml\", platform: \"netlify\" },\n    { file: \"_headers\", platform: \"cloudflare\" },\n    { file: \"wrangler.toml\", platform: \"cloudflare\" },\n  ];\n\n  for (const { file, platform } of checks) {\n    try {\n      await fs.access(path.join(cwd, file));\n      return platform;\n    } catch {\n      // Not found, continue\n    }\n  }\n\n  return \"none\";\n}\n\nasync function detectLlmsPlugin(cwd: string): Promise<boolean> {\n  try {\n    const pkgPath = path.join(cwd, \"package.json\");\n    const content = await fs.readFile(pkgPath, \"utf-8\");\n    const pkg = JSON.parse(content);\n    const allDeps = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n    return \"docusaurus-plugin-llms\" in allDeps;\n  } catch {\n    return false;\n  }\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport interface FrameworkResult {\n  name: \"docusaurus\" | \"vitepress\" | \"mkdocs\" | \"starlight\" | \"generic\";\n  configFile: string | null;\n  docsDir: string;\n}\n\nconst DETECTORS: Array<{\n  name: FrameworkResult[\"name\"];\n  files: string[];\n  docsDir: string;\n}> = [\n  {\n    name: \"docusaurus\",\n    files: [\n      \"docusaurus.config.ts\",\n      \"docusaurus.config.js\",\n      \"docusaurus.config.mts\",\n      \"docusaurus.config.mjs\",\n    ],\n    docsDir: \"./docs\",\n  },\n  {\n    name: \"vitepress\",\n    files: [\n      \".vitepress/config.ts\",\n      \".vitepress/config.js\",\n      \".vitepress/config.mts\",\n      \".vitepress/config.mjs\",\n    ],\n    docsDir: \"./docs\",\n  },\n  {\n    name: \"mkdocs\",\n    files: [\"mkdocs.yml\", \"mkdocs.yaml\"],\n    docsDir: \"./docs\",\n  },\n  {\n    name: \"starlight\",\n    files: [\"astro.config.mjs\", \"astro.config.ts\", \"astro.config.js\"],\n    docsDir: \"./src/content/docs\",\n  },\n];\n\nexport async function detectFramework(projectDir: string): Promise<FrameworkResult> {\n  for (const detector of DETECTORS) {\n    for (const file of detector.files) {\n      const fullPath = path.join(projectDir, file);\n      try {\n        await fs.access(fullPath);\n\n        if (detector.name === \"starlight\") {\n          const content = await fs.readFile(fullPath, \"utf-8\");\n          if (!content.includes(\"starlight\")) {\n            continue;\n          }\n        }\n\n        return {\n          name: detector.name,\n          configFile: fullPath,\n          docsDir: detector.docsDir,\n        };\n      } catch {\n        // File doesn't exist, try next\n      }\n    }\n  }\n\n  return {\n    name: \"generic\",\n    configFile: null,\n    docsDir: \"./docs\",\n  };\n}\n"],"mappings":";;;;;;;AAAA,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,OAAOA,WAAU;;;ACHjB,OAAOC,SAAQ;AACf,OAAOC,WAAU;AACjB,SAAS,uBAAuB;AAChC,SAAS,OAAO,cAAc;;;ACH9B,OAAO,QAAQ;AACf,OAAO,UAAU;AAQjB,IAAM,YAID;AAAA,EACH;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,SAAS;AAAA,EACX;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,SAAS;AAAA,EACX;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO,CAAC,cAAc,aAAa;AAAA,IACnC,SAAS;AAAA,EACX;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO,CAAC,oBAAoB,mBAAmB,iBAAiB;AAAA,IAChE,SAAS;AAAA,EACX;AACF;AAEA,eAAsB,gBAAgB,YAA8C;AAClF,aAAW,YAAY,WAAW;AAChC,eAAW,QAAQ,SAAS,OAAO;AACjC,YAAM,WAAW,KAAK,KAAK,YAAY,IAAI;AAC3C,UAAI;AACF,cAAM,GAAG,OAAO,QAAQ;AAExB,YAAI,SAAS,SAAS,aAAa;AACjC,gBAAM,UAAU,MAAM,GAAG,SAAS,UAAU,OAAO;AACnD,cAAI,CAAC,QAAQ,SAAS,WAAW,GAAG;AAClC;AAAA,UACF;AAAA,QACF;AAEA,eAAO;AAAA,UACL,MAAM,SAAS;AAAA,UACf,YAAY;AAAA,UACZ,SAAS,SAAS;AAAA,QACpB;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,SAAS;AAAA,EACX;AACF;;;ADjEA,eAAsB,YAAY,UAAuB,CAAC,GAAkB;AAC1E,QAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;AACvC,QAAM,aAAaC,MAAK,KAAK,KAAK,kBAAkB;AAGpD,MAAI;AACF,UAAMC,IAAG,OAAO,UAAU;AAC1B,QAAI,KAAK,4DAA4D;AACrE;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,QAAM,OAAO,QAAQ,gCAAgC;AACrD,OAAK,MAAM;AAGX,QAAM,YAAY,MAAM,gBAAgB,GAAG;AAC3C,OAAK,KAAK;AAEV,MAAI,KAAK,uBAAuB,UAAU,IAAI,EAAE;AAChD,MAAI,KAAK,mBAAmB,UAAU,OAAO,EAAE;AAG/C,QAAM,WAAW,MAAM,eAAe,GAAG;AACzC,MAAI,aAAa,QAAQ;AACvB,QAAI,KAAK,sBAAsB,QAAQ,EAAE;AAAA,EAC3C;AAGA,QAAM,gBAAgB,MAAM,iBAAiB,GAAG;AAChD,MAAI,eAAe;AACjB,QAAI,KAAK,qFAAgF;AAAA,EAC3F;AAGA,QAAM,KAAK,gBAAgB,EAAE,OAAO,OAAO,QAAQ,OAAO,CAAC;AAC3D,QAAM,QAAQ,MAAM,GAAG,SAAS,iBAAiB;AACjD,QAAM,cAAc,MAAM,GAAG,SAAS,eAAe;AACrD,QAAM,MAAM,MAAM,GAAG,SAAS,4CAA4C;AAC1E,KAAG,MAAM;AAGT,QAAM,eAAuC;AAAA,IAC3C,OAAO,SAAS;AAAA,IAChB,aAAa,eAAe;AAAA,IAC5B,KAAK,OAAO;AAAA,IACZ,SAAS,UAAU;AAAA,IACnB,SAAS,OAAO,CAAC,aAAa;AAAA,IAC9B,aAAa,OAAO,CAAC,aAAa;AAAA,IAClC;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,aAAa;AACpC,QAAM,WAAW,SAAS,QAAQ,kBAAkB,CAAC,GAAG,QAAQ,aAAa,GAAG,KAAK,EAAE;AAEvF,QAAMA,IAAG,UAAU,YAAY,UAAU,OAAO;AAChD,MAAI,QAAQ,0BAA0B;AACtC,MAAI,IAAI,4DAA4D;AACtE;AAEA,eAAe,eAAgC;AAE7C,QAAM,aAAa;AAAA,IACjBD,MAAK,KAAKA,MAAK,QAAQ,IAAI,IAAI,YAAY,GAAG,EAAE,QAAQ,GAAG,kCAAkC;AAAA,IAC7FA,MAAK,KAAKA,MAAK,QAAQ,IAAI,IAAI,YAAY,GAAG,EAAE,QAAQ,GAAG,+BAA+B;AAAA,EAC5F;AAEA,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,aAAO,MAAMC,IAAG,SAAS,WAAW,OAAO;AAAA,IAC7C,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBT;AAEA,eAAe,eACb,KACuD;AACvD,QAAM,SAAiF;AAAA,IACrF,EAAE,MAAM,eAAe,UAAU,SAAS;AAAA,IAC1C,EAAE,MAAM,gBAAgB,UAAU,UAAU;AAAA,IAC5C,EAAE,MAAM,YAAY,UAAU,aAAa;AAAA,IAC3C,EAAE,MAAM,iBAAiB,UAAU,aAAa;AAAA,EAClD;AAEA,aAAW,EAAE,MAAM,SAAS,KAAK,QAAQ;AACvC,QAAI;AACF,YAAMA,IAAG,OAAOD,MAAK,KAAK,KAAK,IAAI,CAAC;AACpC,aAAO;AAAA,IACT,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,SAAO;AACT;AAEA,eAAe,iBAAiB,KAA+B;AAC7D,MAAI;AACF,UAAM,UAAUA,MAAK,KAAK,KAAK,cAAc;AAC7C,UAAM,UAAU,MAAMC,IAAG,SAAS,SAAS,OAAO;AAClD,UAAM,MAAM,KAAK,MAAM,OAAO;AAC9B,UAAM,UAAU;AAAA,MACd,GAAG,IAAI;AAAA,MACP,GAAG,IAAI;AAAA,IACT;AACA,WAAO,4BAA4B;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;AD3IA,IAAMC,aAAYC,MAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,eAAe,aAA8B;AAC3C,MAAI,MAAMD;AACV,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,QAAI;AACF,YAAM,MAAM,KAAK,MAAM,MAAM,SAASC,MAAK,KAAK,KAAK,cAAc,GAAG,OAAO,CAAC;AAC9E,aAAO,IAAI;AAAA,IACb,QAAQ;AACN,YAAMA,MAAK,QAAQ,GAAG;AAAA,IACxB;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,OAAsB;AACnC,QAAM,UAAU,MAAM,WAAW;AAEjC,QAAM,UAAU,IAAI,QAAQ;AAE5B,UACG,KAAK,YAAY,EACjB,YAAY,8CAA8C,EAC1D,QAAQ,OAAO;AAElB,UACG,QAAQ,MAAM,EACd,YAAY,uCAAuC,EACnD,OAAO,YAAY;AAClB,UAAM,YAAY;AAAA,EACpB,CAAC;AAEH,UACG,QAAQ,UAAU,EAClB,YAAY,wCAAwC,EACpD,OAAO,aAAa,oDAAoD,EACxE,OAAO,iBAAiB,mDAAmD,EAC3E,OAAO,OAAO,SAAS;AACtB,UAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,wBAAwB;AACjE,UAAM,gBAAgB,EAAE,QAAQ,KAAK,QAAQ,MAAM,KAAK,KAAK,CAAC;AAAA,EAChE,CAAC;AAEH,UACG,QAAQ,OAAO,EACf,YAAY,oCAAoC,EAChD,OAAO,MAAM;AACZ,YAAQ,IAAI,gCAAgC;AAAA,EAC9C,CAAC;AAEH,UACG,QAAQ,UAAU,EAClB,YAAY,kCAAkC,EAC9C,OAAO,MAAM;AACZ,YAAQ,IAAI,mCAAmC;AAAA,EACjD,CAAC;AAEH,QAAM,QAAQ,WAAW,QAAQ,IAAI;AACvC;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":["path","fs","path","path","fs","__dirname","path"]}
+{"version":3,"sources":["../src/cli/index.ts","../src/cli/commands/init.ts","../src/frameworks/detector.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { readFile } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport path from \"node:path\";\nimport { initCommand } from \"./commands/init.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nasync function getVersion(): Promise<string> {\n  let dir = __dirname;\n  for (let i = 0; i < 5; i++) {\n    try {\n      const pkg = JSON.parse(await readFile(path.join(dir, \"package.json\"), \"utf-8\"));\n      return pkg.version;\n    } catch {\n      dir = path.dirname(dir);\n    }\n  }\n  return \"0.0.0\";\n}\n\nasync function main(): Promise<void> {\n  const version = await getVersion();\n\n  const program = new Command();\n\n  program\n    .name(\"docs-ready\")\n    .description(\"Make your docs AI-ready. Keep them that way.\")\n    .version(version);\n\n  program\n    .command(\"init\")\n    .description(\"Initialize docs-ready in your project\")\n    .action(async () => {\n      await initCommand();\n    });\n\n  program\n    .command(\"generate\")\n    .description(\"Generate AI-facing documentation files\")\n    .option(\"--dry-run\", \"Show what would be generated without writing files\")\n    .option(\"--only <type>\", \"Generate only: llms-txt, llms-full, or ai-context\")\n    .action(async (opts) => {\n      const { generateCommand } = await import(\"./commands/generate.js\");\n      await generateCommand({ dryRun: opts.dryRun, only: opts.only });\n    });\n\n  program\n    .command(\"guard\")\n    .description(\"Check AI-facing docs for staleness\")\n    .option(\"--output <format>\", \"Output format: console, json, or markdown\", \"console\")\n    .action(async (opts) => {\n      const { guardCommand } = await import(\"./commands/guard.js\");\n      await guardCommand({ output: opts.output });\n    });\n\n  program\n    .command(\"validate\")\n    .description(\"Lint and validate AI-facing docs\")\n    .action(() => {\n      console.log(\"Validate command coming in v0.6.0\");\n    });\n\n  await program.parseAsync(process.argv);\n}\n\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createInterface } from \"node:readline/promises\";\nimport { stdin, stdout } from \"node:process\";\nimport { detectFramework } from \"../../frameworks/detector.js\";\nimport { log, spinner } from \"../../utils/logger.js\";\n\ninterface InitOptions {\n  cwd?: string;\n}\n\nexport async function initCommand(options: InitOptions = {}): Promise<void> {\n  const cwd = options.cwd ?? process.cwd();\n  const configPath = path.join(cwd, \".docs-ready.yaml\");\n\n  // Check if config already exists\n  try {\n    await fs.access(configPath);\n    log.warn(\".docs-ready.yaml already exists. Use --force to overwrite.\");\n    return;\n  } catch {\n    // Config doesn't exist, proceed\n  }\n\n  const spin = spinner(\"Detecting project structure...\");\n  spin.start();\n\n  // Detect framework\n  const framework = await detectFramework(cwd);\n  spin.stop();\n\n  log.info(`Detected framework: ${framework.name}`);\n  log.info(`Docs directory: ${framework.docsDir}`);\n\n  // Detect deployment platform\n  const platform = await detectPlatform(cwd);\n  if (platform !== \"none\") {\n    log.info(`Detected platform: ${platform}`);\n  }\n\n  // Detect docusaurus-plugin-llms\n  const hasLlmsPlugin = await detectLlmsPlugin(cwd);\n  if (hasLlmsPlugin) {\n    log.warn(\"Detected docusaurus-plugin-llms — disabling llms.txt/llms-full.txt generation.\");\n  }\n\n  // Prompt for project info\n  const rl = createInterface({ input: stdin, output: stdout });\n  const title = await rl.question(\"Project title: \");\n  const description = await rl.question(\"Description: \");\n  const url = await rl.question(\"Docs URL (e.g. https://docs.example.com): \");\n  rl.close();\n\n  // Render config from template (try file first, fall back to inline)\n  const templateData: Record<string, string> = {\n    title: title || \"My Project\",\n    description: description || \"Project documentation\",\n    url: url || \"https://docs.example.com\",\n    docsDir: framework.docsDir,\n    llmsTxt: String(!hasLlmsPlugin),\n    llmsFullTxt: String(!hasLlmsPlugin),\n    platform,\n  };\n\n  const template = await loadTemplate();\n  const rendered = template.replace(/\\{\\{(\\w+)\\}\\}/g, (_, key) => templateData[key] ?? \"\");\n\n  await fs.writeFile(configPath, rendered, \"utf-8\");\n  log.success(\"Created .docs-ready.yaml\");\n  log.dim(\"Next: run `docs-ready generate` to create AI-facing files.\");\n}\n\nasync function loadTemplate(): Promise<string> {\n  // Try to load the template file (works when installed as npm package)\n  const candidates = [\n    path.join(path.dirname(new URL(import.meta.url).pathname), \"../../templates/config.yaml.tmpl\"),\n    path.join(path.dirname(new URL(import.meta.url).pathname), \"../templates/config.yaml.tmpl\"),\n  ];\n\n  for (const candidate of candidates) {\n    try {\n      return await fs.readFile(candidate, \"utf-8\");\n    } catch {\n      // Try next\n    }\n  }\n\n  // Inline fallback\n  return `# docs-ready configuration\ntitle: \"{{title}}\"\ndescription: \"{{description}}\"\nurl: \"{{url}}\"\ndocs:\n  dir: \"{{docsDir}}\"\n  include:\n    - \"**/*.md\"\n    - \"**/*.mdx\"\n  exclude:\n    - \"**/node_modules/**\"\n    - \"**/_*\"\ngenerate:\n  llms_txt: {{llmsTxt}}\n  llms_full_txt: {{llmsFullTxt}}\n  ai_context: true\n  output_dir: \"./build\"\ndeploy:\n  platform: \"{{platform}}\"\n`;\n}\n\nasync function detectPlatform(\n  cwd: string\n): Promise<\"vercel\" | \"netlify\" | \"cloudflare\" | \"none\"> {\n  const checks: Array<{ file: string; platform: \"vercel\" | \"netlify\" | \"cloudflare\" }> = [\n    { file: \"vercel.json\", platform: \"vercel\" },\n    { file: \"netlify.toml\", platform: \"netlify\" },\n    { file: \"_headers\", platform: \"cloudflare\" },\n    { file: \"wrangler.toml\", platform: \"cloudflare\" },\n  ];\n\n  for (const { file, platform } of checks) {\n    try {\n      await fs.access(path.join(cwd, file));\n      return platform;\n    } catch {\n      // Not found, continue\n    }\n  }\n\n  return \"none\";\n}\n\nasync function detectLlmsPlugin(cwd: string): Promise<boolean> {\n  try {\n    const pkgPath = path.join(cwd, \"package.json\");\n    const content = await fs.readFile(pkgPath, \"utf-8\");\n    const pkg = JSON.parse(content);\n    const allDeps = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n    return \"docusaurus-plugin-llms\" in allDeps;\n  } catch {\n    return false;\n  }\n}\n","import fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport interface FrameworkResult {\n  name: \"docusaurus\" | \"vitepress\" | \"mkdocs\" | \"starlight\" | \"generic\";\n  configFile: string | null;\n  docsDir: string;\n}\n\nconst DETECTORS: Array<{\n  name: FrameworkResult[\"name\"];\n  files: string[];\n  docsDir: string;\n}> = [\n  {\n    name: \"docusaurus\",\n    files: [\n      \"docusaurus.config.ts\",\n      \"docusaurus.config.js\",\n      \"docusaurus.config.mts\",\n      \"docusaurus.config.mjs\",\n    ],\n    docsDir: \"./docs\",\n  },\n  {\n    name: \"vitepress\",\n    files: [\n      \".vitepress/config.ts\",\n      \".vitepress/config.js\",\n      \".vitepress/config.mts\",\n      \".vitepress/config.mjs\",\n    ],\n    docsDir: \"./docs\",\n  },\n  {\n    name: \"mkdocs\",\n    files: [\"mkdocs.yml\", \"mkdocs.yaml\"],\n    docsDir: \"./docs\",\n  },\n  {\n    name: \"starlight\",\n    files: [\"astro.config.mjs\", \"astro.config.ts\", \"astro.config.js\"],\n    docsDir: \"./src/content/docs\",\n  },\n];\n\nexport async function detectFramework(projectDir: string): Promise<FrameworkResult> {\n  for (const detector of DETECTORS) {\n    for (const file of detector.files) {\n      const fullPath = path.join(projectDir, file);\n      try {\n        await fs.access(fullPath);\n\n        if (detector.name === \"starlight\") {\n          const content = await fs.readFile(fullPath, \"utf-8\");\n          if (!content.includes(\"starlight\")) {\n            continue;\n          }\n        }\n\n        return {\n          name: detector.name,\n          configFile: fullPath,\n          docsDir: detector.docsDir,\n        };\n      } catch {\n        // File doesn't exist, try next\n      }\n    }\n  }\n\n  return {\n    name: \"generic\",\n    configFile: null,\n    docsDir: \"./docs\",\n  };\n}\n"],"mappings":"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","names":["path","fs","path","path","fs","__dirname","path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docs-ready",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Make your docs AI-ready. Keep them that way.",
   "type": "module",
   "bin": {
@@ -58,6 +58,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
+    "msw": "^2.12.14",
     "tsup": "^8.2.0",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"